Explication de SAP Build Process Automation
Réutilisation du contenu SAP Build Process Automation existant
Exécution de la création de processus de base dans SAP Build Process Automation
Explication des automatisations dans une synthèse
Utilisation des fonctionnalités de création de processus avancée dans SAP Build Process Automation
Utilisation d'API pour l'intégration

Encapsulation des API des systèmes distants à l'aide de projets d'actions

Objective

After completing this lesson, you will be able to encapsulation des API de systèmes distants à l'aide de projets d'actions

Encapsulation des API de systèmes distants à l'aide de projets d'actions

Étant donné que de nombreux processus de gestion couvrent une multitude de systèmes et d'applications différents, un moyen d'interagir avec ces systèmes et applications est nécessaire dans le système de gestion des processus de gestion. Dans SAP Build Process Automation, vous utilisez Actions pour réaliser l'intégration. Les interfaces de programmation d'applications (API) des systèmes source et cible avec lesquels interagir sont encapsulées en tant qu' actions dans les projets d'actions. Ces projets Actions sont ensuite gérés dans une bibliothèque de projets Actions et, à partir de là, peuvent être intégrés aux processus de gestion. Cette approche offre différents avantages par rapport à l'intégration directe de l'API dans le processus respectif :

  • Il existe une abstraction de l'API. Le développeur de processus n'a pas besoin de connaître exactement les détails techniques de l'API.
  • Les API peuvent être adaptées aux besoins des développeurs de processus, en exposant uniquement les points de terminaison et les données requis ou à utiliser en toute sécurité par les développeurs de processus.
  • Les actions peuvent être configurées une fois, puis réutilisées dans différents projets de processus de gestion.
  • Les projets d'actions permettent le versionnement et facilitent ainsi la gestion des modifications des exigences de processus ou des versions d'API.

Comme les actions dépendent de la norme de spécification OpenAPI (https://spec.openapis.org/oas/v3.1.0#openapi-specification) pour la définition d'API, elles ne sont pas limitées aux API des systèmes SAP, mais offrent la possibilité d'intégrer n'importe quelle API qui est ou peut être décrite dans la spécification OpenAPI. Un grand nombre de définitions d'API, notamment pour les solutions SAP, sont disponibles dans SAP Business Accelerator Hub.

Remarque

Vous trouverez des informations supplémentaires sur les API, en particulier sur les API SAP Build Process Automation, et sur la manière d'interagir avec elles à un niveau plus technique dans l'unité Intégration d'API de SAP Build Process Automation.

Éditeur d'actions

L'éditeur d'actions vous permet de composer plusieurs actions à partir d'une API sous-jacente dans un projet d'actions. Notez que vous n'avez pas besoin d'inclure tous les paramètres possibles d'un point de terminaison d'API comme paramètres dans les actions respectives et que vous n'avez pas non plus besoin d'inclure tous les champs de corps de réponse disponibles dans la réponse fournie via l'action. Ainsi, seules les informations pertinentes pour le processus de gestion peuvent être incluses.

Une fois vos actions définies, le projet doit être publié dans une version, puis publié dans la bibliothèque des actions.

Une fois que les API ont été encapsulées dans un projet Actions et publiées dans la bibliothèque, leur ajout comme action à un processus est assez simple. Sélectionnez le type d'étape correspondant Actions et parcourez la bibliothèque Actions. Sélectionnez l'action requise dans votre processus et cliquez sur Ajouter. Une fois l'étape Action incluse dans votre processus, assurez-vous de définir ses paramètres :

  • Variable de destination : variable de processus qui contiendra le nom de destination technique SAP BTP à utiliser pour accéder à l'API sous-jacente au moment de l'exécution du processus. Cette variable peut être renseignée avec un nom de destination lors du déploiement du processus.
  • Entrées : mappage du contenu de processus à tous les paramètres dont l'action a besoin pour être exécutée (par exemple, le numéro de commande client, lors de la récupération d'une entrée de commande client à partir d'un système SAP S/4HANA).
  • Sorties : synthèse du résultat de l'appel Actions, tel que défini dans l'action correspondante.

Encapsulation des API de systèmes distants à l'aide de projets d'actions

Scénario de gestion

Vous et vos collègues créez un processus qui doit lire les données de commande client à partir de votre système SAP S/4HANA et, ultérieurement, réécrire les données de la commande client dans le système. Vous êtes maintenant confronté au défi d'interagir avec ce système SAP S/4HANA dans le processus. Pour relever ce défi, SAP Build Process Automation offre les fonctionnalités des projets d'actions. Vous allez définir tous les points de terminaison de l'API de commande client SAP S/4HANA à utiliser dans le processus, comme Actions dans un projet Actions. Cette procédure peut également être décrite comme encapsulant les API, car vous créez un wrapper uniquement autour des points de terminaison d'API spécifiquement requis. En validant et publiant le projet Actions, les actions seront disponibles dans une bibliothèque Actions pour être utilisées dans vos processus.

Pour en savoir plus sur l'encapsulation des API de systèmes distants à l'aide de projets Actions, suivez ce didacticiel.

Options d'exercice

Pour lancer l'exercice, sélectionnez Commencer l'exercice dans la figure ci-dessous.

Une fenêtre pop-up s'ouvre. Vous disposez des options suivantes :

  • Sélection de Lancer : la simulation démarre. Suivez la simulation pour apprendre à encapsuler des API de systèmes distants à l'aide de projets d'actions.
  • Sélectionnez Ouvrir le document PDF : un PDF s'ouvre. En fonction des étapes décrites dans ce document, vous pouvez effectuer l'exercice dans votre propre infrastructure système.

Étapes

  1. Réencapsuler les API de systèmes distants à l'aide de projets Actions.

    1. Sélectionnez Actions.

    2. Sélectionnez Créer.

    3. Sélectionnez la zone de défilement pour faire défiler vers le bas.

    4. Sélectionnez SAP Business Accelerator Hub.

    5. Sélectionnez la zone de défilement pour faire défiler vers le bas.

    6. Sélectionnez SAP S/4HANA Cloud, édition publique.

    7. Sélectionnez la zone de défilement pour faire défiler vers le bas.

    8. Sélectionnez SAP S/4HANA Cloud, édition publique.

    9. Dans la zone Rechercher, saisissez Ventes.

    10. Appuyez sur Entrée.

    11. Sélectionnez Commande client (A2X).

    12. Sélectionnez Afficher documentation API.

    13. Sélectionnez la zone de défilement pour faire défiler vers le bas.

    14. Sélectionnez API Spécifications.

    15. Sélectionnez Télécharger.

      Remarque

      Dans les étapes suivantes, vous allez charger le fichier JSON téléchargé dans votre projet pour revenir à l'onglet Build Apps.
    16. Cliquez sur Retour.

    17. Sélectionnez Sources d'intégration.

    18. Sélectionnez la zone de défilement pour faire défiler vers le bas.

    19. Sélectionnez Charger spécification API.

    20. Sélectionnez Parcourir Fichiers.

    21. Sélectionnez API_SALES_ORDER_SRV.json.

    22. Cliquez sur Ouvrir.

    23. Cliquez sur Next.

    24. Dans la zone Nom du projet, saisissez Actions de commande client SAP S/4HANA.

    25. Dans la zone Description, saisissez Actions Projet pour interagir avec la commande client dans le système S/4HANA.

    26. Sélectionnez Créer.

    27. Sélectionnez SAP S/4HANA Sales Order Actions.

    28. Sélectionnez la zone de défilement pour faire défiler vers le bas.

    29. Sélectionnez En-tête de commande client.

    30. Sélectionnez Lit l'en-tête d'une commande client.

    31. Cliquez sur Add.

    32. Sélectionnez Édition.

    33. Cliquez sur Marquer tout.

    34. Pour développer le volet Clé, cliquez sur la flèche.

    35. Cliquez sur Search.

    36. Dans la zone Rechercher, saisissez Organi.

    37. Décochez/décochez la case OrganizationDivison.

    38. Dans la zone Rechercher, saisissez Répartir.

    39. Décochez/décochez la case DistributionChannel.

    40. Dans la zone Rechercher, saisissez Total.

    41. Décochez/décochez la case Montant total net.

    42. Dans la zone Search, saisissez Salesord.

    43. Décochez/décochez la case SalesOrderType.

    44. Décochez/décochez la case SalesOrderDate.

    45. Dans la zone Rechercher, saisissez Achat.

    46. Décochez/décochez la case UncheckPurchaseOrderByShipToParty.

    47. Dans la zone Rechercher, saisissez salesorga.

    48. Décochez/décochez la case Organisation commerciale.

    49. Dans la zone Rechercher, saisissez demande.

    50. Décochez/décochez la case RequestedDeliveryD.

    51. Sélectionnez Supprimer.

    52. Sélectionnez à nouveau Supprimer.

      Remarque

      Notez que nous avons maintenant supprimé toutes les autres clés non requises pour l'action.
    53. Cliquez sur Sauvegarder.

Résultat

Vous avez encapsulé correctement les API de systèmes distants à l'aide de projets Actions.

Tâche 1: Actions de test

Étapes

  1. Encapsuler les API des systèmes distants à l'aide de projets d'actions.

    1. Sélectionnez Try Out.

    2. Sélectionnez En-tête de commande client.

    3. Sélectionnez Get/A_SalesOrder("{SalesOrder}").

    4. Dans la zone Valeur, saisissez 1.

    5. Sélectionnez Exécuter.

      Remarque

      Vous pouvez vérifier l'URL de la demande, la sortie du corps de la réponse ci-dessous.
    6. Sélectionnez Afficher clé API.

      Remarque

      La clé API sera incluse dans vos paramètres d'entrée Actions. Gardez cet onglet ouvert car nous y reviendrons pour les étapes suivantes de cet exercice.
    7. Sélectionnez Copier clé et Fermer.

    8. Sélectionnez Entrée.

    9. Cliquez sur Add.

    10. Sélectionnez Nouvelle zone.

    11. Dans la zone Clé, saisissez Clé API.

    12. Sélectionnez Paramètre.

    13. Sélectionnez Header.

    14. Dans la zone Valeur, saisissez pGAVlcXDR7tPplcGF02RinSeiT79TYSO.

      Remarque

      Vous trouverez l' étiquette dans le Business Accelerator Hub. Revenez à l'onglet à partir duquel vous avez copié la clé API.
    15. Sélectionnez Synthèse.

    16. Sélectionnez la zone de défilement pour faire défiler vers le bas.

      Remarque

      Copiez l'URL SANDBOX et ajoutez-la au paramètre d'entrée Valeurs.
    17. Dans la zone Étiquette, saisissez https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_SALES_ORDER_SRV.

    18. Sélectionnez la zone de défilement pour faire défiler vers le bas.

    19. Cliquez sur Add.

    20. Sélectionnez Test.

    21. Sélectionnez Manuel.

    22. Dans la zone URL, saisissez https://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_SALES_ORDER_SRV.

    23. Dans la zone Valeur de chaîne, saisissez 1.

    24. Sélectionnez Test.

      Remarque

      Le résultat de l'aperçu Test affiche les valeurs d'en-tête de la commande client.
    25. Sélectionnez Valider.

    26. Dans la zone Nouveautés version, saisissez Lit l'en-tête de la commande client.

    27. Sélectionnez Valider.

    28. Sélectionnez Publier dans la bibliothèque.

    29. Sélectionnez Publier.

      Remarque

      Le paramètre d'entrée pour la commande client a été ajouté. Vous pouvez maintenant accéder au Lobby pour le confirmer.
    30. Cliquez sur Mettre à jour.

Résultat

Vous avez encapsulé correctement les API de systèmes distants à l'aide de projets d'actions.