8VDQGR5HSRUW0DQDJHUFRP&ODULRQH3RVWJUH64/ -XOLR&HVDU3HGURVR 8VDQGRSDUkPHWURV

Transcrição

1 8VDQGRSDUkPHWURV O envio de parâmetros para um relatório é uma das funções mais úteis do Report Manager, com eles você pode: Permitir que o usuário final altere palavras ou sentenças de um relatório; Atribuir valores iniciais para grupos de totalizadores; Passar o nome do parâmetro em qualquer expressão avaliada em tempo; de execução; Atribuir o parâmetro para consultas, alterando assim o conjunto de dados retornados pela consulta (parametrizados ou linked querys); Substituir textos na consulta por um texto digitado (substituição de texto); Imprimir ou alterá-lo enquanto executa o relatório, você pode usar o parâmetro em qualquer expressão; Você pode atribuir os valores dos parâmetros mesmo quando usa o aplicativo UHSRUW FOLHQW DSSOLFDWLRQ, que vem junto com o Report Manager. Atribuir valores para os parâmetros quando usar o ZHE UHSRUW 6HUYHU ou qualquer cliente html; Os parâmetros podem conter expressões avaliadas antes ou após a abertura do conjunto de dados do relatório; Um conjunto de dados pode ser definido para que o usuário possa buscar o valor do parâmetro dentro deste conjunto de dados. Semelhante a um lookup; Configurar regras de validação para o parâmetro; Definir uma mensagem de erro se a regra de validação do parâmetro falhar; Configurar diferentes descrições e mensagens explicativas, para cada linguagem do relatório. Você não só pode definir os parâmetros como também visualizar como eles serão apresentados para o usuário final. 'HILQLomRGRVSDUkPHWURV A janela de definição de parâmetros permite adicionar, modifica e excluir parâmetros no relatório. Você pode atribuir parâmetros para conjunto de dados (data sets, ou consultas parametrizadas). Os parâmetros assim definidos podem ser visíveis ou não para o usuário final. Você pode definir um único parâmetro para múltiplos conjuntos de dados. A partir do menu 5HODWyULRV, escolha a opção 'HILQLomRGHSDUkPHWUR. Será aberta uma janela de definição de parâmetros onde iremos incluir todos os parâmetros que desejamos aplicar ao nosso relatório. Nas definições dos parâmetros, tenha em mente que na maioria das vezes, a pessoa que irá

2 preencher os valores destes, será um usuário final, com poucos ou às vezes, nenhum conhecimento de SQL. Portanto, não é recomendável incluir como parâmetro uma sentença SQL. Quando a janela 'HILQLomR GH SDUkPHWUR se abrir, uma lista com todos os parâmetros do relatório será exibida. No caso da figura ao lado, temos um parâmetro chamado (PSUHVD. Logo abaixo da lista de parâmetros são apresentadas as propriedades destes parâmetros: 7LSR GH GDGR: é um controle do tipo GURS OLVW contendo as opções para os diversos tipos que você pode configurar para o seu relatório. As opções são: 'HVFRQKHFLGR: quando o tipo de parâmetro for indeterminado. Não utilizo esta opção. &DGHLD: para definir uma cadeia de caracteres, como se diz em programação, uma string.,qwhlur: Dados do tipo integer, para os programadores Clarion, long, ulong, short, ushort, etc... 'HFLPDO: Dados do tipo decimal, pdecimal, etc... 0RHGD: Para expressar valores monetários (reais, dólares, euros, etc...) 'DWD: Dados do tipo data (date). 'DWDHKRUD: Dado0s do tipo data e hora (timestamp). +RUD: Dados que irão representar unidades de tempo (horas, minutos, segundos, etc...). /yjlfr: Valores que irão representar em expressões booleanas (byte). ([SUHV$QWHV GH DEULU: Uma expressão que será avaliada antes que o conjunto de dados seja aberta. Normalmente modifica o comportamento da pesquisa SQL que envia os dados para o relatório. Exemplo: Data Inicial e Data Final, irão limitar o conjunto de dados a um intervalo de datas. ([SUHV $SyV DEULU: Uma expressão que será avaliada quando os dados já estiverem abertos e apresentados. Permite, por exemplo, que o usuário final aplique um filtro sobre um relatório já em tela, antes de enviá-lo para a impressora.

3 &DGHLD GH VXEVW Uma string que substituirá o valor de um parâmetro em tempo de execução. Por exemplo, em um sistema multi empresa, o nome da empresa no cabeçalho do relatório, obtido pelo preenchimento de um parâmetro ou via programação. /LVWD GH YDORUHV: Uma coleção de valores que será preenchida pelo desenvolvedor do relatório. Em tempo de execução o usuário irá selecionar entre os valores da coleção, exibido em um drop list. 0XOWLSOHVHO Exibe uma caixa de seleção múltipla, semelhante ao anterior, só que com a possibilidade de múltiplas escolhas. 6WULQJ6XEVW([ Uma string que será substituída em uma expressão. Importante destacar que nas expressões, os parâmetros são precedidos pelo símbolo : (dois pontos), conforme mostra a figura. Na figura acima é mostrado um SELECT que abastecerá o relatório com a união (join) de duas tabelas e parâmetros para limitar os valores retornados. A figura acima mostra a tela do usuário no momento da exibição do relatório, com os SURPSWV para passar os valores dos parâmetros. Quando usamos um parâmetro do tipo &DGHLD GH VXEVWLWXLomR, na realidade estamos passando uma string para o dataset. Neste caso devemos providenciar uma string de busca para que o engine busque pela string na sentença SQL e a substitua pelo valor do parâmetro. Pode ser passada para toda a sentença SQL como parâmetro, ou somente para a cláusula WHERE, por exemplo.

4 Quando usamos 0XOWLSOHVHOna realidade temos uma mesclagem ente VWULQJV GH VXEVWLWXLomR e OLVWD GH YDORUHV. Os parâmetros são separados por vírgula, e são muito úteis em sentenças do tipo: WHERE ORDERTYPE IN (:ORDERTYPES) O usuário final poderá selecionar mais que um valor, uma lista será exibida na janela de parâmetros em tempo de execução. A lista de valores poderá também ser carregada a partir de uma consulta SQL (data set), como uma lista de tipos de parâmetros que o usuário irá escolher para aplicar ao relatório. Você poderá obter mais informações sobre um parâmetro, ou uma seleção múltipla, usando a função 3DUDP,QIR do $YDOLDGRU GH ([SUHVV}HV. Um exemplo é exibido na figura acima. 3DUkPHWURVHVSHFLDLV Existem alguns parâmetros especiais que podem ser usados para interagir com o engenho do gerador de relatórios, proporcionando ainda mais flexibilidade. $'2&211(&7,21675,1* Permite trocar a string de conexão padrão do relatório, pelo que for passado neste parâmetro. Possibilita que você troque de banco de dados em tempo de execução. $/,$6B$'2&211(&7,21675,1* Troca a string de conexão do ALIAS pelo conteúdo do parâmetro. '%;&211(&7,216 Caminho para um arquivo de conexão dbx, permitindo alterar a senha e o database em tempo de execução. '%;'5,9(56 Caminho para um arquivo de Driver DBX definido pelo usuário. 0$,/B'(67,1$7,21 Parâmetro que define o destinatário do , na janela de visualização, quando o usuário desejar enviar o relatório como anexo de um . 0$,/B68%-(&7 Parâmetro que permite passar um conteúdo para a linha de assunto (subject), quando o usuário desejar enviar o relatório como anexo de um .

5 0$,/B%2'< Parâmetro que permite passar um texto para o corpo do , quando, a partir da janela de visualização do relatório, o usuário desejar enviar um . 0$,/B),/( Parâmetro opcional que força um nome para o arquivo anexado. Você deve fornecer o nome do arquivo com extensão. '%3$5$0B3$5$01$0( Substitui o parâmetro 3$5$01$0( da conexão do banco de dados pelo valor deste parâmetro. Útil quando queremos atribuir o nome do usuário, senha e caminho do banco de dados, antes de executar o relatório. $/,$6B'%3$5$0B3$5$01$0( O mesmo que '%3$5$0B3$5$01$0(, mas aplicado somente às conexões com alias $/,$6. '$7$6(71$0(B),/7(5 Filtro para o driver Mybase no dataset em memória, se um parâmetro chamado '$7$6(1$0(B),/7(5 for encontrado, este será usado como filtro para o conjunto de dados. 9DOLGDo}HV Podemos configurar uma expressão de validação para um dado parâmetro. A validação é feita no momento da exibição do parâmetro para o usuário final. Se o parâmetro for inválido, uma mensagem de erro é mostrada. Isto será verdadeiro para um servidor web integrado. Observe que a validação não é feita antes de executar o relatório. Para fazer a validação antes de executar o relatório você pode usar a função FKHFNH[SUHVVLRQ no avaliador de expressões, conforme mostra a figura acima, no caso do exemplo, uma expressão sem parâmetros. &RPRFULDUORRNXSVSDUDSUHHQFKHUSDUkPHWURV Algumas vezes um parâmetro é definido como um número de código, um CPF, um CNPJ, um código de barras, etc... (código de cliente, código do grupo...). Com o Report Manager você pode especificar um consulta de pesquisa que servirá como lookup para buscar o parâmetro a partir de um dataset. Ou seja, usando uma consulta SQL podemos encontrar o código desejado. Um exemplo bem simples, é selecionar um número de código a partir de um pequeno conjunto de dados. Imagine que você tenha no seu relatório um parâmetro chamado )$0,/<B&2'(, e que o usuário deva entrar este valor como um número. O ideal, neste caso, seria colocar um botão do tipo... ao lado do controle de entrada do parâmetro, e, quando o usuário clicar neste botão todas

6 as famílias existentes em uma tabela, sejam mostradas. Se o usuário selecionar uma família, o seu código preencherá o valor do parâmetro. Neste caso a lista mostrará os códigos e os nomes para que o usuário as selecione, mas somente o código da família preencherá o campo de entrada do parâmetro do relatório. Vamos ver como fazer isto com o Report Manager: 1. Crie um parâmetro chamado )$0,/<B&2'( do tipo integer; 2. Crie um novo dataset chamado )$0,/<B/22.83 com uma sentença SQL que mostre as informações para o usuário final, onde o primeiro campo deverá ser o código e o segundo deverá ser o nome da família, algo como 6(/(&7 FyGLJRGHVFULomR )520 IDPtOLDV 25'(5 %< GHVFULomR. Desmarque a opção 2SHQDW6WDUW, para que o dataset não seja aberto na inicialização do relatório, mas apenas e tão somente quando necessário. 3. Vá para a janela de definição de parâmetros e selecione o novo dataset como sendo o Search Dataset para o parâmetro )$0,/<B&2'(. 4. Teste usando a janela de parâmetros na opção de Visualizar o Relatório da IDE do Report Manager. Mas... E se ao invés de um pequeno conjunto de dados precisarmos consultar uma tabela grande, como por exemplo, um Cadastro de Clientes? É claro, vamos ter que permitir que o usuário faça consultas no Dataset que preencherá o parâmetro! 1. Crie um novo parâmetro chamado &RGB&OLHQWH do tipo inteiro. Use como descrição a expressão Código do Cliente. Crie um novo Dataset chamado &/,(17(B/22.83 com uma sentença SQL que mostre as informações do código e nome do cliente para o usuário. O primeiro campo deverá ser o código do cliente, que preencherá o parâmetro &RGBFOLHQWH mas, ele deverá conter um parâmetro para pesquisar por apenas um subconjunto de dados no dataset como na sentença SQL 6(/(&7FRGLJRQRPH)520FOLHQWHV :+(5( 833(5QRPH &217$,1,1* SQRPH 25'(5 %< QRPH desmarque a opção 2SHQDW6WDUW de maneira que o DataSet não seja aberto na inicialização do relatório, mas apenas quando necessário, ou seja, quando o usuário pressionar o botão de lookup. Você deverá criar um parâmetro chamado SQRPH do tipo string o qual será atribuído ao dataset &/,(17(B/22.83, setando a propriedade YLVLEOH do parâmetro para IDOVH. Em seguida vá para as definições do parâmetro e selecione o novo Dataset como sendo o Search Dataset para o parâmetro &RGBFOLHQWH. Defina o QRPHcomo sendo o parâmetro de busca. Teste na janela de parâmetros do relatório. Quando passamos um parâmetro para uma consulta (query) do tipo SELECT MYDATA FROM MYTABLE WHERE MYCODE=:CODE Dizemos que esta consulta é uma query parametrizada. A consulta é enviada para o Banco de Dados e traduzida para o driver de acordo com a sintaxe entendida por ele. Devemos ter cuidado com as traduções pois nem todos os drivers entendem isso. Melhor é passar a query utilizando o padrão ANSI.