Was sind REST-APIs?
Natürlich basieren die meisten Anwendungen und Services, die auf der Cloud basieren und in der Cloud ausgeführt werden, auf REST-APIs:
- REST (= Representational State Transfer)
- ist ein Architekturstil, der bestimmte Richtlinien und Einschränkungen für die Gestaltung von Komponenten im Web definiert. Der Schwerpunkt liegt dabei insbesondere auf der Interaktion und Kommunikation solcher Komponenten.
- APIs (= Application Programming Interfaces)
- legt fest, wie Komponenten von anderen Komponenten kontaktiert werden können, um bestimmte Funktionen auszulösen oder Daten auszutauschen.
Eine REST-API (auch RESTful-API) ist eine API, die den Richtlinien und Einschränkungen entspricht, die durch den REST-Architekturstil definiert sind.
Endbenutzer greifen in der Regel nicht direkt auf die REST-APIs von Cloud-Anwendungen und -Services zu. Sie verwenden meist eine Anwendung, die eine grafische Benutzungsoberfläche (GUI) bereitstellt und relevante Informationen aus weiteren Cloud-Anwendungen und -Komponenten unter Verwendung von REST-APIs zusammenstellt. Daher werden die REST-APIs für den Endbenutzer ausgeblendet. Dies kann jedoch für Entwickler oder Administratoren anders sein, da sie möglicherweise Funktionen verwenden oder testen möchten, die nicht von einer Anwendung mit GUI bereitgestellt werden.
Während des Entwicklungsprozesses muss der Entwickler möglicherweise einzelne Funktionen bestimmter Komponenten testen oder simulieren, unabhängig von anderen Komponenten, die für das gesamte System oder die Architektur relevant sind. Beispielsweise arbeitet der Entwickler an einem neuen Prozess für die Genehmigung von Abwesenheitsanträgen. Im produktiven Szenario soll der Prozess durch eine Anwendung ausgelöst werden, die von einem anderen Team entwickelt wird. Die Anwendung ruft ein REST-API von SAP Build Process Automation auf, um den Abwesenheitsgenehmigungsprozess auszulösen. Da die Anwendung noch nicht vorhanden ist, möchte der Entwickler das REST-API während des Entwicklungsprozesses zum Testen manuell auslösen. Zu diesem Zweck können sie einen sogenannten REST-Client verwenden.
Ein REST-Client ist ein Werkzeug, das die technische Kommunikation mit REST-APIs vereinfacht. Sie bietet eine Schnittstelle zu erforderlichen technischen Kommunikationsprotokollen wie HTTPS und erleichtert deren Verwendung.
Eine weitere Rolle, die an REST-Clients im Kontext von SAP Build Process Automation interessiert sein könnte, ist der Operator oder Administrator. Diese Rolle verwaltet, verarbeitet und muss möglicherweise gelegentlich irreguläre Aufgaben ausführen. Dies können z.B. Bereinigungsaufgaben sein. Viele Administrations- und Betriebsfunktionen von SAP Build Process Automation sind über die Apps "Prozess- und Workflow-Instanzen überwachen" und "Prozesse und Workflows verwalten" verfügbar, einige Funktionen sind jedoch möglicherweise nur über das REST-API verfügbar.
APIs von SAP Build Process Automations im SAP Business Accelerator Hub ermitteln
Wenn Sie den SAP API Business Hub aufrufen (Link wird in Kürze ersetzt) und nach dem Produkt SAP Build Process Automation suchen, finden Sie das entsprechende API-Paket. Im Folgenden finden Sie die verschiedenen APIs, die es enthält, sowie jeweils ein Beispiel dafür, wie diese APIs genutzt werden können.
- Automatisierungsausführung
- Erstellen Sie eine Anwendung, mit der Sie bestimmte Automatisierungen starten können, indem Sie auf einen Button klicken.
- Automatisierungsüberwachung
- Ruft die Protokolle vergangener Automatisierungsläufe ab und verwaltet sie in einem anderen Werkzeug.
- Entscheidungen
- Führen Sie einen Regeldienst mit einem REST-Client aus, um zu testen, ob er die erwarteten Ergebnisse liefert.
- Eingang
- Erstellen Sie eine benutzerdefinierte Inbox-Anwendung, die ein anderes Erscheinungsbild hat als die von SAP ausgelieferte Standard-App Meine Inbox. Dieser Anwendungsfall erfordert auch das API Prozesse und Workflows.
- Workflows
- Lassen Sie eine andere Anwendung neue Prozess- oder Workflow-Instanzen auslösen.
- Szenarien für Prozesstransparenz
- Gewinnen Sie Transparenz über Prozesse oder Workflows in Fremdsystemen, indem Sie Prozessereignisse in den Service SAP Build Process Automation übertragen.
- Sichtbarkeitsarbeitsbereich
- Verschaffen Sie sich einen Überblick über die Sichtbarkeitsszenarios, auf die ein bestimmter Benutzer Zugriff hat.
Zu verwendenden Endpunkt suchen
Angenommen, Sie möchten erfahren, wie Sie einen neuen Prozess oder eine neue Workflow-Instanz mit den APIs von SAP Build Process Automation auslösen.
Wählen Sie im API-Paket von SAP Build Process Automation das REST-API Workflows aus. Sie erhalten eine Übersicht und Beschreibung des REST-APIs.
Wählen Sie API-Referenz, um die Details der verschiedenen API-Endpunkte anzuzeigen, die sie bereitstellt.
Wählen Sie Workflow-Instanzen und dann den POST-Endpunkt zum Starten neuer Instanzen aus.
Nun können Sie die Details für den entsprechenden Endpunkt anzeigen. Diese Sicht ist besonders wichtig, da sie auch Details zu erforderlichen Rollen oder Umfängen zum Ausführen des APIs und zu Parametern liefert, die beim Aufruf des APIs erforderlich sind. In der folgenden Übung lernen Sie die genauen erforderlichen Schritte kennen, wenn Sie ein SAP-Build-Process-Automation-API verwenden.
