À propos du package d'activités BAPI SAP

Le package d’activités SAP BAPI permet aux développeurs RPA d’invoquer une interface de programmation d’application métier (BAPI). Le package est livré avec une activité d'étendue, Étendue de l'application SAP ( SAP Application Scope), qui permet à l'utilisateur de se connecter à un système SAP et d'utiliser une activité Invoke SAP BAPI pour invoquer une BAPI spécifiée.

Prérequis d'installation

Remarque : les prérequis d'installation s'appliquent aux versions 2.2.6 et antérieures du package SAP BAPI . À partir de la version 3.0.0, Les prérequis ne sont pas requis pour les projets Studio Windows, mais restent nécessaires si vous créez un workflow Windows - Héritage (Windows - Legacy).

La variante 32 bits (x86) .NET 4.0 du connecteur SAP pour Microsoft .NET 3.0 (NCo 3.0) (de préférence 3.0.0.42) est un prérequis pour ce package d'activités. Ce connecteur nécessite également la version 10.0 du DLL de Microsoft C++ Runtime (celle-ci est contenue dans le package de redistribution Microsoft Visual C++ 2010). Votre administrateur SAP doit être en mesure de fournir le programme d'installation.

Remarque : veuillez noter que le connecteur SAP pour Microsoft doit être installé dans le Global Assembly Cache (GAC) de Windows pour fonctionner correctement. Pour ce faire, sélectionnez l'option appropriée lors de l'installation du connecteur SAP.

Ces dépendances doivent être installées sur toute machine sur laquelle vous souhaitez utiliser ce package d'activités. Cela fait référence aux machines de développement, où les workflows sont créés dans Studio, ainsi que les machines de production, où le Robot exécute ces workflows.

La documentation officielle du connecteur SAP .NET est disponible ici.

Génération d'un workflow SAP BAPI pour les versions v2.0.0 et supérieures

Tout d'abord, vous devez configurer une connexion au système SAP . Une fois cette étape effectuée, vous pouvez appeler plusieurs workflows BAPI avant de fermer la connexion.

Configuration d'une connexion

Vous pouvez configurer une connexion à un système SAP à l'aide d'un serveur d'applications personnalisé ou d'une sélection de groupe/serveur, ainsi que vous authentifier à l'aide de l'utilisateur/mot de passe ou de l'authentification unique. Un ensemble de paramètres valides doit être spécifié pour le serveur et l'authentification pour une connexion réussie. Un message d'erreur de SAP indique tous les paramètres manquants.

Connexion concepteur

Cliquer sur le bouton Configurer (Configure) dans le corps de l'activité Étendue de l'application SAP ouvre un assistant qui vous permet de configurer votre connexion au système SAP au moment de la conception.

Entrez simplement toutes les informations d'identification requises pour la connexion et cliquez sur le bouton Tester la connexion . Si la connexion est établie avec succès, un message apparaît pour vous en informer.

Cliquer sur Fermer ( Close ) dans cette boîte de message ferme l'assistant de connexion et définit toutes les valeurs que vous avez fournies comme informations d'identification pour leurs champs de propriété respectifs, rendant l'activité prête à l'emploi.

Remarque : la valeur du champ Mot de passe n'est pas enregistrée dans les propriétés de l'activité lorsque vous quittez la fenêtre de connexion.

Connexion robot

Vous pouvez également configurer les détails de la connexion du Robot en basculant vers l'onglet Connexion du Robot (Robot Connection).

Les détails de la connexion Robot peuvent également être automatiquement copiés à partir de l'onglet Connexion Conception (Design Connection) en utilisant le bouton Copier vers la connexion Robot ( Copy to Robot Connection) .

Runtime

Au moment de l'exécution, toutes les informations d'identification du serveur doivent être fournies en tant que variables dans leurs champs de propriétés respectifs. Vous pouvez également utiliser un objet IConnectionService qui contient tous les détails de la connexion dans les champs de propriété ExistingSAPConnection .

Configuration de l'activité Invoke SAP BAPI

Cliquer sur le bouton Configurer (Configure) dans le corps de l'activité Invoquer la BAPI SAP (Invoke SAP BAPI) ouvre un assistant qui vous permet de choisir et de configurer la BAPI que vous souhaitez invoquer.

La barre de recherche Nom de la BAPI (BAPI Name) peut être utilisée pour trouver la BAPI que vous souhaitez appeler. Une fois sélectionnés, les paramètres obligatoires de la BAPI sont ajoutés dans le tableau ci-dessous, où ils peuvent être modifiés.

Remarque : les paramètres marqués de * sont obligatoires et ne peuvent pas être supprimés.

Le tableau est divisé en sept colonnes, comme suit :

• Nom (Name) : le nom du paramètre spécifique à la BAPI sélectionnée.
• Description : une brève description détaillant le paramètre.
• Longueur : nombre maximal de caractères, le cas échéant.
• Type de données (Data Type ) : le type de variable ou d'objet du paramètre.
• Direction - Spécifie si un paramètre est In, Outou In/Out.
• Valeur (Value) - La valeur du paramètre.
• - supprime le paramètre de la BAPI.

Après avoir configuré les paramètres souhaités pour votre BAPI, cliquez sur Done (Terminé) pour fermer l'assistant et enregistrer la configuration dans l'activité Invoke SAP BAPI (Invoquer SAP BAPI). Vous pouvez maintenant exécuter le processus que vous avez créé.

Ajout de paramètres

Vous pouvez ajouter des paramètres un par un en utilisant le champ de texte Ajouter un paramètre dans la partie inférieure gauche de la fenêtre pour rechercher dans la liste des paramètres et en appuyant sur Entrée.

Le bouton Ajouter des paramètres (Add Parameters ) dans la zone supérieure droite vous permet d'ajouter tous les paramètres de votre choix dans l'invocation BAPI que vous effectuez. Cliquez sur le bouton pour afficher une liste de tous les paramètres disponibles, dans laquelle vous pouvez spécifier les paramètres que vous souhaitez ajouter en cochant leurs cases respectives.

Exportation des paramètres

Le bouton Exporter les paramètres permet d'exporter tous les paramètres actuellement définis et leurs métadonnées dans un fichier .xlsx . Cliquer sur le bouton ouvre une fenêtre de navigation qui vous permet de sélectionner l'emplacement où vous souhaitez enregistrer le fichier contenant les données exportées. Ce fichier peut ensuite être utilisé comme modèle pour créer des fichiers de données d'entrée.

Génération d'un workflow SAP BAPI pour la version v1.xx

Si vous utilisez une version antérieure à la version v2.0.0, vous pouvez accéder aux instructions sur la génération d'un workflow BAPI SAP ici.