timer

Temporizador

Cronómetro da linha, com perfil de campos, arredondamento e linha derivada ao parar.

• Kind: component
• Key: timer
• Categoria: tempo
• Envelope: mapa (um objeto JSON em config)

Campos

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
label	string	não	-	Etiqueta do temporizador a correr; vazio usa o rótulo da coluna.	-
contextFieldsToCapture	list de string	não	[]	Colunas desta tabela copiadas para o histórico ao arrancar; anterior ao featureColumnMap, que é o caminho de hoje.	-
categoryFromField	string	não	-	Descontinuado. Coluna desta tabela cujo valor virava a categoria; hoje a origem escreve-se em fieldSources.category.	coluna (nome)
timerProfileId	uuid	não	-	Perfil que define o esquema de campos do temporizador; sem perfil, a coluna comporta-se como antes.	perfil de timer (uuid)
fieldSources	map	não	-	Origem de cada campo do esquema do perfil (label, category, notes, custom_1..3) nesta coluna.	-
promptBeforeStart	boolean	não	false	Abre o diálogo de arranque antes de contar o tempo.	-
showHistoryButton	boolean	não	true	Mostra o botão de histórico no formulário.	-
linkFeatureId	uuid	não	-	Tabela que recebe uma linha nova ao parar; vazio só alimenta as tabelas de temporizador.	feature (uuid)
featureColumnMap	map	não	-	Mapeamento para a tabela de destino: que coluna recebe o quê ao parar. As chaves de auto e host são nomes de colunas dessa tabela.	-
roundingMinutes	integer	não	-	Arredonda a duração ao múltiplo de minutos mais próximo ao parar; vazio ou 0 não arredonda.	-
countdownMinutes	integer	não	-	Conta para trás a partir destes minutos em vez de mostrar o tempo decorrido.	-
dailyGoalMinutes	integer	não	-	Objetivo diário mostrado como "Hoje: X / Y" no formulário; nunca bloqueia nada.	-
startWorkflowV2Id	uuid	não	-	Automação WorkflowV2 disparada quando arranca.	workflow V2 (uuid)
stopWorkflowV2Id	uuid	não	-	Automação WorkflowV2 disparada quando para; independente da de arranque.	workflow V2 (uuid)

fieldSources{}

Cada entrada de fieldSources é um objeto:

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
mode	enumeration	sim	-	De onde vem o valor: coluna da linha, valor fixo, pergunta ao iniciar, ou campo escondido.	-
column	string	não	-	Coluna desta tabela lida no modo "host".	coluna (nome)
value	string	não	-	Valor escrito na configuração no modo "fixed": dado de utilizador. Opaco: transporta dados do utilizador e nenhum resolvedor entra aqui.	-

featureColumnMap

Chave	Tipo	Obrigatório	Omissão	Descrição	Referência
auto	map	não	-	Coluna de destino → campo do temporizador que a preenche. Pelo menos uma entrada liga a criação da linha.	chave: coluna de linkFeatureId (nome)
host	map	não	-	Coluna de destino → coluna DESTA tabela de onde se copia o valor, lido na linha ao arrancar.	chave: coluna de linkFeatureId (nome)
ask_at_start	list de string	não	-	Colunas da tabela de destino que o utilizador preenche no diálogo de arranque.	-
history_label_field	string	não	-	Título de cada entrada no histórico: "auto:<campo>" ou "field:<coluna de destino>"; vazio mostra a duração.	-

Exemplo JSON

{
  "contextFieldsToCapture": [],
  "promptBeforeStart": false,
  "showHistoryButton": true
}

---

Gerado de definitions.json versão 17f3e0bc59d9. Esta página nasce no build: não se edita à mão.