Anwenderhandbuch › Berichte › Berichtstypen › Parametrierte Berichte

Parametrierte Berichte

In einem parametrisierten Bericht (siehe Berichtstypen) wurde für mindestens einen der Parameter in dem Code, aus dem der Bericht erstellt wird, kein Wert angegeben. Bei jeder Generierung des Berichts werden spezifische Werte (über WebServices oder die grafische Anwenderschnittstelle) für die einzelnen Felder hinzugefügt.

In vielen Fällen ist der einzige Unterschied zwischen dem Code, der zum Generieren von zwei unterschiedlichen Berichten verwendet wird, der spezifische Wert eines oder mehrerer Parameter in einer ansonsten identischen Gruppe von Parametern, z. B. Kunde_A im Vergleich zu Kunde_B oder Februar 2011 im Vergleich zu Januar 2012.

Berichte, deren Generierungscode nur Parameter ohne Werte enthält, werden als parametrisierte Berichte bezeichnet. Wie bei über die Benutzeroberfläche generierten Berichten können Sie Webservices verwenden, um einen Bericht aufzurufen und die Werte von Parametern über die Methode "GetMyReportsAdvanced" zu übergeben.

Um einen Bericht zu generieren, werden spezifische Werte für jeden Parameter in den XML-Code des Berichts eingefügt. Dieser wird dann ausgeführt, um die einzelnen Berichte zu generieren. Zum Beispiel kann der Wert "Consumption" für den Parameter "Metric type" eingegeben werden, um einen Verbrauchsbericht zu generieren.

Der folgende XML-Code zum Generieren eines parametrisierten Berichts wurde durch Auswahl der in der folgenden Abbildung dargestellten Parameter erstellt. Anschließend wurde der Bericht mit "Speichern unter" gespeichert. Auf den Bericht kann jetzt über die grafische Anwenderschnittstelle oder über WebServices zugegriffen werden.

Für jeden der drei Parameter (Metric_Type, Customer, Service_Domain) müssen spezifische Werte eingefügt werden, um den Code ausführen zu können.

<REPORT_PARAMETERS xmlns="">
         <REPORT_ITEM>
             <REPORT>
                <PARAMETERS>
                    <METRIC_TYPE IS_MANDATORY="N"></METRIC_TYPE>
                    <CUSTOMER IS_MANDATORY="N"></CUSTOMER>
                    <SERVICE_DOMAIN IS_MANDATORY="N"></SERVICE_DOMAIN>
                </PARAMETERS>
                <TIME IS_MANDATORY="Y">
                   <FROM_BEGINING>
                      <TIME_UNIT>MONAT</TIME_UNIT>
                   </FROM_BEGINING>
                 </TIME>
             </REPORT>
          </REPORT_ITEM>
</REPORT_PARAMETERS>