Activité SAP Appeler BAPI

A l'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) - A l'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 -  A l'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 -  A l'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é.

    Le connecteur SAP permet aussi au noeud final de se connecter dynamiquement à un autre système SAP. A l'exécution, ajoutez des paramètres optionnels dans la partie sapConnectionProperties de la mappe des entrées si vous voulez vous connecter dynamiquement à un système SAP autre que celui qui est configuré dans le panneau du noeud final, si vous voulez vous connecter au même système SAP, mais avec une combinaison nom d'utilisateur/mot de passe autre que celle qui est spécifiée dans le panneau du noeud final ou si vous souhaitez un jeton SSO autre que celui qui est ajouté dans le panneau du noeud final. Les paramètres du noeud sapConnectionProperties sont décrits dans le tableau suivant :
    Tableau 1. Propriétés de connexion
    Paramètre optionnel Description
    Paramètres sapConnectionProperties
    hostName Adresse IP ou nom de la machine contenant le système SAP.
    systemNumber Numéro qui identifie l'instance spécifique du système SAP auquel Studio soit se connecter. Votre administrateur SAP doit fournir cette information.
    client Numéro qui identifie Studio et le dispositif d'intégration comme client pour le système SAP. Votre administrateur SAP doit fournir cette information.
    language Option de langue des messages pour SAP. Par exemple, EN est le code ISO pour l'anglais.
    Paramètres basicAuthentication
    username Nom d'utilisateur à utiliser lors de la connexion au système SAP.
    password Mot de passe pour le nom d'utilisateur lors de la connexion au système SAP.
    Paramètres ssoAuthentication
    ssotoken Spécifie le jeton de connexion unique (SSO, Single Sign-On).
    Paramètres sncAuthentication
    sncmode Indique si le mode SNC (Secure Network Connections) est activé.
    sncname Nom distinctif de la connexion SNC.
    partner Nom distinctif du partenaire SNC.
    qop Niveau de sécurité de SNC.
    Certificat X509 Certificat X509 à utiliser comme ticket de connexion. Ce champ est optionnel uniquement si l'option Authentification à base de nom d'utilisateur/mot de passe est utilisée avec SNC.
    Paramètres connectionPool
    maximumConnections Connexions SAP supplémentaires, dans la limite du nombre spécifié, ouvertes par le dispositif d'intégration en fonction de la charge de messages.
    maxIdleTime Spécifie le nombre de minutes pendant lequel une connexion SAP peut être ouverte et inactive avant d'être fermée par le dispositif d'intégration.
  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. A l'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.




Commentaires | Notices


Icône d'horodatage Dernière révision: Friday, November 1, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/SAP_Invoke_BAPI_Activity.html