1

Lyceum NG: Relatórios em Reporting Services

2

Sumário

Introdução........................................................................................................................3

Pré-Requisitos..................................................................................................................4

Configuração....................................................................................................................5

Configuração do Context das Aplicações NG.........................................................................................5

Configuração da Autenticação Básica no Reporting Services................................................................6

Cadastro dos Relatórios no Módulo de Secretaria...............................................................7

Cadastro do Relatório............................................................................................................................8

Cadastro dos Parâmetros do Relatório..................................................................................................9

Configuração dos Padrões de Acesso..................................................................................................10

Emissão dos Relatórios...................................................................................................11

Emissão pela Tela de Emissão da Secretaria.......................................................................................12

Emissão Através de um Link em Tela..................................................................................................13

3

Introdução

Nos módulos do Lyceum NG é possível criar links para relatórios publicados no SQL Server Reporting Services.Oslinks para a emissão desses relatórios são feitos através do controle “LinkReport”.

O controle “LinkReport”consulta o banco de dados do Lyceum para validar os dados do relatório e em seguida realiza a comunicação com o servidor de relatórios, através do WebService disponível no Reporting Services.O WebService então executa o relatório e devolve o mesmo já em seu formato final, que é então enviado ao browser para que o usuário receba o mesmovia download pelo browser.

4

Pré-Requisitos

Os pré-requisitos para a utilização dos relatórios em Reporting Services no NG são:

1. Módulos do Lyceum NG instalados e funcionando.2. Possuir os grupos de relatório do NG cadastrados (“AcademicoNG”, “FinanceiroNG”, etc.).3. Serviço “SQL Server Reporting Services” instalado e funcionando.4. Usuário Windows com acesso ao servidor de relatórios e permissões de execução nos relatórios.5. Possuir os relatóriosque serão utilizados já publicados e funcionando no servidor de relatórios.

5

Configuração

Para que a emissão dos relatórios funcione nos módulos do Lyceum NG é necessário configurar o “context” de cada aplicação e também habilitar a autenticação básica no servidor de relatórios.

Configuraçãodo Context das Aplicações NG

Localizar e abrir o arquivo “context.xml” da aplicação que será configurada (Ex: Lyceum\conf\Catalina\localhost\context.xml).

Localizar o seguinte trecho de código no arquivo e realizar as substituições de acordo com ambiente em questão:

sqlserver.reportServer: Url do “ReportServer” do servidor de relatórios. sqlserver.reportUrl:Url do WebService do servidor de relatórios (ReportExecution2005.asmx é o

mesmo para o Sql Server 2005/2008 e 2008 R2) sqlserver.reportUserId:Usuário Windows com acesso aos relatórios. sqlserver.reportPassword:Senha do usuário Windows.

6

Configuraçãoda Autenticação Básica no Reporting Services

Localizar e abrir o arquivo “rsreportserver.config” (Ex: Microsoft SQL Server\MSRS10_50.MSSQLSERVER\Reporting Services\ReportServer\rsreportserver.config).

Localizar o seguinte trecho de código no arquivo e adicionar a chave marcada em amarelo como no exemplo abaixo:

7

Cadastro dos Relatórios no Módulo de Secretaria

Para poder criar os links e visualizar os relatórios tanto no módulo de Secretaria como nos outros, é necessário primeiramente cadastrar os mesmos e os seus respectivos parâmetros no Lyceum.

Esse cadastro é realizado no módulo de Secretaria:

Menu: Relacionamento / Relatórios Nome da Tela: Configuração Tela: Secretaria/operacoesaluno/TAOP028D.tp

8

Cadastrodo Relatório

Na tela de configuração, adicionar um novo registro e preencher os campos como no exemplo abaixo:

Grupo: Grupo do relatório. Relatório: Identificação única do relatório. Tipo: Tipo do relatório, no caso sempre “SQL Reporting Services”. Descrição: Descrição do relatório. Caminho: Endereço do relatório no servidor de relatórios.

9

Cadastrodos Parâmetros do Relatório

Na tela de configuração, selecionar na primeira grid o relatório para o qual deseja cadastrar os parâmetros e adicionar um novo registro no painel de parâmetros como no exemplo abaixo:

Ordem: Ordem do parâmetro. É necessário manter a mesma ordem do relatório. Parâmetro: Nome do parâmetro. É necessário manter o mesmo nome do parâmetro interno do

relatório. Tipo: Tipo do parâmetro. Descrição: Descrição do parâmetro. Obrigatório: Indica se o parâmetro é obrigatório ou não. Comando: Comando SQL para buscar a lista de valores do parâmetro. Caso seja um parâmetro

livre, deixar o campo em branco. Coluna Valor: Nome do campo que irá retornar o valor do parâmetro. Informar apenas se o

comando tiver sido informado.

10

Coluna Descrição: Nome do campo que irá retornar adescrição do parâmetro. Informar apenas se o comando tiver sido informado.

Configuração dos Padrões de Acesso

No módulo Hades, navegar para o menu Hades / Relatórios e definir os padrões de acesso desejados para o relatório cadastrado anteriormente:

11

Emissão dos Relatórios

A emissão dos relatórios cadastrados pode ser feita de duas maneiras:

Através da tela de emissão de relatórios do módulo de Secretaria Através da criação de um link direto em qualquer tela de qualquer módulo do Lyceum NG (Aluno

Online, Docente, Secretaria).

12

Emissão pela Tela de Emissão da Secretaria

Para emitir um relatório através da Secretaria, navegar para a tela:

Menu: Relacionamento / Relatórios Nome da Tela: Relatórios Tela: Secretaria/atendimento/TATD059D.tp

Escolher o relatório desejado na lista e clicar no ícone para exibir a janela de seleção de parâmetros. Nessa janela serão exibidos os parâmetros cadastrados para o relatório. Preencher ao menos os parâmetros obrigatórios, clicando sobre os mesmos na tabela do lado esquerdo e selecionando o valor desejado na tabela do lado direito (ou digitando diretamente o valor, caso seja um campo livre).

Por fim, escolher o formato de emissão do relatório e clicar em “Emitir Relatório” para iniciar o processo.

13

Emissão Através de um Link em Tela

Para criar um link para um relatório em uma tela qualquer dos módulos do Lyceum NG primeiramente é necessário analisar seus pré-requisitos:

A tela precisa possuir todos os parâmetros que serão passados para o relatório. Esses parâmetros podem ser parâmetros de página, controles visíveis ou escondidos ou inclusive

controles específicos para que o usuário escolha um dos parâmetros (Ex:um “DropDown” com uma lista qualquer).

Com esses pré-requisitos atendidos, basta adicionar um controle “LinkReport” na página desejada e preencher os parâmetros como no exemplo abaixo:

14

15

label: Descrição que será exibida no link. parameterNames: Nomes dos parâmetros esperados pelo relatório, separados por vírgula. Os

nomes dos parâmetros precisam ser idênticos aos cadastrados na Secretaria. parameters: Valores dos parâmetros esperados pelo relatório em sequência. Devem ser

referências para os campos em tela, conforme citado nos pré-requisitos. relatorio: Identificador único do relatório. O nome precisa ser idêntico ao cadastrado na

Secretaria. relatorioApplication: Aplicação do relatório (Padrão: Lyceum). relatorioGrupo: Grupo do relatório publicado na Secretaria. Se for um relatório Acadêmico deve

ser “AcademicoNG” se for um relatório Financeiro deve ser “FinanceiroNG”. reportFormat: Formato de emissão do relatório (Padrão: pdf).