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 primeiramente é preciso habilitá-la no programa BTB946AA - Parâmetros Gerais Módulo Básico conforme mostrado abaixo:

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.

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.

Ao clicar no botão "Executar" o relatório será gerado conforme o destino selecionado ressaltando que 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.

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:

Exemplo:

• UTB303AA_SUPER_20150108064898.XLS

O identificador acrescentado seguirá o seguinte padrão:

• YYYY + MM + DD + HH + MM + SS

Onde:

• YYYY : Ano atual com quarto dígitos.
• MM : Mês atual com dois dígitos.
• DD : Dia atual com dois dígitos.
• HH : Hora atual com dois dígitos.
• MM : Minuto atual com dois dígitos.
• SS : Segundo atual com dois dígitos.

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.

Para os relatórios do EMS2 o nome do arquivo será alterado sempre que a opção de destino do relatório for igual a “Terminal” ou “Arquivo” e o formato de saída do relatório for igual a “Excel”. Esta alteração sempre irá ocorrer quando o programa BTB/BTB901ZS for encerrado e a opção “Excel” for selecionada ou quando o usuário alterar o destino do relatório e a opção “Excel” foi previamente selecionada no programa BTB/BTB901ZS.

Para os relatórios do EMS5 a regra para o nome do arquivo é a mesma, ou seja, o nome do arquivo será alterado sempre que a opção de destino do relatório for igual a “Terminal” ou “Arquivo” e o formato de saída do relatório for igual a “Excel”. Esta alteração sempre irá ocorrer quando o programa PRGTEC/BTB/BTB901ZS for encerrado e a opção “Excel” for selecionada ou quando o usuário disparar a execução do relatório.

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.

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.

Ao ler o relatório gerado é feita uma tentativa de reconhecer o layout do relatório e caso o mesmo não seja reconhecido como um layout suportado pelo Goto Excel então será mostrada uma mensagem ao usuário informado que não foi possível exportar os dados e nenhuma outra ação será executada.

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.

Após a geração do relatório o arquivo do mesmo é lido e então é mostrada a primeira tela de configuração da exportação dos dados para planilha conforme mostrado abaixo.

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.

Configurador do exportador de relatórios para planilha

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