Timer
Configuration reference: Temporizador
Overview
The Timer column measures the time spent on a row. Each finished session becomes a row of the workspace's Tempos table, linked to this row by the origin column; the total and the history add up those rows. Times are kept even if you stop the timer offline or it stops on its own with the app closed.
Runtime controls
In form view
The form panel shows a timer icon, the label (or column name), and up to three controls:
- "Iniciar" / "Parar" — starts or stops the running stopwatch. While running, an elapsed counter ticks in real time.
- "+" (add manually) — opens the "Adicionar" dialog to log a past duration against today's date. Only available on a saved row.
- "Histórico" — opens the history dialog for this row. Only available on a saved row when Show history button is enabled in the column configuration.
In cell (table) view
The cell renders a single icon button: play_circle_outline when stopped ("Iniciar temporizador"), stop_circle when running ("Parar temporizador"). Manual-add and history are not accessible from the cell.
Where times are stored
Every workspace has a Tempos table, created by the system. The server writes each stopped session there, with:
| Column | What it holds |
|---|---|
| Início, Fim | The real interval of the session. |
| Duração | In hours and minutes (stored in seconds), already rounded by the column (Arredondar ao parar (minutos)). |
| Data | The day in the workspace's time zone. |
| Utilizador, Operador | Who logged the time (on a Kiosk, the operator). |
| Perfil, Descrição, Categoria, Notas | The session's context. |
| Name of the origin table | The row where the timer was started. |
Until the server writes the row (offline, for example), the session shows as por sincronizar (pending sync) in the timers panel and greyed out in timesheets, and it already counts in the totals. If the write fails, the panel shows a tentar de novo (retrying) and a Tentar agora (retry now) button.
The Tempos system columns can't be deleted or renamed; you can hide them, add columns and create views. By default each person sees only their own times; an admin changes this in the table settings (Cada pessoa vê só os seus tempos). Admins always see everything.
Configuration
| Setting | Description |
|---|---|
| Label | Optional text that overrides the column name in the form panel and history dialog title. |
| Prompt before start | When enabled, opens a start dialog before the timer actually begins. Use this to capture notes or linked-row choices at start time. |
| Show history button | Shows the "Histórico" button in the form panel. Disable for a cleaner layout when users don't need to review past entries. |
| Round on stop (minutes) ("Arredondar ao parar (minutos)") | Rounds each session's duration to the nearest multiple of these minutes when the timer stops (e.g., 15). Empty = no rounding. |
| Category from field | Column whose current value goes into the Tempos Categoria column when the timer starts. Useful for tagging entries automatically (e.g., a "Project" select column). |
| Context fields to capture | Legacy list of host columns whose values are snapshotted into metadata.fields at start. Still read for backwards compatibility; new configs should use featureColumnMap.host instead. |
| Link feature | Table the user picks a row from at start (pick-row mode). Times are not written to this table: they go to Tempos. |
| Feature column map | Dictionary linking the timer to the link feature. Recognised keys: host (maps linked-feature columns to columns of the current row, read at start), ask_at_start (list of linked-feature columns rendered in the start dialog for the user to fill in), history_label_field (controls the title of each entry in the history list — auto:label|category|notes|duration or auto:custom_1|custom_2|custom_3 to read a field of the time entry, or field:<name> to read another column). |
Profiles ("Perfis")
Profiles are named shortcuts managed per workspace. Each profile can predefine a label, icon, colour, default category, default notes, a linked feature, a feature column map, optional auto-stop rules (stop at a fixed time of day, stop after a maximum duration, with an optional warning window), and the Grelha horária used by the Timesheet Horário mode: Começa às, Acaba às and Intervalo (15, 30 or 60 minutes). Empty means the default, 08:00–18:00 in 30-minute slots. When the user opens the "Adicionar" dialog (from the form panel or a timesheet view), they can pick a profile — its defaults pre-populate the form, and any ask_at_start columns are rendered for input.
Automations
The stop workflow always runs, also when the timer stops on its own with the app closed; the start workflow runs in the app. A stop workflow needs a plan with manual workflows; when the timer stops on its own it also needs a plan with automations.
History dialog ("Histórico")
Lists your times on this row, newest first, with the total. All of them can be edited and deleted; editing a time keeps its start time. Controls:
- "Adicionar" button — opens the entry dialog to log a manual time.
- Tap a time — opens the edit dialog.
- "Editar" and "Eliminar" — buttons on each time. Deletion asks for confirmation.
The cell total adds up the times you can see on this row (the whole team's when the table shows everyone's times, or for admins); the daily goal counts only yours.
Your logs ("Os teus registos")
Ver registos…, in the timers panel, opens the timesheet with your times. The profile chip in the title offers Todos os perfis and the workspace's enabled profiles, and starts on Todos os perfis: it shows all your times, and Horário uses the grid of the newest running session's profile (with none, the newest one waiting to sync; with neither, the default). Picking a profile keeps only its times and uses its grid; a new entry preselects that profile (on «Todos os perfis», the session's one if enabled).
Timesheet views
The Timesheet view's Diário, Semanal, Horário, Blocos and Mensal modes expose the same "Adicionar" dialog and profile picker. The dialog shows the time as Duração (hours and minutes) or Início e fim (two times on the same day), always with the duration next to it; it opens in Início e fim in Horário (from a slot or Adicionar) and when editing a stopwatch entry that starts and ends on that day, and the Introduzir só a duração / Introduzir início e fim link switches mode. The +15 min, +30 min and +1 h buttons add to the duration; in Início e fim they move the end, up to 24:00. Entries created there are identical to those created from the component; only entries with an origin (a picked row, or the view's origin table, filterSourceFeatureId) appear in a row's history.