WecDB - Criando um Carrossel

Para cadastrar um novo Carrossel é muito fácil! Abaixo estão os passos que você deve seguir:

Cadastrar o Carrossel

No Portal WecDB, vá até o menu Consultas > Carrossel > Cadastrar Novo Carrossel como mostra a figura abaixo:

Menu de cadastro de Carrossel

Identificação do Carrossel

Abaixo está a tela onde será dado início ao cadastro:

Página de cadastro de Carrossel

Nos campos enumerado temos:

1. Título: Título do Carrossel. Usado para identificar o Carrossel na Listagem de Carrosséis cadastrados.
2. Tempo de Atualização: Intervalo de atualização padrão do Carrossel (em segundos). Quando uma consulta for adicionada ao Carrossel sem que o intervalo de atualização da mesma seja especificado, o tempo de intervalo padrão do Carrossel será utilizado.
3. Observações: Campo livre para observações do cliente quanto ao Carrossel cadastrado.
4. Botão Cancelar: Quando pressionado, o site será redirecionado para a tela de Listagem de Carrosséis Cadastrados
5. Botão Prosseguir: Quando pressionado, os dados em edição serão gravados, gerando um código identificador para o Carrossel, e a página será redirecionada para a página de Configuração de Carrossel.

Configuração do Carrossel

Esta é a página de Configuração de Carrossel. Se você clicou em Prosseguir na etapa anterior, foi direcionado a esta página. É aqui onde as consultas serão adicionadas ao Carrossel e os Parâmetros de cada uma delas serão configurados.

Página para adicionar e configurar as consultas do Carrossel (Cenário)

Nos campos enumerados temos:

1. Consulta: Consulta a ser adicionada ao Carrossel. Este campo é uma caixa de opções procurável. Digite parte do nome da consulta e os registros correspondentes serão encontrados automaticamente.
2. Intervalo de Atualização: Intervalo de atualização da Consulta dentro do Carrossel, de preenchimento opcional. Se não for especificado, será usado o intervalo padrão informado no cadastro do Carrossel. Use este campo se deseja cadastrar consulta com intervalos de atualização diferentes dentro de um mesmo Carrossel.
3. Botão Adicionar: Ao pressioná-lo, os dados serão validados e a Consulta será adicionada ao Carrossel, sendo exibida na grade com título Consultas.

Na figura abaixo, temos as consultas DEMO - Consulta de Sessões de Trabalho e Windev3 - Grafico Pizza adicionadas ao Carrossel:

Página para adicionar e configurar as consultas do Carrossel com registros incluídos

Nos campos enumerados temos:

1. Ícone de edição: Usado para editar a configuração da consulta. Na edição, é permitido apenas alterar o intervalo de atualização.
2. Link Parâmetros: Quando clicado, abrirá a janela de configuração dos Parâmetros da Consulta para uso no Carrossel.
3. Link Excluir: Quando clicado, pergunta se o usuário deseja excluir o registro da configuração da Consulta. Se o usuário clicar em Sim a configuração será excluído.
4. Botão Voltar para a Listagem de Carrosséis: Quando pressionado, redireciona o site para a página de Listagem de Consultas.

Configuração dos Parâmetros

Na Janela de configuração dos parâmetros, serão carregados todos os parâmetros da Consulta para que o valor de cada um seja configurado.

Ao acessar pela primeira vez, o valor padrão de cada parâmetro (configurados no cadastro da consulta) será usado como carga inicial para valor a ser utilizado no Carrossel.

Janela de configuração do valor dos parâmetros das consultas que serão executadas no Carrossel

Nos campos enumerados temos:

1. Parâmetro do tipo Caixa de Opções: Para configurar o valor de parâmetro do tipo Caixa de Opções basta selecionar uma das opções disponíveis.
2. Parâmetro do tipo Numério/Alfanumérico: Para configurar os tipos de parâmetro Numérico e Alfanumérico basta informar um valor fixo no campo.
3. Parâmetro do tipo Data: Este tipo de parâmetro é um pouco mais complexo para ser configurado. Possui os seguinte campos:

1. 1. Tipo de Valor Padrão: Selecione o tipo de valor padrão a ser utilizado. Estão disponíveis os valores:

      Vazio: Indica que nenhum valor deve ser considerado para o parâmetro. Será passa um valor NULO na execução da consulta.

      Data Fixa: Quando selecionada, habilita o campo para informar uma data fixa.

      Data Atual: Indica que o parâmetro usará o valor de data atual (data do dia).

      Pri.Dia Mês: Indica que o parâmetro usará o valor de data do primeiro dia do mês atual.

      Últ.Dia Mês: Indica que o parâmetro usará o valor de data do último dia do mês atual.

1. 1. Data Fixa: Este campo é habilitado quando o o Tipo de Valor Padrão selecionado for Data Fixa. Use-o para informar a data que será usada como valor do parâmetro.
   2. Operador: Operador de Soma ou Subtração. Será usado em conjunto com os campos Quantidade a somar ou subtrair e Tipo de período a somar ou subtrair. Ele indica se determinado número de Dias/Mese/Anos será somado ou subtraído do valor de data configurado nos campos anteriores.
   3. Quantidade a somar ou subtrair: Informe a quantidade a ser somada ou subtraída (dependendo do operador) do valor de data configurado nos campos anteriores.
   4. Tipo de período a somar ou subtrair: Indica o tipo de período que será usado no calculo de soma ou substração de dada.

Executando o Carrossel

A figura abaixo mostra a página de Listagem de Carrosséis. A partir desta página é possível editar, configurar e iniciar um carrossel já cadastrado;

Página de listagem dos Carrosséis cadastrados

Nos campos enumerados temos:

1. Link Alterar: Altera os dados básicos de um Carrossel.
2. Link Configurar: Abre a página de configuração do Carrossel, onde é possível adicionar, remover ou configurar as consultas.
3. Link Excluir: Exclui o carrossel correspondente a linha.
4. Link Configurar: Abre a página de visualização/execução do Carrossel.
5. Adicionar novo registro: Abre a página de cadastro de Carrossel, para incluir um novo registro.
6. Atualizar: Atualiza os registros da grade.

Página de visualização do Carrossel

Rodapé de uma consulta que teve a página movida automaticamente

Painel de Navegação do Carrossel

Segunda página do Carrossel cadastrado, com uma consulta do tipo Gráfico Pizza