Références techniques

Cette section comprend les informations utiles dont vous pourriez avoir besoin lorsque vous travaillez avec la SAP BAPI.

Création d'entrées de tableau pour les types d'entrée de table

Dans l'activité Exécuter BAPI (Execute BAPI), les types d'entrée de table pour les BAPI sont représentés par des entrées de tableau. Cela vous oblige à créer manuellement les objets. Nous travaillons activement à une solution permettant de simplifier les mappages de tableaux et d'améliorer l'expérience globale.

Cette section explique comment créer des entrées de tableau de type natif dans SAP BAPI, avec des exemples dans Studio Desktop version 2023.10 et Studio Web.

Nous allons expliquer ce sujet avec l'exemple d'un objet BAPI_PO_CREATE .

Studio Desktop (Language C#)

1. Dans l'activité Exécuter BAPI (Execute BAPI), sélectionnez l'objet BAPI_PO_CREATE .
2. Après avoir sélectionné l'objet, le reste des champs est automatiquement récupéré.
3. Pour une table de PO_ITEMS, par exemple, vous souhaitez créer un tableau d'objets équivalent. Sélectionnez le bouton Plus + à côté du champ PO_ITEMS pour ouvrir l ' éditeur d'expressions.
4. Dans la fenêtre de l ' éditeur d'expressions , saisissez UiPath.IntegrationService.Activities.SWEntities. Cela charge une liste d’éléments. Vous pouvez utiliser IntelliSense pour vous aider à parcourir.
5. Dans la liste, choisissez l'élément qui correspond à votre InArgument (dans ce cas, bapis_sub_execute_TABLES_sub_PO_ITEMS_CREATE). Cet élément est toujours unique pour une table.
   
   

   

   
   
6. Ensuite, saisissez une période (.), puis choisissez Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create dans la liste disponible. Ajoutez deux paires de crochets à la fin : []{}.
7. À ce stade, le tableau est instancié et vous êtes prêt à construire l'objet à l'intérieur.
   
   

   

   
   
   Remarque : l'ID CEBA75DCD15 est un identifiant unique généré de notre côté, spécifique à votre connexion SAP BAPI pour chaque objet. L'ID est unique pour chaque objet.
8. Copiez la ligne de l'étape précédente et ajoutez des parenthèses () à la fin. Vous êtes maintenant prêt à mapper les propriétés de l'objet.
   
   

   

   
   
9. Saisissez une période (.) pour rechercher toutes les propriétés de l'objet.
   
   

   

   
   
10. Mappez les propriétés selon vos besoins et sélectionnez Enregistrer ( Save).
    
    

    

    
    

Échantillon :

new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create[] {
    new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create()
    {
        PO_ITEM = 00001,
        PUR_MAT = "TG12",
        PLANT = "1710"
    },
    new UiPath.IntegrationService.Activities.SWEntities.CD6D3C0011F_bapis_sub_execute_TABLES_sub_PO_ITEMS_Create_CFXVARGYNSGMNQOY1M9XDRN8OK3VIHY.Bundle.bapis_sub_execute_TABLES_sub_PO_ITEMS_Create()
    {
        PO_ITEM = 00002,
        PUR_MAT = "TG12",
        PLANT = "1710"
    }
}

Studio Web (Language VB)

Prenons le même exemple et voyons comment nous pouvons obtenir le résultat dans Studio Web.

1. Dans l'activité Exécuter BAPI (Execute BAPI), sélectionnez l'objet BAPI_PO_CREATE .
2. Après avoir sélectionné l'objet, le reste des champs est automatiquement récupéré.
3. Pour une table de PO_ITEMS, par exemple, vous souhaitez créer un tableau d'objets équivalent. Sélectionner l'option Voir plus pour ouvrir l' éditeur d'expressions.
   
   

   

   
   
4. Tapez New, suivi d’une espace, puis bapis. Cela déclenche IntelliSense pour afficher une liste d'éléments. Dans la liste, sélectionnez l'élément correspondant à votre InArgument, dans ce cas bapis_sub_execute_TABLES_sub_PO_ITEMS_CREATE. Cet élément est toujours unique pour une table.
   
   

   

   
   
   
   

   

   
   
5. Ensuite, ajoutez une paire de crochets {}. À l'intérieur des parenthèses, saisissez un point .. Vous pouvez alors voir les propriétés disponibles dans l'objet.
   
   

   

   
   
6. Mappez les propriétés selon vos besoins et sélectionnez Enregistrer ( Save).
   
   

   

   
   

Échantillon :

{ 
    New bapis_sub_execute_TABLES_sub_PO_ITEMS_Create With 
    { 
        .PO_ITEM = 00001,
        .PUR_MAT = "TG12",
        .PLANT = "1710"
    },
    New bapis_sub_execute_TABLES_sub_PO_ITEMS_Create With 
    { 
        .PO_ITEM = 00002,
        .PUR_MAT = "TG12",
        .PLANT = "1710"
    }
}

Questions fréquemment posées

Le package d'activités SAP BAPI est-il compatible avec les projets Windows et multiplateformes ?

Oui, le package d’activité SAP BAPI est compatible avec les types de projet Windows et multiplateformes dans Studio Desktop.

Pourquoi ne puis-je pas voir toutes les propriétés requises d'une BAPI dans la zone de dessin de l'activité ?

Lorsqu'une propriété d'une BAPI donnée est de type structure, l'entrée (structure) elle-même n'est pas affichée sur la zone de dessin de l'activité Exécuter la BAPI (Execute BAPI ), mais ses propriétés sous-jacentes sont affichées. Même si certaines propriétés de la structure sont requises par la BAPI, elles restent affichées comme facultatives sur la zone de dessin principale, ce qui entraîne souvent une interface d'activité encombrée. SAP n'indique pas quels champs sont requis dans la structure et fournit uniquement des informations sur la structure obligatoire. Par conséquent, vous devez identifier et mapper manuellement les champs requis en conséquence. Vous pouvez en savoir plus sur cette limitation dans ce fil de discussion de la communauté SAP : Champs obligatoires BAPI ( BAPI Obligatoire Fields).

Pourquoi ne puis-je pas voir les types d'entrée de table pour les BAPI ?

Dans l'activité Exécuter BAPI (Execute BAPI), les types d'entrée de table pour les BAPI sont représentés par des entrées de tableau. Cela vous oblige à créer manuellement les objets. Voir les exemples fournis dans Création d'entrées de tableau pour les types d'entrée de table.

Nous travaillons activement à une solution permettant de simplifier les mappages de tableaux.

Pourquoi ne puis-je pas voir toutes mes entrées sur la zone de dessin ?

Par défaut, seuls les champs requis sont affichés sur la zone de dessin de l'activité principale. Vous pouvez accéder à des champs facultatifs et les configurer dans le panneau Gérer les propriétés . Sélectionnez les entrées supplémentaires dont vous avez besoin et utilisez l'option Mettre à jour les champs ( Update fields ) pour les intégrer dans la zone de dessin principale.

L'invocation de RFC est-elle prise en charge ?

L'appel de RFC n'est actuellement pas pris en charge dans le module d'activités SAP BAPI.

Existe-t-il des prérequis d'installation pour utiliser les activités SAP BAPI ?

Aucune installation n'est nécessaire pour utiliser les nouvelles activités SAP BAPI d'Integration Service. Vous avez besoin d'UiPath Studio version 2023.10 ou supérieure, ou vous pouvez commencer à créer vos automatisations directement dans Studio Web.

Comment puis-je déterminer si l'activité Exécuter la BAPI (Execute BAPI) a réussi ?

Toutes les BAPI incluent un tableau _RETURN dans la section Tables de sortie. Cela fournit des sorties telles que LOG_NO, CODE, MESSAGE, etc. Vérifiez ces valeurs pour évaluer le succès ou l'échec de l'exécution de la BAPI.

Puis-je utiliser une adresse IP au lieu d'un nom DNS pour le nom d'hôte ?

L'utilisation d'une adresse IP offre un avantage considérable : son caractère unique. Lorsque vous utilisez un nom DNS tel que mycompany.com/sap/bapi, vous dépendez de la traduction DNS, du routage et d'autres composants réseau. Cela peut entraîner des problèmes potentiels et des problèmes réseau. Par conséquent, nous vous recommandons d’utiliser des adresses IP pour garantir une expérience de création de connexion plus fiable.

Puis-je utiliser l'activité SAP BAPI depuis Integration Service si mon application SAP est hébergée sur site ou dans un cloud dédié ?

Oui. Si votre système SAP S/4HANA est hébergé sur une plate-forme cloud telle qu'Azure, vous devez disposer d'une adresse IP publique, qui est suffisante pour l'accès. Si votre système SAP est local, vous devez autoriser l'accès à partir d'adresses IP externes spécifiques, ce qui implique la configuration de vos paramètres de pare-feu.

Le système gère-t-il automatiquement les validations des interfaces BAPI ?

Oui. Comme nous utilisons le connecteur SAP Java, le système détecte automatiquement si une BAPI requiert une validation et déclenche BAPI_TRANSACTION_COMMIT pour s'assurer que la transaction est enregistrée. Cela élimine le besoin d'une intervention manuelle.