À propos du package d'activités BAPI SAP

Package d’activités SAP BAPI pour invoquer les interfaces de programmation d’application métier SAP dans les workflows d’automatisation UiPath

Le package d’activités SAP BAPI permet aux développeurs RPA d’invoquer une interface de programmation d’application métier SAP. Le package est fourni avec une activité d'étendue, 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.

La variante 32 bits (x86).NET 4.0 du connecteur SAP pour Microsoft.NET 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 de la DLL de Microsoft C++ Runtime (celle-ci est contenue dans le package redistribuable Microsoft Visual C++ 2010). Votre administrateur SAP doit être en mesure de fournir le programme d'installation.

Remarque :

Notez que SAP Connector for Microsoft doit être installé dans Windows Global Assembly Cache (GAC) pour fonctionner correctement. Pour ce faire, sélectionnez l'option appropriée lors de l'installation de SAP Connector.

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 de SAP .NET Connector est disponible ici.

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

First, you must configure a connection to the SAP system. After this step is performed, you can invoke multiple BAPI workflows before closing the connection.

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

Clicking the Configure button in the body of the SAP Application Scope activity opens a wizard which enables you to configure your connection to the SAP system at design-time.

Simply enter all of the credentials required for connection and click the Test connection button. If the connection is established successfully, a message appears, informing you of this.

Clicking Close in this message box closes the connection wizard and sets all the values you provided as credentials to their respective property fields, rendering the activity ready to use.

Remarque :

The value for the Password field is not saved in the activity properties when exiting the connection window.

Connexion robot

You can also configure the Robot connection details by switching to the Robot Connection tab.

The details for the Robot connection can also be automatically copied over from the Design Connection tab by using the Copy to Robot Connection button.

Runtime

At run time, all the server credentials must be supplied as variables in their respective property fields. You can also use a IConnectionService object that contains all the connection details in the ExistingSAPConnection property fields.

Configuration de l'activité Invoke SAP BAPI

Clicking the Configure button in the body of the Invoke SAP BAPI activity opens a wizard that enables you to choose and configure the BAPI you want to invoke.

The BAPI Name search bar can be used to find the BAPI you want to invoke. Once selected, the BAPI's mandatory parameters are added in the table below, where they can be edited.

Remarque :

Parameters marked with * are mandatory and cannot be deleted.

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

• Name - The name of the parameter specific to the selected BAPI.
• Description - A short description detailing the parameter.
• Length - Maximum number of characters, if any.
• Data Type - The variable or object type of the parameter.
• Direction - Specifies whether a parameter is In, Out, or In/Out.
• Value - The value of the parameter.
• - supprime le paramètre de la BAPI.

After configuring the parameters you want your BAPI to have, clicking Done closes the wizard and saves the configuration in the Invoke SAP BAPI activity. You can now run the process you have created.

Ajout de paramètres

You can add parameters one by one by using the Add Parameter text field in the bottom left part of the window to search the list of parameters and hitting Enter.

The Add Parameters button in the upper right area enables you to add any parameters you want into the BAPI invoke you are performing. Clicking the button switches to a list of all available parameters, where you can specify what parameters you wish to add by selecting their respective check boxes.

Exportation des paramètres

The Export Parameters button exports all of the currently defined parameters and their metadata into an .xlsx file. Clicking the button opens a browsing window which lets you select where you want to save the file containing the exported data. This file can then be used as a template for creating input data files.

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

Si vous utilisez une version antérieure à v2.0.0, vous pouvez accéder aux instructions sur la façon de générer un workflow SAP BAPI ici.