Activité SAP Envoyer IDOC

A l'exécution, utilisez l'activité SAP Envoyer IDOC pour envoyer un IDOC au noeud final SAP spécifié.

Si vous envoyez vos données SAP directement au système SAP à l'aide d'un port RFC, vous devez utiliser l'activitéSAP Envoyer IDOC. Si vous envoyez vos données SAP sous la forme d'un fichier SAP via un port de fichier SAP vers le système SAP, vous devez utiliser l'option de menu de barre d'outils de schéma Projet > Importer > SAP IDOC lors de la phase de conception pour générer un schéma de fichier à plat pour vos métadonnées IDOC et utiliser l'activité Ecrire fichier à plat pour écrire les données SAP. Pour plus d'informations, voir Génération d'un schéma de fichier à plat à partir d'un IDOC.

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.

A l'exécution, si l'activité SAP Envoyer IDOC traite deux instances d'un IDOC, les deux instances ayant le même numéro d'IDOC, l'activité SAP Envoyer IDOC ajoute le segment de données de la deuxième instance à la première instance.

Remarque : La persistance doit être activée pour une orchestration qui contient une activité SAP Envoyer IDOC. Pour plus d'informations, voir Activation de la persistance.

Ajout d'une activité SAP Envoyer IDOC 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é Envoyer IDOC 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. Passez à 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. Cliquez sur Parcourir....
  3. Sélectionnez une ligne d'IDOC existante et cliquez sur OK. Les zones Type de message, Type d'IDOC et Type étendu d'IDOC de la tâche Configurer sont remplies.

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 nouvelle tentative pour la connexion à un système SAP. Le tableau suivant décrit les options de nouvelle tentative de connexion à un système SAP :
    Options de nouvelle 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 Envoyer IDOC 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. Le paramètre d'entrée de l'activité s'affiche dans le panneau Vers l'activité. Le schéma XML généré à partir du type d'IDOC et du type étendu d'IDOC devient le paramètre d'entrée de l'activité.
  2. Cliquez avec le bouton droit sur la section Vers l'activité et sélectionnez Afficher les paramètres facultatifs.

    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.
  3. Créez une mappe entre les variables d'orchestration et les paramètres d'entrée et tables IDOC. 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 que vous puissiez déployer une orchestration avec des activités SAP à l'aide de la console de gestion Web, 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.