Histórico da Página

Introdução

...

O relatório dinâmico visa de forma transparente e simples, permitir que sejam inseridos componentes que irão compor a saída do relatório, isto é, seu resultado final apresentado. Desta forma, temos uma interface que pode ser confeccionada e customizada em poucos passos, trazendo um dinamismo e maior rapidez na execução dos relatórios do sistema.  Dessa forma podem ser passados parâmetros de seleção por contratos, subunidades, cliente/fornecedor, entre outros.

Como utilizar

...

O relatório dinâmico deve ser acessado em Shopping / Relatórios / Relatório Dinâmico. Este menu possui permissão, então o usuário deve ter a sua respectiva permissão habilitada para utilizá-lo.

É importante frisar que toda a modificação resultante na tela do relatório dinâmico deve ser primeiro realizada nos relatórios que irão fornecer os parâmetros para a exibição da tela. Abaixo vamos mostrar como realizar essa alteração.

Existem duas opções de tipo de retorno de componentes:

• Multi Record: Quando há a necessidade que em determinado parâmetro seja selecionado vários registros. Identificado pela inicial MRE_
• Lookup: Quando há a seleção somente de um registro em determinado parâmetro. Identificado pela inicial LKP_

As tabelas disponíveis para passagem de parâmetros para execução do relatório dinâmico são as seguintes:

Tipos de Parâmetros

Multi Record (MRE_)
Utilizado quando é necessário selecionar mais de um registro em um mesmo parâmetro.
Esse tipo de parâmetro é identificado pelo prefixo MRE_ e deve ser aplicado em consultas SQL que utilizem operadores como IN ou FILTER, conforme exemplificado na Tabela abaixo.

Lookup (LKP_)
Utilizado quando é permitida a seleção de apenas um único registro no componente.
É identificado pelo prefixo LKP_ e possui uma regra específica de uso: ao criar o relatório, o parâmetro deve ser nomeado com o prefixo LKP_, e a sentença SQL deve utilizar o parâmetro conforme o padrão definido para cada Tabela, conforme listado abaixo.

Tabela Definição de Campos

Tipos de Parâmetros Compatíveis

Os tipos de parâmetros listados abaixo são compatíveis e podem ser utilizados como componentes na geração de relatórios dinâmicos.

Exemplos de Utilização

SELECT XALGCONTRATOLOC.CODCOLCONTLOC, XALGCONTRATOLOC.CODCONTLOC,XALGCONTRATOLOC.NUMCONTLOC, XALGCONTRATOLOC.DTVIGENCIAINICONTLOC
  FROM XALGCONTRATOLOC (NOLOCK)
 WHERE XALGCONTRATOLOC.CODCOLCONTLOC = 1
   AND XALGCONTRATOLOC.CODCONTLOC IN (SELECT [VALUE] AS PARAMETRO FROM STRING_SPLIT(:MRE_XCONTRATOLOC_IN, ','))

SELECT XALGEVENTOFINANCEIRODISTRIBUIC.CODCOLEVENTFIN, XALGEVENTOFINANCEIRODISTRIBUIC.CODEVENTFIN,
       FLAN.CODCOLIGADA, FLAN.IDLAN, FLAN.VALORORIGINAL,
       FLAN.CODCCUSTO
  FROM XALGEVENTOFINANCEIRODISTRIBUIC (NOLOCK)
          JOIN FLAN (NOLOCK)
            ON FLAN.CODCOLIGADA = XALGEVENTOFINANCEIRODISTRIBUIC.CODCOLEVENTFIN
           AND FLAN.IDLAN = XALGEVENTOFINANCEIRODISTRIBUIC.IDLAN
           AND FLAN.CODCOLIGADA = :CODCOLCCUSTO  AND FLAN.CODCCUSTO = :CODCCUSTO
 WHERE XALGEVENTOFINANCEIRODISTRIBUIC.CODCOLEVENTFIN = 1

SELECT XALGEVENTOFINANCEIRODISTRIBUIC.CODCOLEVENTFIN, XALGEVENTOFINANCEIRODISTRIBUIC.CODEVENTFIN,
       FLAN.CODCOLIGADA, FLAN.IDLAN, FLAN.VALORORIGINAL,
       FLAN.CODCCUSTO
  FROM XALGEVENTOFINANCEIRODISTRIBUIC (NOLOCK)
          JOIN FLAN (NOLOCK)
            ON FLAN.CODCOLIGADA = XALGEVENTOFINANCEIRODISTRIBUIC.CODCOLEVENTFIN
           AND FLAN.IDLAN = XALGEVENTOFINANCEIRODISTRIBUIC.IDLAN
           AND FLAN.CODCOLIGADA = :CODCOLCCUSTO  AND FLAN.CODCCUSTO = :CODCCUSTO
           AND FLAN.IDLAN IN(SELECT [VALUE] AS PARAMETRO FROM STRING_SPLIT(:MRE_IDLAN_IN, ','))
WHERE XALGEVENTOFINANCEIRODISTRIBUIC.CODCOLEVENTFIN = 1

Resumo Comparativo

Como fazer (Relatório com Sentença SQL IN e Componente MultiRecord)

...

Dada as tabelas acima, eu quero que o meu relatório me permita escolher vários contratos de locação que irão fazer parte do resultado dele. Este relatório possui uma sentença SQL com uma clausula IN, então neste caso devemos proceder da seguinte maneira

Para isso então estou dizendo que deve existir o parâmetro MRE_XCONTRATOLOC_IN no relatório como mostra a imagem abaixo:

Na minha cláusula WHERE eu preciso utilizar obrigatoriamente a função string_split. dessa forma, passamos os parâmetros como abaixo:

...

Após a criação da função, a cláusula WHERE da consulta SQL deve obrigatoriamente seguir o padrão:

WHERE 
-
AND
XALGCONTRATOLOC.CODCONTLOC  IN (    SELECT TO_NUMBER(COLUMN_VALUE)     FROM TABLE(split_string(:MRE_XCONTRATOLOC_IN, ','))  )

Como fazer (Relatório com Sentença SQL FILTER e Componente MultiRecord)

...

Para esse relatório dinâmico ser criado, deve existir o parâmetro MRE_XCONTRATOLOC_FILTER no relatório como mostra a imagem abaixo:

...

O resultado da exibição no relatório dinâmico será o mesmo da exibição quando temos um componente IN, entretanto a o resultado da consulta SQL do relatório será filtrada de acordo com os contratos selecionados. Não é necessário utilizar a função split.

Como fazer (Relatório com Componente Lookup)

...

Neste exemplo, eu quero que o meu relatório me permita escolher somente um contrato de locação que irão fazer parte do resultado dele através de uma lookup. Então neste caso devemos proceder da seguinte maneira.

Para isso então estou dizendo que deve existir o parâmetro LKP_XCONTRATOLOC no relatório como mostra a imagem abaixo:

Image Added

Na consulta SQL deste relatório, devemos também passar na cláusula WHERE o parâmetro em questão:

...

Dessa forma, ao executar o relatório dinâmico, teremos o seguinte resultado: