Activité SAP Appeler BAPI

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

Remarque : Pour vous connecter au système SAP depuis Studio, vous devez télécharger et installer les fichiers JAR et les DLL SAP sur votre machine de développement Windows. Pour plus d'informations, voir Téléchargement et installation de fichiers JAR et de DLL SAP.

Ajout d'une activité SAP Appeler BAPI dans l'orchestration

  1. Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration apparaît.
  2. Sélectionnez l'onglet Activités et développez l'arborescence du dossier SAP.
  3. Faites glisser l'activité SAP Appeler BAPI sur l'orchestration.
  4. Sélectionnez l'activité. La Liste de contrôle est affichée.

Création, sélection ou édition d'un noeud final SAP

  1. 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 :
      1. Sélectionnez Parcourir. L'explorateur de projets apparaît.
      2. 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.
      1. Sélectionnez Parcourir. L'explorateur de projets apparaît.
      2. Sélectionnez un noeud final existant et cliquez sur OK.
      3. 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.
  2. Créez ou éditez un noeud final SAP.

Configuration de l'activité

  1. Sélectionnez la tâche Configurer dans la Liste de contrôle. Le panneau Configurer apparaît.
  2. Dans la zone Nom d'objet, cliquez sur Parcourir.... La boîte de dialogue Liste BAPI s'affiche.
  3. Recherchez un objet métier. Cliquez sur un objet métier dans la liste et entrez les premiers caractères de son nom.
  4. Développez l'arborescence de l'objet métier pour afficher les méthodes BAPI associées.
  5. Sélectionnez un objet métier et une méthode, puis cliquez sur OK.
  6. 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

  1. Sélectionnez la tâche Réessayer dans la Liste de contrôle. Le panneau Réessayer s'affiche.
  2. 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é

  1. 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é.
  2. 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é

  1. 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é.
  2. 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.