Ir para o conteúdo

Painéis de Calendário

calendário de pedidos.png

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

Nota

O método de escape SQL é mais eficiente programaticamente, mas IIF não depende da sintaxe SQL. Ambos resultam em saída idêntica.

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