Objetivo

...

Permitir que o usuário exporte os dados gerados por um relatório para uma planilha.

...

Layout suportado

...

Não existe no produto Datasul uma definição de layout de relatório definido e por este motivo nem todos os relatórios serão exportáveis para planilha. Os relatórios exportáveis para planilha basicamente deverão ter um layout parecido com o mostrado abaixo:

Relatórios suportados

...

Todos os relatórios do produto Datasul, EMS 2 e EMS 5, podem ser exportados para planilha desde que atendam ao layout suportado e sejam configurados para exportação para planilha conforme será mostrado na próxima seção.

Como funciona

...

Para que a exportação de relatórios para planilha seja habilitada no produto Datasul são necessárias alguma configurações prévias conforme itens a seguir:

Habilitar a exportação de relatórios para planilha

...

Primeiramente é preciso habilitar a exportação de relatórios para planilha no programa BTB946AA - Parâmetros Gerais Módulo Básico conforme mostrado abaixo:

Configurar Programa x Tipos de relatórios

...

Depois de habilitar a exportação dos relatórios para planilha no programa BTB946AA - Parâmetros Gerais Módulo Básico é preciso configurar o tipo de relatório suportado no programa BAS_PROG_DTSUL - Manutenção de Programa indicando a opção "Texto e Excel" ou "Texto PDF e Excel" conforme mostrado abaixo. Este procedimento precisará ser repetido para cada programa gerador de relatório que se deseja exportar os dados para planilha e lembrando que o mesmo deve gerar um relatório cujo layout é similar ao layout suportado pela função de exportação de relatórios para planilha.

Configurar saída do relatório

...

O próximo passo é, ao executar o programa de relatório, alterar a saída do relatório selecionando a opção "Excel" conforme mostrado na figura abaixo.

Executar o relatório

...

Ao clicar no botão "Executar" o relatório será gerado conforme o destino selecionado e então o arquivo gerado será lido e as informações serão coletadas para que a planilha possa ser gerada.

Restrições

...

A exportação do relatório para planilha somente estará disponível quando o destino do mesmo for igual a "Arquivo" ou "Terminal" e a execução for igual a "On-line".

Ao selecionar a opção de destino "Impressora" ou selecionar a execução "Batch" a opção "Excel" não será mostrada e se a opção "Excel" for selecionada a opção de destino "Impressora" e a opção de execução "Batch" serão desabilitadas.

Nome do arquivo gerado

...

Quando o formato de saída selecionado for igual a “Excel” então o nome do arquivo gerado será alterado de modo que o mesmo contenha o nome do usuário e um identificador de data e hora conforme o exemplo abaixo:

...

Isso se deve a uma limitação tecnológica pois não é possível sobrescrever o evento de “VALUE-CHANGED” do radio-set responsável por determinar o tipo de destino do relatório no EMS5. Então o nome do arquivo não será alterado ao mudar o destino do relatório e sim somente quando a execução do mesmo for iniciada. Somente neste momento é que o nome do arquivo alterado será visualizado em tela.

Local de destino do arquivo

...

As regras quanto ao local de destino do arquivo continuam inalteradas mudando apenas o nome do arquivo devido ao acréscimo do nome do usuário e do identificador de data e hora ao arquivo assim como as demais regras para os demais destinos de relatório não mencionados neste documento.

Layout do relatório não suportado

...

Se o layout do relatório não for reconhecido, será mostrada mensagem para o usuário informando que não foi possível exportar os dados para uma planilha conforme imagem abaixo.

...

Não serão suportados neste primeiro momento relatórios que contenham dados fora da tabela, ou seja, campos identificados como Campos Iniciais ou Campos Finais. Também não serão suportados relatórios que contenham quebra de dados como por exemplo o relatório RPT_BANCO – Relatório Bancos que lista os bancos cadastrados e também as agências relacionados aos bancos.

Configurador do exportador de relatórios para planilha

...

Após a geração do relatório, o arquivo do mesmo é lido e então o configurador de exportação do relatório para planilha é executado.

Configurar exportação da primeira e última página do relatório

...

Abaixo temos um exemplo de como a primeira tela do configurador de exportação de relatórios se parece.

...

Na primeira tela do configurador serão mostradas a primeira e a última página do relatório e é onde também será possível indicar se as mesmas serão ou não exportadas bastando para isso marcar a opção "Ignorar" da primeira e/ou última página.

Configurar a identificação das linhas do relatório

...

O próximo passo do configurador é a tela onde aparecem as linhas da primeira página do relatório e nesta tela é possível modificar o tipo da linha selecionando uma das opções disponíveis no campo Tipo.

Configurar quais campos serão exportados

...

Depois de configurar o tipo das linhas do relatório é possível indicar quais os campos do relatório que serão exportados para a planilha conforme mostrado abaixo.

Configurar os campos do relatório

...

E finalmente, no último passo do configurador é possível unir campos adjacentes ou dividir campos que foram previamente unidos assim como remover um campo para que o mesmo não seja exportado para a planilha.

Ainda nesta tela também é possível ajustar a posição inicial e final dos campos que serão exportados para a planilha mostrando o resultado de como irá ficar logo abaixo na seção Registros.Na seção Registros temos uma escala numérica e uma escala gráfica para facilitar a visualização do registro selecionado no browse acima.

Planilha gerada

Finalmente, depois de tudo configurado o relatório é exportado para planilha e a mesma é executada conforme mostrado abaixo.

...

A exportação do relatório para planilha pode ser realizada em qualquer momento não sendo necessário prosseguir até o final do configurador para que a planilha seja gerada.

Armazenamento das configurações

Ao confirmar a exportação da planilha as configuração realizadas pelo usuário serão armazenadas no diretório temporário do usuário para ser utilizados em execuções futuras do mesmo relatório. As seguintes configurações serão armazenadas:

...

• <código_do_programa>_<código_do_usuário>_ttField.json
• <código_do_programa>_<código_do_usuário>_ttFPage1Config.json
• <código_do_programa>_<código_do_usuário>_ttPosition.json

Arquivos de configurações

No arquivo ttLine.json estarão as informações de quais os tipos de linha foram alteradas no relatório, conforme exemplo abaixo:

...