Guía del usuario › Informes › Tipos de informes › Informes de formato libre › Parámetros de informe de formato libre

Parámetros de informe de formato libre

Las dos cadenas especificadas en los campos Cadena de conexión y Consulta de la página Detalles de informe de formato libre son suficientes para generar un informe de formato libre. Sin embargo, la flexibilidad y utilidad del informe pueden mejorarse en gran medida mediante la adición de parámetros al archivo XML predeterminado contenido en el campo Parámetros. Una vez que todos los parámetros se hayan definido, aparece una ventana emergente para especificar los valores para dichos parámetros al generar el informe.

El archivo XML predeterminado tiene la siguiente forma:

<custom>
     <connection>
          <params>
               <!--<param name='@UID' disp_name='User id' type='TEXT' size='10'><value>user id</value></param>- > 
               <!--<param name='@PWD' disp_name='Password' type='PASSWORD' size='10'><value>password</value></param>- > 
          </params>
     </connection>
     <query>
          <params>
               <!--<param name='@PRM1' disp_name='PARAM 1' type='TEXT' size='10'><value>param1 value</value></param>- > 
               <!--<param name='@PRM2' disp_name='PARAM 2' type='LIST'><value>value 1</value><list><item><value>value 1</value><text>text 1</text></item><item><value>value 2</value><text>text 2</text></item></list></param>- > 
               <!--<param name="@PRM3" disp_name="PARAM 3" type="LIST">
                    <value>value</value>
                    <list>
                         <list_query>select customer_id value, customer_name text from t_customers</list_query>
                    </list>
               </param>- > 
          </params>
     </query>
     <pdf>
          <!--<option><name>pameter name</name><value>parameter value</value></option>- > 
     </pdf>
     <chart>
          <!--<precision>Numeric value from 0 to 5</precision>- > 
     </chart>
     <!--<ContainsHTML>0/1</ContainsHTML>- > 
     <!--<headstyle>
          <titlerow bgcolor="value or color name"></titlerow>
          <firstcolumn bgcolor="value or color name"></firstcolumn>
     </headstyle>
</custom>

El archivo XML contiene las siguientes secciones principales:

• <connection>: contiene información sobre la conexión para la base de datos.
• <query>: contiene la consulta de SQL.
• <pdf>:contiene opciones de impresión de PDF para la salida, como el tamaño de papel, la orientación, etc.

Cada parámetro de <connection> y <query> tiene su propio nodo <param> con los atributos siguientes:

• name: el nombre del parámetro.
• disp_name: el nombre del parámetro como se muestra en la ventana emergente.
• type: el tipo de parámetro, que puede ser uno de los siguientes:
• TEXT: entrada de texto.
• PASSWORD: el texto se muestra como asteriscos.
• DATE: campo de calendario.
• LIST: lista desplegable con varias selecciones.
• list_query: lista desplegable con varias selecciones que habilitan una lista de valores dinámicos. Por ejemplo:

  <list>
  
       <list_query>select some_value value, some_text text from some_table</list_query>
  
  </list>
  

  Nota: la declaración seleccionada siempre debe contener dos columnas, una para valores y otra para el texto para mostrar.

• size: el número máximo de caracteres permitidos en el campo de entrada.

Los parámetros del <pdf> tienen los siguientes atributos:

• name: el nombre del parámetro.
• value: el valor del parámetro.