## Função Cenários Dinâmicos

##### Objetivo

Possibilitar a geração de relatórios com o recurso de visualização de cenários dinâmicos.

##### Pré-requisitos

Para a utilização de Cenários Dinâmicos é necessário observar os seguinte pré-requisitos:

- O Microsoft Office deve estar previamente instalado, ou, no mínimo, o Microsoft Excel;

- Para a utilização de gráficos, é necessário que esteja instalado o Microsoft Office 2000;

- Se a opção Cenários Dinâmicos for executada em ambiente Windows em Inglês e Office em Inglês, devem ser observados os seguintes detalhes:

  - A configuração do separador de listas do Windows deve estar marcada para utilizar ponto e vírgula;

  - A configuração do formato de moeda da sessão Progress utilizada (americano/europeu) deve ser compatível com as configurações de moeda do Windows (separador de milhar e decimal);

Nota:
As configurações do Windows podem ser verificadas e alteradas acessando a opção Configuração/Painel de Controle/Configurações Regionais/Números.

##### Visão Geral

A opção de Cenários Dinâmicos permite uma melhor visualização de relatórios gerados pelo Data Viewer, utilizando o recurso de tabelas dinâmicas do Excel. Esses cenários podem ser visualizados no próprio Excel, na forma de tabelas dinâmicas, ou no Internet Explorer, como tabelas dinâmicas ou gráficos.

É possível alterar um relatório existente para que utilize cenários dinâmicos e convertê-lo novamente para o tipo original sem a perda de dados.

Todas as possibilidades de configuração do relatório podem ser executadas de modo on-line ou batch (cenário dinâmico no Excel com e sem gráfico, cenário dinâmico no Internet Explorer com e sem gráfico). Porém, em modo batch somente será possível se o servidor RPW for Windoes X e possuir o Office instalado (ou, no mínimo, o Excel).

Importante:
A planilha de dados do Excel é limitada a 65.535 linhas. Pelo fato de a combinação possível de informações ser muito grande, o Data Viewer não controla o número de registros automaticamente. Se a planilha possuir mais de 65.535, apresentará erros de comunicação e execução.

##### Descrição

Na tela “Manutenção de Relatórios” do Data Viewer (ver detalhes Função Manutenção do Relatório), com o acionamento do botão Incluir é apresentada a seguinte janela:

### Janela Inclui Relatórios

Nas tabelas a seguir estão descritos os elementos dessa janela.

Campo | Descrição
Relatório | Inserir o nome do relatório a ser gerado. O nome deve ter seis caracteres, mais uma ou duas letras, variando de "a" até "bz", e que definem as várias classificações de um mesmo relatório. Exemplo: Relatório: CDR004a.
Título | Inserir o título para o relatório que está sendo criado. Esse título será impresso no cabeçalho de cada página do relatório. Exemplo: Relatório: CDR004a Título: Listagem de Produtos Faturados.
Título Classificação | Inserir o título para identificar a classificação do relatório. Exemplo: Relatório: CDR004a Título: Listagem de Produtos Faturados Título Classificação: Por cliente Nota: O título de classificação será impresso na página de parâmetros do relatório e também será utilizado no programa a ser gerado para apresentar todas as classificações desse relatório. É possível, a partir dele, identificar e chamar o relatório pela classificação.
Sistema Relatório | Inserir o nome do sistema ou módulo a que pertence o relatório. Exemplo: Faturamento, Ponto Eletrônico, Contas a Pagar.
Subdiretório Programa | Inserir o subdiretório do diretório de trabalho do usuário onde serão gravados os programas dos relatórios gerados. Exemplo: Subdiretório Programa: Cdp Relatório gerado: c:\relatorios\cdp\cdr004a Onde c:\relatorios é o diretório de trabalho do usuário, cdp é o subdiretório programa e cdr004a é o programa gerado. Nota: Caso esse subdiretório ou estrutura de subdiretório não exista, será criada automaticamente pelo Data Viewer no momento da geração do programa do relatório. Se o seu conteúdo for branco, o programa do relatório será gerado no diretório de trabalho do usuário.
Listagem, Exportação, Gráfico ou Cenário Dinâmico | Selecionar, entre as opções disponíveis, se o relatório trará como resultado uma listagem, um arquivo texto como exportação de dados, um gráfico para visualização de dados ou um relatório com cenários dinâmicos. Para exportação não traz no resultado cabeçalho, labels para grupos de dados, rodapé, página de parâmetros, nem realiza cálculos como média, máximo, mínimo, total etc. Somente serão considerados como objetos de exportação os que estiverem no layout do relatório.

Nota:
Os demais campos apresentados nessa janela estão descritos na Função Manutenção do Relatório.

### Janela Tabelas do Relatório

Nas tabelas a seguir estão descritos os elementos dessa janela.

Botão | Nome | Descrição
| Incluir | Por intermédio desse botão é possível selecionar uma tabela da lista de tabelas disponíveis.
| Eliminar | Por intermédio desse botão é possível eliminar uma tabela da lista de tabelas selecionadas.

Campo | Descrição
Visualizar | Selecionar, entre as opções disponíveis, a forma como serão apresentadas as tabelas na lista de tabelas disponíveis e na lista de tabelas utilizadas.
Banco | Selecionar de qual base de dados serão utilizadas tabelas para a geração do relatório.

### Janela Campos do Relatório

Nota:
A ordenação das informações pode ser realizada de duas formas:

- Considerando a ordem de inserção dos campos no relatório.

- Considerando o alinhamento da esquerda para direita independente da altura, na área de dados do Data Viewer.

Nas tabelas a seguir estão descritos os elementos dessa janela.

Botão | Nome | Descrição
| Incluir | Por intermédio desse botão é possível selecionar um campo da tabela selecionada.
| Eliminar | Por intermédio desse botão é possível eliminar um campo previamente selecionado.

Campo | Descrição
Visualizar | Selecionar, entre as opções disponíveis, a forma como serão apresentadas as tabelas e os atributos nas listas desse programa: Nome: as tabelas e campos são listados por seus nomes. Descrição: as tabelas e campos são listados por suas descrições.

Importante:
Caso haja a necessidade de incluir campos cujo conteúdo deve ser calculado, deve-se executar a Função Campos Calculados, por intermédio do botão Campos Calculados que se encontra na tela base do Data Viewer.

### Janela Principal do Data Viewer

Quando selecionada a opção Cenários Dinâmicos, depois da seleção das tabelas e dos campos a janela principal do Data Viewer apresenta as seguintes características:

Os campos selecionados para impressão no relatório estão representados pelos retângulos que aparecem no lado esquerdo da tela. No exemplo acima, aparecem os campos Cliente, Repres, Item, Valor Total e Quantidade.

As quatro áreas brancas representam as áreas de impressão do relatório. Os campos devem ser arrastados com o mouse de acordo com o cenário dinâmico que se deseja obter, como no exemplo a seguir:

Na tabela a seguir estão descritos os principais elementos dessa janela.

Botão | Nome | Descrição
| Teste | Esse botão possibilita a geração do programa de interface do relatório e do programa de processamento, além de compilar e executar esses programas. Veja mais detalhes na Função Teste.
| Executar | Utilizando esse botão é possível executar o relatório criado. Caso a nova versão não tenha sido gerada, o Data Viewer executará a anterior. Veja mais detalhes na Função Executar.

Nota:
Os demais elementos apresentados nessa janela estão descritos na Função Acessando o Data Viewer.

Importante:

- Para a montagem de um relatório do tipo Cenário Dinâmico devem ser observados os itens abaixo:

- Deve existir pelo menos um campo na posição Dados.

- Campos do tipo Dados devem armazenar pelo menos uma das funções que seguem (Contagem de Itens, Soma, Média, Maior Valor, Menor Valor).

- As opções de função são de múltipla escolha, não se devendo repetir nenhum rótulo.

- Quando um campo não for numérico e sua posição no layout for Dados, a única opção de função que poderá ser escolhida é a Contagem de Itens.

- As funções para campo com posição no layout Linha ou Coluna serão aplicadas somente se existir mais de um campo na linha/coluna.

- Um campo não estará em mais de uma posição no layout ao mesmo tempo.

- O campo que estiver como Página só poderá ter função “Nenhum”.

- As funções de grupos, totais e cálculos do Data Viewer serão desabilitadas.

- Ao informar o nome do arquivo a ser gerado na execução do relatório, ele deve possuir a extensão “.csv”.

##### Exemplo

Quando executado o relatório com a opção Cenários Dinâmicos, existem duas formas de visualização dos dados: tabelas dinâmicas (no Excel) ou gráfico (no Internet Explorer), conforme exemplos abaixo:

### Opção de Apresentação – Tabelas Dinâmicas

### Opção de Apresentação – Gráfico

Procedimentos Montagem de Relatório com Cenário Dinâmico

| Índice | Topo |