Painéis de Calendário¶

Um painel de calendário

Os painéis de calendário preenchem um calendário com informações de uma fonte de dados, fazendo uso de três tipos de controle exclusivos: Descrição, Início do evento e Fim do evento. O controle Descrição designa o que aparecerá no calendário e normalmente é um nome de evento. Os controles Início do evento e Fim do evento designam em qual dia o evento aparecerá e podem incluir carimbos de data/hora, que serão exibidos junto com a descrição do evento. Assim como os painéis de gráfico, os painéis de calendário podem ser vinculados a outro painel para exibir mais detalhes sobre o evento no calendário.

Por padrão, o painel de calendário será exibido com base nos dados na regra comercial, honrando qualquer classificação aplicada na regra comercial. Revise sua regra comercial para verificar a classificação.

Se não houver dados na regra comercial, o mês, dia ou ano atual deverá aparecer no calendário. Assim que os dados forem adicionados, você provavelmente desejará adicionar uma classificação à regra comercial.

Como Exibir o Mês Atual no Calendário¶

Para garantir que o painel retorne o mês, dia ou ano atual, adicione uma coluna chamada Sort com tipo lógico numérico e aplique uma classificação ascendente nesta coluna. Por exemplo, se o seu objeto de negócios que suporta seu painel de calendário tiver uma coluna chamada StartDate que você gostaria de usar e for uma fonte de dados SQL, você pode usar uma função de escape SQL:

${ABS(DateDiff(day, getdate(), StartDate))}

ou an App Builder declaração IIF:

IIF(DateDiff(dd, Now(), StartDate) < 0, (DateDiff(dd, Now(), StartDate))*-1, DateDiff(dd, Now(), StartDate))

Para visualizar outros meses, clique nos botões de chevron para frente e para trás no canto superior esquerdo do painel. A alternância entre as visualizações Dia, Semana e Mensal pode ser feita clicando nos botões correspondentes no canto superior direito do painel. Os painéis de calendário não podem ser editados; no entanto, um painel separado que exibe os controles de eventos pode ser.

Como Alterar a Data e a Hora de um Evento¶

1. Selecione o evento
2. No painel que exibe as informações do evento, clique no ícone Lápis
3. Ajuste a data e a hora conforme necessário e clique na Marca de seleção para salvar

Como Adicionar um Novo Evento ao Calendário¶

1. Selecione qualquer evento pré-existente e clique no botão Criar
2. Insira um título para o evento, selecione uma data no menu suspenso do calendário
3. Para controles com hora e data habilitados, clique no ícone Hora para abrir um relógio
4. Clique na Marca de seleção para salvar
5. Após quaisquer revisões feitas no calendário, atualize a página e confirme as atualizações

Como Criar um Calendário Usando o Banco de Dados Northwinds¶

Neste exemplo, adicionaremos um novo painel Calendário para representar visualmente a data em que os Pedidos são registrados no Northwinds.

Crie um Objeto Comercial para Usar com o Painel de Calendário¶

1. Crie uma nova regra de negócios
2. Dê à regra um Nome. Por exemplo: Ordem (Calendário)
3. Defina o Propósito como Calendário
4. Direcione a tabela Order
5. Clique no botão Salvar
6. Na tabela Order, clique para selecionar as colunas OrderID e OrderDate
7. Clique na aba Where. Adicione a coluna OrderDate ao campo Left. Escolha IS NOT NULL como o Operator. Deixe o campo Right em branco.
8. Se desejar, adicione uma coluna que suporte Sort à aba Columns. Por exemplo: DatePart(mm, O.OrderDate)

Crie o Calendário¶

1. Vá para App Workbench > Adicionar uma página
2. Nomeie a página Calendário de pedidos e clique em Criar
3. Selecione o layout de coluna única, clique em Adicionar painel
4. Selecione o Calendário
5. Localize a Regra de calendário e clique em Selecionar
6. Clique em Personalizar página
7. Insira Calendário de pedidos para o Nome, selecione Painel de calendário como o Tipo e selecione Mensal como o Subtipo.

8. Adicione dois controles com as seguintes configurações:

   	Coluna	Nome	Tipo de uso
   Controle #1:	OrderID	Pedido	Descrição
   Controle #2:	Data do pedido	Data do pedido	Início do evento

9. Navegue até a visualização do aplicativo e confirme que agora você vê o Calendário

Configurar os Eventos do Calendário para Vincular a Outra Página¶

1. Na página Calendário do seu aplicativo, clique em Action Drawer > Live Designer
2. Clique no botão Controls no painel Calendário
3. Clique no ícone Open Record para o controle vincular de
4. Em Update and Linking, defina Link To Page como OrderID
5. Verifique se ele está vinculado por OrderID nos Criteria
6. Navegue até a visualização do aplicativo e confirme a atualização

Use o Controle de Cor para Alterar a Cor dos Eventos¶

1. Adicione uma nova coluna à Regra Comercial do Calendário. Por exemplo: insira '#000343' no campo Coluna ou Expressão. Insira Cor no campo Alias.
2. Navegue até a página Calendário do seu aplicativo e selecione Gaveta de Ações > Live Designer

3. Adicione um novo Controle.

   • Selecione Cor para a Coluna
   • Nomeie o controle Cor
   • Selecione Cor para o Tipo de Controle

4. Navegue até a visualização do aplicativo e confirme a atualização