I9 – CRM | DIS | FIN – SEPTEMBER / 2016

Apresentação em tema: "I9 – CRM | DIS | FIN – SEPTEMBER / 2016"— Transcrição da apresentação:

1 I9 – CRM | DIS | FIN – SEPTEMBER / 2016
Datasul Report Service I9 – CRM | DIS | FIN – SEPTEMBER / 2016

2 MOTIVADORES Versão defasada do BIRT utilizado na parte FLEX do TOTVS;
Várias versões do BIRT espalhados pelo sistema: Framework FLEX (BIRT 2), CRM (BIRT 4.2), E-Kanban (BIRT 4.3) e WEB Viewer (4.2.1); Vários chamados técnicos nas áreas de negócio; Ter uma interface única para geração de relatório; permitindo que o mesmo seja acessado via Progress ou HTML.

3 BIRT

4 BIRT – DEFINIÇÃO O que é? Como vamos utilizar? DEFINIÇÃO
É uma ferramenta de Business Intelligence e de relatórios; É um projeto de software de código aberto que fornece capacidades de comunicação e de inteligência de negócios para aplicativos; desde 03/2005; DEFINIÇÃO Como vamos utilizar? Para o Datasul Report Service será utilizado apenas a camada de relatórios da ferrameta; Está por sua vez, será encapsulada dentro do Framework em forma de serviço.

5 BIRT – DOCUMENTAÇÃO Documentação e afins DOCUMENTAÇÃO
Para iniciantes: Youtube -BIRT Report Designer Tutorial Part-1 Youtube -BIRT Report Designer Tutorial Part-2 TOTVS: DTS - Relatórios DOCUMENTAÇÃO

6 TOTVS - Datasul

7 PRÉ-REQUISITOS As execuções dos relatórios, farão uso do Datasul REST para resgatar os dados e verificar permissões de acesso. Desta forma faz-se necessário que o AppServer e o Datasul REST estejam configurados e operando; Por padrão o diretório utilizado para repositório dos .rptdesign (relatórios) será o datasul-report em: %JBOSS_HOME%\server\<instância>\. Entretanto, caso seja preciso alterar o diretório padrão poderá ser informada a propriedade datasul.report.dir no datasul_framework.properties; quando esta propriedade foi informada o Datasul Report Services irá considerar este diretório informado; Configurar os parâmetros de localização e porta, interno e externo, do servidor de aplicação (JBoss) no programa 'Parâmetros Gerais Módulo Básico' (btb946aa) na aba 'Servidor'.

8 CONFIGURAÇÃO Verificar se o pacote datasul-report-service-11.5.X-SNAPSHOT.war está contido dentro do EAR; Verificar se o mesmo está registrado no META-INF\application.xml dentro do EAR: Verificar se o mesmo está declarado como partner-app do JOSSO no arquivo: %JBOSS_HOME%\server\<instância>\conf\josso-agent- config.xml Verificar se o diretório datasul-report está criado na estrutura %JBOSS_HOME%\server\<instância>\ e se o parâmetro datasul.report.dir, no arquivo datasul_framework.properties, está comentado ou apontando para o diretório correto:

9 CONFIGURAÇÃO Verificar se a configuração de servidor está correta na aba Servidores do programa Parâmetros Gerais (btb946aa.p): Atenção: Essa informação é essencial para o funcionamento da API Progress para acesso ao Datasul Report Service.

10 EXPEDIÇÃO Os fontes e o arquivo de definição do relatório devem ser comitados na branch Progress sob o path ‘report’: O relatórios comitados neste diretório serão, durante o processo de compilação, copiados para o diretório: %JBOSS_HOME%\server\<instância>\datasul-report Atenção: Os .p serão ignorados neste processo. Apenas os arquivos .porperties, .rptdesign e os demais diretórios/arquivos serão copiados.

11 COMO FUNCIONA ? Programa solicita a geração/impressão de um relatório ou documento. DTS.RS: recebe a solicitação contendo o nome do relatório e o programa de extração de dados ou a própria massa de dados. DTS.RS: verifica o controle de acesso ao relatório e carrega as variáveis de ambiente do usuário; caso tenha sido informado um programa de extração de dados. DTS.RS: inicia o BIRT e envia a massa de dados e parâmetros para o BIRT. BIRT: recebe a massa de dados, gera o documento/relatório e devolve para o DTS.RS. DTS.RS: devolve o documento gerado para o programa e/ou publica na central de documentos.

12 COMO FUNCIONA ? Observações
Quando não informado um programa de extração de dados na chamada do relatório, o Datasul Report Service não irá validar o controle de acesso nem irá passar as variáveis de ambiente do usuário; O controle de acesso ao relatório é realizado pelo controle de acesso ao programa de extração de dados. Caso o usuário tenha acesso ao programa, ou não exista registro do programa no cadastro de menu, o acesso é liberado; Quando especificado o programa de extração de dados tanto a extração como verificação de acesso e carregamento das váriaveis de ambiente do usuário são realizadas através do Datasul REST utilizando o AppServer; Para isto, todos os programas de extração de dados devem possuir declarada a include: {utp/ut-report-api.i} É possível realizer a impressão do relatório sem fornecer os dados de um programa de extração de dados. Desta forma se faz obrigatório passar para o Datasul Report Service os dados, em formato JSON, para geração do relatório/documento; Existe a possibilidade de publicar o document/relatório gerado também na central de documentos; A chamada para o Datasul Report Service é idêntica tanto através da API Javascript quanto Progress.

13 HELP ! Observações Para verificação do status do serviço assim como de suas configurações foi disponibilizada uma URL de help: os: sistema operacional no qual está sendo executado o JBoss; java_home: diretório raiz a instalação da JVM utilizada pelo JBoss; java_version: versão da JVM utilizada pelo JBoss; encoding: encoding utilizado pela JVM; separator: separador padrão do sistema operacional '/' ou '\'; birt_home: diretório contento a raiz da engine do BIRT; birt_temp_dir: diretório temporário utilizado pelo BIRT; birt_resources: diretório raiz para bibliotecas auxiliares (normalmente /dataul_report/libs/). report_home: diretório raiz no qual estão os .rptdesign (normalmente /dataul_report/).

14 HANDS ON ;)

15 fluig.com /totvs @totvs blog.totvs.com company/totvs
Thiago A. de Souza Weber /totvs I9 – CRM | DIS | FIN +55 (47) @totvs blog.totvs.com company/totvs Thanks ;) fluig.com