Activité SAP Appeler RFC

A l'exécution, utilisez l'activité SAP Appeler RFC pour appeler un appel RFC (appel de fonction distante) qui est activé à 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 RFC 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 RFC 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 de RFC, cliquez sur Parcourir.... La boîte de dialogue Liste RFC s'affiche.
  3. Dans la zone de fonction de recherche RFC, entrez une combinaison de caractères et du caractère générique * pour trouver le nom RFC souhaité, comme illustré dans les exemples suivants :
    • AB* — Trouve tous les appels RFC dont le nom commence par le préfixe AB.
    • AB*TRANSACTION — Trouve tous les appels RFC dont le nom commence par le préfixe AB et se termine par la chaîne TRANSACTION.

      Le système SAP est interrogé et les noms de RFC qui correspondent à l'expression générique sont répertoriés dans la table Fonctions SAP correspondantes.

  4. A partir de la table Fonctions SAP correspondantes, sélectionnez l'une des fonctions SAP et cliquez sur OK.

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 RFC 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 RFC s'affichent sous la forme de noeuds sous le paramètre d'entrée request du panneau Vers l'activité. En outre, si l'appel RFC 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 RFC. 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 l'appel RFC. 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 et tables RFC, aucune exception n'est émise lors de l'exécution.

Options de transaction :

  1. Dans la section Mapper les entrées de l'activité, cliquez avec le bouton droit de la souris sur la section Vers l'activité et sélectionnez Afficher les paramètres facultatifs. Une variable transactionOptions apparaît dans l'entrée de mappe. Cette propriété n'est disponible que dans Cast Iron Studio version 6.1.0.12.
  2. Sélectionnez l'une des valeurs suivantes :
    Remarque : Si vous n'affectez pas de valeur à la propriété transactionOptions, la valeur COMMIT_HANDLED_BY_RFC sera utilisée.
    Tableau 1.
    Valeur Description
    COMMIT_HANDLED_BY_RFC La validation du RFC est traitée par le RFC lui-même. Le connecteur ne valide pas explicitement les appels.
    COMMIT_TRANSACTION_AFTER_COMPLETION A l'exécution, le connecteur SAP appelle le RFC 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 connecteur SAP envoie un autre appel pour demander au système SAP de valider ou d'annuler la transaction :
    • Si le code retour retransmis par RFC indique un succès, le connecteur SAP envoie un autre appel demandant au système SAP de valider la transaction et commence immédiatement le traitement de l'activité suivante de l'orchestration.
    • Si le code retour retransmis par RFC indique un échec, le connecteur SAP envoie une demande d'annulation au système SAP et commence immédiatement le traitement de l'activité suivante de l'orchestration.
    COMMIT_TRANSACTION_AND_WAIT_UPON_COMPLETION A l'exécution, le connecteur SAP appelle le RFC 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 connecteur SAP envoie un autre message pour demander au système SAP de valider ou d'annuler la transaction :
    • Si le code retour retransmis par RFC indique un succès, le connecteur SAP envoie un autre appel 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 RFC indique un succès, le connecteur SAP envoie une demande d'annulation au système SAP. Avant de traiter son activité suivante, l'orchestration attend que le système SAP envoie un second message indiquant que l'annulation de la transaction a eu lieu.
  3. Une fois les opérations de transaction sélectionnées, renseignez les données d'entrée du RFC.
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 2. 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.

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 l'appel RFC s'affichent sous la forme de noeuds sous le paramètre d'entrée request du panneau Depuis l'activité. En outre, si l'appel RFC contient des tables, les schémas XML représentant ces tables s'affichent sous la forme de noeuds sous le noeud request du panneau Depuis l'activité.
  2. Créez une mappe entre les paramètres de sortie et les tables l'appel RFC 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_RFC_Activity.html