Timesheet View
Overview
The Timesheet view aggregates recorded time into Diário (daily), Semanal (weekly), and Mensal (monthly) tabs, plus an Estatísticas (stats) tab for period totals grouped by category, user, profile, or a mapped field. A KPI strip above the tabs always shows totals for today, this week, this month, and overall.
It reads time either from the global Timer log or from a feature's own rows, so it works both as a personal/team time-tracking dashboard and as a read-oriented report over any feature that has date and duration data.
Data source
| Setting | Description |
|---|---|
| Fonte de dados | Auto (default) resolves automatically: when the view isn't tied to a feature — or the feature is named "Timer" — it reads the global Timer log; otherwise it reads rows from that feature. Timer and Feature force one source explicitly. |
| Mapeamento de colunas | Only shown when the effective source is a feature. Maps feature columns to the timesheet's semantic fields: Data, Duração (segundos), Início/Fim (used to derive duration when no duration column is mapped), Etiqueta, Categoria, Utilizador, Notas. At minimum a date (or start time) and either a duration or a start/end pair must be mapped, or the view shows a "Mapeamento de colunas em falta" notice instead of data. |
When the source resolves to a feature, entries are read-only — the tab bar and KPI strip show aggregated totals, but there's no "Adicionar" button and existing rows can't be edited from the timesheet itself. Only a Timer-sourced timesheet supports adding and editing entries inline, through the same "Adicionar" dialog described in the Timer component page.
Modes
Configure which tabs are visible under Modos. When only one mode is enabled, the tab bar is hidden and that mode fills the whole view.
| Mode | Layout |
|---|---|
| Diário | A single day's entries as a list (start, end, duration per row), with prev/today/next navigation and a running total against an optional daily target. |
| Semanal | A grid with one column per weekday and one row per category (or a single "Total" row when category grouping is off), plus a totals row and a rightmost total column. |
| Mensal | A month calendar grid with per-day totals. On wide screens it splits into the calendar plus a day-detail panel on the right; on narrow screens tapping a day opens the same detail as a dialog. |
| Estatísticas | A period selector (Hoje / Semana / Mês / Ano / Tudo / custom range) and a "group by" switch (Categoria / Utilizador / Perfil / mapped field), rendering a bar list of totals per group. |
Mode-specific settings, also under Modos:
| Setting | Applies to | Description |
|---|---|---|
| Breakdown por categoria | Diário | Shows chips with the total per category above the day's list. |
| Agrupar por categoria | Semanal | Splits the grid into one row per category instead of a single aggregated total row. |
| Semana começa em | Semanal | Which weekday starts the week grid. |
| Primeiro dia da semana | Mensal | Which weekday starts each row of the month grid. |
| Coluna total de semana | Mensal | Shows the per-row week-total column on the left of the grid. |
Filters
| Setting | Description |
|---|---|
| Categoria | Limits records to a single category value. Leave blank to show all categories. |
| User id | Limits records to a single user. Leave blank to fall back to whatever the row-level security rules allow. |
| Target horas/dia | Optional daily hours target, used to render a "logged / target" total in the Diário, Semanal, and Mensal headers. |
Interface
| Setting | Description |
|---|---|
| Permitir entradas manuais | Shows the "Adicionar" button and enables editing existing entries. Has no effect when the data source is a feature — those timesheets are always read-only. |
Admin configuration
The Configurar Timesheet dialog has four tabs: Filtros, Fonte, Modos, and Interface, matching the sections above.
Tips
- Use a Timer-sourced Timesheet when you want people to log and edit their own time from the view; use a feature-sourced Timesheet when you want a read-only rollup of time-like data that already lives in a feature.
- Older workspaces may still have separate Daily/Weekly/Monthly Timesheet view types created before the unified view existed. They render through the same components locked to a single mode and no longer appear in the view type picker — new views should use Timesheet with only the needed mode(s) enabled instead.
- If a feature-sourced timesheet shows "Mapeamento de colunas em falta", open the view's configuration and complete the Data/Duração (or Início+Fim) mapping under Fonte.