Manuel de l'utilisateur › Rapports › Types de rapports › Rapports Free-Form › Paramètres de rapport au format libre

Paramètres de rapport au format libre

Les deux chaînes introduites dans les champs Chaîne de connexion et Requête de la page Détails du rapport au format libre suffisent à générer un rapport au format libre. Vous pouvez, toutefois, améliorer la flexibilité et l'utilité du rapport en ajoutant des paramètres au fichier XML par défaut contenu dans le champ Paramètres. Une fois tous les paramètres définis, une fenêtre contextuelle de saisie des valeurs de ces paramètres à la génération du rapport s'affiche.

Le fichier XML par défaut se présente comme suit :

<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>valeur de paramètre</value></option>- > 
     </pdf>
     <chart>
          <!--<precision>Valeur numérique de 0 à 5</precision>- > 
     </chart>
     <!--<ContainsHTML>0/1</ContainsHTML>- > 
     <!--<headstyle>
          <titlerow bgcolor="value or color name"></titlerow>
          <firstcolumn bgcolor="value or color name"></firstcolumn>
     </headstyle>
</custom>

Le fichier XML contient les sections principales suivantes :

• <connection> : contient les informations de connexion pour la base de données interrogée
• <query> : contient la requête SQL
• <pdf> : contient les options d'impression en PDF (format du papier, orientation, etc.)

Chaque paramètre dans <connection> et <query> possède son propre noeud de <param> qui inclut les attributs suivants :

• name : nom du paramètre
• disp_name : nom du paramètre tel qu'il apparaît dans la fenêtre contextuelle
• type : type de paramètre. Il peut s'agir de l'un des types suivants :
• TEXT : entrée de texte
• PASSWORD : texte s'affichant sous la forme d'astérisques
• DATE : champ du calendrier
• LIST : liste déroulante proposant plusieurs choix
• list_query : liste déroulante proposant plusieurs choix activant une liste dynamique de valeurs. Par exemple :

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

  Remarque : L'énoncé select doit toujours contenir deux colonnes, l'une pour la valeur et l'autre pour l'affichage du texte.

• size : nombre maximal de caractères autorisés dans le champ d'entrée.

Les paramètres dans <pdf> possèdent les attributs suivants :

• name : nom du paramètre
• value : valeur du paramètre