Anwenderhandbuch › Berichte › Berichtstypen › Freiformberichte › Parameter für Freiformberichte

Parameter für Freiformberichte

Die beiden in die Felder Verbindungsstring und Abfrage auf der Seite Eigenschaften des Freiformberichts eingegebenen Strings sind für die Erstellung eines Freiformberichte ausreichend. Sie können die Flexibilität und den Nutzen des Berichts jedoch erheblich steigern, indem Sie der Standard-XML-Datei im Feld Parameter weitere Parameter hinzufügen. Nachdem Sie alle Parameter definiert haben, wird ein Fenster eingeblendet, in das Sie die Werte für diese Parameter eingeben können, die beim Generieren des Berichte angezeigt werden.

Die Standard-XML-Datei sieht so aus:

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

Die XML-Datei enthält die folgenden Hauptsegmente:

• <connection>: Enthält die Verbindungsinformationen für die Datenbank, die die Abfrage erhält.
• <query>: Enthält die SQL-Abfrage
• <pdf>: Enthält die Druckeinstellungen für die Ausgabe als PDF-Datei, etwa Papiergröße, Ausrichtung usw.

Jeder Parameter innerhalb <connection> und <query> hat seinen eigenen <param>-Knoten, der die folgenden Attribute enthält:

• name: Der Name des Parameters.
• disp_name: Der Name des Parameters wie er im Einblendfenster angezeigt wird.
• type: Parametertyp, der einer der folgenden sein kann:
• TEXT: Texteingabe
• PASSWORD: Text, der als Sternchen angezeigt wird.
• DATE: Kalenderfeld
• LIST: Drop-down-Liste mit mehreren Auswahlmöglichkeiten
• list_query: Drop-down-Liste mit Auswahlmöglichkeiten für eine dynamische Werteliste. Zum Beispiel:

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

  Hinweis: Das Feld Erklärung auswählen sollte zwei Spalten enthalten, eine für Wert und eine weitere für den Anzeigetext.

• size: Die maximale Anzahl der zulässigen Zeichen im Eingabefeld.

Die Parameter innerhalb <pdf> haben die folgenden Attribute:

• name: Der Name des Parameters.
• value: Der Wert des Parameters