Lyceum NG: Relatrios em

Reporting Services

Sumrio
Introduo...........................................................................................................................3
Pr-Requisitos.....................................................................................................................4
Configurao........................................................................................................................5
Configurao do Context das Aplicaes NG.............................................................................5
Configurao da Autenticao Bsica no Reporting Services.......................................................6
Cadastro dos Relatrios no Mdulo de Secretaria.................................................................7
Cadastro do Relatrio...........................................................................................................8
Cadastro dos Parmetros do Relatrio.....................................................................................9
Configurao dos Padres de Acesso.....................................................................................10
Emisso dos Relatrios.......................................................................................................11
Emisso pela Tela de Emisso da Secretaria...........................................................................12
Emisso Atravs de um Link em Tela.....................................................................................13

Introduo
Nos mdulos do Lyceum NG possvel criar links para relatrios publicados no SQL Server
Reporting Services.Oslinks para a emisso desses relatrios so feitos atravs do controle LinkReport.
O controle LinkReportconsulta o banco de dados do Lyceum para validar os dados do relatrio e
em seguida realiza a comunicao com o servidor de relatrios, atravs do WebService disponvel no
Reporting Services.O WebService ento executa o relatrio e devolve o mesmo j em seu formato final,
que ento enviado ao browser para que o usurio receba o mesmovia download pelo browser.

Pr-Requisitos
Os pr-requisitos para a utilizao dos relatrios em Reporting Services no NG so:
1.
2.
3.
4.
5.

Mdulos do Lyceum NG instalados e funcionando.

Possuir os grupos de relatrio do NG cadastrados (AcademicoNG, FinanceiroNG, etc.).
Servio SQL Server Reporting Services instalado e funcionando.
Usurio Windows com acesso ao servidor de relatrios e permisses de execuo nos relatrios.
Possuir os relatriosque sero utilizados j publicados e funcionando no servidor de relatrios.

Configurao
Para que a emisso dos relatrios funcione nos mdulos do Lyceum NG necessrio configurar o
context de cada aplicao e tambm habilitar a autenticao bsica no servidor de relatrios.

Configuraodo Context das Aplicaes NG

Localizar e abrir o arquivo context.xml da aplicao que ser configurada (Ex:
Lyceum\conf\Catalina\localhost\context.xml).
Localizar o seguinte trecho de cdigo no arquivo e realizar as substituies de acordo com
ambiente em questo:

sqlserver.reportServer: Url do ReportServer do servidor de relatrios.

sqlserver.reportUrl:Url do WebService do servidor de relatrios (ReportExecution2005.asmx o
mesmo para o Sql Server 2005/2008 e 2008 R2)
sqlserver.reportUserId:Usurio Windows com acesso aos relatrios.
sqlserver.reportPassword:Senha do usurio Windows.

Configuraoda Autenticao Bsica 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 cdigo no arquivo e adicionar a chave marcada em amarelo como
no exemplo abaixo:

Cadastro dos Relatrios no Mdulo de Secretaria

Para poder criar os links e visualizar os relatrios tanto no mdulo de Secretaria como nos outros,
necessrio primeiramente cadastrar os mesmos e os seus respectivos parmetros no Lyceum.
Esse cadastro realizado no mdulo de Secretaria:
Menu: Relacionamento / Relatrios
Nome da Tela: Configurao
Tela: Secretaria/operacoesaluno/TAOP028D.tp

Cadastrodo Relatrio
Na tela de configurao, adicionar um novo registro e preencher os campos como no exemplo
abaixo:

Grupo: Grupo do relatrio.

Relatrio: Identificao nica do relatrio.
Tipo: Tipo do relatrio, no caso sempre SQL Reporting Services.
Descrio: Descrio do relatrio.
Caminho: Endereo do relatrio no servidor de relatrios.

Cadastrodos Parmetros do Relatrio

Na tela de configurao, selecionar na primeira grid o relatrio para o qual deseja cadastrar os
parmetros e adicionar um novo registro no painel de parmetros como no exemplo abaixo:

Ordem: Ordem do parmetro. necessrio manter a mesma ordem do relatrio.

Parmetro: Nome do parmetro. necessrio manter o mesmo nome do parmetro interno do
relatrio.
Tipo: Tipo do parmetro.
Descrio: Descrio do parmetro.
Obrigatrio: Indica se o parmetro obrigatrio ou no.
Comando: Comando SQL para buscar a lista de valores do parmetro. Caso seja um parmetro
livre, deixar o campo em branco.
Coluna Valor: Nome do campo que ir retornar o valor do parmetro. Informar apenas se o
comando tiver sido informado.
9

Coluna Descrio: Nome do campo que ir retornar adescrio do parmetro. Informar apenas se
o comando tiver sido informado.

Configurao dos Padres de Acesso

No mdulo Hades, navegar para o menu Hades / Relatrios e definir os padres de acesso
desejados para o relatrio cadastrado anteriormente:

10

Emisso dos Relatrios

A emisso dos relatrios cadastrados pode ser feita de duas maneiras:

Atravs da tela de emisso de relatrios do mdulo de Secretaria

Atravs da criao de um link direto em qualquer tela de qualquer mdulo do Lyceum NG (Aluno
Online, Docente, Secretaria).

11

Emisso pela Tela de Emisso da Secretaria

Para emitir um relatrio atravs da Secretaria, navegar para a tela:

Menu: Relacionamento / Relatrios
Nome da Tela: Relatrios
Tela: Secretaria/atendimento/TATD059D.tp

Escolher o relatrio desejado na lista e clicar no cone para exibir a janela de seleo de
parmetros. Nessa janela sero exibidos os parmetros cadastrados para o relatrio. Preencher ao menos
os parmetros obrigatrios, 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 emisso do relatrio e clicar em Emitir Relatrio para iniciar o
processo.

12

Emisso Atravs de um Link em Tela

Para criar um link para um relatrio em uma tela qualquer dos mdulos do Lyceum NG
primeiramente necessrio analisar seus pr-requisitos:

A tela precisa possuir todos os parmetros que sero passados para o relatrio.
Esses parmetros podem ser parmetros de pgina, controles visveis ou escondidos ou inclusive
controles especficos para que o usurio escolha um dos parmetros (Ex:um DropDown com
uma lista qualquer).

Com esses pr-requisitos atendidos, basta adicionar um controle LinkReport na pgina desejada
e preencher os parmetros como no exemplo abaixo:

13

14

label: Descrio que ser exibida no link.

parameterNames: Nomes dos parmetros esperados pelo relatrio, separados por vrgula. Os
nomes dos parmetros precisam ser idnticos aos cadastrados na Secretaria.
parameters: Valores dos parmetros esperados pelo relatrio em sequncia. Devem ser
referncias para os campos em tela, conforme citado nos pr-requisitos.
relatorio: Identificador nico do relatrio. O nome precisa ser idntico ao cadastrado na
Secretaria.
relatorioApplication: Aplicao do relatrio (Padro: Lyceum).
relatorioGrupo: Grupo do relatrio publicado na Secretaria. Se for um relatrio Acadmico deve
ser AcademicoNG se for um relatrio Financeiro deve ser FinanceiroNG.
reportFormat: Formato de emisso do relatrio (Padro: pdf).

15