Génération d'un workflow SAP BAPI pour les versions antérieures à la v2.0.0

Une fois le paquet BAPI SAP installé, l'assistant de SAP Connector devient disponible dans UiPath Studio, dans l'onglet du ruban Conception (Design), dans la section Assistants (Wizards).

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

L'assistant contient 4 sections, comme suit :

Identifiants de connexion

Dans cette section, vous devez saisir les paramètres de connexion système (System Connection Parameters) et les informations de connexion ( Login Information) .

Pour les Paramètres de connexion système (System Connection Parameters), entrez les détails du système SAP auquel vous souhaitez vous connecter afin d'extraire les informations BAPI. Les champs obligatoires sont :

• Hôte du serveur d'applications (Application Server Host)
• Numéro système (System Number)

Pour les Informations de connexion (Login Information), entrez les détails de l'utilisateur de SAP qui est autorisé à se connecter au système SAP ci-dessus. Les champs requis sont les suivants :

• Client (Client)
• Utilisateur (User)
• Mot de passe (Password)

Vous pouvez également spécifier la langue du système SAP en renseignant le champ Langue (Language). Notez que ce champ doit être rempli avec un code langue (p. ex. EN, DE, etc.). La langue spécifiée doit être installée sur l'instance de SAP à laquelle vous vous connectez. Si aucune langue n'est spécifiée dans ce champ, celle par défaut du système SAP est utilisée.

Cliquer sur Connecter ( Connect ) indique si la connexion a réussi et change le statut en En ligne (Online).

Remarque : si la connexion ne peut pas être établie, un message d'erreur apparaît. Examinez et corrigez les paramètres de connexion système ou les informations de connexion, puis réessayez. Si une connexion ne peut pas être établie avec succès, contactez votre administrateur SAP.

L'assistant BAPI SAP conserve les valeurs Paramètres de connexion système (System Connection Parameters) et Informations de connexion (Login Information) (à l'exception du champ Mot de passe (Password)) pour la session Studio en cours.

Choisir BAPI

Saisissez le nom de la BAPI à automatiser dans le champ Nom de la BAPI SAP . Vous pouvez également saisir une description.

Une fois le champ Nom de la BAPI SAP rempli, cliquez sur Suivant(Next). Si la BAPI est trouvée dans le référentiel, l'assistant accède à l'écran Arguments (Arguments).

Si la BAPI est introuvable, un message d'erreur apparaît. Veuillez vérifier que le nom SAP BAPI que vous avez entré est correct et qu'il est activé dans le système SAP. Votre administrateur SAP devrait être en mesure de vous aider si la BAPI est introuvable.

Sélectionner des arguments

L'assistant répertorie tous les arguments de la BAPI, avec les détails de chaque argument, tels que Direction (Direction) (Entrée, Sortie, Entrée/Sortie), Type de données (Data Type), et si l'argument est Obligatoire (Mandatory). Sélectionnez les arguments à mapper au workflow. Les arguments marqués comme Obligatoires sont toujours sélectionnés pour le mappage.

Vous pouvez également spécifier un Nom assigné (Assigned Name) à utiliser pour l'Argument de workflow (Workflow Argument) à la place du Nom technique (Technical Name) de la BAPI SAP.

Si une BAPI inclut des arguments complexes, tels que des tables et des structures, qui à leur tour contiennent des arguments complexes, une exception BAPI non prise en charge est levée. Cela arrive dans les cas de types d'arguments suivants :

• Une table à l'intérieur d'une table.
• Une table à l'intérieur d'une structure.
• Une structure à l'intérieur d'une structure.
• Une structure à l'intérieur d'une table.

Une erreur est également générée si une BAPI inclut l'argument de retour avec un type de paramètre différent de BAPIRETURN, BAPIRETURN1, BAPIRET1, BAPIRET2, BAPIRET2_FIX.

Un clic sur Suivant (Next) permet d'accéder à l'écran Générer un workflow (Generate Workflow).

Générer un workflow

Cet écran permet d'examiner les détails de votre workflow. Cela garantit la sélection de tous les arguments qui doivent être mappés.

Le champ de la propriété Workflow File Path spécifie l'emplacement d'enregistrement du workflow.

Cliquer sur Générer ( Generate ) crée un fichier .xaml au chemin spécifié, avec toutes les options sélectionnées dans l'écran Sélectionner les arguments ( Select Arguments ).

Invocation du workflow BAPI

L'activité Invoke Workflow File peut être utilisée pour appeler le workflow SAP BAPI. L'activité Open SAP Connection doit être placée avant l'activité invoke, car elle génère une variable SAPConnectionService , qui est ensuite utilisée dans l'argument de workflow SAP BAPI nommé SAPConnectionService. Cet argument doit être défini dans le champ de propriété SapConnectionService de l'activité Ouvrir la connexion SAP .

Remarque : les workflows générés avec le pack SAP BAPI ne peuvent pas être appelés lors de l'utilisation de la propriété Isolé dans l'activité Invoke Workflow File .

Les arguments de type Table dans la BAPI sont mappés aux arguments DataTable et les arguments de type Structure dans la BAPI sont mappés aux arguments DataRow. Tous les autres arguments sont mappés aux types de données basiques.

Tous les workflows BAPI renvoient également un argument contenant la structure BapiReturn du type approprié.

Après l'activité Invoke Workflow File , une activité Close SAP Connection (Close SAP Connection) doit être utilisée pour fermer la connexion à SAP. La connexion peut être spécifiée en utilisant la même variable SAPConnectionService .