Timer
Visão geral
A coluna Timer regista o tempo despendido numa linha. Pode iniciar e parar um cronómetro diretamente a partir do registo, ou adicionar entradas manualmente com uma duração definida. Cada entrada é guardada no histórico da linha, e os totais acumulam entre sessões.
Controlos em tempo de execução
Na vista de formulário
O painel do formulário mostra um ícone de temporizador, a etiqueta (ou o nome da coluna), e até três controlos:
- "Iniciar" / "Parar" — inicia ou para o cronómetro em execução. Enquanto está em execução, um contador de tempo decorrido avança em tempo real.
- "+" (adicionar manualmente) — abre o diálogo "Adicionar" para registar uma duração passada, associada à data de hoje. Só está disponível numa linha já guardada.
- "Histórico" — abre o diálogo de histórico desta linha. Só está disponível numa linha já guardada quando a opção Mostrar histórico no formulário está ativada na configuração da coluna.
Na vista de célula (tabela)
A célula apresenta um único botão de ícone: play_circle_outline quando parado ("Iniciar temporizador"), stop_circle quando em execução ("Parar temporizador"). A adição manual e o histórico não estão acessíveis a partir da célula.
Configuração
| Definição | Descrição |
|---|---|
| Etiqueta | Texto opcional que substitui o nome da coluna no painel do formulário e no título do diálogo de histórico. |
| Pedir confirmação antes de iniciar | Quando ativado, abre um diálogo de início antes de o temporizador começar de facto. Utilize esta opção para capturar notas ou escolhas de linhas ligadas no momento de início. |
| Mostrar histórico no formulário | Mostra o botão "Histórico" no painel do formulário. Desative para um layout mais limpo quando os utilizadores não precisam de rever entradas anteriores. |
| Categoria a partir da coluna | Coluna cujo valor atual é copiado para Timer.category quando o temporizador é iniciado. Útil para etiquetar entradas automaticamente (por exemplo, uma coluna de lista "Projeto"). |
| Campos de contexto a capturar | Lista legada de colunas da feature anfitriã cujos valores são capturados para metadata.fields no início. Ainda é lida para compatibilidade com versões anteriores; novas configurações devem utilizar antes featureColumnMap.host. |
| Feature destino | Feature de destino cujas linhas recebem o resultado do temporizador. Quando definida, ao parar é criada uma nova linha nessa feature (ou o utilizador escolhe uma linha existente, consoante a forma como o mapeamento está configurado). |
| Mapa de colunas da feature | Dicionário que controla como os dados do temporizador fluem para a feature ligada. Quatro chaves reconhecidas: auto (mapeia colunas da feature ligada para campos do temporizador — ver lista abaixo), host (mapeia colunas da feature ligada para colunas da linha atual, lidas no início), ask_at_start (lista de colunas da feature ligada apresentadas no diálogo de início para o utilizador preencher), history_label_field (controla o título de cada entrada na lista de histórico — ou auto:label|category|notes|duration para ler um campo do temporizador, ou field:<name> para ler dos metadados capturados). |
As fontes disponíveis para auto são: started_at (Início), ended_at (Fim), duration_seconds (Duração, em segundos), user_id (Utilizador que iniciou o temporizador), label (Etiqueta), category (Categoria), notes (Notas), subuser_id (Operador, id), subuser_name (Operador, nome) e subuser_sector (Operador, setor).
As três últimas (subuser_id, subuser_name, subuser_sector) vêm do operador com sessão iniciada num Kiosk no momento em que o temporizador arranca. Se o temporizador for iniciado a partir de um kiosk com um operador em sessão, essas colunas ficam preenchidas quando o temporizador para; se for iniciado fora de um kiosk (ou sem operador em sessão), ficam vazias.
Perfis ("Perfis")
Os perfis são atalhos com nome, geridos por workspace. Cada perfil pode predefinir uma etiqueta, ícone, cor, categoria por defeito, notas por defeito, uma feature de ligação, um mapa de colunas da feature, e regras opcionais de paragem automática (parar a uma hora fixa do dia, parar após uma duração máxima, com uma janela de aviso opcional). Quando o utilizador abre o diálogo "Adicionar" (a partir do painel do formulário ou de uma vista de timesheet), pode escolher um perfil — os valores por defeito desse perfil pré-preenchem o formulário, e quaisquer colunas ask_at_start são apresentadas para preenchimento.
Diálogo de histórico ("Histórico")
O diálogo de histórico lista todas as entradas do temporizador para a linha, ordenadas da mais recente para a mais antiga. O cabeçalho mostra o tempo total e o número de entradas. Controlos:
- Botão "Adicionar" — abre o diálogo de entrada para registar uma nova entrada manual.
- Tocar numa entrada — abre o diálogo de edição quando a entrada foi adicionada manualmente. As entradas criadas pelo cronómetro mantêm-se só de leitura, e tocar nelas mostra uma breve mensagem informativa.
- Menu de contexto — cada entrada tem um menu com "Editar" (apenas entradas manuais) e "Eliminar". A eliminação pede confirmação num diálogo e mostra uma breve confirmação.
Vistas de timesheet
Os modos Diário, Semanal e Mensal da vista Timesheet disponibilizam o mesmo diálogo "Adicionar" e o mesmo seletor de perfis. As entradas criadas aí são idênticas às criadas a partir do componente, e aparecem no histórico da linha.