Exemple d'utilisation de l'action Exécuter le flux de travail standard du package BAPI SAP

L'action Exécuter le flux de travail standard du package BAPI SAP vous permet de créer un robot qui récupère des données auprès de systèmes SAP.

Prérequis

Téléchargez le connecteur Java SAP et la DLL sur le site Web de SAP.

Dans ce tutoriel, vous allez créer un robot qui utilise l'action Exécuter le flux de travail standard. L'action Exécuter le flux de travail standard fournit une interface utilisateur qui vous permet de sélectionner des BAPI (interfaces de programmation d'application métier) et de configurer les paramètres de la BAPI sélectionnée.

L'utilisation de cette action unique du package BAPI SAP vous permet d'effectuer les actions suivantes :

  • Sélectionner une BAPI (BAPI_FLIGHT_CHECKAVAILABILITY) dans une liste de modules de fonction disponibles dans le système SAP connecté.
  • Définir les valeurs des paramètres d'importation et d'exportation de la BAPI sélectionnée.
  • Affecter la structure ou les tableaux récupérés à des variables de dictionnaire ou de tableau.

Lors de son exécution, le robot obtient les données de disponibilité de vol en fonction des données d'entrée, et les écrit dans un fichier CSV.

Procédure

  1. Créez un robot nommé SAP-BAPI-CheckFlightAvailability.
    1. Connectez-vous à la Control Room.
    2. Dans le volet de gauche, cliquez sur Automatisation.
    3. Cliquez sur l'icône Créer un robot.
    4. Dans le champ Nom, saisissez SAP-BAPI-CheckFlightAvailability, puis cliquez sur Créer et modifier.
  2. Pour connecter le robot à votre système SAP, dans le panneau Actions, recherchez BAPI SAP > Se connecter et ajoutez-le à l'Éditeur de robots.
    1. Dans JCo : Package de connecteur Java SAP, spécifiez le chemin du fichier .jar du connecteur Java.
    2. Dans Dépendance DLL Jco,, spécifiez le chemin du fichier DLL.
    3. Choisissez Serveur d'applications personnalisé comme Type de connexion.
    4. Dans Nom d'hôte du serveur d'applications, spécifiez le nom d'hôte du serveur d'applications SAP.
      Remarque : La pratique recommandée consiste à utiliser le Credential Vault pour spécifier des informations sensibles telles que le nom d'hôte, le nom d'utilisateur et le mot de passe.
    5. Dans Numéro du système, saisissez le numéro d'instance.
    6. Dans Identifiant du système d'instances SAP, saisissez l'ID du système.
    7. Dans Numéro de client, saisissez le numéro de client.
    8. Dans Code de langue de connexion, saisissez FR ou la langue spécifique à votre système.
    9. Dans Chaîne de routeur, saisissez la chaîne de routeur SAP.
    10. Dans Nom d'utilisateur, saisissez votre nom d'utilisateur SAP.
    11. Dans Mot de passe, saisissez votre mot de passe.
    12. Exécutez le robot pour tester la connexion.
      Si les propriétés de connexion spécifiées sont correctes, le robot est exécuté avec succès.
  3. Dans le panneau Actions, recherchez l'action BAPI SAP > Exécuter le flux de travail standard après l'action Se connecter.
  4. Sélectionnez une BAPI.
    1. Cliquez sur l'option Sélectionner le flux de travail.
    2. Dans la section Sélectionner la BAPI standard de la fenêtre Sélecteur de BAPI standard, développez Modules SAP.
    3. Recherchez et développez Vol avec données de liaison (formation SAP).
    4. Dans Vol avec données de liaison (formation SAP), développez l'action Général > Créer, sélectionnez BAPI_FLIGHT_CHECKAVAILABILITY, puis cliquez sur Sélectionner.
  5. Spécifiez les valeurs des champs dans le paramètre d'importation. Procédez comme suit dans Importer vers BAPI :
    1. Cliquez sur l'icône des points de suspension en regard du champ AIRLINEID et sélectionnez Modifier.
    2. Dans le champ Valeur, saisissez DL et cliquez sur Appliquer.
    3. Cliquez sur l'icône des points de suspension en regard du champ CONNECTIONID et sélectionnez Modifier.
    4. Dans le champ Valeur, saisissez 1699 et cliquez sur Appliquer.
    5. Cliquez sur l'icône des points de suspension en regard du champ FLIGHTDATE et sélectionnez Modifier.
    6. Dans le champ Valeur, saisissez 20170418 et cliquez sur Appliquer.
      Le connecteur Java pour les systèmes SAP prend en charge les valeurs de date au format aaaammjj.
    BAPI_FLIGHT_CHECKAVAILABILITY renvoie des données dans le paramètre d'exportation DISPONIBILITÉ, qui est de type structure.
  6. Dans le champ Exporter vers BAPI, procédez comme suit :
    1. Cliquez sur l'icône des points de suspension en regard du champ DISPONIBILITÉ.
    2. Dans le champ Disponibilité, cochez la case Nom du champ pour sélectionner tous les champs de la structure, puis cliquez sur Appliquer.
  7. Stockez les données que la BAPI exporte dans une variable.
    1. Dans Enregistrer les structures et scalaires exportés, créez une variable en cliquant sur (x) et nommez-la ReturnStructure.
  8. Dans Enregistrer les structures et scalaires exportés, créez une variable en cliquant sur (x) et nommez-la ReturnStructure.
  9. Enregistrez l'action Exécuter le flux de travail standard.
  10. Convertissez les données exportées en un tableau.
    1. Dans le panneau Actions, recherchez l'action Dictionnaire > Obtenir et ajoutez-la après l'action Exécuter le flux de travail standard.
    2. Cliquez sur Variable du dictionnaire et sélectionnez ReturnStructure.
    3. Dans Clé, saisissez AVAILABILITY.
    4. Dans Attribuer la sortie à une variable, créez une variable en cliquant sur (x) et nommez-la Availability.
  11. Pour écrire les données de tableau récupérées dans un fichier CSV, ajoutez l'action Tableau de données > Écrire dans le fichier.
    1. Dans le champ Tableau de données, sélectionnez Availability.
    2. Dans le champ Saisir le nom du fichier, spécifiez le chemin d'accès au fichier CSV dans lequel vous voulez écrire les données.
    3. Sélectionnez Créer les dossiers/fichiers s'ils n'existent pas.
    4. Cliquez sur Écraser un fichier existant.
  12. Enregistrez le robot et exécutez-le.