Permitir que o usuário exporte os dados gerados por um relatório para uma planilha.
Matriz de evolução
| Versão / Release | Funcionalidade |
|---|---|
| 12.1.4 | Liberação da nova funcionalidade de exportação de relatórios para planilha. |
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:
Todos os relatórios dos produtos 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.
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 descritos a seguir.
Primeiramente é preciso habilitar a exportação de relatórios para planilha no programa BTB946AA - Parâmetros Gerais Módulo Básico conforme identificado 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:
Importante:
Este procedimento precisará se repetir para cada programa gerador de relatório, o qual se deseja exportar os dados para planilha. 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.
A próxima etapa é executar o programa de relatório, alterar a saída do relatório selecionando a opção "Excel" conforme os passos abaixo:
Restrições:
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.
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:
O identificador acrescentado seguirá o seguinte padrão:
Onde:
| Identificador | Descrição |
|---|---|
| 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. |
EMS2:
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.
EMS5:
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.
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.
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.
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 o configurador de exportação do relatório para planilha é executado.
Ao executar o relatório, a primeira tela do configurador de exportação de relatórios é apresentada.
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.
O próximo passo do configurador (botão "Próximo") é 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.
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.
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 ficará logo abaixo da tela, na seção Registros. Na seção Registros existe uma escala numérica e uma escala gráfica para facilitar a visualização do registro selecionado no browse acima.
Finalmente, depois de tudo configurado o relatório é exportado para planilha e a mesma é executada para visualização pelo usuário.
Dica:
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.
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:
As configurações serão gravadas em arquivos no formato JSON que estarão localizados no diretório temporário da sessão do usuário e serão carregadas no momento de executar a exportação dos dados para planilha. Os arquivos de configuração seguirão o seguinte padrão de nome conforme abaixo:
<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
No arquivo ttField.json estarão as informações sobre os campos do relatório conforme exemplo abaixo:
{"ttField": [{
"iSequency": 1,
"cOriginalSequency": "",
"cField": "Descrição ",
"logShow": true,
"logRepeat": false,
"logEnabled": true},{
"iSequency": 2,
"cOriginalSequency": "",
"cField": "Impressora ",
"logShow": true,
"logRepeat": false,
"logEnabled": true}]}
No arquivo ttFPage1Config.json estarão informadas se a primeira e / ou a última página do relatório serão ignoradas conforme exemplo abaixo:
{"ttFPage1Config": [{
"logIgnoreFirstPage": false,
"logIgnoreLastPage": false }]}
No arquivo ttPosition.json estarão as informações sobre as posições dos campos do relatório conforme exemplo abaixo:
{"ttPosition": [ {
"iSequency": 1,
"cFieldName": "Descrição",
"iInitialPosition": 1,
"iFinalPosition": 41,
"logEnabled": true }, {
"iSequency": 2,
"cFieldName": "Impressora ",
"iInitialPosition": 42,
"iFinalPosition": 54,
"logEnabled": true }]}