Exemple d'utilisation de l'appel de fonction à distance dans SAP

Cet exemple décrit comment construire un robot qui créera un document dans SAP à l'aide de la méthode d'appel de fonction à distance.

Prérequis

Téléchargez le SAPJava package de connecteurs et DLL depuis le site Web SAP.

Procédure

  1. Ouvrez un nouveau robot :
    1. Dans le panneau de gauche, cliquez sur Automatisation.
    2. Cliquez sur Créer un nouveau > robot.
    3. Dans la fenêtre Créer un robot de tâches, saisissez un nom de robot.
    4. Cliquez sur Créer et modifier.
  2. Établissez une connexion avec l'application SAP à l'aide de l'action Connecter.
    1. Dans le champ Session SAP BAPI, saisissez Default.
    2. Sélectionnez l'option Bureau, puis parcourez et sélectionnez le package de connecteur Java SAP disponible sur votre périphérique.
      Exemple : F:\SAP \SAP Jco 3.1.3\Microsoft Windows et Windows Server\64-bit\sapjco3.jar
    3. Sélectionnez l'option Bureau, puis parcourez et sélectionnez la DLL du connecteur Java SAP disponible sur votre périphérique.
      Exemple : F:\SAP \SAP Jco 3.1.3\Microsoft Windows et Windows Server\64-bit\sapjco3.dll
    4. Sélectionnez l'option Groupe/Serveur comme type de connexion.
    5. Sélectionnez Chaîne non sécurisée et saisissez AWINAAWO12.bcone.com pour spécifier le nom d'hôte du serveur de messages SAP.
    6. Saisissez AWINAAWO12.bcone.com dans le champ Hôte de passerelle pour vous connecter au serveur.
    7. Saisissez les valeurs suivantes :
      Champ Valeur
      Groupe de connexion Public
      Numéro du système 01
      Identifiant du système d'instance SAP AAI
      Numéro de client 800
      Code de la langue de connexion EN
      Chaîne de routeur /H/115.112.148.66/S/3299
    8. Sélectionnez Chaîne non sécurisée et saisissez ISR3 pour spécifier le nom d'utilisateur que vous souhaitez utiliser pour vous connecter au serveur SAP.
    9. Sélectionnez Chaîne non sécurisée et saisissez Automation@123 pour indiquer le mot de passe que vous souhaitez utiliser pour vous connecter au serveur SAP.
  3. Utilisez l'action Créer une fonction pour créer une fonction pour la fonction BAPI SAP.
    1. Créez un alias pour une fonction BAPI SAP et enregistrez-la avec un nom d'alias.
    2. Dans le champ Nom de session, saisissez Default.
    3. Dans le champ Nom d'alias de la fonction saisissez BAPI_Post.
    4. Dans le champ Nom de la BAPI, saisissez BAPI_ACC_DOCUMENT_POST.
      Remarque : Le nom de la fonction BAPI SAP et les autres paramètres sont spécifiques à l'environnement du client lors de la création du robot Automation 360.
  4. Pour créer BAPI_ACC_DOCUMENT_POST dans SAP, vous devez d'abord créer une structure et des tableaux. Sélectionnez Obtenir la structure pour obtenir les données d'une structure à l'aide de l'alias de fonction.
    1. Dans le champ Alias de la fonction BAPI, saisissez BAPI_POST, l'alias que vous avez fourni pour la fonction BAPI SAP à l'aide de l'action Créer une fonction.
    2. Dans le champ Nom de la structure, saisissez DOCUMENTHEADER (le nom de la structure à partir de laquelle vous souhaitez obtenir des données).
    3. Dans le champ Session BAPI SAP, saisissez Default (le nom de la session que vous avez utilisé pour vous connecter à l'application SAP dans l'action Se connecter).
    4. Sélectionnez l'option Alias pour enregistrer les données récupérées dans la structure et saisissez Doc dans le champ Créer un alias de la structure.
  5. Sélectionnez l'action Obtenir le tableau pour obtenir les données tabulaires d'un tableau à l'aide de l'alias de fonction.
    1. Dans le champ Alias de la fonction BAPI, saisissez BAPI_Post, l'alias que vous avez fourni pour la fonction BAPI SAP à l'aide de l'action Créer une fonction.
    2. Dans le champ Nom de tableau, saisissez ACCOUNTGL (le nom du tableau à partir duquel vous souhaitez obtenir des données).
    3. Dans le champ Session BAPI SAP, saisissez Default (le nom de la session que vous avez utilisé pour vous connecter à l'application SAP dans l'action Se connecter).
    4. Sélectionnez l'option Alias pour enregistrer les données extraites du tableau et saisissez GL dans le champ Créer un alias du tableau.
  6. Répétez l'étape 5. À l'étape 5(b), saisissez la valeur CURRENCYAMOUNT dans le champ Nom de tableau et à l'étape 5(d), saisissez la valeur Currency dans le champ Créer un alias du tableau.
  7. Sélectionnez l'action Définir une valeur de champ pour définir les données dans la structure et le tableau vides créés précédemment.
    1. Dans le champ Alias de la fonction BAPI, saisissez BAPI_Post.
    2. Dans le champ Source, sélectionnez Structure.
    3. Saisissez DOC dans le champ Alias de la structure.
    4. Dans le champ Nom du champ, saisissez USERNAME (le nom du champ dans lequel vous souhaitez définir des données).
    5. Dans le champ Valeur de champ, saisissez sy-uname (la valeur que vous souhaitez définir).
    6. Dans le champ Session BAPI SAP, saisissez Default.
  8. Répétez l'étape 7 sept fois et saisissez les mêmes valeurs que celles que vous avez saisies précédemment aux étapes 7(a,) 7(b), 7(c) et 7(f). Saisissez les valeurs suivantes pour les étapes 7(d) et 7(e).
    Nom du champ Valeur de champ
    BUS_ACT RFBU
    HEADER_TXT TEST BOC BAPI POSTING
    COMP_CODE 1000
    DOC_DATE 20210127
    PSTNG_DATE 20210127
    DOC_TYPE SA
    FIS_PERIOD 00
  9. Sélectionnez l'action Obtenir la structure.
    1. Dans le champ Alias de la fonction BAPI, saisissez BAPI_POST.
    2. Dans le champ Nom de la structure, saisissez DOCUMENTHEADER.
    3. Dans le champ Session BAPI SAP, saisissez Default.
    4. Sélectionnez l'option Variable pour stocker les données extraites de la structure dans une variable de tableau. Créez une variable de tableau Sap-Bapi-Table.
  10. Double-cliquez sur ou faites glisser l'action Données de tableau > Écrire dans le fichier.
    1. Sélectionnez la variable de tableau Sap-Bapi-Table qui contient les données à écrire dans la liste Nom du tableau de données.
    2. Spécifiez l'emplacement du fichier dans lequel vous souhaitez écrire les données dans le champ Saisir le nom de fichier. Par exemple, D:/défini par l'utilisateur/Mon bureau/SAP Test/DOCUMENTHEADER.csv.
    3. Cochez la case Créer les dossiers/fichiers s'ils n'existent pas.
    4. Sélectionnez l'option Remplacer le fichier existant lorsque vous écrivez des données dans un fichier existant.
    5. Sélectionnez l'option nouvelle ligne dans le champ Séparateur de lignes.
    6. Sélectionnez l'option virgule dans le champ Séparateur de colonnes.
    7. Sélectionnez l'option ANSI dans la liste Codage.
  11. Double-cliquez ou faites glisser l'action Définir une valeur de champ pour définir les données dans le tableau.
    1. Dans le champ Alias de la fonction BAPI, saisissez BAPI_POST.
    2. Dans le champ Source, sélectionnez Tableau.
    3. Saisissez GL dans le champ Alias du tableau.
    4. Dans le champ Nom du champ, saisissez ITEMNO_ACC (le nom du champ dans lequel vous souhaitez définir des données).
    5. Dans le champ Valeur de champ, saisissez 2 (la valeur que vous souhaitez définir).
    6. Dans le champ Session BAPI SAP, saisissez Par défaut (le nom de la session que vous avez utilisé pour vous connecter à l'application SAP dans l'action Se connecter).
  12. Répétez l'étape 11 sept fois pour définir des données dans un tableau.

    Lors de la définition des valeurs dans le tableau, conservez la même valeur que celle que vous avez saisie aux étapes 11(a), 11(b), 11(c) et 11(f). Modifiez les valeurs suivantes pour les étapes 11(d) et 11(e) :

    Valeur de champ Nom du champ
    GL_ACCOUNT 0000078310
    PSTNG_DATE 20210127
    ITEM_TEXT TEST POSTING DEBIT ITEM
    QUANTITY 1000
    BASE_UOM EA
    COMP_CODE 1000
    DOC_TYPE SA
  13. Sélectionnez le champ de l'action Définir la valeur.
    1. Dans le champ Alias de la fonction BAPI, saisissez BAPI_POST.
    2. Dans le champ Source, sélectionnez Tableau.
    3. Saisissez GL dans le champ Alias du tableau.
    4. Cochez la case Créer une nouvelle ligne pour saisir les données dans la ligne suivante.
    5. Dans le champ Nom du champ, saisissez ITEMNO_ACC (le nom du champ dans lequel vous souhaitez définir des données).
    6. Dans le champ Valeur de champ, saisissez 1 (la valeur que vous souhaitez définir).
    7. Dans le champ Session BAPI SAP, saisissez Par défaut (le nom de la session que vous avez utilisé pour vous connecter à l'application SAP dans l'action Se connecter).
  14. Sélectionnez l'action Obtenir le tableau.
    1. Dans le champ Alias de la fonction BAPI, saisissez BAPI_POST.
    2. Dans le champ Nom du tableau, saisissez ACCOUNTGL.
    3. Dans le champ Session BAPI SAP, saisissez Default.
    4. Sélectionnez l'option Variable pour stocker les données extraites du tableau dans une variable de tableau. Créez une variable de tableau Sap-Bapi-Table.
  15. Double-cliquez ou faites glisser l'option Données de tableau > Écrire dans le fichier.
    1. Sélectionnez la variable de tableau Sap-Bapi-Table qui contient les données à écrire dans la liste Nom du tableau de données.
    2. Spécifiez l'emplacement du fichier dans lequel vous souhaitez écrire les données dans le champ Saisir le nom de fichier. Par exemple, D:/utilisateur défini /Mon bureau/SAP Test/ACCOUNTGL.csv.
    3. Cochez la case Créer les dossiers/fichiers s'ils n'existent pas.
    4. Sélectionnez l'option Remplacer le fichier existant lorsque vous écrivez des données dans un fichier existant.
    5. Sélectionnez l'option nouvelle ligne dans le champ Séparateur de lignes.
    6. Sélectionnez l'option virgule dans le champ Séparateur de colonnes.
    7. Sélectionnez l'option ANSI dans la liste Codage.
  16. Double-cliquez ou faites glisser l'action Définir une valeur de champ pour définir les données dans le tableau.
    1. Dans le champ Alias de la fonction BAPI, saisissez BAPI_POST.
    2. Dans le champ Source, sélectionnez Tableau.
    3. Saisissez CURRENCY dans le champ Alias du tableau.
    4. Dans le champ Nom du champ, saisissez ITEMNO_ACC (le nom du champ dans lequel vous souhaitez définir des données).
    5. Dans le champ Valeur de champ, saisissez 2 (la valeur que vous souhaitez définir).
    6. Dans le champ Session BAPI SAP, saisissez Default (le nom de la session que vous avez utilisé pour vous connecter à l'application SAP dans l'action Se connecter).
  17. Répétez l'étape 16 sept fois pour définir des données dans un tableau.

    Lors de la définition des valeurs dans le tableau, conservez la même valeur que celle que vous avez saisie aux étapes 16(a), 16(b), 16(c) et 16(f). Modifiez les valeurs suivantes pour les étapes 16(d) et 16(e) :

    Nom du champ Valeur de champ
    DEVISE USD
    AMT_DOCCUR -2000
    ITEMNO_ACC 1
    DEVISE USD (répété) ligne 43
    AMT_DOCCUR 2000
  18. Répétez l'étape 14 et saisissez CURRENCYAMOUNT dans le champ Nom de tableau.
  19. Répétez l'étape 15 et spécifiez l'emplacement du fichier, par exemple D:/utilisateur défini /Mon bureau/SAP Test/CURRENCYAMOUNT.csv.
  20. Sélectionnez l'action Exécuter la fonction pour exécuter la fonction BAPI SAP.
    1. Dans le champ Alias de la fonction BAPI, saisissez BAPI_POST.
    2. Sélectionnez l'option Terminer la séquence pour marquer la fin d'un processus et l'option Effectuer une transaction pour valider les modifications apportées pendant le processus.
    3. Dans le champ Session BAPI SAP, saisissez Default.
  21. Sélectionnez l'action Obtenir le tableau.
    1. Dans le champ Alias de la fonction BAPI, saisissez BAPI_POST.
    2. Dans le champ Nom du tableau, saisissez RETURN.
    3. Dans le champ Session BAPI SAP, saisissez Default.
    4. Sélectionnez l'option Variable pour stocker les données extraites du tableau dans une variable de tableau. Créez une variable de tableau Sap-Bapi-Table.
  22. Répétez l'étape 15 et indiquez l'emplacement du fichier, par exemple D:/utilisateur défini /Mon bureau/SAP Test/Retour.csv.
  23. Sélectionnez l'action Obtenir une valeur de champ pour obtenir les données d'un champ spécifié à partir d'une fonction.
    1. Dans le champ Alias de la fonction BAPI, saisissez BAPI_POST.
    2. Sélectionnez l'onglet Fonction dans le champ Source.
    3. Dans le champ Nom du champ, saisissez OBJ_KEY.
    4. Dans le champ Session SAP BAPI, saisissez Par défaut.
    5. Sélectionnez Attribution d'invite dans le champ Enregistrer le résultat dans une variable.
  24. Doublez cliquez sur ou faites glisser l'action Zone de message.
    1. Saisissez Client Automation Anywhere Enterprise dans le champ Entrer le titre de la fenêtre de la zone de message.
    2. Saisissez $Prompt-Assignment.
    3. Entrez 30 dans le champ Barre de défilement après les lignes pour afficher une barre de défilement.
  25. Répétez l'étape 23 et l'étape 24 (à l'étape 23(c), saisissez la valeur OBJ_SYS).
  26. Répétez l'étape 23 et l'étape 24 (à l'étape 23(c), saisissez la valeur OBJ_TYPE).
  27. Cliquez sur Enregistrer et sur Exécuter.