PHSYS - Wiki

Conceito

A Agenda é a tela que reúne, numa única visão de calendário, os compromissos de cada recurso da empresa. O que ela mostra não é fixo: cada Agenda cadastrada aponta para um cadastro do sistema e ensina a Agenda a ler aquele cadastro como se fosse um compromisso, dizendo qual campo guarda a data, quais guardam a hora de início e fim, e qual guarda o recurso responsável.

Várias Agendas convivem ao mesmo tempo na mesma tela. Os compromissos de todas aparecem juntos, cada um com a sua cor, e o usuário decide quais quer enxergar pelo filtro.

O que é

É o cadastro que define uma origem de compromissos para a Agenda. Um registro aqui não guarda compromisso nenhum: ele descreve onde os compromissos estão e como devem ser exibidos.

Por isso, incluir uma Agenda nova é trabalho de configuração, não de programação. Cadastros que hoje não aparecem na Agenda podem passar a aparecer desde que tenham data, hora e recurso.

Para que serve

Serve para dar ao usuário uma visão única da ocupação dos recursos, sem que ele precise abrir cada cadastro para descobrir o que está agendado. A partir dessa visão ele consegue:

• enxergar a ocupação de um recurso por dia, semana ou mês, e comparar recursos lado a lado;
• localizar espaço livre antes de assumir um novo compromisso;
• abrir o registro de origem direto pelo compromisso, sem procurar na tela do cadastro;
• incluir um compromisso novo clicando no espaço vazio da agenda.

Quais os benefícios e/ou ganhos de uso

O ganho principal é o compromisso deixar de existir só dentro do cadastro em que foi lançado e passar a disputar espaço na agenda do recurso junto com todos os demais. Quem marca passa a ver o que já está marcado, e a sobrecarga de um recurso fica visível antes de virar atraso.

O segundo ganho é a regra de persistência. Um compromisso cuja situação ainda não foi resolvida continua aparecendo na data de hoje mesmo depois de a data original passar, em vez de ficar para trás no calendário. Ele só sai da frente do usuário quando a situação muda para uma que não persiste, o que transforma a agenda também em lista do que está pendente.

O terceiro é a configuração ser por cadastro. Cada empresa decide o que vira compromisso, com que texto, com que cor e sob que condição, sem depender de versão nova do sistema.

Exemplos

Uma empresa de serviços usa duas Agendas. A primeira lê os apontamentos de ordem de serviço, para o técnico enxergar os atendimentos do dia. A segunda lê as anotações da agenda, usadas para lembretes e retornos a clientes.

Nessa mesma empresa, o apontamento que já virou item de ordem de serviço aparece numa cor própria e não aceita ser arrastado, porque o trabalho já foi registrado. A anotação com situação de pendência continua aparecendo hoje até alguém trocá-la por uma situação concluída.

Uma terceira Agenda pode ser criada para visitas comerciais, apontando para o cadastro de visitas, sem nenhuma alteração de programa.

Cadastro

Campo	Finalidade
Nome	Identificação da Agenda. É por ele que a Agenda é reconhecida ao exportar e importar a configuração entre ambientes.
Legenda	Texto apresentado ao usuário, inclusive na lista de Agendas do filtro.
Cadastro	Cadastro de origem dos compromissos. Define a tabela que a Agenda lê e também qual tela é aberta quando o usuário clica em um compromisso.
Campo Data	Coluna que guarda a data do compromisso. É por ela que a Agenda decide se o registro cai dentro do período exibido.
Campo Hora Início	Coluna com a hora de início. Define onde o card começa na grade de horas.
Campo Hora Fim	Coluna com a hora de término. Define a altura do card na grade de horas.
Campo Recurso	Coluna que liga o compromisso ao recurso responsável. É ela que distribui os compromissos entre as colunas de recurso e que faz valer a permissão de enxergar a agenda de outro recurso.
Título	Expressão que monta o texto principal do card.
Expressão	Expressão que monta o texto complementar, exibido como segunda linha do card quando há espaço.
Condição SQL	Condição adicional aplicada à busca dos compromissos desta Agenda. Serve para restringir o que aparece, por exemplo ignorando registros cancelados.
Expressão Cor	Expressão que devolve a cor do card. Em branco, o card assume a cor do recurso.
Expressão Persistir	Condição que, sendo verdadeira, mantém o compromisso visível na data de hoje depois de a data original passar. Em branco, o compromisso aparece apenas na data dele.
Expressão Leitura	Condição que, sendo verdadeira, trava o compromisso: ele não aceita ser arrastado nem redimensionado na agenda. Em branco, nada é travado.
Margem Direita	Espaço reservado à direita do card no aplicativo, útil quando o card precisa conviver com um ícone.
Máximo de Linhas	Quantidade máxima de linhas do texto complementar no card do aplicativo.
Padrão	Marca a Agenda usada quando o usuário pede um compromisso novo sem partir de um compromisso existente. Somente uma Agenda fica marcada: ao marcar uma, as demais são desmarcadas.

Sobre as expressões

As três expressões são escritas em SQL e valem sobre o registro do compromisso, que na consulta recebe o apelido A. Uma coluna do próprio cadastro é referenciada como A.NOMEDACOLUNA.

Quando a expressão precisa de informação de outra tabela, ela é escrita como subconsulta, e não como junção. Assim a expressão se basta e a Agenda não exige nenhuma configuração adicional de relacionamento.

Funções de data e outras que mudam de nome conforme o banco de dados são escritas com os marcadores do sistema, como @DATA, que são substituídos no momento da consulta. Isso permite que a mesma expressão funcione em qualquer banco homologado.

Filtros

Cada Agenda aceita uma lista de filtros, que ligam um campo do formulário de filtro da Agenda a uma coluna do cadastro de origem, com o operador desejado. É assim que um campo novo no formulário passa a filtrar os compromissos, sem alteração de programa.

Campo	Finalidade
Formulário Campo	Campo do formulário de filtro que fornece o valor informado pelo usuário.
Operação	Forma de comparação entre o valor informado e a coluna: igual, diferente, maior ou igual, menor ou igual, contém ou em.
Campo	Coluna do cadastro de origem que será comparada.

Campo do formulário deixado em branco pelo usuário não gera filtro, o que permite um formulário com vários campos sem obrigar o preenchimento de todos. Recurso, Agenda e situação das anotações são filtros próprios da tela e não precisam ser configurados aqui.

Conclusão

Uma Agenda bem configurada resume-se a responder três perguntas: de onde vêm os compromissos, como eles se apresentam e sob que condição continuam exigindo atenção. As duas primeiras são atendidas pelos campos de cadastro e de texto; a terceira, pelas expressões.

Vale rever a configuração sempre que o cadastro de origem ganhar um campo relevante, como uma situação nova, já que a cor e a persistência são consequência do que estiver escrito nas expressões.

Sugestão de Leitura

• Parâmetros da Agenda
• Recursos
• Formulários
• Permissões de Recurso