Base de connaissances > Automation Engine et systèmes cibles > SAP > Utilisation du MBean Crystal Reports

Utilisation du MBean CrystalReports

 Le MBean intitulé "CrystalReports" que nous mettons à votre disposition est livré avec l'Agent JMX et doit être installé en complément.

MBean

Description

Nom

UC4:name=CrystalReports

Attribut

"StatusCheckInterval" - Intervalle dans lequel le statut du rapport est vérifié.

Valeur par défaut : 3 secondes

Opérations

"executeAndMail" - Exécution d'un rapport et envoi du Fichier de sortie par e-mail

Paramètres : données du rapport, attributs du rapport, destinataire de l'e-mail

"executeAndSave" - Exécution d'un rapport et enregistrement du Fichier de sortie

Paramètres : données du rapport, attributs du rapport

Déroulement

Pour pouvoir exécuter un rapport, quelques étapes sont nécessaires :

  1. Définissez les paramètres de l'opération que vous souhaitez exécuter. Pour ce faire, utilisez la fonction JMX_COMPOSITE_ADD, car une liste de valeurs est attendue. Le paramètre pour les données du rapport contient entre autres l'adresse du service Web et le nom du rapport, par exemple.
  2. Exécutez ensuite l'opération souhaitée avec la fonction JMX_INVOKE.

 Le MBean "CrystalReports" est enregistré automatiquement par l'Agent JMX. Vous n'avez pas besoin d'exécuter la fonction JMX_CREATE_MBEAN.

Exemple

L'entreprise Müller exécute un rapport sur les contrats du client portant le numéro 55355. Le résultat est envoyé sous forme de fichier Excel par e-mail à M. Meier.

La fonction JMX_COMPOSITE_ADD crée trois paramètres : "report", "settings" et "mail". Plusieurs valeurs sont attribuées à chacun de ces paramètres, qui sont ensuite transmis à l'opération "executeAndMail".

! Données du rapport
JMX_COMPOSITE_ADD NAME="report",KEY="URL",VALUE="http://localhost:5555/dswsbobje2/services"
JMX_COMPOSITE_ADD NAME="report",KEY="REPORT",VALUE="dossier principal/fichier client/3000 - MUELLER - commandes client"
JMX_COMPOSITE_ADD NAME="report",KEY="FORMAT",VALUE="EXCEL"
JMX_COMPOSITE_ADD NAME="report",KEY="MAIL_SUBJECT",VALUE="numéro client 55355"
JMX_COMPOSITE_ADD NAME="report",KEY="MAIL_BODY",VALUE="Bonjour M. Meier,
Ci-joint le rapport du numéro client 55355.
Il contient les commandes du mois de décembre.

Cordialement
Hans Huber
"
JMX_COMPOSITE_ADD NAME="report",KEY="MAIL_FROM",VALUE="huber@mueller.com"

! Attribut pour le rapport
JMX_COMPOSITE_ADD NAME="settings",KEY="numéro client",VALUE="55355"
JMX_COMPOSITE_ADD NAME="settings",KEY="intervalle de dates",VALUE="20061201;20061231"

! Adresse e-mail du destinataire
JMX_COMPOSITE_ADD NAME="mail",KEY="meier@mueller.com",VALUE="TO"

! Appel du MBeans
JMX_INVOKE OPERATIONNAME="executeAndMail",MBEAN="UC4:name=CrystalReports",PARAMS="report,settings,mail"

Paramètres

Comme vous le voyez dans l'exemple précédent, un concept clé est attribué aux valeurs transmises immédiatement au paramètre. L'Agent JMX peut ainsi distinguer les paramètres pour le rapport.

Paramètres

Description

Données du rapport

Concepts clés disponibles :

  • "URL" - Adresse du service Web
  • "REPORT" - Nom et chemin du rapport
  • "FORMAT" - Format de fichier du rapport ("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")
Spécial pour l'opération "executeAndMail" :
  • "MAIL_SUBJECT" - Sujet de l'e-mail
  • "MAIL_BODY" - Message de l'e-mail
  • "MAIL_FROM" - Adresse e-mail de l'expéditeur
Spécial pour l'opération "executeAndSave" :
  • "FILE" - Chemin et nom du Fichier de sortie

Attributs du rapport

Indiquez les attributs devant être pris en compte lors de l'exécution du rapport.

Les concepts clés dépendent du rapport.

Destinataire de l'e-mail

Indiquez l'adresse e-mail comme concept clé. La valeur pour le destinataire est "TO" ou "CC" s'il doit recevoir une copie.

Codes retour

Après l'exécution réussie du Crystal Report, le Job JMX reçoit le code retour "0". En cas d'erreur, "1" est renvoyé en cas d'erreur d'exécution de l'opération ou "3" en cas d'erreur du programme MBean. Le rapport contient des informations détaillées sur les causes de l'erreur.

Dans le rapport, le statut du Job s'affiche également :

Pour "0" et "9", l'exécution du rapport est examinée plus en détail.

 

Rubriques connexes : 

Prise en charge de Business Objects (Crystal Reports)