Vista Timesheet

Referência de configuração: Folha de horas

Visão geral

A vista Timesheet agrega o tempo registado em separadores Diário, Semanal, Horário, Blocos e Mensal, mais um separador Estatísticas para totais de período agrupados por categoria, utilizador, perfil, ou um campo capturado pelo perfil do temporizador, como cliente, projeto ou tarefa. Uma faixa de KPI acima dos separadores mostra os totais de hoje, esta semana, este mês, e global; no Horário e nos Blocos só com Resumo no topo ligado.

Lê o tempo a partir do Tempos do workspace (onde o Temporizador guarda as sessões) ou das próprias linhas de uma tabela, pelo que funciona tanto como um painel pessoal/de equipa de registo de tempo como um relatório orientado a leitura sobre qualquer tabela que tenha dados de data e duração.

Fonte de dados

Fonte de dados:

• Auto (por omissão): o Tempos do workspace quando a vista não está ligada a uma tabela, ou está ligada ao próprio Tempos; as linhas da tabela da vista nos outros casos.
• Tabela: as linhas da tabela da vista, lidas pelo mapa de colunas (data, duração, início, fim, …).

A fonte Temporizador deixou de existir; as vistas que a usavam leem agora o Tempos.

Mapeamento de colunas: só aparece quando a fonte efetiva é uma tabela. Mapeia colunas da tabela para os campos do timesheet: Data, Duração (segundos), Início/Fim (usados para derivar a duração quando não há coluna de duração mapeada), Etiqueta, Categoria, Utilizador, Notas. No mínimo, é preciso mapear uma data (ou hora de início) e ou uma duração ou um par início/fim, caso contrário a vista mostra um aviso "Mapeamento de colunas em falta" em vez de dados.

Mostrar os tempos da equipa: só aparece na fonte Tempos. Desligado (por omissão), cada pessoa vê só os seus tempos; ligado, vê os tempos de todos os que pode ver.

Quando a fonte é uma tabela, as entradas são só de leitura: não há botão "Adicionar" e as linhas não se editam a partir do timesheet. Na fonte Tempos, "Adicionar", tocar para editar e "Apagar" trabalham sobre as linhas do Tempos, com a mesma caixa de diálogo "Adicionar" descrita na página do componente Temporizador.

Modos

Configura quais os separadores visíveis em Modos. Quando só um modo está ativo, a barra de separadores fica oculta e esse modo preenche toda a vista. Com mais de quatro modos, o seletor da barra passa a ser um menu. Uma vista nova tem os seis; numa vista que já existia, o Horário e os Blocos aparecem quando um administrador os liga.

Modo	Layout
Diário	As entradas de um único dia como lista (início, fim, duração por linha), com navegação anterior/hoje/seguinte e um total corrente face a um objetivo diário opcional.
Semanal	Uma grelha com uma coluna por dia da semana e uma linha por categoria (ou uma única linha "Total" quando o agrupamento por categoria está desligado), mais uma linha de totais e uma coluna de total mais à direita.
Horário	A semana com as horas do dia à esquerda e um dia por coluna; cada registo do Tempos aparece no seu início e fim, lado a lado quando se sobrepõem (até três; os restantes contam num chip +N). Tocar numa fatia cria um registo nessa fatia; arrastar com o rato, ou carregar e arrastar no ecrã tátil, cobre várias. As horas e o intervalo vêm da Grelha horária do perfil do filtro; sem perfil, ou com o perfil desativado, das 08:00 às 18:00 em fatias de 30 minutos. Só funciona com o Tempos como fonte; com outra fonte mostra «O Horário usa o Tempos.»
Blocos	A semana sem eixo de horas: cada dia empilha os seus registos com a altura da duração, e o Adicionar tempo de cada dia cria um registo em horas e minutos. Com um objetivo diário, uma linha tracejada marca a meta, com o valor na primeira coluna. Numa fonte tabela é só de leitura.
Mensal	Uma grelha de calendário mensal com totais por dia. Em ecrãs largos divide-se no calendário mais um painel de detalhe do dia à direita; em ecrãs estreitos, tocar num dia abre o mesmo detalhe como caixa de diálogo.
Estatísticas	Um seletor de período (Hoje / Semana / Mês / Ano / Tudo / intervalo personalizado) e um seletor de "agrupar por" (Categoria / Utilizador / Perfil / campo capturado pelo perfil do temporizador, como cliente, projeto ou tarefa), gerando uma lista de barras de totais por grupo.

Definições específicas de cada modo, também em Modos:

Definição	Aplica-se a	Descrição
Detalhe por categoria	Diário	Mostra chips com o total por categoria acima da lista do dia.
Agrupar por categoria	Semanal	Divide a grelha numa linha por categoria em vez de uma única linha de total agregado.
Semana começa em	Semanal, Horário, Blocos	Que dia da semana inicia a semana.
Mostrar fim de semana	Horário, Blocos	Mostra sábado e domingo (showWeekend, ligado por omissão). Desligado só os esconde: o total da semana e o Exportar contam a semana inteira.
Resumo no topo	Horário, Blocos	Mostra a faixa de KPI acima da grelha (summaryOnTop, desligado por omissão).
Primeiro dia da semana	Mensal	Que dia da semana inicia cada linha da grelha mensal.
Coluna total de semana	Mensal	Mostra a coluna de total de semana por linha à esquerda da grelha.

Filtros

Definição	Descrição
Categoria	Limita os registos a um único valor de categoria. Deixe em branco para mostrar todas as categorias.
Utilizador (id)	Limita os registos a um único utilizador. Deixe em branco para mostrar todos os utilizadores visíveis (ver Mostrar os tempos da equipa).
Perfil	Fica só com os tempos desse perfil do temporizador e pré-escolhe-o na entrada manual. No Horário dá também a grelha («Define a grelha do Horário»). Um perfil desativado aparece com « (desativado)»; um que já não existe, como «Perfil removido».

Um filtro da fonte Tempos define-se na configuração da vista (filterSourceFeatureId, ver a referência), sem campo no diálogo:

• Tabela de origem: fica só com os tempos cuja coluna de origem dessa tabela está preenchida.

Objetivo

Definição	Descrição
Objetivo (horas/dia)	Objetivo diário de horas opcional, usado para mostrar um total "registado / objetivo" nos cabeçalhos Diário, Semanal, e Mensal.

Interface

Definição	Descrição
Botão de exportar	Mostra o botão de exportar na barra de ferramentas.
Permitir entradas manuais	Mostra o botão "Adicionar" e ativa a edição de entradas existentes. Não tem efeito quando a fonte de dados é uma tabela — esses timesheets são sempre apenas de leitura.

No Horário, um registo que começa ou acaba fora das horas da grelha aparece cortado; um registo todo fora delas conta no chip N fora do horário por cima do dia, que abre a lista do dia. Os registos criados nos Blocos, só com duração, aparecem às 09:00 no Horário. Tocar num bloco edita-o: no Horário o diálogo abre em Início e fim (um bloco que passa da meia-noite abre na duração), nos Blocos em horas e minutos, salvo um tempo do cronómetro que começa e acaba nesse dia, que abre em Início e fim.

Os tempos por sincronizar (parados mas ainda sem linha no Tempos) aparecem a cinzento com "por sincronizar" e não se editam até chegarem. Só aparecem em timesheets sem filtros dinâmicos, sem facetas selecionadas e sem filtro de categoria; com esses filtros, o tempo aparece quando a linha chega.

Configuração de admin

A caixa de diálogo Configurar vista tem cinco secções: Filtros, Mapeamento (fonte de dados, mapa de colunas e tempos da equipa), Modos, Objetivo e Interface, correspondendo às secções acima.

Sugestões

• Usa um Timesheet com origem no Tempos quando quiseres que as pessoas registem e editem o seu próprio tempo a partir da vista; usa um Timesheet com origem numa tabela quando quiseres um resumo apenas de leitura de dados semelhantes a tempo que já vivem nessa tabela.
• Workspaces mais antigos podem ainda ter tipos de vista Diário/Semanal/Mensal separados, criados antes de a vista unificada existir. Renderizam através dos mesmos componentes fixos a um único modo e já não aparecem no seletor de tipo de vista — novas vistas devem usar Timesheet com apenas o(s) modo(s) necessário(s) ativo(s).
• Se um timesheet com origem numa tabela mostrar "Mapeamento de colunas em falta", abre a configuração da vista e completa o mapeamento de Data/Duração (ou Início+Fim) em Mapeamento.