Knowledge Base > Automation Engine und Zielsysteme > SAP > Verwenden des MBeans CrystalReports

Verwenden des MBeans CrystalReports

Das von uns zur Verfügung gestellte MBean namens "CrystalReports" wird zusammen mit dem JMX-Agenten ausgeliefert und muss zusätzlich installiert werden.


MBean

Beschreibung

Name

UC4:name=CrystalReports

Attribut

"StatusCheckInterval" - Intervall in dem der Status des Reports geprüft wird.

Standardwert: 3 Sekunden

Operationen

"executeAndMail" - Ausführen eines Reports und Senden der Ausgabedatei als Mail

Parameter: Angaben zum Report, Attribute für den Report, E-Mail-Empfänger

"executeAndSave" - Ausführen eines Reports und Speichern der Ausgabedatei

Parameter: Angaben zum Report, Attribute für den Report

Ablauf

Um einen Report ausführen zu können, sind einige Schritte notwendig:

  1. Setzen Sie die Parameter für die Operation, die Sie aufrufen möchten. Verwenden Sie dazu die Funktion JMX_COMPOSITE_ADD, da eine Liste von Werten erwartet wird. Der Parameter für die Angaben zum Report beispielsweise enthält unter anderem die Adresse des Web Services und den Namen des Reports.
  2. Rufen Sie anschließend die gewünschte Operation mit der Funktion JMX_INVOKE auf.

Das MBean "CrystalReports" wird automatisch vom JMX-Agenten registriert. Sie brauchen die Funktion JMX_CREATE_MBEAN nicht aufzurufen.

Beispiel

Die Firma Müller führt einen Report über die Aufträge des Kunden mit der Nummer 55355 aus. Das Ergebnis wird in einer Excel-Datei per Mail zu Hrn. Meier gesendet.

Die Funktion JMX_COMPOSITE_ADD erstellt die drei Parameter "report", "settings" und "mail". Jedem dieser Parameter werden mehrere Werte zugeordnet und anschließend der Operation "executeAndMail" übergeben.

! Report details
JMX_COMPOSITE_ADD NAME="report",KEY="URL",VALUE="http://localhost:5555/dswsbobje2/services"
JMX_COMPOSITE_ADD NAME="report",KEY="REPORT",VALUE="Main_Folder/Customer_List/3000 - SMITH - Sales_Orders"
JMX_COMPOSITE_ADD NAME="report",KEY="FORMAT",VALUE="EXCEL"
JMX_COMPOSITE_ADD NAME="report",KEY="MAIL_SUBJECT",VALUE="Customer Number 55355"
JMX_COMPOSITE_ADD NAME="report",KEY="MAIL_BODY",VALUE="Dear Mr. Black,
Please find enclosed the report for customer number 55355.
It contains all orders made in December.

Best regards
Jack White

JMX_COMPOSITE_ADD NAME="report",KEY="MAIL_FROM",VALUE="white@smith.com"

! Report attributes
JMX_COMPOSITE_ADD NAME="settings",KEY="Customer_number",VALUE="55355"
JMX_COMPOSITE_ADD NAME="settings",KEY="Date_area",VALUE="20061201;20061231"

! Email receiver
JMX_COMPOSITE_ADD NAME="mail",KEY="black@smith.com",VALUE="TO"

! Calling the MBean
JMX_INVOKE OPERATIONNAME="executeAndMail",MBEAN="UC4:name=CrystalReports",PARAMS="report,settings,mail"

Parameter

Wie Sie im obigen Beispiel sehen, werden die Werte einem Schlüsselbegriff zugeordnet und erst dann dem Parameter übergeben. Der JMX-Agent kann auf diese Weise die Einstellungen für den Reports unterscheiden.

Parameter

Beschreibung

Angaben zum Report

Verfügbare Schlüsselbegriffe:

  • "URL" - Adresse des Web Services
  • "REPORT" - Name und Pfad des Reports
  • "FORMAT" - Dateiformat für die Reportausgabe ("CRYSTAL_REPORT", "EXCEL", "WORD", "PDF", "RTF", "TEXT_PLAIN", "TEXT_PAGINATED", "TEXT_TAB_SEPARATED", "TEXT_CHARACTER_SEPARATED", "EXCEL_DATA_ONLY", "TEXT_TAB_SEPARATED_TEXT", "RTF_EDITABLE", "USER_DEFINED")
Speziell für die Operation "executeAndMail":
  • "MAIL_SUBJECT" - Betreff der E-Mail
  • "MAIL_BODY" - Nachricht der E-Mail
  • "MAIL_FROM" - E-Mail-Adresse des Absenders
Speziell für die Operation "executeAndSave":
  • "FILE" - Pfad und Name für die Ausgabedatei

Attribute für den Report

Geben Sie die Attribute an, die bei der Reportausführung berücksichtigt werden sollen.

Die Schlüsselbegriffe hängen vom Report ab.

E-Mail-Empfänger

Als Schlüsselbegriff ist die E-Mail-Adresse anzugeben. Der Wert ist entweder "TO" für den Empfänger oder "CC" für den Empfänger, der eine Kopie erhalten soll.

Rückgabewerte

Nach der erfolgreichen Durchführung des Crystal Reports gibt der JMX-Job den Rückgabewert "0" zurück. Im Fehlerfall wird entweder "1" bei einem Fehler im Operationsaufruf oder "3" bei einem MBean-Programmfehler zurückgeliefert. Sie finden im Report nähere Informationen über die Ursache des Fehlers.

Im Report wird auch der Jobstatus ausgegeben:

Im Falle von "0" und "9" wird die Reportausführung weiter überwacht.

 

Siehe auch:

Unterstützung für Business Objects (Crystal Reports)

 

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

 Copyright © 2016 Automic Software GmbH