Exemple d'utilisation de la commande Obtenir la structure du package BAPI SAP

Le package BAPI SAP vous permet de créer un robot qui utilise une structure pour obtenir des données.

Prérequis

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

Dans ce tutoriel, vous allez construire un robot qui invoque BAPI_FLIGHT_GETLIST à partir de l'application de démonstration SAP Flight Data. Lorsqu'il est exécuté, le robot appelle la fonction BAPI en saisissant l'identifiant de la compagnie aérienne et les détails de la destination, obtient une liste de vols et écrit les données de réponse dans un fichier CSV.

Vous utiliserez les paramètres d'importation suivants pour limiter votre recherche :
  • AIRLINE : Utilisez ce paramètre pour transmettre l'identifiant de la compagnie aérienne.
  • DESTINATION_FROM : utilisez ce paramètre pour obtenir la structure et transmettre le nom de la ville et l'identifiant de l'aéroport.
Dans ce tutoriel, nous vous expliquons comment effectuer les actions suivantes :
  • Obtenir la structure d'un paramètre d'importation.
  • Définir les valeurs des champs dans la structure récupérée.
  • Obtenir des données de réponse dans un tableau en fonction des données d'entrée.

Procédure

  1. Créez un Robot de tâches nommé SAP-BAPI-FlightListReport.
    1. Connectez-vous à 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-FlightListReport, 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. Pour créer une fonction, ajoutez l'action BAPI SAP > Créer une fonction.
    1. Dans Nom d'alias de la fonction, saisissez getFlightListByAirline.
    2. Dans Nom de la BAPI, saisissez BAPI_FLIGHT_GETLIST.
  4. Pour filtrer les données par nom de compagnie aérienne, ajoutez l'action BAPI SAP > Définir la valeur du champ.
    1. Dans Nom d'alias de la fonction, saisissez getFlightListByAirline.
    2. Cliquez sur l'onglet Fonction.
    3. Dans Nom du champ, saisissez AIRLINE comme nom du paramètre d'entrée.
    4. Dans Valeur du champ, saisissez AZ.
  5. Pour limiter la sélection à l'aéroport et à la ville de destination, obtenez la structure du paramètre d'importation DESTINATION_FROM, puis définissez les valeurs des champs dans la structure récupérée. Pour ce faire, ajoutez l'action BAPI SAP > Obtenir la structure.
    1. Dans Nom d'alias de la fonction, saisissez getFlightListByAirline.
    2. Dans Nom de la structure, saisissez DESTINATION_FROM.
    3. Pour affecter la structure récupérée à un alias, cliquez sur l'onglet Alias dans la section Destination, puis saisissez destinationFrom dans le champ Créer un alias de structure.
      Vous pouvez maintenant utiliser l'alias pour définir les valeurs des champs dans la structure récupérée.
  6. Pour définir une valeur dans le champ ID DE L'AÉROPORT du paramètre DESTINATION_FROM, ajoutez l'action BAPI SAP > Définir la valeur du champ.
    1. Dans Nom d'alias de la fonction, saisissez getFlightListByAirline.
    2. Dans Source, cliquez sur l'onglet Structure.
    3. Dans Alias de la structure, saisissez destinationFrom.
    4. Dans Nom du champ, saisissez AIRPORTID.
    5. Dans Valeur du champ, saisissez FCO.
  7. Pour définir une valeur dans le champ VILLE du paramètre DESTINATION_FROM, ajoutez l'action BAPI SAP > Définir la valeur du champ.
    1. Dans Nom d'alias de la fonction, saisissez getFlightListByAirline.
    2. Dans Source, cliquez sur l'onglet Structure.
    3. Dans Alias de la structure, saisissez destinationFrom.
    4. Dans Nom du champ, saisissez CITY.
    5. Dans Valeur du champ, saisissez ROME.
  8. Pour exécuter BAPI_FLIGHT_GETLIST, ajoutez l'action BAPI SAP > Exécuter la fonction.
    1. Dans Nom d'alias de la fonction, saisissez getFlightListByAirline.
  9. Pour obtenir les données filtrées du tableau FLIGHT_LIST, ajoutez l'action BAPI SAP > Obtenir le tableau.
    1. Dans Nom d'alias de la fonction, saisissez getFlightListByAirline.
    2. Dans le champ Nom de tableau, cliquez sur l'onglet FLIGHT_LIST.
    3. Dans le champ Destination, cliquez sur Variable pour stocker en mémoire les données de tableau récupérées.
    4. Dans le champ Enregistrer la sortie dans une variable, créez une variable nommée tblFlightList en cliquant sur (x).
  10. 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 tblFlightList.
    2. Dans le champ Saisir le nom de fichier, spécifiez le chemin du fichier CSV dans lequel vous souhaitez écrire les données.
    3. Sélectionnez Créer les dossiers/fichiers s'ils n'existent pas.
    4. Cliquez sur Écraser un fichier existant.
  11. Enregistrez le robot et exécutez-le.