Configuração das Agendas - Histórico de revisão

Admin em 20h37min de 13 de setembro de 2026

2026-09-13T20:37:42Z

Admin em 20h36min de 13 de setembro de 2026

2026-09-13T20:36:24Z

Mostrar alterações

Admin: /* Conceito */

2026-09-12T13:49:53Z

‎Conceito

Admin: /* Sugestão de Leitura */

2026-09-12T13:49:21Z

‎Sugestão de Leitura

Admin: Criou página com '==='''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 '''Agen...'

2026-09-12T13:47:20Z

Criou página com '==='''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 '''Agen...'

Página nova

==='''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'''===

{| class="wikitable"
!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.

{| class="wikitable"
!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

← Edição anterior		Edição das 13h49min de 12 de setembro de 2026
Linha 124:		Linha 124:

	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.		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

← Edição anterior		Edição das 20h37min de 13 de setembro de 2026
Linha 1:		Linha 1:
		+	==='''Conceito'''===
		+
		+	Este é o cadastro das diferentes informações que serão unificadas na exibição da Agenda. Cada registro representa uma origem de compromissos, e a tela da Agenda apresenta todas as origens juntas, no mesmo calendário, como se fossem uma coisa só.
		+
		+	Cada registro aponta para um cadastro do sistema e ensina a Agenda a lê-lo como compromisso: qual campo guarda a data, quais guardam a hora de início e de fim, e qual guarda o recurso responsável. É o que permite informações de naturezas diferentes, lançadas em telas diferentes, dividirem a mesma visão de calendário.
		+
		+	Os compromissos de todas as origens aparecem juntos, cada um com a sua cor, e o usuário decide pelo filtro quais deseja enxergar.
		+
		+	==='''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'''===
		+
		+	{\| class="wikitable"
		+	!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.
		+	\|-
		+	\|'''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.
		+
		+	{\| class="wikitable"
		+	!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.
		+
	==='''Exportar e Importar'''===		==='''Exportar e Importar'''===

Linha 31:		Linha 147:

	Os '''filtros''' são regravados por inteiro: a importação descarta a lista que a Agenda tiver no destino e grava a que veio no arquivo. Filtro cujo formulário, campo do formulário ou coluna não existam no destino fica de fora, e o restante da Agenda é gravado normalmente — por isso vale conferir a lista de filtros depois de importar para um ambiente que ainda não tenha o formulário correspondente.		Os '''filtros''' são regravados por inteiro: a importação descarta a lista que a Agenda tiver no destino e grava a que veio no arquivo. Filtro cujo formulário, campo do formulário ou coluna não existam no destino fica de fora, e o restante da Agenda é gravado normalmente — por isso vale conferir a lista de filtros depois de importar para um ambiente que ainda não tenha o formulário correspondente.
		+
		+	==='''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.

@@ Linha 1: / Linha 1: @@
 ==='''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.
+Este é o cadastro das diferentes informações que serão unificadas na exibição da Agenda. Cada registro representa uma origem de compromissos, e a tela da Agenda apresenta todas as origens juntas, no mesmo calendário, como se fossem uma coisa só.
-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.
+Cada registro aponta para um cadastro do sistema e ensina a Agenda a lê-lo como compromisso: qual campo guarda a data, quais guardam a hora de início e de fim, e qual guarda o recurso responsável. É o que permite informações de naturezas diferentes, lançadas em telas diferentes, dividirem a mesma visão de calendário.
 ==='''O que é'''===