In dieser Anleitung wird ein Anwendungsfall beschrieben, in dem die Anwendungsintegration verwendet wird, um den Geschäftsprozessablauf für das Weiterleiten und Zuweisen eines Salesforce-Kundenfalls zu automatisieren.
Übersicht
In dieser Anleitung erstellen Sie eine Integration, die einen Salesforce-Trigger verwendet, um einen Fallkanal in Salesforce zu abonnieren. Durch einen neuen Fall in Salesforce wird die Integration aufgerufen, die die Fall-ID und den Falltyp extrahiert. Je nach Falltyp wird in Jira Cloud bzw. ServiceNow ein neues Problem oder Vorfall erstellt.
Lernziele
In dieser Anleitung erfahren Sie, wie Sie die folgenden Aufgaben in Ihrer Integration ausführen:
- Richten Sie den Salesforce-Trigger zum Aufrufen Ihrer Integration ein.
- Connectors-Aufgaben für Salesforce-, Jira Cloud- und ServiceNow-Verbindungen hinzufügen und konfigurieren.
- Fügen Sie Datenzuordnungsaufgaben hinzu und konfigurieren Sie sie, um Falldetails zu extrahieren und zuzuordnen.
Kosten
In dieser Anleitung verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:
Die Anweisungen in dieser Anleitung sind so konzipiert, dass Ihre Ressourcennutzung innerhalb der Grenzen der Immer kostenlos-Stufe von Google Cloud bleibt.
Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.
Hinweise
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the following roles to the service account: Secret Manager Viewer (
roles/secretmanager.viewer
), Secret Manager Secret Accessor (roles/secretmanager
).To grant a role, find the Select a role list, then select the role.
To grant additional roles, click
Add another role and add each additional role. - Click Continue.
-
Click Done to finish creating the service account.
-
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the following roles to the service account: Secret Manager Viewer (
roles/secretmanager.viewer
), Secret Manager Secret Accessor (roles/secretmanager
).To grant a role, find the Select a role list, then select the role.
To grant additional roles, click
Add another role and add each additional role. - Click Continue.
-
Click Done to finish creating the service account.
-
Umgebung vorbereiten
Salesforce-Nutzereinrichtung überprüfen
In dieser Anleitung wird davon ausgegangen, dass Sie ein bestehendes Salesforce-Entwicklerkonto mit den erforderlichen Nutzereinstellungen und Berechtigungen haben. Prüfen Sie, ob für Ihr Konto Change Data Capture (CDC) aktiviert ist. Informationen zum Erstellen eines neuen Kontos finden Sie unter Integrationsnutzer einrichten.
Jira Cloud-Konto bestätigen
In dieser Anleitung wird Jira Cloud verwendet. Sie können entweder Ihr vorhandenes Jira Cloud-Konto verwenden oder ein neues erstellen. Prüfen Sie, ob Ihr Jira Cloud-Projekt und Ihre Boards eingerichtet sind. Weitere Informationen zu Jira Cloud finden Sie in der Jira-Softwaredokumentation.
ServiceNow-Instanz prüfen
In dieser Anleitung wird eine kostenlose Personal Developer-Instanz (PDI) von ServiceNow verwendet. Sie können entweder Ihre vorhandene ServiceNow-Instanz verwenden oder eine neue erstellen. Prüfen Sie, ob Ihre Instanz aktiv ist, und notieren Sie sich die Instanz-URL. Weitere Informationen zu PDI finden Sie in der Dokumentation zu ServiceNow PDI.
Verbindungen konfigurieren
Für diese Anleitung müssen Sie die folgenden Verbindungen in Integration Connectors konfigurieren:
- Salesforce-Verbindung
- Konfigurieren Sie eine Salesforce-Verbindung in Integration Connectors. Informationen zum Konfigurieren eines Salesforce-Connectors finden Sie unter Salesforce-Connector.
- Jira Cloud-Verbindung
- Konfigurieren Sie eine Jira Cloud-Verbindung in Integration Connectors mithilfe Ihrer Projekt-URL, um Jira-Probleme in Ihrem Projekt zu erstellen. Notieren Sie sich die Projekt-ID und die Problem-ID. Informationen zum Konfigurieren eines Jira-Cloud-Connectors finden Sie unter Jira-Cloud-Connector.
- ServiceNow-Verbindung
- Konfigurieren Sie in Integration Connectors eine ServiceNow-Verbindung mithilfe Ihrer Instanz-URL, um Vorfälle in ServiceNow zu erstellen. Informationen zum Konfigurieren eines ServiceNow-Connectors finden Sie unter ServiceNow-Connector.
Verknüpfung erstellen
So erstellen Sie eine neue Integration:
- Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
- Klicken Sie im Navigationsmenü auf Integrations (Integrationen). Die Seite Liste der Integrationen wird angezeigt.
- Klicken Sie auf
- Integration name (Name der Integration): Geben Sie
salesforce-case-integration
ein. - Beschreibung: Geben Sie
Demo integration created for tutorial
ein. - Region: Wählen Sie
us-central1
aus der Liste der unterstützten Regionen aus. - Klicken Sie auf Erstellen, um den Integrationseditor zu öffnen.
Create integration (Integration erstellen) und geben Sie auf der Seite Create Integration (Integration erstellen) die folgenden Details an:
- Integration name (Name der Integration): Geben Sie
Integrationstrigger einrichten
Nachdem Sie die Integration erstellt haben, können Sie einen Integrationstrigger hinzufügen und konfigurieren, der die Integration für ein identifiziertes Ereignis aufruft.
In dieser Anleitung wird ein Salesforce-Trigger verwendet, um die Integration für jeden neuen Fall aufzurufen, der in Salesforce erstellt wird. So fügen Sie Ihrer salesforce-case-integration
-Integration einen Salesforce-Trigger hinzu und konfigurieren ihn:
- Klicken Sie im Integrationseditor auf Trigger, um eine Liste der verfügbaren Trigger aufzurufen.
- Klicken Sie auf das Element Salesforce-Trigger und platzieren Sie es im Integrationseditor.
- Wählen Sie auf dem Designer-Canvas das Element Salesforce-Trigger aus, um den Bereich mit der Salesforce-Triggerkonfiguration zu öffnen.
- Konfigurieren Sie die folgenden Felder unter Triggereingabe:
- Ereignistyp: Wählen Sie Change Data Capture (CDC) aus der Drop-down-Liste aus.
- Salesforce-Instanzkonfiguration: Klicken Sie auf die Option + Neue Salesforce-Instanzkonfiguration hinzufügen aus der Drop-down-Liste.
Führen Sie im Dialogfeld Salesforce-Instanzkonfiguration hinzufügen die folgenden Schritte aus:
- Verbindungsname der Salesforce-Instanz: Geben Sie einen Verbindungsnamen für die Salesforce-Instanz ein. Beispiel:
test
. - Salesforce-Domain: Geben Sie Ihren Salesforce-Domainnamen ein. Diese Informationen finden Sie auf der Seite Salesforce-Konto > Profil anzeigen.
- Authentifizierungsprofil: Wählen Sie ein Authentifizierungsprofil aus. Falls Sie noch kein Authentifizierungsprofil haben, erstellen Sie ein neues Profil. Weitere Informationen finden Sie unter Neues Authentifizierungsprofil erstellen.
- Klicken Sie auf Hinzufügen.
- Verbindungsname der Salesforce-Instanz: Geben Sie einen Verbindungsnamen für die Salesforce-Instanz ein. Beispiel:
- Salesforce-Kanalkonfiguration: Klicken Sie auf die Option + Neue Salesforce-Kanalkonfiguration hinzufügen aus der Drop-down-Liste.
Führen Sie im Dialogfeld Salesforce-Kanal hinzufügen die folgenden Schritte aus:
- Salesforce-Objektname: Geben Sie
Case
ein. - Klicken Sie auf Hinzufügen.
- Salesforce-Objektname: Geben Sie
- Vorgang: Wählen Sie aus der Drop-down-Liste Erstellen aus.
Änderungen an den Attributen werden automatisch gespeichert.
Triggernutzlast dem Salesforce-Connector zuordnen
Wenn die Integration mit dem Salesforce-Trigger aufgerufen wird, extrahieren Sie die Fall-ID und ordnen sie einem Salesforce-Connector zu, um weitere Details zur Anfrage abzurufen.
Verbindung zum Salesforce-Konto herstellen
Führen Sie die folgenden Schritte aus, um eine Connectors-Aufgabe hinzuzufügen und zu konfigurieren und die Falldetails über die Salesforce-Verbindung abzurufen:
- Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
- Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.
- Wählen Sie das Aufgabenelement Connectors im Designer aus, um die Aufgabe Connectors anzuzeigen. Konfigurationsbereich.
- Klicken Sie auf
Fetch Salesforce Data
um.
und benennen Sie das Label Connectors in - Klicken Sie auf Connector konfigurieren.
- Führen Sie auf der Seite Connectors-Task-Editor folgende Schritte aus:
- Wählen Sie unter Verbindung auswählen die Region
us-central1
aus. - Wählen Sie Ihre Salesforce-Verbindung aus der Liste der verfügbaren Verbindungen aus.
- Klicken Sie auf Weiter.
- Wählen Sie unter Typ die Option Entitäten aus.
- Wählen Sie unter Set entities/actions (Entitäten/Aktionen festlegen) aus der Liste der verfügbaren Entitäten die Option Case (Fall) und dann Get (Abrufen) als Operation (Vorgang) aus.
- Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.
- Wählen Sie unter Verbindung auswählen die Region
Fall-ID extrahieren und zuordnen
Mit der Aufgabe Datenabgleich werden die Falldetails zwischen diesem Salesforce-Trigger und dem Salesforce-Connector zugeordnet und extrahiert.
So fügen Sie der Integration die Datenzuordnung hinzu und konfigurieren sie:
- Klicken Sie im Integrationseditor auf Tasks (Aufgaben), um eine Liste der verfügbaren Aufgaben aufzurufen.
- Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
- Wählen Sie im Designer das Element Datenabgleich aus, um den Konfigurationsbereich der Aufgabe aufzurufen.
- Klicken Sie auf
Get Case ID
um.
und benennen Sie die Aufgabe Datenabgleich in - Klicken Sie auf Datenabgleichs-Editor öffnen.
Mit den Transformationsfunktionen im Datenabgleichs-Editor können Sie Eingabevariablen den gewünschten Ausgabevariablen zuordnen. Die Ausgabe ist dann als Variable für alle anderen Integrationsaufgaben oder Trigger verfügbar. Weitere Informationen zu finden Sie unter Zuordnung hinzufügen.
- Ordnen Sie die Trigger-Ausgabevariable
SalesforceTriggerCdcRecordID
der automatisch generierten EingabevariablenentityId(Fetch Salesforce Data)
des Connectors zu.Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.
- Fügen Sie eine Edge-Verbindung über den Salesforce-Trigger zur Aufgabe Fall-ID abrufen hinzu.
- Fügen Sie eine Edge-Verbindung aus der Aufgabe Fall-ID abrufen zum Connector Salesforce-Daten abrufen hinzu.
Falltyp extrahieren
Nachdem Sie alle Falldetails aus dem Salesforce-Connector abgerufen haben, extrahieren Sie den Falltyp und leiten ihn an die Anwendung Jira Cloud oder ServiceNow weiter.
So extrahieren Sie den Salesforce-Falltyp:
- Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
- Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
- Klicken Sie im Designer auf das Element Datenzuordnung, um den Bereich zur Aufgabenkonfiguration aufzurufen.
- Klicken Sie auf
Get case type
um.
und benennen Sie die Aufgabe Datenzuordnung in - Klicken Sie auf Datenabgleichs-Editor öffnen.
- Klicken Sie auf + Neue Variable hinzufügen und erstellen Sie die folgende Ausgabevariable:
Ausgabe-Variablenname Datentyp sf_case_type
STRING
- Erstellen Sie die folgende Zuordnung zwischen der Nutzlastvariable des Salesforce-Connectors und der lokalen Variablen:
Eingabe Ausgabe connectorOutputPayload (Fetch Salesforce Data) .GET_PROPERTY("Type")
sf_case_type
Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.
- Fügen Sie eine Edge-Verbindung vom Connector Salesforce-Daten abrufen zur Aufgabe Falltyp abrufen hinzu.
Neues Jira-Problem erstellen
Nachdem Sie den Salesforce-Falltyp extrahiert haben und der Fall vom Typ Engineering
ist, leiten Sie ihn als neues Problem an Jira Cloud weiter.
Mit Jira-Projekt verbinden
Führen Sie die folgenden Schritte aus, um eine Connectors-Aufgabe zu konfigurieren, die in Ihrem Jira-Projekt ein neues Problem erstellt:
- Klicken Sie im Integrationseditor auf Tasks (Aufgaben), um eine Liste der verfügbaren Aufgaben aufzurufen.
- Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.
- Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
- Klicken Sie auf
Create issue in Jira
.
und ändern Sie den Namen von Connectors in - Klicken Sie auf Connector konfigurieren.
- Führen Sie auf der Seite Connectors-Aufgabeneditor die folgenden Schritte aus:
- Wählen Sie unter Verbindung auswählen die Region
us-central1
aus. - Wählen Sie Ihre Jira Cloud-Verbindung aus der Liste der verfügbaren Verbindungen aus.
- Klicken Sie auf Weiter.
- Wählen Sie unter Typ die Option Entitäten aus.
- Wählen Sie unter Set entities/actions (Entitäten/Aktionen festlegen) die Option Issues (Probleme) aus der Liste der verfügbaren Entitäten aus und wählen Sie dann Create (Erstellen) als Operation (Vorgang) aus.
- Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.
- Wählen Sie unter Verbindung auswählen die Region
Problemdetails transformieren und zuordnen
So transformieren Sie die Falldetails und ordnen sie einem Jira-Problem zu:
- Klicken Sie im Integrationseditor auf Tasks (Aufgaben), um eine Liste der verfügbaren Aufgaben aufzurufen.
- Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
- Klicken Sie im Designer auf das Element Datenzuordnung, um den Bereich zur Aufgabenkonfiguration aufzurufen.
- Klicken Sie auf
Mapping for issue creation
um.
und benennen Sie die Aufgabe Datenzuordnung in - Klicken Sie auf Datenabgleichs-Editor öffnen.
- Klicken Sie auf + Neue Variable hinzufügen und erstellen Sie die folgenden Variablen:
Variablenname Datentyp Standardwert jira_project-id
STRING
Ersetzen Sie JIRA_PROJECT_ID durch Ihre Jira-Projekt-ID.JIRA_PROJECT_ID
jira_issue_type_id
STRING
Ersetzen Sie JIRA_ISSUE_TYPE_ID durch eine der folgenden Problemtyp-IDs:JIRA_ISSUE_TYPE_ID
1000
– für Epic1001
: für Story1002
– für Aufgabe1003
: für Unteraufgabe1004
– für Fehler
- Erstellen Sie die folgende Zuordnung:
Eingabe Ausgabe "{ "IssueTypeId": jira_issue_type_id, "ProjectId": jira_project_id }" .TO_JSON() .SET_PROPERTY( connectorOutputPayload.Description (Fetch Salesforce Data), "Description" ) .SET_PROPERTY( connectorOutputPayload.Subject (Fetch Salesforce Data), "Summary" )
connectorInputPayload (Create issue in Jira)
Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.
- Fügen Sie eine Edge-Verbindung aus der Aufgabe Für die Problemerstellung zuordnen dem Connector Problem in Jira erstellen hinzu.
Neuen ServiceNow-Vorfall erstellen
Wenn der aus Salesforce extrahierte Fall den Typ Sales
hat, leite ihn als neuen Vorfall an ServiceNow weiter.
Verbindung zu ServiceNow herstellen
Führen Sie die folgenden Schritte aus, um eine Connectors-Aufgabe zu konfigurieren, die einen neuen Vorfall für Ihre ServiceNow-Instanz erstellt:
- Klicken Sie im Integrationseditor auf Tasks (Aufgaben), um eine Liste der verfügbaren Aufgaben aufzurufen.
- Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.
- Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
- Klicken Sie auf
Create incident in ServiceNow
um.
und benennen Sie die Connectors in - Klicken Sie auf Connector konfigurieren.
- Führen Sie auf der Seite Connectors-Aufgabeneditor die folgenden Schritte aus:
- Wählen Sie unter Verbindung auswählen die Region
us-central1
aus. - Wählen Sie Ihre ServiceNow-Verbindung aus der Liste der verfügbaren Verbindungen aus.
- Klicken Sie auf Weiter.
- Wählen Sie unter Typ die Option Entitäten aus.
- Wählen Sie unter Set entities/actions (Entitäten/Aktionen festlegen) die Option Vorfall aus der Liste der verfügbaren Entitäten und dann Create (Erstellen) als Operation (Vorgang) aus.
- Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.
- Wählen Sie unter Verbindung auswählen die Region
Verkehrsbehinderungsdetails transformieren und zuordnen
So transformieren Sie die Falldetails und ordnen sie einem ServiceNow-Vorfall zu:
- Klicken Sie im Integrationseditor auf Tasks (Aufgaben), um eine Liste der verfügbaren Aufgaben aufzurufen.
- Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
- Klicken Sie im Designer auf das Element Datenzuordnung, um den Bereich zur Aufgabenkonfiguration aufzurufen.
- Klicken Sie auf
Mapping for incident creation
um.
und benennen Sie die Aufgabe Datenzuordnung in - Klicken Sie auf Datenabgleichs-Editor öffnen.
- Klicken Sie auf + Neue Variable hinzufügen und erstellen Sie die folgenden Eingabevariablen:
- Erstellen Sie die folgende Zuordnung:
Eingabe Ausgabe "{}" .TO_JSON() .SET_PROPERTY( connectorOutputPayload.Description (Fetch Salesforce Data), "description" ) .SET_PROPERTY( connectorOutputPayload.Subject (Fetch Salesforce Data), "short_description" )
connectorInputPayload (Create incident in ServiceNow)
Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.
- Fügen Sie eine Edge-Verbindung aus der Aufgabe Für die Vorfallerstellung zuordnen dem Connector Vorfall in ServiceNow erstellen hinzu.
Randbedingung hinzufügen
Mit einer Edge-Bedingung können Sie die Bedingungen angeben, die erfüllt sein müssen, damit die Steuerung einer Integration an die über die Edge verbundene Aufgabe übergeben wird. Nachdem Sie nun die erforderlichen Aufgaben hinzugefügt und konfiguriert haben, können Sie eine Edge-Bedingung hinzufügen, um den Integrationsablauf zu definieren.
Die folgende Edge-Bedingung steuert den Ablauf der Integration basierend auf dem Typ des Salesforce-Falls:
- Fügen Sie eine Edge-Verbindung aus der Aufgabe Falltyp abrufen der Aufgabe Für die Problemerstellung zuordnen mit der folgenden Edge-Bedingung hinzu:
$sf_case_type$ = "Engineering"
- Fügen Sie eine weitere Edge-Verbindung aus der Aufgabe Falltyp abrufen der Aufgabe Für Vorfallerstellung zuordnen mit der folgenden Edge-Bedingung hinzu:
$sf_case_type$ = "Sales"
Beispiel für den Integrationsablauf
Die folgende Abbildung zeigt ein Beispiellayout der mit dieser Anleitung erstellten Integration.
Integration veröffentlichen und testen
Um die Integration zu veröffentlichen, klicken Sie in der Symbolleiste des Integrationseditors auf Publish (Veröffentlichen).
Nachdem die Integration veröffentlicht wurde, können Sie die Ausführungsprotokolle der veröffentlichten Integration aufrufen und prüfen. Klicken Sie auf Ausführungsprotokolle für diese Integration ansehen, um Protokolle aufzurufen. Die Seite Ausführungsprotokolle wird angezeigt.
Testfall 1: Prüfen, ob ein Jira-Problem für einen Engineering-Fall erstellt wurde
Testen Sie die Integration, indem Sie sich bei der Salesforce-Instanz anmelden und einen neuen Fall erstellen. Beim Erstellen des Falls musst du in das Feld Typ den Wert Engineering
eingeben.
So überprüfen Sie, ob die Integration erfolgreich war:
Rufen Sie Ihr Jira Cloud-Konto auf.
- Prüfen Sie, ob in Ihrem Projekt ein neues Problem mit der Beschreibung und Zusammenfassung der Salesforce-Anfrage erstellt wurde.
Testfall 2: Um zu prüfen, ob ein ServiceNow-Vorfall für einen Verkaufsfall erstellt wird
Testen Sie die Integration, indem Sie sich bei der Salesforce-Instanz anmelden und einen neuen Fall erstellen. Beim Erstellen des Falls musst du in das Feld Typ den Wert Sales
eingeben.
So überprüfen Sie, ob die Integration erfolgreich war:
Rufen Sie Ihre ServiceNow-Instanz auf.
- Prüfen Sie, ob in Ihrer Instanz ein neuer Vorfall mit der Beschreibung und Zusammenfassung der Salesforce-Anfrage erstellt wurde.
Bereinigen
Damit Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen nicht in Rechnung gestellt werden, heben Sie die Veröffentlichung der Integration auf und löschen Sie die in Integration Connectors erstellten Verbindungen.
- Klicken Sie in der Symbolleiste des Integrationseditors auf Veröffentlichung aufheben, um die Veröffentlichung dieser Integration aufzuheben. Weitere Informationen finden Sie unter Integrationen löschen.
- Informationen zum Löschen einer Verbindung finden Sie unter Connectors verwalten.