Salesforce-Opportunity zu BigQuery-Bestellung automatisieren

In dieser Anleitung wird ein Anwendungsfall beschrieben, wie Sie Application Integration nutzen können, um einen Bestellverwaltungsfluss zwischen einer CRM-Anwendung (Customer-Relationship-Management) und einer ERP-Anwendung (Enterprise Resource Planning) zu automatisieren.

Überblick

Unternehmen nutzen verschiedene CRM- und ERP-Anwendungen, um Kundenaufträge zu erstellen, zu verarbeiten, zu verwalten und zu pflegen. Jede dieser Anwendungen wird von verschiedenen Teams oder Organisationen bearbeitet, und es ist eine Herausforderung, sicherzustellen, dass die Bestellung ständig verfolgt wird und gleichzeitig zeitnahe Kunden-Updates zur Verfügung gestellt werden.

In dieser Anleitung erstellen Sie eine Integration, die einen Salesforce-Trigger verwendet, um ein neues Opportunity-Ereignis in Salesforce zu abonnieren. Wenn eine neue Empfehlung erstellt wird, werden durch die Integration zusätzliche Details zur Empfehlung abgerufen, z. B. die Konto-ID und der Name. Diese Details werden in einer BigQuery-Tabelle geprüft, um die Opportunity zu erstellen und mit einer Tracking-Bestellnummer zu aktualisieren. Wenn die Kontoinformationen während der Validierung nicht in BigQuery vorhanden sind, erstellt die Integration mithilfe von Integration Connectors automatisch einen neuen Eintrag sowohl in der BigQuery-Tabelle als auch in der angehängten ServiceNow-Instanz.

Diagramm: Salesforce-Opportunity zu BigQuery-Bestellung Diagramm: Salesforce-Opportunity zu BigQuery-Bestellung

Lernziele

In dieser Anleitung erfahren Sie, wie Sie die folgenden Aufgaben in Ihrer Integration ausführen:

  • Richten Sie den Salesforce-Trigger zum Aufrufen der Integration ein.
  • Connectors-Aufgaben für Salesforce-, BigQuery- und ServiceNow-Verbindungen hinzufügen und konfigurieren.
  • Datenzuordnungsaufgaben hinzufügen und konfigurieren, um Details zu Geschäftschancen 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 Limits 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

  1. 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.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the BigQuery API.

    Enable the API

  5. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    2. Select your project.

    3. 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.

    4. Click Create and continue.

    5. Grant the following roles to the service account: BigQuery Data Editor (roles/bigquery.dataEditor), BigQuery Read Session User (roles/bigquery.readSessionUser), 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.

    6. Click Continue.

    7. Click Done to finish creating the service account.

  6. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  7. Make sure that billing is enabled for your Google Cloud project.

  8. Enable the BigQuery API.

    Enable the API

  9. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    2. Select your project.

    3. 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.

    4. Click Create and continue.

    5. Grant the following roles to the service account: BigQuery Data Editor (roles/bigquery.dataEditor), BigQuery Read Session User (roles/bigquery.readSessionUser), 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.

    6. Click Continue.

    7. 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 Change Data Capture (CDC) für Ihr Konto aktiviert ist. Informationen zum Erstellen eines neuen Kontos finden Sie unter Integrationsnutzer einrichten.

BigQuery-Dataset und -Tabelle einrichten

Für diese Anleitung müssen Sie ein BigQuery-Dataset einrichten und zwei Tabellen erstellen, um die Details zur Salesforce-Opportunity und die ServiceNow-Kontoinformationen zu speichern.

BigQuery-Dataset einrichten

So richten Sie das BigQuery-Dataset ein:

  1. Rufen Sie in der Google Cloud Console die Seite BigQuery auf.

    BigQuery aufrufen

  2. Klicken Sie auf den Bereich Explorer und wählen Sie das Projekt aus, das Sie für diese Anleitung verwenden.
  3. Maximieren Sie (Aktionen) und wählen Sie Dataset erstellen aus.
  4. Konfigurieren Sie auf der Seite Dataset erstellen die folgenden Details:
    1. Dataset-ID: Geben Sie Demo_order_dataset ein.
    2. Standorttyp > Region:Wählen Sie die Region us-central1 (lowa) aus.
  5. Klicken Sie auf Dataset erstellen.

    6. Das neue Dataset Demo_order_dataset sollte jetzt in Ihrem Projekt im Bereich Explorer angezeigt werden.

BigQuery-Tabellen einrichten

So erstellen Sie die BigQuery-Tabellen:

  1. Klicken Sie im Bereich Explorer auf das erstellte Dataset Demo_order_dataset und öffnen Sie es.
  2. Führen Sie die folgenden Schritte aus, um eine leere Tabelle Orders zum Speichern der Salesforce-Opportunity-Details zu erstellen:
    1. Klicken Sie auf Tabelle erstellen.
    2. Geben Sie im Abschnitt Ziel Orders als Tabellennamen ein.
    3. Klicken Sie im Abschnitt Schema auf Als Text bearbeiten und fügen Sie die folgende JSON-Schemadefinition ein: 
      [
  {
    "name": "order_number",
    "type": "STRING",
    "mode": "NULLABLE",
    "description": "Salesforce order number"
  },
  {
    "name": "order_status",
    "type": "STRING",
    "mode": "NULLABLE",
    "description": "Sale order status"
  },
  {
    "name": "tracking_number",
    "type": "INTEGER",
    "mode": "NULLABLE",
    "description": "Salesforce tracking number"
  }
]
    4. Klicken Sie auf Tabelle erstellen.
  3. So erstellen Sie eine leere Tabelle Konten, in der die Salesforce-Kontodetails gespeichert werden:
    1. Klicken Sie auf Tabelle erstellen.
    2. Geben Sie im Abschnitt Ziel Accounts als Tabellennamen ein.
    3. Klicken Sie im Abschnitt Schema auf Als Text bearbeiten und fügen Sie die folgende JSON-Schemadefinition ein: 
      [
  {
    "name": "account_id",
    "type": "STRING",
    "mode": "NULLABLE",
    "description": "Account ID for the opportunity"
  },
  {
    "name": "name",
    "type": "STRING",
    "mode": "NULLABLE",
    "description": "Account name for the opportunity"
  }
]
    4. Klicken Sie auf Tabelle erstellen.

    Die neuen Tabellen Orders und Accounts sollten jetzt im Bereich Explorer im Dataset Demo_order_dataset angezeigt werden.

ServiceNow-Instanz überprüfen

In dieser Anleitung wird eine kostenlose ServiceNow-PDI (Personal Developer Instance) verwendet. Sie können entweder Ihre vorhandene ServiceNow-Instanz verwenden oder eine neue erstellen. Überprüfen Sie, ob die 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
Salesforce-Verbindungen in Integration Connectors konfigurieren. Informationen zum Konfigurieren eines Salesforce-Connectors finden Sie unter Salesforce-Connector.
BigQuery-Verbindung
Konfigurieren Sie eine BigQuery-Verbindung in Integration Connectors, um Bestell- und Kontodetails im Dataset Demo_order_dataset abzurufen, zu aktualisieren und zu validieren. Informationen zum Konfigurieren eines BigQuery-Connectors finden Sie unter BigQuery-Connector.
ServiceNow-Verbindung
Konfigurieren Sie eine ServiceNow-Verbindung in Integration Connectors mithilfe Ihrer Instanz-URL, um Kontodetails in ServiceNow zu erstellen und abzurufen. Informationen zum Konfigurieren eines ServiceNow-Connectors finden Sie unter ServiceNow-Connector.

Integration erstellen

So erstellen Sie eine neue Integration:

  1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

    Zur Seite „Application Integration“

  2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen). Die Seite Integrations List (Integrationsliste) wird angezeigt.
  3. Klicken Sie auf Integration erstellen und geben Sie auf der Seite Integration erstellen die folgenden Informationen an:
    1. Integrationsname: Geben Sie opportunity-to-order-integration ein.
    2. Beschreibung: Geben Sie Demo integration created for tutorial ein.
    3. Region:Wählen Sie us-central1 aus der Liste der unterstützten Regionen aus.
    4. Klicken Sie auf Erstellen, um den Integrationseditor zu öffnen.

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 jede neue Opportunity aufzurufen, die in der Salesforce-Instanz erstellt wird. So fügen Sie in der opportunity-to-order-integration-Integration einen Salesforce-Trigger hinzu und konfigurieren ihn:

  1. Klicken Sie im Integrationseditor auf Trigger, um eine Liste der verfügbaren Trigger aufzurufen.
  2. Klicken Sie im Integrationseditor auf das Element Salesforce-Trigger und platzieren Sie es dort.
  3. Wählen Sie im Designer-Canvas das Element Salesforce-Trigger aus, um den Konfigurationsbereich für den Salesforce-Trigger zu öffnen.
  4. Konfigurieren Sie die folgenden Felder unter Triggereingabe:
    1. Ereignistyp: Wählen Sie Change Data Capture (CDC) aus der Drop-down-Liste aus.
    2. 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.
    3. 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 Opportunity ein.
      • Klicken Sie auf Hinzufügen.
    4. Vorgang: Wählen Sie aus der Drop-down-Liste Erstellen aus.

      5. Änderungen an den Attributen werden automatisch gespeichert.

Triggernutzlast dem Salesforce-Connector zuordnen

Wenn die Integration mit dem Salesforce-Trigger aufgerufen wird, extrahieren Sie die Opportunity-ID und ordnen sie einem Salesforce-Connector zu, um weitere Details zur Opportunity abzurufen.

Verbindung zum Salesforce-Konto herstellen

Führen Sie die folgenden Schritte aus, um eine Connectors-Aufgabe hinzuzufügen und zu konfigurieren, um die Opportunity-Details über die Salesforce-Verbindung abzurufen:

  1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  2. Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.
  3. Wählen Sie im Designer das Aufgabenelement Connectors aus, um den Konfigurationsbereich der Aufgabe „Connectors“ aufzurufen.
  4. Klicken Sie auf und benennen Sie das Label Connectors in Fetch Salesforce Data um.
  5. Klicken Sie auf Connector konfigurieren.
  6. Führen Sie auf der Seite Connectors-Task-Editor die folgenden Schritte aus:
    1. Wählen Sie unter Verbindung auswählen die Region us-central1 aus.
    2. Wählen Sie Ihre Salesforce-Verbindung aus der Liste der verfügbaren Verbindungen aus.
    3. Klicken Sie auf Next (Weiter).
    4. Wählen Sie unter Typ die Option Entitäten aus.
    5. Wählen Sie unter Set entity/actions (Entitäten/Aktionen festlegen) die Option Opportunity aus der Liste der verfügbaren Entitäten und dann Get als Operation (Vorgang) aus.
    6. Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.

Opportunity-ID extrahieren und zuordnen

Mithilfe der Aufgabe Datenzuordnung werden die Opportunity-Details zwischen diesem Salesforce-Trigger und dem Salesforce-Connector zugeordnet und extrahiert.

So fügen Sie Ihrer Integration die Datenzuordnung hinzu und konfigurieren sie:

  1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  2. Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
  3. Wählen Sie das Element Datenzuordnung im Designer aus, um den Bereich für die Aufgabenkonfiguration aufzurufen.
  4. Klicken Sie auf und benennen Sie die Aufgabe Datenzuordnung in Map to opportunity ID um.
  5. 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 zum Zuordnen von Variablen finden Sie unter Zuordnung hinzufügen.

  6. Ordnen Sie die Ausgabevariable SalesforceTriggerCdcRecordID der automatisch generierten Connector-Eingabevariable entityId(Fetch Salesforce Data) zu.

    Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

  7. Fügen Sie eine Edge-Verbindung über den Trigger Salesforce in der Aufgabe Zur Opportunity-ID zuordnen hinzu.
  8. Fügen Sie eine Edge-Verbindung aus der Aufgabe Zu Opportunity-ID zuordnen zum Connector Salesforce-Daten abrufen hinzu.

Salesforce-Konto in der BigQuery-Tabelle validieren

Nachdem Sie alle Opportunity-Details aus dem Salesforce-Connector abgerufen haben, extrahieren Sie die mit der Opportunity verknüpfte Konto-ID, ordnen Sie sie zu und überprüfen, ob sie in der BigQuery-Tabelle vorhanden ist.

Verbindung zur BigQuery-Tabelle herstellen

Führen Sie die folgenden Schritte aus, um eine Aufgabe Connectors zu konfigurieren, die die BigQuery-Tabellen Konten über die BigQuery-Verbindung liest:

  1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  2. Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.
  3. Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
  4. Klicken Sie auf und benennen Sie die Connectors in Check account in BigQuery um.
  5. Klicken Sie auf Connector konfigurieren.
  6. Führen Sie auf der Seite Connectors-Task-Editor die folgenden Schritte aus:
    1. Wählen Sie unter Verbindung auswählen die Region us-central1 aus.
    2. Wählen Sie Ihre BigQuery-Verbindung aus der Liste der verfügbaren Verbindungen aus.
    3. Klicken Sie auf Next (Weiter).
    4. Wählen Sie unter Typ die Option Entitäten aus.
    5. Wählen Sie unter Entitäten/Aktionen festlegen die Option Konten aus der Liste der verfügbaren Entitäten und dann Liste als Vorgang aus.
    6. Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.
  7. Fügen Sie eine Edge-Verbindung vom Connector Salesforce-Daten abrufen zum Connector Konto in BigQuery prüfen hinzu.

Salesforce-Konto-ID extrahieren und validieren

So extrahieren, ordnen und validieren Sie die Konto-ID der Opportunity:

  1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  2. Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
  3. Klicken Sie im Designer auf das Element Datenzuordnung, um den Bereich für die Aufgabenkonfiguration aufzurufen.
  4. Klicken Sie auf und benennen Sie die Aufgabe Datenzuordnung in Check account um.
  5. Klicken Sie auf Datenabgleichs-Editor öffnen.
  6. Klicken Sie auf + Neue Variable hinzufügen und erstellen Sie die folgenden Ausgabevariablen:
    Ausgabe-Variablenname Datentyp
    sf_account_id STRING
    sf_account_name STRING
    account_exists BOOLEAN
  7. Erstellen Sie die folgende Zuordnung zwischen der Nutzlastvariable des Salesforce-Connectors und der lokalen Variablen:
    Eingabe Ausgabe 
    
connectorOutputPayload ( Fetch Salesforce Data)
.GET_PROPERTY("AccountId")
    		sf_account_id 
    
connectorOutputPayload ( Fetch Salesforce Data)
.GET_PROPERTY("Name")
    		sf_account_name 
    
connectorOutputPayload (Check account in BigQuery)
.FILTER(~obj1 ->
~obj1
.GET_PROPERTY("account_id")
.TO_STRING()
.EQUALS(sf_account_id)
)
.SIZE()
.EQUALS("1")
    		account_exists

    Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

  8. Fügen Sie eine Edge-Verbindung vom Connector Konto in BigQuery prüfen in der Aufgabe Konto prüfen hinzu.

Neues BigQuery-Konto erstellen

Wenn Sie das Salesforce-Konto in BigQuery validiert haben und das Konto noch nicht vorhanden ist, gehen Sie so vor, um ein neues Konto in BigQuery zu erstellen. Sie verwenden dieselben Informationen auch, um ein Konto in ServiceNow zu erstellen.

Konto zu BigQuery hinzufügen

Führen Sie die folgenden Schritte aus, um eine Aufgabe Connectors zu konfigurieren, mit der eine neue Entität in der BigQuery-Tabelle Konten erstellt wird:

  1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  2. Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.
  3. Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
  4. Klicken Sie auf und benennen Sie die Connectors in Create account in BigQuery um.
  5. Klicken Sie auf Connector konfigurieren.
  6. Führen Sie auf der Seite Connectors-Task-Editor die folgenden Schritte aus:
    1. Wählen Sie unter Verbindung auswählen die Region us-central1 aus.
    2. Wählen Sie Ihre BigQuery-Verbindung aus der Liste der verfügbaren Verbindungen aus.
    3. Klicken Sie auf Next (Weiter).
    4. Wählen Sie unter Typ die Option Entitäten aus.
    5. Wählen Sie unter Entitäten/Aktionen festlegen die Option Konten aus der Liste der verfügbaren Entitäten aus und wählen Sie dann Erstellen als Vorgang aus.
    6. Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.

Neues ServiceNow-Konto erstellen

Führen Sie die folgenden Schritte aus, um eine Aufgabe Connectors zu konfigurieren, mit der Ihrer ServiceNow-Instanz ein neues Konto hinzugefügt wird:

  1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  2. Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.
  3. Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
  4. Klicken Sie auf und benennen Sie die Connectors in Create account in ServiceNow um.
  5. Klicken Sie auf Connector konfigurieren.
  6. Führen Sie auf der Seite Connectors-Task-Editor die folgenden Schritte aus:
    1. Wählen Sie unter Verbindung auswählen die Region us-central1 aus.
    2. Wählen Sie Ihre BigQuery-Verbindung aus der Liste der verfügbaren Verbindungen aus.
    3. Klicken Sie auf Next (Weiter).
    4. Wählen Sie unter Typ die Option Entitäten aus.
    5. Wählen Sie unter Entitäten/Aktionen festlegen den Eintrag system_user aus der Liste der verfügbaren Entitäten und dann Erstellen als Vorgang aus.
    6. Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.

Kontodetails umwandeln und zuordnen

So transformieren Sie die Kontodetails und ordnen sie den BigQuery- und ServiceNow-Connectors zu:

  1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  2. Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
  3. Klicken Sie im Designer auf das Element Datenzuordnung, um den Bereich für die Aufgabenkonfiguration aufzurufen.
  4. Klicken Sie auf und benennen Sie die Aufgabe Datenzuordnung in Mapping for Account Creation um.
  5. Klicken Sie auf Datenabgleichs-Editor öffnen.
  6. Klicken Sie auf + Neue Variable hinzufügen und erstellen Sie die folgenden Eingabevariablen:
    Name der Eingabevariablen Datentyp
    new_BQaccount JSON
    new_SNaccount JSON
  7. Erstellen Sie die folgende Zuordnung, um die ID und den Namen des Salesforce-Kontos der BigQuery-Tabelle zuzuordnen:
    Eingabe Ausgabe 
    
new_BQaccount
.SET_PROPERTY(
sf_account_id,
"account_id"
)
.SET_PROPERTY(
  sf_account_name,
  "name"
  )
    		connectorInputPayload (Create account in BigQuery) 
    
new_SNaccount
.SET_PROPERTY(
sf_account_id,
"sys_id"
)
.SET_PROPERTY(
 sf_account_name,
 "first_name"
 )
    		connectorInputPayload (Create account in ServiceNow)

    Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

  8. Fügen Sie eine Edge-Verbindung aus der Aufgabe Zuordnung für Kontoerstellung zum Connector Konto in BigQuery erstellen hinzu.
  9. Fügen Sie eine Edge-Verbindung aus der Aufgabe Zuordnung für Kontoerstellung zum Connector Konto in ServiceNow erstellen hinzu.

Neuen Auftrag in BigQuery erstellen

Gehen Sie wie folgt vor, um eine Bestellnummer zu generieren und in BigQuery hinzuzufügen.

Bestellung in BigQuery hinzufügen

Führen Sie die folgenden Schritte aus, um eine Aufgabe Connectors zu konfigurieren, mit der eine neue Entität in der BigQuery-Tabelle Orders erstellt wird:

  1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  2. Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.
  3. Klicken Sie auf das Connectors-Aufgabenelement im Designer, um den Konfigurationsbereich der Connectors-Aufgabe aufzurufen.
  4. Klicken Sie auf und benennen Sie die Connectors in Create order in BigQuery um.
  5. Klicken Sie auf Connector konfigurieren.
  6. Führen Sie auf der Seite Connectors-Task-Editor die folgenden Schritte aus:
    1. Wählen Sie unter Verbindung auswählen die Region us-central1 aus.
    2. Wählen Sie Ihre BigQuery-Verbindung aus der Liste der verfügbaren Verbindungen aus.
    3. Klicken Sie auf Next (Weiter).
    4. Wählen Sie unter Typ die Option Entitäten aus.
    5. Wählen Sie unter Set Entitäten/Aktionen die Option Aufträge aus der Liste der verfügbaren Entitäten und dann Erstellen als Vorgang aus.
    6. Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.

Reihenfolge generieren und BigQuery zuordnen

  1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  2. Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
  3. Klicken Sie im Designer auf das Element Datenzuordnung, um den Bereich für die Aufgabenkonfiguration aufzurufen.
  4. Klicken Sie auf und benennen Sie die Aufgabe Datenzuordnung in Mapping for Order Creation um.
  5. Klicken Sie auf Datenabgleichs-Editor öffnen.
  6. Klicken Sie auf + Neue Variable hinzufügen und erstellen Sie die folgende Variable:
    Variablenname Datentyp
    order_number STRING
  7. Erstellen Sie die folgende Zuordnung, um eine neue Bestellnummer zu generieren und die Bestelldetails dem BigQuery-Connector zuzuordnen:
    Eingabe Ausgabe 
    
GENERATE_UUID()
.SPLIT("-")
.GET("0")
    		new_order_number 
    
"{}"
.TO_JSON()
.SET_PROPERTY(
connectorOutputPayload ( Fetch Salesforce Data)
.GET_PROPERTY("DeliveryInstallationStatus__c")
,
"order_status"
)
.SET_PROPERTY(
connectorOutputPayload ( Fetch Salesforce Data)
.GET_PROPERTY("TrackingNumber__c")
,
"tracking_number"
)
.SET_PROPERTY(
new_order_number
,
"order_number"
)
    		connectorInputPayload (Create Order in BigQuery)

    Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

  8. Fügen Sie eine Edge-Verbindung vom Connector Konto in BigQuery erstellen in der Aufgabe Zuordnung für Auftragserstellung hinzu.
  9. Fügen Sie eine Edge-Verbindung aus dem Connector Konto in ServiceNow erstellen in die Aufgabe Zuordnung für Auftragserstellung ein.
  10. Fügen Sie eine Edge-Verbindung aus der Aufgabe Zuordnung für Bestellerstellung zum Connector Auftrag in BigQuery erstellen hinzu.

Salesforce-Opportunity aktualisieren

Nachdem Sie die neue Auftragsnummer generiert haben, aktualisieren Sie die Quell-Salesforce-Opportunity

Salesforce-Connector konfigurieren

Führen Sie die folgenden Schritte aus, um eine Aufgabe Connectors zu konfigurieren, mit der die vorhandene Salesforce-Opportunity aktualisiert wird:

  1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  2. Klicken Sie auf das Element Connectors und platzieren Sie es im Integrationseditor.
  3. Klicken Sie im Designer auf das Aufgabenelement Connectors, um den Konfigurationsbereich der Aufgabe „Connectors“ aufzurufen.
  4. Klicken Sie auf und benennen Sie die Connectors in Update Salesforce um.
  5. Klicken Sie auf Connector konfigurieren.
  6. Führen Sie auf der Seite Connectors-Task-Editor die folgenden Schritte aus:
    1. Wählen Sie unter Verbindung auswählen die Region us-central1 aus.
    2. Wählen Sie Ihre Salesforce-Verbindung aus der Liste der verfügbaren Verbindungen aus.
    3. Klicken Sie auf Next (Weiter).
    4. Wählen Sie unter Typ die Option Entitäten aus.
    5. Wählen Sie unter Set entity/actions (Entitäten/Aktionen festlegen) die Option Opportunity aus der Liste der verfügbaren Entitäten und dann Update (Aktualisieren) als Operation (Vorgang) aus.
    6. Klicken Sie auf Fertig, um die Verbindungskonfiguration abzuschließen und den Bereich zu schließen.

Bestellnummer Salesforce Salesforce zuordnen

  1. Klicken Sie im Integrationseditor auf Aufgaben, um eine Liste der verfügbaren Aufgaben aufzurufen.
  2. Klicken Sie auf das Element Datenabgleich und platzieren Sie es im Integrationsdesigner.
  3. Klicken Sie im Designer auf das Element Datenzuordnung, um den Bereich für die Aufgabenkonfiguration aufzurufen.
  4. Klicken Sie auf und benennen Sie die Aufgabe Datenzuordnung in Mapping to update opportunity um.
  5. Klicken Sie auf Datenabgleichs-Editor öffnen.
  6. Erstellen Sie die folgende Zuordnung, um die Salesforce-Opportunity zu aktualisieren:
    Eingabe Ausgabe 
    
"{}"
.TO_JSON()
.SET_PROPERTY(
new_order_number
,
"OrderNumber__c"
)
    		connectorInputPayload (Update Salesforce) 
    
entityId ( Fetch Salesforce Data)
    		entityId (Update Salesforce ) 
    
"'"
.CONCAT(entityId ( Fetch Salesforce Data))
.CONCAT("'")
    		filterClause (Update Salesforce )

    Schließen Sie das Fenster, wenn die Zuordnung abgeschlossen ist. Alle Änderungen werden automatisch gespeichert.

  7. Fügen Sie eine Edge-Verbindung aus dem Connector Create Order in BigQuery (Auftrag in BigQuery erstellen) in der Aufgabe Opportunity zum Aktualisieren von Geschäftschancen zuordnen hinzu.
  8. Fügen Sie eine Edge-Verbindung aus der Aufgabe Opportunity zum Aktualisieren zuordnen dem Connector Salesforce aktualisieren hinzu.

Randbedingung hinzufügen

Mit einer Edge-Bedingung können Sie die Bedingungen angeben, die erfüllt sein müssen, damit eine Integration an die durch 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 Integrationsablauf basierend auf der Validierung der Kontoinformationen:

  1. Fügen Sie eine Edge-Verbindung aus der Aufgabe Konto prüfen der Aufgabe Zuordnung für Kontoerstellung mit der folgenden Edge-Bedingung hinzu: 
      $account_exists$ = False
  2. Fügen Sie eine weitere Edge-Verbindung aus der Aufgabe Konto prüfen der Aufgabe Zuordnung für Auftragserstellung mit der folgenden Edge-Bedingung hinzu: 
      $account_exists$ = True

Beispiel für einen Integrationsablauf

Die folgende Abbildung zeigt ein Beispiellayout der Integration, die mit dieser Anleitung erstellt wurde.

Beispielbild für den Integrationsablauf Beispielbild für den Integrationsablauf

Integration veröffentlichen und testen

Wenn Sie die Integration veröffentlichen möchten, klicken Sie in der Symbolleiste des Integrationseditors auf 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 Bild mit dem Symbol für AusführungsprotokolleAusführungsprotokolle für diese Integration ansehen, um Protokolle aufzurufen. Die Seite Ausführungsprotokolle wird angezeigt.

Testfall 1: Um zu prüfen, ob eine Bestellnummer für eine neue Konto-ID erstellt wird

Melden Sie sich bei der Salesforce-Instanz an und erstellen Sie eine neue Opportunity, um die Integration zu testen. Sie müssen die Opportunity in einem neuen Konto oder in einem Konto erstellen, das in Ihrer BigQuery-Tabelle nicht vorhanden ist.

So überprüfen Sie, ob die Integration erfolgreich war:

  1. Rufen Sie die Seite BigQuery auf.

    BigQuery aufrufen

    • Öffnen Sie die Tabelle Konten und prüfen Sie, ob die neue Opportunity-Konto-ID eingefügt wurde.
    • Öffnen Sie die Tabelle Aufträge und klicken Sie auf das Kästchen, um das Einfügen der neuen Auftragsdetails zu bestätigen.
  2. Rufen Sie die ServiceNow-Instanz auf.
    • Prüfen Sie, ob Ihrer Instanz ein neues Konto mit derselben Salesforce-Opportunity-Konto-ID hinzugefügt wurde.
  3. Öffnen Sie Salesforce.
    • Prüfen Sie, ob die Opportunity mit der neuen Bestellnummer aktualisiert wurde.

Testfall 2: Prüfen, ob eine Bestellnummer für eine vorhandene Konto-ID in BigQuery erstellt wird

Melden Sie sich bei der Salesforce-Instanz an und erstellen Sie eine neue Opportunity, um die Integration zu testen. Sie müssen die Opportunity in einem vorhandenen Konto erstellen, das auch in Ihrer BigQuery-Tabelle vorhanden ist.

So überprüfen Sie, ob die Integration erfolgreich war:

  1. Rufen Sie die Seite BigQuery auf.

    BigQuery aufrufen

    • Öffnen Sie die Tabelle Konten und vergewissern Sie sich, dass KEINE neue Konto-ID eingefügt wird.
    • Öffnen Sie die Tabelle Aufträge und klicken Sie auf das Kästchen, um das Einfügen der neuen Auftragsdetails zu bestätigen.
  2. Öffnen Sie Salesforce.
    • Prüfen Sie, ob die Opportunity mit der neuen Bestellnummer aktualisiert 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.

  • Wenn Sie die Veröffentlichung dieser Integration aufheben möchten, klicken Sie in der Symbolleiste des Integrationseditors auf Veröffentlichung aufheben. Weitere Informationen finden Sie unter Integrationen löschen.
  • Informationen zum Löschen einer Verbindung finden Sie unter Connectors verwalten.