Funktionen von Advanced Process Building in SAP Build Process Automation verwenden

Kapseln der APIs von Remote-Systemen mithilfe von Aktionsprojekten

Objective

After completing this lesson, you will be able to aPIs von Remote-Systemen mithilfe von Aktionsprojekten kapseln

Kapselung von Remote-System-APIs mithilfe von Aktionsprojekten

Da sich viele Geschäftsprozesse über eine Vielzahl verschiedener Systeme und Anwendungen erstrecken, ist eine Interaktion mit diesen Systemen und Anwendungen im Business-Process-Management-System erforderlich. In SAP Build Process Automation verwenden Sie Aktionen, um die Integration durchzuführen. Application Programming Interfaces (APIs) aus dem Quell- und Zielsystem für die Interaktion sind in Aktionsprojekten als Aktionen gekapselt. Diese Aktionsprojekte werden dann in einer Aktionsprojektbibliothek abgelegt und können von dort aus in die Geschäftsprozesse integriert werden. Dieser Ansatz bietet verschiedene Vorteile im Vergleich zur direkten API-Integration in den jeweiligen Prozess:

  • Es gibt eine Abstraktion der API. Der Prozessentwickler muss die technischen Details der API nicht genau kennen.
  • APIs können an die Anforderungen der Prozessentwickler angepasst werden und stellen nur Endpunkte und Daten bereit, die von den Prozessentwicklern benötigt oder sicher verwendet werden können.
  • Aktionen können einmal konfiguriert und dann in verschiedenen Geschäftsprozessprojekten wiederverwendet werden.
  • Aktionsprojekte ermöglichen die Versionierung und erleichtern so den Umgang mit geänderten Prozessanforderungen oder API-Versionen.

Da sich Aktionen für die API-Definition auf den OpenAPI-Spezifikationsstandard (https://spec.openapis.org/oas/v3.1.0#openapi-specification) stützen, sind sie nicht auf APIs aus SAP-Systemen beschränkt, sondern bieten die Möglichkeit, beliebige APIs zu integrieren, die in der OpenAPI-Spezifikation beschrieben sind oder beschrieben werden können. Eine große Anzahl von API-Definitionen, insbesondere für SAP-Lösungen, finden Sie im SAP Business Accelerator Hub.

Notiz

Weitere Informationen zu APIs, insbesondere zu SAP-Build-Process-Automation-APIs, und wie Sie mit ihnen auf einer eher technischen Ebene interagieren, finden Sie im Kapitel API-Integration von SAP Build Process Automation.

Aktionseditor

Mit dem Aktionseditor können Sie mehrere Aktionen aus einer zugrunde liegenden API in ein Aktionsprojekt zusammenstellen. Beachten Sie, dass Sie nicht alle möglichen Parameter eines API-Endpunkts als Parameter in die entsprechenden Aktionen aufnehmen müssen und dass Sie auch nicht alle verfügbaren Antworttextfelder in die Antwort aufnehmen müssen, die über die Aktion bereitgestellt wird. Dadurch können nur Informationen aufgenommen werden, die für den Geschäftsprozess relevant sind.

Sobald Ihre Aktionen definiert wurden, muss das Projekt in einer Version freigegeben und dann in der Aktionsbibliothek veröffentlicht werden.

Nachdem APIs in einem Aktionsprojekt gekapselt und in der Bibliothek veröffentlicht wurden, ist das Hinzufügen als Aktion zu einem Prozess recht einfach. Wählen Sie den entsprechenden Schritttyp Aktionen aus, und durchsuchen Sie die Aktionsbibliothek. Wählen Sie die in Ihrem Prozess erforderliche Aktion aus, und wählen Sie Hinzufügen. Sobald der Aktionsschritt in Ihrem Prozess enthalten ist, stellen Sie sicher, dass Sie seine Parameter definieren:

  • Zielvariable: Eine Prozessvariable, die den technischen Namen der SAP-BTP-Destination enthält, der für den Zugriff auf das zugrunde liegende API zur Prozesslaufzeit verwendet werden soll. Diese Variable kann während des Deployments des Prozesses mit einem Destinationsnamen gefüllt werden.
  • Eingaben: Zuordnung des Prozessinhalts zu allen Parametern, die die Aktion erfordert, um ausgeführt zu werden (z.B. die Kundenauftragsnummer, wenn ein Kundenauftragseintrag aus einem SAP-S/4HANA-System abgerufen wird).
  • Ausgaben: Übersicht über das Aktionsanrufergebnis, wie in der jeweiligen Aktion definiert.

APIs von Remote-Systemen mithilfe von Aktionsprojekten kapseln

Unternehmensszenario

Sie und Ihre Kollegen erstellen einen Prozess, der Kundenauftragsdaten aus Ihrem SAP-S/4HANA-System lesen und zu einem späteren Zeitpunkt auch Kundenauftragsdaten zurück in das System schreiben muss. Jetzt stehen Sie vor der Herausforderung, im Prozess mit diesem SAP-S/4HANA-System zu interagieren. Als Lösung für diese Herausforderung bietet SAP Build Process Automation die Funktionen von Aktionsprojekten. Sie definieren alle Endpunkte des SAP-S/4HANA-Kundenauftrags-APIs, die im Prozess verwendet werden sollen, als Aktionen in einem Aktionsprojekt. Diese Vorgehensweise kann auch als Kapselung der APIs beschrieben werden, da Sie einen Wrapper nur um die speziell erforderlichen API-Endpunkte erstellen. Durch die Freigabe und Veröffentlichung des Aktionsprojekts sind die Aktionen in einer Aktionsbibliothek für die Verwendung in Ihren Prozessen verfügbar.

Weitere Informationen zum Kapseln von Remote-System-APIs mithilfe von Aktionsprojekten finden Sie in diesem Tutorial.

Ausübungsoptionen

Um mit der Übung zu beginnen, wählen Sie in der Abbildung unten Übung starten.

Ein Dialogfenster wird geöffnet. Sie haben folgende Möglichkeiten:

  • Wählen Sie Start: Die Simulation wird gestartet. Folgen Sie der Simulation, um zu erfahren, wie Sie APIs von Remote-Systemen mithilfe von Aktionsprojekten kapseln.
  • Wenn Sie PDF-Dokument öffnen: Eine PDF wählen, wird geöffnet. Basierend auf den in diesem Dokument beschriebenen Schritten können Sie die Übung in Ihrer eigenen Systemlandschaft durchführen.

Schritte

  1. Kapseln Sie Remote-System-APIs mithilfe von Aktionsprojekten neu.

    1. Wählen Sie Actions.

    2. Wählen Sie Anlegen.

    3. Wählen Sie den Blätterbereich, um nach unten zu blättern.

    4. Wählen Sie SAP Business Accelerator Hub.

    5. Wählen Sie den Blätterbereich, um nach unten zu blättern.

    6. Wählen Sie SAP S/4HANA Cloud Public Edition.

    7. Wählen Sie den Blätterbereich, um nach unten zu blättern.

    8. Wählen Sie SAP S/4HANA Cloud Public Edition.

    9. Geben Sie im Feld Suchen den Wert Verkauf ein.

    10. Drücken Sie die Eingabetaste.

    11. Wählen Sie Kundenauftrag (A2X).

    12. Wählen Sie API-Dokumentation anzeigen.

    13. Wählen Sie den Blätterbereich, um nach unten zu blättern.

    14. Wählen Sie API-Spezifikationen.

    15. Wählen Sie Herunterladen.

      Notiz

      In den folgenden Schritten laden Sie die heruntergeladene JSON-Datei in Ihr Projekt hoch. Navigieren Sie dazu zurück zur Registerkarte „Build Apps".
    16. Wählen Sie Zurück.

    17. Wählen Sie Integrationsquellen.

    18. Wählen Sie den Blätterbereich, um nach unten zu blättern.

    19. Wählen Sie API-Spezifikation hochladen.

    20. Wählen Sie Durchsuchen Dateien.

    21. Wählen Sie API_SALES_ORDER_SRV.json.

    22. Wählen Sie Open.

    23. Wählen Sie Next.

    24. Geben Sie im Feld ProjektnameSAP S/4HANA Sales Order Actions ein.

    25. Geben Sie im Feld BeschreibungAktionen Projekt ein, um mit dem Kundenauftrag im S/4HANA-System zu interagieren.

    26. Wählen Sie Anlegen.

    27. Wählen Sie SAP S/4HANA Sales Order Actions.

    28. Wählen Sie den Blätterbereich, um nach unten zu blättern.

    29. Wählen Sie Kundenauftragskopf.

    30. Wählen Sie Liest den Kopf eines Kundenauftrags.

    31. Wählen Sie Add.

    32. Wählen Sie Ausgabe.

    33. Wählen Sie Alle markieren.

    34. Um den Bereich Schlüssel zu expandieren, wählen Sie den Pfeil.

    35. Wählen Sie Search.

    36. Geben Sie im Feld SuchenOrgani ein.

    37. Entmarkieren Sie das Ankreuzfeld OrganizationDivison.

    38. Geben Sie im Feld Suchendistrib.

    39. Entmarkieren Sie das Ankreuzfeld DistributionChannel.

    40. Geben Sie im Feld Suchen den Wert Gesamt ein.

    41. Entmarkieren Sie das Ankreuzfeld TotalNetAmount.

    42. Geben Sie im Feld Searchden Wert Salesord ein.

    43. Entmarkieren Sie das Ankreuzfeld SalesOrderType.

    44. Deaktivieren Sie das Kontrollkästchen SalesOrderDate.

    45. Geben Sie im Feld Suchen den Wert Einkauf ein.

    46. Entmarkieren Sie das Ankreuzfeld UncheckPurchaseOrderByShipToParty.

    47. Geben Sie im Feld Suchensalesorga ein.

    48. Entmarkieren Sie das Ankreuzfeld Verkaufsorganisation.

    49. Geben Sie im Feld Suchen die Anforderung ein.

    50. Entmarkieren Sie das Ankreuzfeld RequestedDeliveryD.

    51. Wählen Sie Entfernen.

    52. Wählen Sie erneut Entfernen.

      Notiz

      Beachten Sie, dass wir nun alle anderen nicht erforderlichen Schlüssel für die Aktion entfernt haben.
    53. Wählen Sie Sichern.

Ergebnis

Sie haben nun APIs für Remote-Systeme mithilfe von Aktionsprojekten gekapselt.

Aufgabe 1: Testaktionen

Schritte

  1. Kapseln Sie Remote-System-APIs mithilfe von Aktionsprojekten.

    1. Wählen Sie Try Out.

    2. Wählen Sie Kundenauftragskopf.

    3. Wählen Sie Get/A_SalesOrder("{SalesOrder}").

    4. Geben Sie im Feld Wertden Wert 1 ein.

    5. Wählen Sie Run.

      Notiz

      Sie können die folgende Ausgabe für Anfrage-URL und Antworttext überprüfen.
    6. Wählen Sie API-Schlüssel anzeigen.

      Notiz

      Der API-Schlüssel wird in Ihre Aktionen -Eingabeparameter aufgenommen. Lassen Sie diese Registerkarte geöffnet, da wir für die nächsten Schritte in dieser Übung zurückkehren.
    7. Wählen Sie Schlüssel kopieren und schließen.

    8. Wählen Sie Eingabe.

    9. Wählen Sie Add.

    10. Wählen Sie Neues Feld.

    11. Geben Sie APIKey in das Feld Key ein.

    12. Wählen Sie Parameter.

    13. Wählen Sie Kopf.

    14. Geben Sie im Feld WertpGAVlcXDR7tPplcGF02RinSeiT79TYSO ein.

      Notiz

      Sie finden den Bezeichner im Business Accelerator Hub und kehren zur Registerkarte zurück, von der aus Sie den API-Schlüssel kopiert haben.
    15. Wählen Sie Übersicht.

    16. Wählen Sie den Blätterbereich, um nach unten zu blättern.

      Notiz

      Kopieren Sie die SANDBOX-URL, und fügen Sie sie dem Eingabeparameter Values hinzu.
    17. Geben Sie im Feld Labelhttps://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_SALES_ORDER_SRV ein.

    18. Wählen Sie den Blätterbereich, um nach unten zu blättern.

    19. Wählen Sie Add.

    20. Wählen Sie Testen.

    21. Wählen Sie Manuell.

    22. Geben Sie im Feld URLhttps://sandbox.api.sap.com/s4hanacloud/sap/opu/odata/sap/API_SALES_ORDER_SRV ein.

    23. Geben Sie im Feld Zeichenfolgenwertden Wert 1 ein.

    24. Wählen Sie Testen.

      Notiz

      Die Ausgabe der Testvorschau zeigt die Kopfwerte des Kundenauftrags an.
    25. Wählen Sie Freigeben.

    26. Geben Sie im Feld Release-Informationenden Wert Liest den Kopf des Kundenauftrags ein.

    27. Wählen Sie Freigeben.

    28. Wählen Sie In Bibliothek veröffentlichen.

    29. Wählen Sie Freigeben.

      Notiz

      Der Eingabeparameter für den Kundenauftrag wurde erfolgreich hinzugefügt. Sie können nun zur Lobby navigieren, um dies zu bestätigen.
    30. Wählen Sie Aktualisieren.

Ergebnis

Sie haben nun APIs für Remote-Systeme mithilfe von Aktionsprojekten gekapselt.