Olá comunidade,
Vamos para a 2º parte do artigo InterSystems IRIS Reports.
Somente relembrando na primeira parte do artigo falamos dos desafios existentes para atender a demanda das áreas de negócios, clientes ou usuários finais com a entrega de relatórios em diversos formatos e suas melhorias, e como o InterSystems IRIS Reports vem para facilitar está demanda, facilitando o desenvolvimento, a administração, o deploy de relatórios em diversos formatos, bem como a automação da distribuição por e-mail ou pastas e integração (build-in) em suas aplicações já existentes!
O InterSystems IRIS Reports, powered by Logi Report se encontra disponível para download no WRC (https://wrc.intersystems.com/wrc/coDistribution.csp), lembrando que para clientes que já possuem o licenciamento InterSystems IRIS Advanced Server ou InterSystems IRIS Advanced for Health, precisam somente abrir um chamado solicitando o serial para a instalação do InterSystems IRIS Reports, sem custo adicional.
Como mencionando no artigo anterior o InterSystems IRIS Reports é divido em dois componentes:
Server: O ambiente servidor tem a sua finalidade de administrar as configurações e segurança. É também onde os usuários finais via browser têm acesso aos relatórios, você pode agendar execução de relatórios, aplicar filtros e modificar os relatórios disponibilizados.
Designer: O ambiente designer por sua vez é onde os relatórios são desenvolvidos. É possível visualizar os relatórios antes de disponibilizar acessando diretamente a bases de dados.
Quando o relatório estiver pronto, você consegue publicar para o ambiente servidor.
Após entrar no WRC, selecionar a opção Components, e no campo Name, digitar: InterSystems Reports.
Você tem a opção para instalar tanto o Server como o Designer no SO de sua preferência sendo: Linux/Unix, Mac ou Windows.
Neste tutorial vamos fazer a instalação do Server no Linux e do Designer no Windows.
Começando pelo lado servidor, vamos aos pré-requisitos:
Aplicar permissão ao arquivo instalador:
|
$ chmod +x server-xxx-linux.bin |
./server-xxx-linux.bin -i console (mude server-xxx-linux.bin para o novo do arquivo correto). |
|
Nota: É necessário o X server esteja em execução. |
No meu caso: ./server-17-b202006051612-linux.bin -i console
Neste momento você deve ler o License Agreement.
Após ler o License Agreement, e caso concorde com os termos pressione Y e <Enter>
Após concordar com o License Agreement, é necessário informar o User ID e a License key que você recebeu pelo chamado feito no WRC.
Após a inclusão do User ID e a License Key, você escolherá o tipo da instalação. Aqui vamos optar pela Recomendada, a opção 1:
Agora vamos escolher Production Database (A opção Trial Database, instala um banco de dados local somente com o propósito de testes).
|
NOTA: Com já sabemos o InterSystems IRIS Reports é distribuído pela Logi, e seu produto é compatível com outros bancos de dados do mercado, a licença que o WRC disponibilizou só é permitido seu uso com o nosso banco de dados InterSystems IRIS Advanced Server ou InterSystems IRIS for Health. |
Escolhendo a opção 8 – Other Databases, vamos passar os parâmetros:
|
NOTA: Uma recomendação é que você crie um namespace exclusivo para o InterSystems IRIS Reports Server, onde serão criadas as tabelas de gerenciamento do IRIS Reports. Caso tenha dúvidas na criação do namespace, clique aqui. |
JDBC URL: jdbc:IRIS://<IP DO SEU SERVIDOR IRIS>:<SuperServerPort>/<namespace>
A próxima opção é o nome da classe:
JDBC Driver Class Name : com.intersystems.jdbc.IRISDriver
As próximas opções são usuário e senha:
User Name: <entrar com o usuário>
Password: <entrar com a senha>
|
Nota: lembrando que você possui o driver no diretório de instalação do seu IRIS, ou você pode fazer o download através deste link: https://github.com/intersystems/quickstarts-java/blob/master/lib/intersystems-jdbc-3.2.0.jar |
O próximo passa é confirmar a inclusão da classe!
A próxima opção precisamos confirmar a adição do driver do JDBC :
Would you like to continue to add classes? (Y/N): Y
Please specify the path of classes which you need: <Caminho>/ intersystems-jdbc-3.2.0.jar
Agora a próxima etapa é escolher o JDK, podemos confirmar o encontrado pelo instalador no início da instalação ou definir um outro caminho para o JDK.
Como já adicionamos o JDBC necessário, vamos escolher a opção 2 para o próximo passo.
É apresentando agora um sumário da instalação, se tudo estiver certo, é só pressionar <ENTER> para dar continuidade.
Ao final da instalação iram aparecer informações importantes, como caminho para acessar o IRIS Reports Server e usuário e senha iniciais.
Pronto agora que a instalação está finalizada você pode escolher para que o serviço seja iniciado. Para iniciar manualmente, você precisa entrar no seu diretório de instalação e executar <diretório de instalação>/Server/bin/JRServer.sh
Após iniciado, ir para o browser e chamar: http://<IP-do-servidor>:8888, digitar usuário e senha iniciais:
Legal! Agora que temos o ambiente Server operacional, vamos instalar o Designer!
Primeiro vamos apresentar os pré-requisitos para o ambiente Designer.
Vá para a pasta onde você executou o download do instalador, e o execute!
Após executar o instalar, será apresentada a tela de Welcome. Clique em Next.
A seguinte etapa é ler o License Agreement, e aceitá-lo se estiver de acordo, e clicar em next.
Agora é a hora de colocar o User ID e o License Key recebido pelo chamado feito ao WRC da InterSystems e clicar em Next.
Aqui vamos escolher a pasta onde será instalado o Designer, e neste momento existe uma opção importante: Server for Previewing Reports, está opção dá ao desenvolvedor a oportunidade de visualizar o relatório desenvolvido em sua estação de trabalho e no browser de sua escolha. Aqui vamos utilizar está opção, pois vamos utilizá-la em um artigo posterior.
Nesta etapa se faz necessário escolher o JDK que você deseja usar, lembrando que os compatíveis foram citados no início deste artigo.
Aqui vamos adicionar o ClassPath, lembrando que na pasta da sua instalação do IRIS o drive JDBC encontra-se disponível, exemplo: <pasta de instalação do Iris>/dev/java/lib/JDK18
Agora é apresentado um sumário da instalação, aqui você pode revisar onde será instalado e o espaço em disco requerido. Agora é só clicar em Install.
E após rodar a instalação, é apresentado o README, após a leitura do README, é só clicar em DONE, que o Desiner irá iniciar automaticamente. (Mantendo a opção marcada).
Pronto o Designer está instalado:
Pronto, estamos com o Server e o Designer instalado, no próximo artigo vamos colocar a “mão na massa”, vamos desenvolver relatórios em diversos formatos e disponibilizar para uso!
Obrigado e até a próxima parte!