do tutorial Completo de Pentaho CE
Transcrição
do tutorial Completo de Pentaho CE
GUIA DE CONFIGURAÇÃO DO PENTAHO 4.8 e 5.4 CE Atenção: Este guia foi elaborado utilizando o sistema operacional windows 8.1, com a instalação dos produtos da Pentaho Community Edition versões 4.8 e 5.4, outras distribuições podem ter processo de configurações diferente. Marcelo Afonso Alves www.aprendendoetl.com.br 1 Índice Conteúdo Pentaho........................................................................................................................................ 5 Pentaho community Edition - CE .............................................................................................. 5 Pentaho Business Analytics Platform ........................................................................................ 6 Community Edition do Pentaho 4.8 .......................................................................................... 7 Path de correção para exportação XLS e PDF. ......................................................................... 7 Community Edition do Pentaho 5.4 .......................................................................................... 7 Configurando o Pentaho BA (Versões 4.8 e 5.4) ....................................................................... 7 Pentaho Data Integration - PDI ............................................................................................. 13 Pan e kitchen . ......................................................................................................................... 13 Pan........................................................................................................................................... 13 Kitchen..................................................................................................................................... 14 Criando uma Conexão com o Banco de Dados ....................................................................... 16 Parâmetros de configuração do Banco de Dados ................................................................... 17 Criando Repositório................................................................................................................. 18 Criando Transformações ......................................................................................................... 19 Configurando Conexão ........................................................................................................ 19 Transformação Input Excel Output Table ........................................................................... 21 HOP.......................................................................................................................................... 25 Transformação Input File Output Table .............................................................................. 28 Transformação Input Microsoft Access Output Table ........................................................ 30 Transformação Input File - Transformação Group By - Output Table................................. 34 Modelo de Dados SIGCA ......................................................................................................... 36 Transformação Input File - Transformação Lookup - Output Table .................................... 36 JOB........................................................................................................................................... 38 2 Saiku ........................................................................................................................................... 41 Instalação do CTools: .............................................................................................................. 41 Retirando Splash Screen.......................................................................................................... 42 Pentaho Report Designer ....................................................................................................... 43 Adicionando Fonte de Dados .................................................................................................. 44 Bands ....................................................................................................................................... 47 DashBoards com CTools.......................................................................................................... 48 CDE: Layout, Componentes, e fontes de dados ...................................................................... 49 Pentaho Metadata Editor ....................................................................................................... 53 Domain .................................................................................................................................... 54 Bussiness View ........................................................................................................................ 59 CWM.- Common Warehouse Metamodel .............................................................................. 60 Schema Workbench .................................................................................................................... 61 Schema .................................................................................................................................... 61 Cube ........................................................................................................................................ 62 Dimensions .............................................................................................................................. 62 Hierarchies .............................................................................................................................. 62 Levels ....................................................................................................................................... 62 Named Set ............................................................................................................................... 62 Virtual cubes............................................................................................................................ 62 User-defined function ............................................................................................................. 62 Calculated members ............................................................................................................... 62 Measures ................................................................................................................................. 62 Menu de Navegação do Mondrian ......................................................................................... 67 Personalizando o Pentaho CE 5.4............................................................................................... 68 Personalizando o Pentaho CE 4.8............................................................................................ 69 Resumo dos arquivos de personalização e configuração ....................................................... 69 Substituindo o conjundo de ícones padrão......................................................................... 70 Alterando o logotipo padrão ................................................................................................... 71 Alterando o link do logotipo padrão ....................................................................................... 71 Alterando o Background do Workspace ................................................................................. 71 Personalizando e Desenvolvendo Temas para Pentaho User Console ................................... 71 3 Visão geral do tema................................................................................................................. 71 Criando um Novo Tema .......................................................................................................... 72 Definindo um Tema Padrão .................................................................................................... 73 Temas Switching PUC .............................................................................................................. 73 Instalação do Postgresql ............................................................................................................ 74 4 Pentaho É uma empresa líder de integração de dados e análise de negócios com uma plataforma de classe empresarial desenvolvido em Java. Foi adquirida em 04/06/2015, pela empresa Hitachi Data Systems, oficialmente ninguém informou o valor mas especialista especulam que a transação ficou entre $500 e $600 milhões de dólares. A suíte da ferramenta oferece dois tipos de produto Enteprise (versão paga) e a Community (versão gratuita). A versão Enterprise o cliente paga pelo licenciamento do produto e conta com o suporte da empresa, na opção community exige habilidades apuradas para a instalação do software e adições de plug-ins, possibilitando a competitividade do produto com a versão paga e outros concorrentes. Pentaho community Edition - CE Versão do Pentaho de uso livre que contém todos os principais recursos da ferramenta Enterprise (versão paga), que conta com o apoio da comunidade de desenvolvedores para aperfeiçoamento da ferramenta. A Hitachi Data System liberou a sua primeira versão com a marca da Pentaho, reestilizando o produto na versão 5.4, nessa versão foram retirados o Ad-hoc Query and Reporting, a empresa meteorite.bi fornece o Saiku uma alternativa para geração dos relatórios e análise dos cubos. Visualização do produto CE 4.8 5 Pentaho Business Analytics Platform É o núcleo central do software que armazena todo o conteúdo criado no servidor de aplicações, inclui recursos para gerenciamento de segurança, execução de relatórios, dashboards. A plataforma Pentaho BA é executado dentro de um Webserver J2EE Apache Tomcat e pode ser incorporados em outros servidores de aplicativos Java. . 6 Para realização do download da versão: Community Edition do Pentaho 4.8 Para instalação da versão Java Versão 6 Pentaho BI Server 4.8.0-stable https://sourceforge.net/projects/pentaho/files/Business%20Intelligence%20Server/4.8.0-stable/ Report Designer 3.9.1-stable https://sourceforge.net/projects/jfreereport/files/04.%20Report%20Designer/3.9.1-stable/ Pentaho Metadata 4.8.0-stable - Download - Release Note https://sourceforge.net/projects/pentaho/files/Pentaho%20Metadata/4.8.0-stable/ Path de correção para exportação XLS e PDF. Copie o arquivo fop para a pasta do /biserver-ce/tomcat/webapps/pentaho/WEB-INF/lib e exclua o arquivo fop-0.94.jar. Download do arquivo http://www.aprendendoetl.com.br/painel/images/fop-0.20.5.jar Community Edition do Pentaho 5.4 Para instalação da versão Java Versão 7 link http://community.pentaho.com/ http://sourceforge.net/projects/pentaho/files/Business%20Intelligence%20Server/5.4/biserver-ce5.4.0.1-130.zip/download Configurando o Pentaho BA (Versões 4.8 e 5.4) Um dos pré-requisitos para executar a plataforma do Pentaho BI Server é instalando o JAVA JRE ou JDK. Vamos verificar se a variável JAVA_HOME está configurada no seu computador. 1. Pressionem as teclas : 2. Digite na janela o comando "cmd". 7 3. Digite o comando "java -version". 4. Realizar o download do JAVA no site da Oracle, nos endereços: 5. JDK 6. (http://www.oracle.com/technetwork/java/javaee/downloads/java-ee-sdk-6u3-jdk6u29-downloads-523388.html) 6. JDK 7. (http://www.oracle.com/technetwork/pt/java/javase/downloads/jdk7-downloads1880260.html) 8 7. O sistema não localizou a variável necessária para executar o pentaho BA, vamos criar a variável no "painel de controle" em Propriedades do sistema. Na variável de sistema clique em novo e digite no nome do campo "JAVA_HOME" e no valor da variável informe o caminho do JDK ou JRE instalado no computador. Instale a versão JDK 1.7 para o Pentaho 5.4 ou JDK 1.5 para o Pentaho 4.8. 9 8. Digite o comando "java -version" e o resultado deverá ser parecido com esse. 9. Configurem a variável path e adicionem no final do arquivo o comando ;%JAVA_HOME%\bin. 10 10. Digite o comando "javac - version". 11. Descompacte o arquivo "biserver-ce-5.4.0.1-130" em um diretório de sua preferência e execute o arquivo "start-pentaho.bat" (Procedimento que poderá ser adotado nas versões 4.8 e 5.4). 12. Abra o navegador de sua preferência e digite na http://localhost:8080/pentaho " (Procedimento que poderá ser adotado nas versões 4.8 e 5.4). barra do endereço 11 13. Para efetuar o login na aplicação coloque "admin" no campo nome e "password". na senha utilize 12 Pentaho Data Integration - PDI O Pentaho Data Integration (PDI), também conhecido como kettle, é um componente da Pentaho responsável pelo processo de Extração, Transformação e Carga (ETL) dos processos. Embora o ETL seja muito utilizado na construção de Data Warehouse, o PDI pode ser utilizado também para outros propósitos: - Migração entre Aplicações ou Base de Dados. - Exportação de Base de Dados. - Carga massiva de dados para outras Bases. - Limpeza de Dados. - Integração de Aplicativos Kettle é um acrônimo para "Kettle E.T.T.L. Environment.". O Kettle foi projetado para ajudar no ETTL (Extraction, Transformation, Transportation and Loading of data). Spoon é uma interface gráfica que permite projetar transformações e trabalhos que podem ser executados com a ferramenta Kettle. Pan e kitchen . Pan Executa transformações realizadas no PDI de um arquivo ou repositório. Transformações de um arquivo Transformações de um repositório 13 Kitchen Executa trabalhos realizados no spoon em XML ou no repositório de banco de dados. Os trabalhos são normalmente programadas no modo batch para ser executado automaticamente no período agendado. Para realizar o download da ferramenta acessem o site http://community.pentaho.com/ na área de Download escolha a opção "Data Integration" ou digite o link abaixo para realizar o download direto. http://sourceforge.net/projects/pentaho/files/Data%20Integration/5.4/pdi-ce-5.4.0.1130.zip/download Descompacte o arquivo na pasta de sua preferência e execute o arquivo Spoon.bat para iniciar a aplicação. 14 15 Criando uma Conexão com o Banco de Dados Verifique se na pasta de instalação existe o jar jdbc de conexão com o banco de dados. pentaho\data-integration\lib, sem esse arquivo a ferramenta não consegue realizar a comunicação com o banco de dados. Para criar uma nova conexão com o Banco de Dados, existe três possibilidades para adicionar uma nova conexão. 1 - Clique duas vezes com o botão direito do mouse sobre "Conexões". 2 - Clique com o Botão esquerdo do mouse e escolha "Novo". 3 - Pressione a tecla "F3" e abrirá a janela com o assistente do banco. 16 Parâmetros de configuração do Banco de Dados Nessa etapa vamos configurar o acesso ao banco de dados, para isso vamos precisar das informações de acesso ao banco de dados. Como trabalho com o banco de dados Oracle, vou configurar das informações do host, Nome da base de Dados, Número da Porta, Usuário e senha. Host Name Coloque o ip da máquina que você deseja conectar, no meu exemplo estou acessando remotamente a minha máquina. Database Name Coloque o sid da conexão com o banco de dados, caso esteja em dúvida procure o DBA da sua empresa. Port Number Geralmente a porta de conexão com o oracle é a 1521, porém fica a critério do DBA a escolha da porta. User Name O usuário do banco de dados. Password Coloque a senha de acesso ao banco de Dados. Connection Name Atribua um nome para sua conexão. Faça um teste, para verificar se tudo está correto, no exemplo citado foi realizado a conexão com o Oracle porém escolha o SGBD que deseja realizar e faça os procedimentos informados no passo acima. 17 Vamos iniciar o Pentaho Data Integration na pasta de descompactação procure o arquivo "Spoon.bat". Criando Repositório Clique em Tools --> Repositório --> Conectar a um repositório Surgirá uma tela para você criar um repositório de um metadata ou armazenar os arquivos na pasta do computador, selecione armazenar o arquivo em pasta clicando no símbolo de adicionar Na próximo tela selecione o local que deseja armazenar essas informações e clique em Navega e escolha o local para armazenar o seu repositório, no campo Name informe um nome que deseja para o seu repositório. 18 Criando Transformações Vamos criar uma transformação utilizando como dados de entrada informações do Excel e gravando numa base de dados do Postgres. Clique no menu File --> Novo --> Transformação. Configurando Conexão O próximo passo é criar uma conexão com o banco de dados. Selecione File --> Novo --> Database Connection 19 Após o preenchimento clique em Test e verifique se a conexão foi estabelecida com sucesso. Na aba View é possível visualizar as conexões criadas. 20 Transformação Input Excel Output Table No campo Design podemos selecionar a entrada da origem dos dados, podemos realizar uma rápida pesquisa do Steps e clicar no objeto selecionado e arrastar para a área de desenvolvimento da nossa transformação. Realize o procedimento para saída dos dados (Output), selecionando o objeto Table Output. 21 Dê um duplo clique no objeto "Microsoft Excel Input", selecione o tipo de arquivo compatível com a versão que o arquivo fará a leitura do objeto. Clique em Navega e adicione o arquivo em Add conforme demonstrado na figura abaixo. 22 Na aba Sheets selecione a guia da planilha que você deseja recuperar , clicando em "Get Sheetname(s)" ... Na aba Content, selecione o Conteúdo da planilha Na guia "Fields", selecione os campos que deseja obter, ficando atendo com os tipos de dados data escolhendo o formato da data. 23 Clique em "Preview rows", uma janela será exibida informando a quantidade de registros que será exibido na tela. Clique em OK, e será exibido a janela conforme o exemplo abaixo, feche a visualização e vampos para os próximos passos. 24 E em seguida clique em OK, para preservar as alterações realizadas. No próximo passo precisamos conectar os nossos dados de origem com o destino, clique no objeto e selecione o conector para informar a transformação o destino dos dados. HOP O Hop é um objeto que conecta uma etapa de transformação ou Job de entrada com outro. A direção do fluxo de dados é indicada com uma seta no painel de exibição gráfica. Um hop pode ser ativado ou desativado. Dê um duplo clique no objeto Table Output 25 Selecione a conexão e a tabela de destino e selecione a opção para os campos da base de dados Na guia "Database fields", selecione selecione "Get fields", para recuperar os campos da base de dados e clique em Enter Field mapping para verificar o mapeamento selecionado pelo Pentaho. 26 Execute a transformação. Nessa tela você pode selecionar o tipo de execução o tipo de Nível de log. Após execução a tela irá mostrar o resultado da transformação. 27 Transformação Input File Output Table Vamos criar uma nova transformação utilizando como dados de entrada informações de texto e gravando numa base de dados do Postgres. Clique no menu File --> Novo --> Transformação. No campo Design podemos selecionar a entrada da origem dos dados, podemos realizar uma rápida pesquisa do Steps e clicar no objeto selecionado e arrastar para a área de desenvolvimento da nossa transformação Faça o mesmo procedimento para saída dos dados no objeto Table Output. 28 Realize a conexão com a saída dos dados. Dê um duplo clique e vamos configurar os dados de entrada, selecionando "Navega..." informe a origem dos dados e clique em "Add" Na próxima etapa clique em "Content", informando o tipo delimitador e formato do arquivo. 29 Na guia "Fields", vamos Obter os campos do arquivo, na função "Trim type" seleciono a opção para retirar os espaços do início do arquivo e do final do arquivo. Caso queira visualizar os arquivos clique em Preview rows. Realize os mesmos procedimentos informados anteriormente para conectar com o table output.e execute a transformação. O PDI ( Pentaho Data Integration) realiza transformações de base de dados distintas, vamos realizar uma nova transformação aplicando um filtro, realizando um Join e ordenando os registros da entrada do Access. Transformação Input Microsoft Access Output Table Crie uma nova transformação, criando duas entradas do objeto "Microsoft Access Input", uma do objeto "filter", duas do objeto "Sort rows" e uma"Merge Join" e um table Output, a transformação deverá ficar conforme o modelo abaixo. 30 No objeto "Microsoft Access Input" dê um duplo clique e informe o local de armazenamento do banco de dados do access. Em "Content" selecione a tabela que deseja importar os dados. 31 Na guia "Fields" recupe os campos da base de dados. No outro objeto realize o mesmo procedimento para importar os dados da tabela dbo_AUDIR. No objeto "Filter Rows" realizamos as condições que satisfaçam as necessidades dos nossos dados, funciona como a cláusula where do sql. No objeto "Sort Rows" classificamos os dados chave para realizar um "Merge Join", pois os dados devem ser classificados em ordem crescente para o próximo step. Realize esse mesmo procedimento para o próximo step de ordenação. 32 No objeto Merge Join, selecione o campo chave que irá se relacionar com a outra tabela e escolha o tipo de Join. No próximo passo aponte os dados para tabela de destino.e execute a transformação. 33 Transformação Input File - Transformação Group By - Output Table Vamos criar um nova transformação utilizando os seguintes objetos: Text file input; 2 Sort rows; -Group by Memory Group by Add Sequence Table Output No objeto "Text file input" importe os dados para criar a dimensão atividade. Ordene os dados por TIPO_ATIVIDADE. Agrupe os dados por tipo de atividade. 34 No objeto Sort Rows Ordene novamente o objeto por tipo de atividade, o Pentaho Data Integration tem um bug que por algum motivo os registros perdem a ordenação obrigando a realização de outros steps para garantir o agrupamento dos dados O objeto Memory Group By realiza a mesma função do Group By, porém os registros não precisam estar ordenados. No objeto "Add Sequence", cria uma chave para identificar os registros da tabela. No objeto Table output aponte para a tabela de destino e execute a transformação. 35 Modelo de Dados SIGCA Na próxima transformação vamos carregar na tabela fato buscando as chaves da nossa modelagem do sistema SIGCA. Transformação Input File - Transformação Lookup - Output Table Nessa transformação vamos carregar os seguintes objetos: Text file input; 5 Database lookup Memory Group by Add Sequence Table Output Selecione os dados de origem no objeto Text file input que contém as informações da nossa tabela fato. 36 No objeto Database lookup vamos retornar o valor da chave que identifica na minha dimensional. Selecione a tabela de pesquisa e informe os campos que se relacionam. Realize o mesmo procedimento para outras dimensionais. No "Memory Group By" , agrupe os campos e crie as métricas para tabela fato, no campo Subject retornam os dados de entrada do input. Realize os outros procedimentos salve o arquivo e execute a carga. 37 JOB Para criação de uma rotina de carga, que execute um processo diário você pode criar um JOB, que significa um workflow de uma ou várias rotinas de cargas. Para criar um JOB, clique em Novo--> Job Na tela design selecione o objeto Start E logo em seguida insira 6 componentes "Transformations" e 5 componentes "Success" 38 No componente Transformation dê um duplo clique e especifique o local de origem das transformações criadas. No exemplo que trabalhamos criamos as transformações num repositório de dados. Selecione e clique em OK. No componente "Success" ajuda o desenvolvedor a identificar a continuidade da sequencia de execução da carga. No componente "Start", podemos configurar o agendamento pela ferramenta aplicando um duplo clique. 39 Nesse mesmo componente é possível configurar a execução em paralelos das cargas caso não haja restrições para o carregamento dos outros processos, clicando com o botão direito em cima do objeto Start e selecionando a opção execução em paralelo. 40 Saiku É um produto da empresa Meteorite.bi fundada por Robin Lazenby e Tom Barber que oferece uma melhor alternativa para análise das informações de inteligência empresarial, além possibilitar o acoplamento do produto com o Pentaho BA. Para instalar o Saiku report, pare o servidor do Pentaho BI Server, faça o download do arquivo saikuadhoc-plugin-1.0-GA.zip no link abaixo http://mgiepz.github.io/saiku-reporting/ Versão 4.8 CE Descompacte-o arquivo na pasta biserver-ce/pentaho-solutions/system/. Para colocar os Cubos OLAP do Saiku sob a ACL ( Controle de Acesso ) do Pentaho, adicionar a extensão .saiku para a tag acl-files do arquivo pentaho.xml que pode ser encontrado na pasta biserver-ce/pentaho-solutions/system. Edite o arquivo e inclua a informação "saiku". xaction,url,prpt,prpti,xdash,xcdf,saiku... Instalação do CTools: Copiar e descompactar (Utilizar a opção “Extrair Aqui”) o arquivo ctools.zip para a pasta \biserver-ce O Saiku Reporting é um cliente web disponível como plugin para o Pentaho BI Server. Ele utiliza o Pentaho Metadata-Layer para proporcionar uma forma fácil de usar o recurso de relatórios ad-hoc. 41 Para realizar a instalação do produto vamos logar no pentaho e selecionar a área marketplace e clicar em install e reiniciar o servidor e pronto a instalação está pronta. . Retirando Splash Screen Para retirar a tela de splash screen do Saiku, devemos editar o arquivo biserver-ce/pentaho-solutions/system/saiku/ui/saiku.min.js Substituir !Settings.INITIAL_QUERY&&c.splash?Saiku.tabs.add(new SplashScreen):Settings.INITIAL_QUERY||Saiku.tabs.add(new Workspace)}} Por !Settings.INITIAL_QUERY&&c.splash?Saiku.tabs.add(new Workspace):Settings.INITIAL_QUERY||Saiku.tabs.add(new Workspace)}} Retirar a mensagem do var a=$("\x3cdiv\x3e\x3cdiv id\x3d'uphead' class\x3d'upgradeheader'\x3eYou are using Saiku Community Edition, please consider upgrading to \x3ca target\x3d'_blank' href\x3d'http://meteorite.bi'\x3eSaiku Enterprise, or entering a sponsorship agreement with us\x3c/a\x3e to support development. \x3ca href\x3d'mailto:[email protected]?subject\x3dSupporting Saiku'\[email protected]\x3c/a\x3e\x3c/div\x3e\x3c/div\x3e").html() 42 Pentaho Report Designer É a principal ferramenta de desenvolvimento de relatórios da Pentaho, é destinada a usuários avançados com habilidades técnicas. Para realizar o download do produto acessem o link http://community.pentaho.com/ e localize Download e clique em Report Desginer. Após o download descompacte o arquivo em um diretório de sua preferência e clique no arquivo reportdesigner.bat para executar o programa. O Report Designer exibe uma página de boas-vindas e um área de trabalho padrão no início do programa. A página de Boas vindas fornece uma breve introdução do Report Designer e algumas instruções. Na página de abertura é possível visualizar os relatórios de exemplos e os abertos recentemente. 43 No centro há uma grande área branca que representa a principal área de trabalho, onde é desenvolvido o relatório. No lado esquerdo da área de trabalho é a paleta que lista os elementos gráficos do relatório. No lado direito, a estrutura do painel permite que você veja uma representação hierárquica do relatório. Na propriedades do painel permite ajuste das configurações da seleção atualmente disponíveis. Adicionando Fonte de Dados No Menu Data --> Add Datasource, configure a conexão que deseja realizar. Para efeito didáticos, vamos realizar a conexão Metadata. 44 Clique em Adicionar a consulta e escolha os campos do nosso metadados. 45 Para realizar consulta com parâmetros, coloque na condição o nome do Parâmetro criado entre "{}" Clique com o botão direito no item Parameters e selecione Add Parameter. Informe os campos: E depois informe o nome do Parâmetro no campo Value. 46 Bands Definem individualmente cada parte do relatório. Para publicar o relatório clique em File Publish e escolha a pasta para publicação do relatório. 47 DashBoards com CTools Um conjunto de ferramentas e componentes que executa em cima de Pentaho, criado e mantido por Webdetails para permitir a criação de Dashboards avançados. O CDE é um editor gráfico poderoso para criar e manter painéis. Com esta ferramenta é possível definir o layout, componentes e fontes de dados para a criação de dashboard. CDE é parte de todo um conjunto de plugins de código aberto para o Pentaho BI Server, contribuído e mantido por Pentaho e parceiros como webdetails. Existem vários plugins disponíveis na comunidade e mantidos pela webdetails, alguns dos quais dependem ou se estendem entre si. 48 CDE: Layout, Componentes, e fontes de dados Layout definem blocos HTML estáticos que as partes dinâmicas do dashboard podem conectar, os recursos de. CSS e JavaScript, também são mantidos no layout. Componentes são entidades que exibem dados como gráficos, caixas de selectores e tabelas de dados. Os componentes são colocados no painel, reservando um espaço na seção de layout e realizando a ligação com os componentes. Fontes de dados fornecem informações aos componentes, geralmente parametrizados por consultas SQL ou MDX. A figura abaixo exibe os três conceitos e como eles se relacionam. Vamos selecionar um template para criar o nosso dashboard, você poderá selecionar os existentes ou criar um novo: 49 O Template selecionado foi "Two Columns Template." Após selecionar o template, fiz algumas adaptações. 50 Na aba Data Sources, selecionei a opção de conexão "sql over sqUndi" defini um nome para a minha consulta e apontei a conexão existente com o Pentaho. No campo Query passei o seguinte instrução: Após realizar as configurações da conexão, clique em Components e selecione Charts a opção "CCC BAR Chart" e "CCC Pie Chart" para posicionarmos no panel_1 e panel_2 do layout. 51 No campo preview podemos vizualizar o resultado do nosso dashboard. 52 Pentaho Metadata Editor Pentaho Metadata Editor é uma ferramenta que permite que você construa Pentaho domínios de metadados e modelos de dados relacionais. Um Modelo de Metadados Pentaho mapeia a estrutura física do seu banco de dados em um modelo de negócio lógico. Esses mapeamentos são armazenados em um repositório de metadados centralizado e permitem aos administradores: Definição na criação de uma conceito de negócios nas tabelas do banco de dados; Diminuir o impacto nas alterações do banco de dados; Definição de parâmetros de segurança no acesso do usuário na geração de relatórios. Definir o formato de apresentação dos dados em texto, data e números. Definir as configurações regionais do usuário. Para realizar o download do produto: Versão 5.4 --> acessem o link http://community.pentaho.com/ e localize Design Tools e clique em Metadata Editor. Versão 4.8 --> acessem o link https://sourceforge.net/projects/pentaho/files/Pentaho%20Metadata/4.8.0-stable/ ************************************************************************************* Importante na versão 4.8 é necessário definir uma senha para publicação do metadata. de preferência uma senha que não contenha caracteres especiais, espaços, acentos. Altere o arquivo biserver-ce/pentaho-solutions/system/publisher_config.xml biserver-ce/pentaho-solutions/system/publisher_config.xml Exemplo: <publisher-config> <publisher-password>Definir a senha para publicação</publisher-password> </publisher-config> ************************************************************************************* Conexão com banco de Dados é necessário inserir um arquivo JDBC na pasta de instalação : ...\ metadata-editor\libext\JDBC ************************************************************************************* 53 Para executar o programa clique no arquivo metadata-editor.bat. Domain É um termo Pentaho que representa todos os objetos de negócios criados, armazenados e utilizados na camada de metadados. Um Domain pode consistir em uma ou mais conexões, um ou mais modelos, informações de segurança, dados de negócios, categorias, colunas e conceitos. Você pode criar e salvar vários domínios de metadados usando o Pentaho Metadata Editor. Um Domain de metadados é acessado pela BI Server para publicar ou exportar o domínio para um arquivo com extensão .xmi, e publicando no repositório de soluções do Pentaho, porém na versão 4.8 o arquivo deverá ser enviado manualmente pois existe um bug da ferramenta que não publica o arquivo no repositório, ou seja, quando publicar o arquivo, logo em seguida exportar o arquivo com extensão xmi para o repositório. \biserver-ce\pentaho-solutions\[nome da pasta de publicação]. Ao executar o PME automaticamente um novo domínio é criado, porém podemos criar um novo domínio clique em New --> Domain File ... Para criar uma conexão com o banco de dados devemos nos atentar que o nome da conexão que obrigatoriamente tem que ser idêntica a criada no PAC (Painel Administration Console) na versão PCE 4.8 podemos acessar o painel de administração colocando o usuário "admin" e senha "password", o servidor do BI Server deve estar online, crie uma conexão com o postgres com o nome BASE_POSTGRES_SIGCA. 54 No metadata editor crie um conexão com o nome BASE_POSTGRES_SIGCA., clique com o botão direito em Connections e selecione New Connection. e passe as configurações para o metadata editor possa acessar o banco de dados, nessa etapa você deverá fornecer as informações do banco de dados, clique em testar e a conexão foi criada. 55 Após clicar em OK uma nova janela com as tabelas da conexão criada serão exibidas, selecione a que serão necessárias para a construção do modelo. Com as tabelas importadas precisamos criar um "Bussiness Models" Bussiness Models é o local onde as tabelas físicas e colunas devem ser configuradas no mapeamento lógico de negócios. O BM também definem os relacionamentos entre as tabelas de negócios. Agora clique com o botão direito e vamos criar um Bussiness Model. Defina a conexão com o Banco de Dados e selecione as permissões para o acesso ao metadado. 56 Para recuperar as informações dos usuários ou roles que terão acesso a ferramenta, clique em Tools --> Security. Informe a conexão para recuperar o acesso dos usuários ou roles cadastradas no PAC, por padrão o Username = "admin" e o Password = "password", caso você não tenha alterado. Clique com o botão direito do mouse em Bussiness Tables e clique em New Bussiess Table ou arraste da Connections para área de construção do metadata. Para Criar Relationships entre as tabelas importadas, clique com o botão direito em Relationship e selecione New Relationship ... 57 Selecione a tabela e o campo para realização do relacionamento, o tipo de relacionamento e a forma de Junção das tabelas. Faça o mesmo procedimento para as outras tabelas . 58 Bussiness View É a camada de apresentação final para o usuário, nesse modelo de negócio devemos configurar o acesso dos usuários na aplicação, podemos criar as pastas e definir as categorias das informações. Clique com o Botão direito do mouse em "Bussiness View" e selecione "New Category..", Nessa janela defina um Nome para a Categoria que será exibida para o usuário e quem pode acessar as informações. Em Manage Categoria crie as informações que farão parte da visualização final do usuário. 59 Após realizar os procedimentos supracitados, realize a publicação no servidor do BI Server, clicando File --> Publish To Server... Na versão PME 4.8, informe a senha para publicação do metadata, na tela da versão PME 5.4 não é necessário realizar esse procedimento Além de publicar exporte o arquivo com o nome de metadata.xmi, para a pasta de publicação, selecione File --> Export to XMI File. (..\biserver-ce\pentaho-solutions\SIGCA) CWM.- Common Warehouse Metamodel Define uma especificação para modelagem de metadados para base relacionais, não relacionais e multidimensionais. 60 Schema Workbench O Workbench Mondrian é uma ferramenta de interface que permite criar e testar os cubos OLAP. O Mondrian executa consultas escritas na linguagem MDX, realizando a leitura de banco de dados relacionais e apresenta os resultados em um formato multidimensional através de uma API Java. Para realizar o download do produto acessem o link http://community.pentaho.com/ e localize Design Tools e clique em Schema Workbench Após o download descompacte o arquivo em um diretório de sua preferência e clique no arquivo workbench.bat para executar o programa. Schema Um esquema define uma base de dados multi-dimensional, que contém um modelo lógico, que consiste em cubos, hierarquias e membros. O modelo lógico consiste nas construções usadas para escrever consultas na linguagem MDX: cubos, dimensões, hierarquias, níveis e membros. 61 O modelo físico é a fonte dos dados que é apresentada através do modelo lógico. É tipicamente um esquema em estrela, que é um conjunto de tabelas em um banco de dados relacional. Cube Um cubo é uma coleção nomeada de medidas e dimensões. Dimensions A dimensão é uma coleção de hierarquias que descrevem os atributos da tabela de fatos. Hierarchies Uma hierarquia é um conjunto de membros organizados em uma estrutura conveniente para análise. Levels Um nível é uma colecção de membros que têm a mesma distância a partir da raiz da hierarquia. Named Set A cláusula WITH SET é uma instrução MDX que permite a declaração de uma expressão. Virtual cubes Um cubo virtual combina dois ou mais cubos regulares. User-defined function Uma função definida pelo usuário deve ter um construtor público e implementar a interface mondrian.spi.UserDefinedFunction. Calculated members Uma função para realizar cálculos no cubo. Measures São as métricas definidas no cubo. 62 ************************************************************************* Os cubos publicados são definidos na pasta biserver-ce\pentaho-solutions\system\olap\datasource.xml Na pasta de publicação do cubo tem que criar um arquivo com o mesmo nome da conexão criada no PAC. BASE_POSTGRES_SIGCA.xml <?xml version="1.0" encoding="UTF-8"?> <datasources> <local-tx-datasource> <jndi-name>BASE_POSTGRES_SIGCA</jndi-name> <connection-url>jdbc:postgresql://localhost:5432/SIGCA</connection-url> <driver-class>org.postgresql.Driver</driver-class> <user-name>postgres</user-name> <password>casa12</password> </local-tx-datasource> </datasources> Coloque o driver de conexão do banco de dados na pasta ..\schema-workbench\drivers\ ex: postgresql-9.4-1203.jdbc4.jar Documentação Oficial http://mondrian.pentaho.com/documentation/schema.php http://mondrian.pentaho.com/head/documentation/schema.php#Measures ************************************************************************** Com o Pentaho Schema Workbeach, clique em Option --> Connection.. 63 Adicione um cube. Clique em cima do objeto cube e adicione uma tabela, no exemplo que estamos construindo vamos adicionar uma fato para conectar com as nossas dimensionais. Vamos adicionar uma dimensão e adicionar a nossa tabela dimensional. 64 Na Hierárquia criada vamos definir a chave da tabela dimensional e vamos criar um nível para apresentação dos dados. Agora vamos definir a tabela fato. Na dimensão Semestre vamos definir a foreing Key. 65 Vamos criar as métricas. Vamos criar um campo calculado. Realize a publicação do arquivo em Publish O resultado ficou assim: 66 Menu de Navegação do Mondrian 67 Personalizando o Pentaho CE 5.4 Tela inicial Para retirar a imagem de fundo, substitua a imagem por um fundo de sua preferência com o mesmo nome caminho da imagem. ..\biserver-ce\pentaho-solutions\system\common-ui\resources\themes\crystal\images\login-crystal-bg.jpeg \pentaho-solutions\system\common-ui\resources\themes\images\puc-login-logo.png Para ocultar a lista de usuários edite o arquivo pentaho.xml no diretorio biserver-ce\pentahosolutions\system abrar o arquivo e edite a linha de: <login-show-users-list>true</login-show-users-list> <login-show-sample-users-hint>true</login-show-sample-users-hint> para: <login-show-users-list>false</login-show-users-list> <login-show-sample-users-hint>false</login-show-sample-users-hint> 68 Personalizando o Pentaho CE 4.8 fonte: https://github.com/brenopolanski/customizando-pentaho-business-analytics Customizando o Pentaho User Console O Pentaho User Console é a interface Web padrão para o Pentaho Business Analytics Server, e inclui elementos interativos de Análises e Relatórios Pentaho. O Pentaho Enterprise Console é a estrutura central do framework, através do qual o seu Business Analytics Server é configurado e gerenciado. Você pode personalizar a interface do User Console ao editar seus arquivos de configuração, imagens e folhas de estilos CSS3 manualmente, e tanto o user Console e Enterprise Console pode ser traduzida para outras línguas através da substituição de pacotes de mensagens de texto simples. Resumo dos arquivos de personalização e configuração Nota: Pare o servidor de aplicação Pentaho antes de editar qualquer coisa dentro do arquivo Pentaho WAR. MantleSettings.properties Localização: /pentaho/server/biserver-ce/tomcat/webapps/pentaho/WEB-INF/lib/mantle-4.8.0-GA.jar Este arquivo é armazenado no pacote JAR acima listado no Pentaho WAR. Você deve abrir o JAR com um utilitário de arquivo ZIP, em seguida, navegue até /org/pentaho/mantle/server/. Não importa como você irá extrair e editar o arquivo, ele deve ser colocado de volta no JAR quando for modificado. É recomenda o uso 7-Zip para este processo, use seu editor de códido preferido, em seguida, faça suas modificações no arquivo. O arquivo MantleSettings.properties contém configurações para a barra de menu, barra de ferramentas principal, e o painel logotipo. Se você decidir desabilitar o menu ou barra de ferramentas, o painel logotipo também será desabilitado por causa de restrições de interface do usuário. Verifique as configurações no arquivo como show-menu-bar=true. Para mudar o comportamento, basta alterar de true para false. MantleStyle.css Localização: /pentaho/server/biserver-ce/tomcat/webapps/pentaho/mantle/MantleStyle.css Esta é a folha de estilo CSS do Pentaho User Console. Ele herda alguns elementos do arquivo widgets.css no mesmo diretório, você pode precisar dele também. Nota: Modificar essa folha de estilo poderia ter um impacto grande sobre a interface do Pentaho User Console. 69 Folhas de estilo locais e globais dos Temas Onyx e Slate Nota: O tema Slate está incluído no Servidor Business Analytics, mas desabilitado por padrão, porque tem problemas de renderização no Internet Explorer. No entanto, você pode achar que é útil para fins de desenvolvimento e testes. Esta é a folha de estilo principal e estrutural, para o tema padrão do Pentaho User Console (Onyx). Localização: /pentaho-solutions/system/common-ui/resources/themes/onyx/globalOnyx.css Esta é a folha de estilo principal e estrutural, específico do tema alternativo para o Pentaho User Console (Slate). Localização: /pentaho-solutions/system/common-ui/resources/themes/onyx/globalSlate.css Esta é a folha de estilo do tema padrão, para o Pentaho User Console (Onyx). Localização: /pentaho/mantle/themes/onyx/mantleOnyx.css Esta é a folha de estilo do tema alternativo, para o console de usuário Pentaho (Slate). Localização: /pentaho/mantle/themes/slate/mantleSlate.css Configurações do tema específico do Analyzer, Dashboard Designer, e Interactive Reporting Esses diretórios contêm folhas de estilo para cada ferramenta cliente BA Server. Analyzer location: /biserver-ce/pentaho-solutions/system/analyzer/styles/themes/ Interactive Reporting location: /biserver-ce/pentaho-solutions/system/pentaho-interactive- reporting/resources/web/themes/ Dashboard Designer location: /biserver-ce/pentaho-solutions/system/dashboards/themes/ Substituindo o conjundo de ícones padrão Os ícones utilizados em todo o Pentaho User Console são consolidadas e armazenadas em arquivos PNG chamados image bundles. Esses arquivos só abrange uma única solicitação HTTP a partir do cliente, para o servidor e para todo o conjunto de imagens, poupando largura de banda e melhorando o desempenho. Os pacotes de imagem têm nomes aleatórios gerados com as extensões PNG e são armazenados no diretório /pentaho/server/biserver-ee/tomcat/webapps/pentaho/mantle. Um exemplo de uma imagem de nome do bundle provável é:EAC2E33CD4B780B5A88A44308412F1CB.cache.png. Se você editar um pacote de imagem, você deve ter certeza de preservar a sua localização e tamanho. A aplicação Web Pentaho utiliza CSS para cortar a imagem e agrupar durante a execução, de modo que você deve respeitar o tamanho, posição e localização do que é atualmente lá. Devido a essas restrições, é recomendado que você não altere as imagens em si. Isso pode ser feito com as ferramentas mais modernas de design gráfico. 70 Alterando o logotipo padrão O logotipo Pentaho exibido no canto superior direito da Pentaho User Console pode ser substituído ou desativado de acordo com suas necessidades. Para desabilidar o logotipo, altere o arquivoMantleSettings.properties explicação acima. O logotipo padrão é: /pentaho/server/biserver-ce/tomcat/webapps/pentaho/mantle/themes/onyx/images/logo.png, o logotipo padrão Pentaho tem um fundo transparente. Se você quiser modificar ou substituir o logotipo, você deve manter o nome do arquivo e tamanho da imagem, que é 152x75 pixels. Se você quiser alterar o tamanho do logotipo, você pode alterar a classe CSS .puc-logospacer emmantleOnyx.css para usar diferentes dimensões: .puc-logo-spacer { width: 152px; height: 75px; } Alterando o link do logotipo padrão Você pode fazer o logotipo ir para uma determinada URL quando clicado. Por padrão, o logotipo do Pentaho não vai para nenhuma URL, mas a funcionalidade para torná-la funcional está ponta. Você pode definir a URL do destino, através do logoPanelWebsite em /pentaho/mantle/messages/mantleMessages.properties. Este arquivo de propriedades está dentro do Pentaho WAR, então você terá que parar o Servidor Business Analytics, antes de fazer qualquer modificação. Alterando o Background do Workspace Você pode alterar a imagem de fundo que aparece no painel de conteúdo do Pentaho User Console, modificando ou substituindo o bg_pentaho_default.png no arquivo pentaho/system/common- ui/resources/themes//images. Personalizando e Desenvolvendo Temas para Pentaho User Console A interface gráfica do Pentaho User Console é construído sobre um motor de temas inovadores, baseados em CSS3. As seções abaixo contêm conselhos para Designers e Front-Ends. Visão geral do tema O tema baseado em CSS3 permite que você mude o visual de suas ferramentas do Business Analytics Server e adicione seus próprios temas. Pode ser feito através do trabalho com apenas alguns arquivos de configuração chaves. As folhas de estilo que compõem o Pentaho User Console, o Dashboard Designer, Analyzer e Interactive Reporting são na sua maioria em um único local. Coletivamente, esses estilos e scripts compreendem o 71 tema padrão do sistema Onyx. Este tema está localizado no diretório UI plugin em/pentaho/server/biserver-ce/pentaho-solutions/system/common-ui/resources/themes. Existem dois tipos de temas: do sistema e local. Temas do sistema fornecem estilos e scripts comuns que se aplicam a todo Business Analytics Server. Por exemplo, os botões são definidos no tema padrão do sistema Onyx. Temas locais são definidos para uma determinada área ou "contexto" do servidor de BI. Contextos incluem plugins do Servidor Business Analytics, bem como os nomes dos diretórios de nível superior no Pentaho WAR. Recursos para temas locais só terão efeito em sua área específica do servidor de BI. Qualquer página mostrada pelo Business Analytics Server que inclui o webcontext.js terá automaticamente todos os JavaScript do tema ativo e CSS incluído. Por exemplo: <themes root-folder="style"> <autumn display-name="Autumn" system="true"> <file>autumnStyles.css</file> <file>autumnScripts.js</file> </autumn> </themes> Quando o tema Autumn estiver ativo, é adicionado à página HTML: <script type="text/javascript" src="/pentaho/common-ui/themes/autumn/autumnStyles.js"></script> <link rel="stylesheet" type="text/css" href="/pentaho/commonui/themes/autumn/autumnStyles.css"/> Esta inserção de recursos faz com que seja possível alterar os temas sem ter que editar os principais documentos HTML. Você pode incluir vários arquivos JavaScript e CSS para o seu tema. Você pode adicionar estilos locais de uma forma similar. A única exigência é que você deve dizer ao sistema que contexto você precisa carregar. Isto é feito através da adição ?context=myPlugin emwebcontext.js script myPlugin é o nome do seu plugin ou a pasta raiz do WAR: <script type=”text/javascript” src=”webContext.js?context=myPlugin”></script> Criando um Novo Tema Na inicialização, o Business Analytics procura por themes.xml em cada arquivo, plugin e pasta de nível raiz no Pentaho WAR. Vários temas podem ser definidos num ficheiro themes.xml. O exemplo a seguir define um tema do sistema chamado Autumn. <themes root-folder="resources/themes"> <autumn display-name=”Autumn” system="true"> <file>autumnStyles.css</file> <file>autumnScripts.js</file> </autumn> <autumn display-name=”Autumn” system="true"> <file>localAutumnStyles.css</file> </autumn> </themes> 72 Observe que a tag tem a pasta de raiz. O valor do atributo root-folder é o nome do diretório (em relação ao contexto da aplicação Web) onde os temas são armazenados. Para contextos baseados em WAR, isso é simplesmente um nome de diretório dentro do WAR. Por exemplo, se o tema está localizado na pasta /pentaho.war/accounting/, os recursos serão carregados a partir de/pentaho.war/accounting/resources/themes/. Carregamento de plugin de recursos é diferente do que WAR-based, ele controla a forma como os recursos são mapeados para o URL. Se o arquivo de tema de cima foi localizado em um plugin chamado accounting, em seguida, os recursos seriam acessadas a partir da seguinte URL:/pentaho/context/accounting/resources/themes/. Este tipo de mapeamento de recursos é mais comumente implementado em plugins Business Analytics Server por meio da tag static-path: <static-paths> <static-path url="/accounting/resources" localFolder="resources"/> </static-paths> É mais fácil e rápido desenvolver um novo tema, baseando-se no tema padrão do Onyx. Cada estilo definido no arquivo mainStyles.css é usado em algum lugar do Business Analytics Server. Onyx também contém vários arquivos de script, como por exemplo JScrollPane, barra de rolagem do jQuery. Esses scripts substitui as barras de rolagem do navegador nativo com versões personalizáveis DHTML. Definindo um Tema Padrão O tema padrão do sistema solutions/system/pentaho.xml através é definido no do default-theme. arquivo O de Business configuração /pentahoAnalytics Server vem com onyxcomo o tema padrão, alterando o valor para um outro nome de tema, irá definir o tema ativo padrão para todos os usuários do Pentaho User Console. Temas Switching PUC Se você criou um tema alternativo e/ou um pacote de mensagens, você pode mudar no Menu Viewdo Pentaho User Console. Nota: Você pode impedir os temas que aparecem neste menu, adicionando um hidden="true"no arquivo de propriedades. Você pode especificar manualmente um tema para uma determinada página, incluindo um theme= e o parâmetro URL. Isso afetará apenas a página solicitada. A seguir irá realizar um debug no sistema e temas locais, se disponíveis: http://localhost:8080/pentaho/content/myPlugin/index.html?theme=debug Se o sistema ou tema de debug local não for encontrado, os recursos serão carregados para o tema ativo em seu lugar. Isso é particularmente útil quando tem testes de novos temas e para carregar versões de depuração de scripts e estilos. Também é possível definir a variável de sessão pentaho-user-theme para o nome do tema desejado. Isso geralmente é feito em uma ação de start-up para ter temas por usuário em cenários multi-locação. 73 Instalação do Postgresql Clique no link abaixo para baixar o banco de dados do postgresql versão 9.4.4 para o sistema operacional windows 64 bits http://www.postgresql.org/download/windows/ 74