Erste Schritte mit externen Services
Lernziele
Nachdem Sie diese Lektion abgeschlossen haben, sind Sie in der Lage, die folgenden Aufgaben auszuführen:
- Erläutern der Funktion der Externe Services-Funktion und der externen Services
- Beschreiben eines einfachen Workflows eines externen Services
Gründe für Externe Services
Sehen Sie sich das Einführungsvideo an, um zu erfahren, wie Sie API-Spezifikationen deklarativ in aufrufbare Aktionen umwandeln können.
Kunden erwarten heutzutage ein nahtloses Erlebnis, unabhängig davon, ob dieses Erlebnis aus Geschäftslösungen und Services hinter den Kulissen besteht, die sich auf einer einzigen Plattform oder auf mehreren Plattformen, Hosts befinden. Es ist diese Interaktion zwischen Salesforce und unabhängigen Services, die bei unserer Lösung "Externe Services" ihre Stärken ausspielt.
Externe Services erleichtert diesen Austausch, indem Ihnen die deklarative (also programmierungsfreie) Integration mit extern gehosteten Services ermöglicht wird, die Geschäftsaktionen oder Berechnungen in Ihrer Salesforce-Organisation durchführen. Welche Art nützlicher Services von Drittanbietern können also in eine Salesforce-Organisation integriert werden? Hier einige Beispiele:
- Service mit Bonitätsprüfungsfunktion für Ihre Salesforce-Detailseite für Accounts
- Service zur Überprüfung der Rabattberechtigung
- Services für flexible digitale Zahlung
- Kartenservices in Visualisierungstools
- Auftragsbenachrichtigung in Echtzeit in Slack
- Identifizierung: Service zur Betrugsverhinderung
- Integration getrennter Services für Einzelhandel auf allen Kanälen
- Google-Services
- Services von Behörden und internationalen Institutionen
- Luftqualitätsindex (Umweltbundesamt)
- Bürgerservices
- Centers for Disease Control and Prevention (CDC) (vergleichbar mit dem Robert-Koch-Institut)
- Weltbank
Wir befassen uns in Kürze mit den Einzelheiten dazu, was Externe Services ist und wie diese Lösung funktioniert. Doch zuerst werfen wir einen Blick auf einige Beispiele, die den Workflow veranschaulichen und zeigen, wie Externe Services die Integrationslandschaft für alle Arten von Webservices verändert.
Neuen Benutzern Ihrer Salesforce-Organisation automatisch das Arbeiten mit externen, organisationsbezogenen Anwendungen ermöglichen. Angenommen, Sie möchten, dass Benutzer auf eine externe Anwendung mit Informationen zur Gehaltsabrechnung zugreifen können, damit sie sich selbst einen Überblick über Arbeitszeit- und Gehaltsdaten verschaffen können. Sie registrieren Ihren externen Service (die Anwendung für die Gehaltsabrechnung), woraufhin Externe Services den Service in Aktionen für den Einsatz mit Flow Builder umwandelt. Als Nächstes erstellen Sie einen Flow mit Auslösern, die auf die Eingaben (z. B. Benutzer-ID) aus Ihrer Anwendung zur Gehaltsabrechnung reagieren. Jedes Mal, wenn Sie jetzt einen neuen Benutzer innerhalb von Salesforce anlegen, wird ein automatisch gestarteter Flow ausgelöst. Der Benutzer wird als Mitarbeiter mit Zugriff auf den Service mit der Anwendung für die Gehaltsabrechnung außerhalb von Salesforce hinzugefügt, die sein Arbeitszeitblatt und Gehalt enthält.
Auf Services außerhalb von Salesforce zugreifen, um eine Aufgabe zu erledigen. Angenommen, Sie möchten eine Verbindung mit einem Kreditservice herstellen, der bestimmt, ob einem in Ihrer Salesforce-Organisation gespeicherten Accountdatensatz der Kredit verlängert wird. Dies funktioniert wie folgt: Sie registrieren Ihren externen Service (den Kreditprüfungsdienst). Externe Services wandelt den Service in aufrufbare Aktionen (siehe Definition) zur Verwendung mit einem Plattform-Tool wie Flow Builder um. Anschließend erstellen Sie mit Flow Builder einen Flow, der die Aktionen dieses externen Service in Eingaben wie Auftragsbetrag und Kreditbedingungen einbezieht. Wenn der Flow ausgeführt wird, aktualisiert er die Kreditbedingungen für den Auftrag, der dem Account zugeordnet ist.
Sobald Sie die Grundlagen beherrschen, sind Sie in der Lage, den Workflow von Externe Services zu nutzen, um Services außerhalb von Salesforce zu nutzen, die am besten zu Ihrem Geschäftsmodell, Ihrem Anwendungsfall und vor allem zu Ihren Kunden passen.
Was wir mit "Externe Services" meinen
Können Sie Ihren externen Webservice von Ihren Externe Services-Lösungen unterscheiden? Beginnen wir mit einigen Definitionen.
Externe Services: Ein Salesforce-Integrationsprodukt, das (1) die Registrierung eines externen Webservice umfasst, den Sie als OpenAPI-konforme Spezifikation zur Definition des Webservice übermitteln, und (2) die (na ja, fast!) Überführung der Vorgänge Ihres externen Webservice auf die Salesforce Platform (siehe aufrufbare Aktionen) zur Verwendung mit Zeigen-und-Klicken-Tools wie Flow Builder. Kurz gesagt, werden externe REST-APIs unter Rückgriff auf OpenAPI-Standards deklarativ verbunden.
Externer Webservice: Auch als externe Services (klein geschrieben) bezeichnet. Jegliche Art von Funktionen, Aktionen oder Prozessen, die außerhalb der Salesforce Platform entwickelt und gehostet werden. Damit ein externer Webservice von Externe Services genutzt werden kann, muss es sich um eine REST-API handeln, die typischerweise das HTTPS-Protokoll zum Navigieren im Web verwendet. (Wenn Sie nicht wissen, was REST ist, kein Problem.)
API-Spezifikation: Bei der API-Spezifikation handelt es sich um eine Datei, die das beschreibende Schema enthält, das definiert, was eine API tun kann. Externe Services befolgt ein auf JSON basierendes OpenAPI-Spezifikationsformat. Eine API-Spezifikation ist sowohl menschen- als auch maschinenlesbar. Sie definiert die Grundlagen für Benennung, Reihenfolge und Inhalt von Objekten und sorgt für klare Interaktionen mit einer REST-API. Siehe OpenAPI-Spezifikation.
Aufrufbare Aktionen (im Kontext von External Services): Aufrufbare Aktionen stellen die deklarativen Bausteine dar, die von einer zunehmenden Zahl von Tools der Salesforce Platform wie Flow Builder oder Einstein Bots zur Verfügung gestellt werden. Aufrufbare Aktionen unterstützen Administratoren und Entwickler, indem sie eine Möglichkeit bieten, jede Art von Aktion einheitlich zu implementieren und zu nutzen. Sobald Sie im Ökosystem von Externe Services die Vorgänge Ihres externen Webservice bei Externe Services registriert haben, können Sie auf die sich ergebenden aufrufbaren Aktionen z. B. mit dem Tool Flow Builder zugreifen.
Flow Builder: Ein Zeigen-und-Klicken-Tool für das Erstellen von Flows.
Flow: Ein Flow ist der Teil von Salesforce Flow, der Daten sammelt und in Ihrer Salesforce-Organisation oder einem externen System Aufgaben ausführt. Salesforce Flow umfasst (mit Flow Builder erstellte) Flows und (mit Prozessgenerator erstellte) Prozesse.
Während sich diese Begriffe (OpenAPI-Spezifikation, API-Spezifikation und Schema) an Entwickler richten, helfen Externe Services dabei, die Lücke zwischen der Programmierung von Webservices und der Automatisierung des Zugriffs darauf zu schließen.
Übersicht
Es ist an der Zeit, einen Schritt zurückzutreten und das Gesamtbild zu betrachten, um die miteinander verbundenen Bausteine von Externe Services zu verstehen. Wie Sie sehen, erfolgen bei der Registrierung eines externen Service viele Schritte deklarativ auf der Registrierungsseite von Externe Services. Nach der Registrierung können Sie mit Tools wie Flow Builder einen Flow anhand der aufrufbaren Aktionen Ihres Webservice erstellen.
Hier Sie sehen eine Übersicht darüber, was passiert. Beachten Sie, dass es zwar sechs Schritte gibt, die wichtigsten für Externe Services jedoch die Schritte 3, 4 und 5 sind.
- Ein externer Webserviceanbieter, beispielsweise eine Bank, hostet seine REST-basierte API. Stellen Sie sich in diesem Szenario eine REST-API so vor, dass sie eine Art Vertrag zwischen der Bank (Anbieter) und Ihnen (Nutzer) festlegt.
- Der Webservice-Anbieter (wie in unserem Bank-Webservice-Beispiel) oder ein Entwickler (vielleicht sogar Sie) gibt eine auf JSON basierende API-Spezifikation frei, die die API beschreibt.
- Ein Salesforce-Administrator oder -Entwickler erstellt deklarativ Anmeldeinformationen mit Namen zur Authentifizierung des Endpunkts des Webservice, und zwar unter Verwendung des URL der REST-basierten API, die vom Anbieter des externen Webservice bereitgestellt wird. Der Endpunkt ist das Element, das die Ressourcen des Webservice für die Interaktion mit Externen Services verfügbar macht.
- Ein Salesforce-Administrator registriert den Webservice deklarativ und verwendet während des Registrierungsprozesses sowohl Anmeldeinformationen mit Namen als auch die API-Spezifikation. Externe Services importiert die Vorgänge der API-Spezifikation in Ihre Organisation und stellt sie als aufrufbare Aktionen zur Verfügung.
- Ein Salesforce-Administrator greift mit Flow Builder auf die aufrufbaren Flow-Aktionen zu, die in Schritt 4 registriert wurden.
- Zur Laufzeit sendet der Flow einen Aufruf an den Endpunkt des Webservice. Der Webservice gibt basierend auf der API-Spezifikation eine Ausgabe zurück. Daten werden vom externen Webservice abgerufen, erstellt, aktualisiert oder gelöscht. Salesforce kann diese Antworten des externen Webservice für den Einsatz mit einem Tool wie Flow Builder erfassen.
Wenn der Ersteller einer API keine Spezifikation für Sie freigegeben hat, ist das Erstellen einer API-Spezifikation in Schritt 2 kein deklarativer Prozess. Sie können die API-Spezifikation (abhängig von Ihrem Hintergrund) entweder selber erstellen, Ihren Entwickler hinzuziehen oder ein Schemagenerator-Tool wie z. B. den Swagger Editor verwenden.
In der nächsten Lektion beschäftigen wir uns mit den Ein- und Ausgaben einer API-Spezifikation und erklären, worum es sich dabei handelt. Sobald Ihre API-Spezifikation erstellt wurde, können Sie die bereits in Salesforce vorhandenen deklarativen Tools verwenden, um die für Ihre Organisation benötigten Geschäftsaktionen hinzuzufügen.