En phase d'exécution, utilisez l'activité SAP Appeler BAPI pour appeler une méthode BAPI (méthode d'objet métier) qui est activée à distance sur le noeud final SAP spécifié.
Ajout d'une activité SAP Appeler BAPI dans l'orchestration
- Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration apparaît.
- Sélectionnez l'onglet Activités et développez l'arborescence du dossier
SAP.
- Faites glisser l'activité SAP Appeler BAPI sur
l'orchestration.
- Sélectionnez l'activité. La Liste de contrôle est affichée.
Création, sélection ou édition d'un noeud final SAP
- Cliquez sur la tâche Sélectionner le noeud final dans la liste de contrôle et sélectionnez l'une des actions suivantes :
- Sélectionnez un noeud final existant :
- Sélectionnez Parcourir. L'explorateur de projets apparaît.
- Sélectionnez un noeud final existant et cliquez sur OK.
Allez à la procédure Configuration de l'activité.
- Sélectionnez un noeud final existant et éditez-le.
- Sélectionnez Parcourir. L'explorateur de projets apparaît.
- Sélectionnez un noeud final existant et cliquez sur OK.
- Cliquez sur Editer. Le panneau Editer un noeud final apparaît.
- Créez un nouveau noeud final : Sélectionnez Nouveau. Le panneau Créer un noeud final s'affiche.
- Créez ou éditez un noeud final SAP.
Configuration de l'activité
- Sélectionnez la tâche Configurer dans la Liste de contrôle.
Le panneau Configurer apparaît.
- Dans la zone Nom d'objet, cliquez sur Parcourir....
La boîte de dialogue Liste BAPI s'affiche.
- Recherchez un objet métier. Cliquez sur un objet métier dans la
liste et entrez les premiers caractères de son nom.
- Développez l'arborescence de l'objet métier pour afficher les méthodes BAPI associées.
- Sélectionnez un objet métier et une méthode, puis cliquez sur OK.
- Sélectionnez l'une des options de transaction suivantes :
- Ne rien faire (la transaction est traitée directement par BAPI) -
En phase d'exécution, le dispositif d'intégration qui appelle BAPI n'effectue aucun traitement de transaction. Si une transaction est associée à BAPI, BAPI doit entièrement traiter la transaction
- Valider la transaction après son achèvement - En phase d'exécution, le dispositif d'intégration appelle BAPI et attend un message de retour du système SAP. Le code retour du message
renvoyé par le système SAP détermine si le dispositif d'intégration envoie un autre message demandant au système SAP de valider ou d'annuler la transaction:
- Si le code retour retransmis par BAPI indique un succès, le dispositif d'intégration envoie un autre message demandant au système SAP de valider
la transaction et de commencer immédiatement le traitement de l'activité suivante de l'orchestration.
- Si le code retour retransmis par BAPI indique un échec, le dispositif d'intégration envoie une demande d'annulation au système SAP et commence immédiatement le traitement de l'activité suivante de l'orchestration.
- Valider la transaction et attendre son achèvement - En phase d'exécution, le dispositif d'intégration appelle BAPI et attend un message de retour du système SAP. Le code retour du message
renvoyé par le système SAP détermine si le dispositif d'intégration envoie un autre message demandant au système SAP de valider ou d'annuler la transaction:
- Si le code retour retransmis par BAPI indique un succès, le dispositif d'intégration envoie un autre message demandant au système SAP de valider
la transaction. L'orchestration attend que le système
SAP envoie un deuxième message indiquant que la transaction a été validée avant de traiter son activité suivante.
- Si le code retour retransmis par BAPI indique un échec, le dispositif d'intégration envoie une demande d'annulation au système SAP.
L'orchestration attend que le système
SAP envoie un deuxième message indiquant que l'd'annulation de la transaction a eu lieu avant de traiter son activité suivante.
Spécification des options de nouvelle tentative
- Sélectionnez la tâche Réessayer dans la Liste de contrôle.
Le panneau Réessayer s'affiche.
- Configurez les options de tentative pour la connexion à un système SAP. Le tableau suivant décrit les options de tentative de connexion à un système SAP :
Options de tentative |
Description |
1) Attendre ___ secondes entre chaque tentative. |
Indique le nombre de secondes pendant lesquelles le dispositif d'intégration attend avant de tenter d'établir une connexion avec le système SAP. |
2) Tenter de se connecter ___ fois avant l'échec. |
Indique le nombre maximum de fois que le dispositif d'intégration tente d'établir une connexion avec le système SAP avant d'émettre une erreur et d'arrêter le traitement du travail d'orchestration en cours. Si vous déployez une orchestration qui contient une activité SAP Appeler BAPI et que le dispositif d'intégration ne peut pas se connecter au système SAP spécifié, le dispositif d'intégration consigne les erreurs de connexion en tant qu'avertissements dans les journaux du système et de l'orchestration jusqu'à ce que la valeur de nombre de tentatives soit atteinte. Lorsque le nombre de tentatives est atteint, le dispositif d'intégration consigne une erreur dans les journaux du système et de l'orchestration et arrête le traitement du travail d'orchestration en cours. Par exemple, si vous indiquez la valeur 3 pour le nombre de tentatives, les erreurs de première, seconde et troisième connexions apparaissent dans le journal système en tant qu'avertissements.
Le dispositif d'intégration consigne la quatrième erreur de connexion en tant qu'erreur et arrête le traitement du travail d'orchestration en cours. |
Mappage des entrées de l'activité
- Sélectionnez la tâche Mapper les entrées dans la Liste de contrôle.
Les schémas XML générés à partir des paramètres d'entrée de BAPI s'affichent sous la forme de noeuds sous le paramètre d'entrée request du panneau
Vers l'activité. En outre, si BAPI contient des tables, les schémas XML représentant ces tables
s'affichent sous la forme de noeuds sous le paramètre d'entrée request du panneau
Vers l'activité.
- Créez une mappe entre les variables d'orchestration et les paramètres d'entrée et tables BAPI. Voir Création d'une mappe pour accéder à des instructions générales sur le mappage.
Des valeurs doivent être fournies lors de l'exécution pour les éléments obligatoires des paramètres d'entrée ou des tables BAPI.
Une valeur peut être indiquée en spécifiant une valeur par défaut pour l'élément ou en reliant l'élément avec un noeud d'entrée. En phase d'exécution, si aucune valeur n'est fournie pour un élément obligatoire, l'activité émet une exception qui est signalée par la console de gestion Web (WMC).
Si une valeur n'est pas fournie pour un élément facultatif des paramètres d'entrée ou tables BAPI, aucune exception n'est émise lors de l'exécution.
Mappage des sorties de l'activité
- Sélectionnez la tâche Mapper les sorties dans la liste de contrôle.
Le schéma XML généré à partir de types de retour de BAPI s'affichent sous la forme de noeuds sous le paramètre d'entrée response du panneau
Depuis l'activité. En outre, si BAPI contient des tables, les schémas XML représentant ces tables
s'affichent sous la forme de noeuds sous le noeud response du panneau
Depuis l'activité.
- Créez une mappe entre les paramètres de sortie et les tables BAPI et les variables d'orchestration. Voir Création d'une mappe pour accéder à des instructions générales sur le mappage.
Remarque concernant le déploiement d'une orchestration SAP
Pour pouvoir déployer une orchestration avec des activités SAP à l'aide de la console WMC, le dispositif d'intégration doit d'abord être en mesure d'établir une connexion vers le système SAP. Si le dispositif d'intégration ne peut pas établir de connexion vers le système SAP, l'orchestration n'est pas déployée.