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.

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:

WHERE 
-
IN
(SELECT value AS parametro FROM STRING_SPLIT(:MRE_XCONTRATOLOC_IN, ','))

Para entender mais sobre essa função, consulte a página abaixo:

O resultado da tela do relatório dinâmico será a seguinte, possibilitando a seleção de vários contratos de locação que irão compor a saída do relatório:

Em bases Oracle, há uma diferença, onde devemos primeiro criar uma função que "imite" a string_split diretamente no banco de dados:

 CREATE OR REPLACE FUNCTION split_string (
   p_string    IN VARCHAR2,
   p_delimiter IN VARCHAR2
) RETURN SYS.ODCIVARCHAR2LIST PIPELINED IS
   l_start     PLS_INTEGER := 1;
   l_end       PLS_INTEGER;
BEGIN
   LOOP
      l_end := INSTR(p_string, p_delimiter, l_start);
      EXIT WHEN l_end = 0;
      PIPE ROW(SUBSTR(p_string, l_start, l_end - l_start));
      l_start := l_end + LENGTH(p_delimiter);
   END LOOP;
   PIPE ROW(SUBSTR(p_string, l_start));
   RETURN;
END;

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 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:

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

WHERE CODCONTLOC =:CODCONTLOC AND CODCOLCONTLOC=:CODCOLCONTLOC

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