Geänderte Salesforce-Objektaufzeichnungen über Salesforce Flow an eine Datenbank senden mit Jitterbit Integration Studio und API Manager

Einführung

Dieses Integrationsdesignmuster richtet einen Salesforce Flow ein, der eine ausgehende Nachricht an eine API Manager API sendet, wenn sich ein Objekt ändert (in diesem Beispiel das Account-Objekt). Ein Integration Studio-Projekt verarbeitet die Salesforce-ausgehende Nachricht, mappt die Daten des Objekts und speichert sie in einer Datenbank.

Um dieses Muster einzurichten, folgen Sie diesen Abschnitten in der angegebenen Reihenfolge:

• Teil 1: Richten Sie in Salesforce eine ausgehende Nachricht und einen Flow ein, um ihn aufzurufen, wenn sich ein Objekt ändert, und laden Sie die WSDL-Datei herunter, die die Nachricht definiert.
• Teil 2: Richten Sie im Integration Studio eine Operation Chain ein, um die Salesforce-ausgehende Nachricht zu empfangen und die gemappten Werte in einer Datenbank zu speichern.
• Teil 3: Richten Sie im API Manager eine API als Endpunkt für Salesforce ein.
• Teil 4: Kehren Sie zu Salesforce zurück, um den Flow zu aktivieren, und testen Sie das vollständige Integrationsdesignmuster.

Teil 1: Salesforce Flow und WSDL-Datei

1. Wählen Sie in Salesforce Setup > Platform Tools > Process Automation > Workflow Actions > Outbound Messages.

2. Klicken Sie auf die Schaltfläche Neue ausgehende Nachricht (hervorgehoben im Bild unten).

   

3. Klicken Sie auf der Seite Neue ausgehende Nachricht im Menü Objekt auf Account und dann auf Weiter.

   

4. Auf der Seite Neue ausgehende Nachricht geben Sie Werte für Folgendes ein und klicken Sie dann auf Speichern:

   • Name: Ihre Wahl des Namens.
   • Eindeutiger Name: Dieser Name wird automatisch basierend auf dem Wert für Name und den Benennungsregeln des Feldes generiert.
   • Beschreibung: (Optional) Eine Beschreibung für diese ausgehende Nachricht.
   • Endpoint-URL: example.com. Diese temporäre URL wird später aktualisiert.
   • Benutzer, der als sendet: Geben Sie den Benutzer ein, der die ausgehende Nachricht sendet. Der Wert wird standardmäßig auf Ihren Salesforce-Benutzernamen gesetzt.
   • Geschütztes Element: Nicht ausgewählt.
   • Sitzungs-ID senden: Nicht ausgewählt.
   • Zu sendende Kontofelder: Wählen Sie die Objektfelder aus, die gesendet werden sollen. In diesem Beispiel sind nur Name und Telefon ausgewählt. Das Feld Id wird automatisch ausgewählt, da es das Schlüssel-Feld für das Objekt ist.

   

5. Auf der Seite Workflow-Detail der ausgehenden Nachricht der Nachricht klicken Sie auf den Link Klicken Sie hier für WSDL in der Zeile mit der Bezeichnung Endpoint WSDL (im Bild unten hervorgehoben).

   

6. Eine XML-Datei öffnet sich in einem neuen Browserfenster. Speichern Sie die Datei mit der Erweiterung .wsdl. Je nach Betriebssystem müssen Sie möglicherweise die Dateierweiterung nach dem Herunterladen festlegen.

7. Wählen Sie im Salesforce-Browserfenster Setup > Plattform-Tools > Prozessautomatisierung > Flows.

8. Klicken Sie auf der Seite Flows auf die Schaltfläche Neuer Flow (im Bild unten hervorgehoben).

   

9. Wählen Sie im Dialogfeld Neuer Flow des Flow Builders die Registerkarte Kern, wählen Sie Aufzeichnung ausgelöster Flow und klicken Sie dann auf Erstellen.

   

10. Geben Sie im Dialogfeld Start konfigurieren Werte für Folgendes ein und klicken Sie dann auf Fertig:

    • Objekt auswählen: Geben Sie im Feld Objekt Account ein.
    • Trigger konfigurieren: Wählen Sie für Trigger den Flow, wenn die Option Ein Datensatz erstellt oder aktualisiert wird.
    • Eingabebedingungen festlegen: Lassen Sie den Wert für Bedingungsanforderungen auf Keine.
    • Flow optimieren für: Wählen Sie Aktionen und verwandte Datensätze.

    

11. Auf der Seite Flow Builder fahren Sie mit der Maus über den Knoten zwischen Start und Ende (im Bild unten durch einen roten Pfeil angezeigt), und klicken Sie dann auf Element hinzufügen.

    

12. Wählen Sie im Dialogfeld Element hinzufügen Aktion aus.

    

13. Wählen Sie im Dialogfeld Neue Aktion die Kategorie Outbound-Nachricht aus.

    

14. Klicken Sie auf die Suchleiste Aktion, und wählen Sie Ihre Outbound-Nachricht aus. Geben Sie Werte für Folgendes ein und klicken Sie auf Fertig:

    • Bezeichnung: Geben Sie eine Bezeichnung für die Aktion ein.
    • API-Name: Dieser Name wird automatisch basierend auf dem Wert für Bezeichnung und den Namensregeln des Feldes generiert.
    • Beschreibung: (Optional) Geben Sie eine Beschreibung für diese Aktion ein.

    

15. Klicken Sie auf der Seite Flow Builder auf Speichern.

    

16. Geben Sie im Dialogfeld Flow speichern Werte für Folgendes ein und klicken Sie auf Speichern:

    • Flow-Bezeichnung: Geben Sie eine Bezeichnung für den Flow ein.
    • Flow-API-Name: Dieser Name wird automatisch basierend auf dem Wert für Flow-Bezeichnung und den Namensregeln des Feldes generiert.
    • Beschreibung: (Optional) Geben Sie eine Beschreibung für diesen Flow ein.

    

Teil 2: Integration Studio-Operationen

Definieren Sie die 'Salesforce Outbound-Nachricht'-Operation

1. Erstellen Sie ein neues Integration Studio-Projekt.

2. Ziehen Sie eine SOAP-Anfrage-Aktivität aus der Design-Komponentenpalette und lassen Sie sie auf eine leere Operation in der Design-Leinwand fallen.

3. Setzen Sie den Operationsnamen auf Salesforce Outbound-Nachricht.
4. Doppelklicken Sie auf die Instanz der SOAP-Anfrage-Aktivität in der Operation, um ihren Konfigurationsbildschirm zu öffnen.
5. Wählen Sie in Schritt 1 Datei hochladen, klicken Sie auf Durchsuchen, wählen Sie die zuvor heruntergeladene WSDL-Datei aus und klicken Sie dann auf Hochladen.
6. Klicken Sie auf Port und wählen Sie Benachrichtigung (die einzige Option). Die verbleibenden Felder werden automatisch ausgefüllt und benötigen keine weitere Bearbeitung.

7. Klicken Sie auf Weiter.

   

8. Klicken Sie in Schritt 2 auf Fertig.

   

9. Fügen Sie eine neue Transformation rechts von der SOAP-Anforderungs-Aktivität hinzu.

10. Klicken Sie für das Zielschema auf Quellschema spiegeln.
11. Klicken Sie auf Automatische Zuordnung exakter Übereinstimmungen oder ordnen Sie manuell die Quell- zu den Ziel-Feldern zu.

12. Klicken Sie im Zielschema auf Schema bearbeiten, setzen Sie den Schemanamen auf Upsert-Schema, und klicken Sie dann auf Änderungen speichern.

    

13. Schließen Sie die Transformation, um zum Workflow zurückzukehren.

    

14. Suchen Sie in der Komponentenpalette in der Kategorie Connectors den Variable-Connector und klicken Sie darauf.

15. Lassen Sie die Verbindungs- und Variablennamen auf ihren Standardwerten und klicken Sie dann auf Änderungen speichern.
16. Ziehen Sie eine Variable-Schreibaktivität aus der Komponentenpalette und lassen Sie sie auf die Salesforce Outbound Message-Operation rechts von der Transformation fallen.
17. Doppelklicken Sie auf die Schreiben-Aktivität.

18. Wählen Sie in Schritt 1 Ja, gespeichertes Schema verwenden, klicken Sie auf Gespeicherte Schemata, wählen Sie Upsert-Schema aus und klicken Sie dann auf Weiter.

    

19. Klicken Sie in Schritt 2 auf Fertig.

    

    Die Salesforce Outbound Message-Operation:

    

Definieren Sie die 'Salesforce Response'-Operation

1. Ziehen Sie eine SOAP-Antwort-Aktivität aus der Komponentenpalette und lassen Sie sie auf eine leere Operation im Entwurfscanvas fallen.
2. Setzen Sie den Operationsnamen auf Salesforce-Antwort.
3. Doppelklicken Sie auf die SOAP-Antwort-Aktivität.

4. Wählen Sie in Schritt 1 Vorhandenes auswählen, wählen Sie die zuvor hochgeladene WSDL-Datei aus und klicken Sie dann auf Weiter.

   

5. Klicken Sie in Schritt 2 auf Fertig.

   

6. Fügen Sie eine neue Transformation links von der SOAP-Antwort-Aktivität in der Salesforce-Antwort-Operation hinzu.

7. Fügen Sie einen benutzerdefinierten Wert zum Feld Ack mit dem Wert true hinzu und schließen Sie dann die Transformation, um zum Workflow zurückzukehren.

   

   Die Salesforce-Antwort-Operation:

   

Definieren Sie die 'Datenbank-Upsert'-Operation

1. Ziehen Sie eine Variablenlese-Aktivität aus der Komponentenpalette und lassen Sie sie auf eine leere Operation im Entwurfscanvas fallen.
2. Setzen Sie den Operationsnamen auf Datenbank-Upsert.
3. Doppelklicken Sie auf die Lesen-Aktivität.

4. Wählen Sie in Schritt 1 Ja, gespeichertes Schema verwenden, klicken Sie auf Gespeicherte Schemata, wählen Sie Upsert-Schema aus und klicken Sie dann auf Weiter.

   

5. Klicken Sie in Schritt 2 auf Fertig.

   

6. Richten Sie eine Datenbankverbindung für Ihre Ziel-Datenbank ein und klicken Sie dann auf Änderungen speichern. (Eine Verbindung zu einem PostgreSQL-Server wird in diesem Beispiel angezeigt.)

   

7. Ziehen Sie eine Datenbank Upsert-Aktivität aus der Komponentenpalette und lassen Sie sie auf die Datenbank Upsert-Operation, rechts von der Lesen-Aktivität, fallen.

8. Doppelklicken Sie auf die Upsert-Aktivität.

9. Klicken Sie in Schritt 1 auf Aktualisieren, wählen Sie die Ziel-Datenbanktabelle aus und klicken Sie dann auf Weiter.

   

10. Wählen Sie in Schritt 2 die zu aktualisierenden Spalten aus und klicken Sie dann auf Weiter.

    

11. Klicken Sie in Schritt 3 auf Fertig.

    

12. Fügen Sie in der Datenbank Upsert-Operation eine neue Transformation zwischen den Lesen- und Upsert-Aktivitäten hinzu.

13. Manuell zuordnen Sie die Quellfelder des Salesforce-Objekts den Zielspalten der Datenbank und schließen Sie dann die Transformation, um zum Workflow zurückzukehren.

    

    Die Datenbank Upsert-Operation:

    

Operation actions and deployment

1. Öffnen Sie den Einstellungsbildschirm für die Salesforce Outbound Message-Operation.
2. Wählen Sie die Registerkarte Aktionen und setzen Sie die folgenden Feldwerte:
   • Bedingung: Bei Erfolg.
   • Aktion: Operation ausführen.
   • Operation: Salesforce-Antwort.

3. Klicken Sie auf + Aktion hinzufügen, und schließen Sie dann den Einstellungsbildschirm der Operation.

   

4. Öffnen Sie den Einstellungsbildschirm für die Salesforce-Antwort-Operation.

5. Wählen Sie die Registerkarte Aktionen und setzen Sie die folgenden Feldwerte:
   • Bedingung: Bei Erfolg.
   • Aktion: Operation ausführen.
   • Operation: Datenbank Upsert.

6. Klicken Sie auf + Aktion hinzufügen, und schließen Sie dann den Einstellungsbildschirm der Operation.

   

   Das abgeschlossene Projekt, vor der Bereitstellung:

   

7. Bereitstellen des Projekts.

Teil 3: API Manager API

1. Wählen Sie im API Manager APIs aus und klicken Sie dann auf Neue API.

2. Geben Sie im Schritt 1 der Seite Neue API veröffentlichen Werte für Folgendes ein und klicken Sie dann auf Weiter:

   • API-Name: Geben Sie einen Namen für die API ein.

   • Umgebung: Wählen Sie die Umgebung aus, in der das Integration Studio-Projekt bereitgestellt wurde.

   • Service-Root: Lassen Sie den ursprünglichen Wert, der aus dem API-Namen abgeleitet ist.

   • Versionsnummer: (Optional) Geben Sie eine API-Versionsnummer ein.

   • Beschreibung: (Optional) Geben Sie eine Beschreibung für diese API ein.

   

3. Wählen Sie im Schritt 2 Benutzerdefinierte API als Service-Typ aus und klicken Sie dann auf API-Service hinzufügen. Geben Sie für den neuen API-Service diese Werte für die folgenden Felder ein, klicken Sie auf Speichern und dann auf Weiter:

   • Anforderungsmethode: Verwenden Sie das Menü, um die Anforderungsmethode POST für den API-Service auszuwählen. Standardmäßig ist die Anforderungsmethode auf GET eingestellt.

   • Service-Name: Geben Sie einen Servicenamen ein.

   • Wählen Sie im Tab Operation diese Werte aus:

     • Projekt zuweisen: Wählen Sie aus dem Menü Ihr Integration Studio-Projekt aus.

     • Operation(en) zuweisen:

       • Operation: Wählen Sie die Operation Salesforce Outbound Message aus.

       • Antworttyp: Wählen Sie Final Target als Antworttyp aus.

   

4. Klicken Sie im Schritt 3 auf Diesen Schritt überspringen.

5. Klicken Sie im Schritt 4 auf Speichern & Veröffentlichen.

   

6. Im Dialogfeld mit dem Titel Alles bereit, Ihre API ist live! klicken Sie auf URL kopieren, und klicken Sie dann auf Schließen.

Teil 4: Aktualisieren Sie die Salesforce-Endpunkt-URL und aktivieren Sie den Flow

1. Wählen Sie in Salesforce Setup > Plattform-Tools > Prozessautomatisierung > Workflow-Aktionen > Ausgehende Nachrichten.
2. Klicken Sie auf der Seite Ausgehende Nachrichten auf Bearbeiten für Ihre ausgehende Nachricht.

3. Ersetzen Sie den Inhalt des Feldes Endpunkt-URL (im Bild unten hervorgehoben) durch die am Ende des vorherigen Abschnitts kopierte URL, und klicken Sie dann auf Speichern.

   

4. Wählen Sie Setup > Plattform-Tools > Prozessautomatisierung > Flows.

5. Klicken Sie auf das Flows-Label für den Eintrag Jitterbit Flow (im Bild unten hervorgehoben).

   

6. Klicken Sie auf der Seite Flow Builder auf die Schaltfläche Aktivieren (im Bild unten hervorgehoben).

   

Testen Sie die Integration

Um dieses Integrationsdesignmuster zu testen, befolgen Sie diese Schritte:

1. Öffnen Sie in Salesforce die Service-App und wählen Sie dann die Registerkarte Konten.
2. Bearbeiten Sie einen Kontaktdatensatz und speichern Sie ihn.
3. Melden Sie sich in Ihrer Datenbank an und führen Sie eine Abfrage auf der Zieltabelle aus.