Guia do Usuário › Relatórios › Tipos de relatório › Relatórios de formato livre › Parâmetros do relatório de formato livre

Parâmetros do relatório de formato livre

As duas sequências de caracteres digitadas no Texto da conexão e nos Campos de consulta da página Detalhes do relatório de formato livre são suficientes para gerar um relatório de formato livre. No entanto, a flexibilidade e a utilidade do relatório podem ser significativamente aprimoradas por meio da adição de parâmetros ao arquivo XML padrão contido no campo Parâmetros. Uma vez que todos os parâmetros tenham sido definidos, é exibida uma janela pop-up para inserir valores para esses parâmetros ao gerar o relatório.

O arquivo XML padrão é o seguinte:

<custom>
     <connection>
          <params>
               <!--<param name='@UID' disp_name='User id' type='TEXT' size='10'><value>id do usuário</value></param>- > 
               <!--<param name='@PWD' disp_name='Password' type='PASSWORD' size='10'><value>senha</value></param>- > 
          </params>
     </connection>
     <query>
          <params>
               <!--<param name='@PRM1' disp_name='PARAM 1' type='TEXT' size='10'><value>valor param1</value></param>- > 
               <!--<param name='@PRM2' disp_name='PARAM 2' type='LIST'><value>valor 1</value><list><item><value>valor 1</value><text>texto 1</text></item><item><value>valor 2</value><text>texto 2</text></item></list></param>- > 
               <!--<param name="@PRM3" disp_name="PARAM 3" type="LIST">
                    <value>valor</value>
                    <list>
                         <list_query>selecionar valor de id_do_cliente, texto do nome_do_cliente de t_clientes</list_query>
                    </list>
               </param>- > 
          </params>
     </query>
     <pdf>
          <!--<option><name>nome do parâmetro</name><value>valor do parâmetro</value></option>- > 
     </pdf>
     <chart>
          <!--<precision>Valor numérico de 0 a 5</precision>- > 
     </chart>
     <!--<ContainsHTML>0/1</ContainsHTML>- > 
     <!--<headstyle>
          <titlerow bgcolor="value or color name"></titlerow>
          <firstcolumn bgcolor="value or color name"></firstcolumn>
     </headstyle>
</custom>

O arquivo XML contém as seguintes seções principais:

• <connection>: contém as informações de conexão do banco de dados que está sendo consultado
• <query>: contém a consulta SQL
• <pdf>: contém opções de saída de impressão do PDF, como o tamanho do papel, orientação e assim por diante

Cada parâmetro em <connection> e <query> tem seu próprio nó de <param> que inclui os seguintes atributos:

• name: o nome de parâmetro
• disp_name: o nome do parâmetro como ele aparece na janela pop-up.
• type: o tipo de parâmetro, que pode ser um dos seguintes:
• TEXT: entrada de texto
• PASSWORD: texto exibido como asteriscos
• DATE: campo Calendário
• LIST: lista suspensa com várias seleções
• list_query: lista suspensa com várias seleções que ativa a lista dinâmica dos valores. Por exemplo:

  <list>

  <list_query> selecionar o valor algum_valor, o texto algum_texto de alguma_tabela </list_query>

  </list>

  Observação: a instrução Selecionar sempre deve conter duas colunas, uma para valor e uma para o texto de exibição.

• size: o número máximo de caracteres permitido no campo de entrada.

Os parâmetros dentro de <pdf> têm os seguintes atributos:

• name: o nome do parâmetro
• value: o valor do parâmetro