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).
