Senden Sie geänderte Salesforce Objektdatensätze über den Salesforce Flow mithilfe von Jitterbit Integration Studio und API-Manager an eine Datenbank

Einführung

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

Um dieses Muster einzurichten, befolgen Sie diese Abschnitte der Reihe nach:

• Teil 1: Richten Sie in Salesforce eine ausgehende Nachricht und einen Flow ein, um diese aufzurufen, wenn sich ein Objekt ändert, und laden Sie die WSDL-Datei herunter, die die Nachricht definiert.
• Teil 2: In Integration Studio, richten Sie eine Operation zum Empfangen der ausgehenden Salesforce Nachricht ein und speichern Sie die zugeordneten Werte in einer Datenbank.
• Teil 3: Richten Sie im API-Manager eine API als Endpoint für Salesforce ein.
• Teil 4: Kehren Sie zu Salesforce zurück, um den Flow zu aktivieren, und testen Sie dann das fertige Integrationsentwurfsmuster.

Teil 1: Salesforce Flow und WSDL-Datei

1. Wählen Sie in Salesforce Setup > Plattformtools > Prozessautomatisierung > Workflow Aktionen > Ausgehende Nachrichten.

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

   

3. Klicken Sie auf der Seite Neue ausgehende Nachricht auf das Menü Objekt, wählen Sie Konto und klicken Sie dann auf Weiter.

   

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

   • Name: Der Name Ihrer Wahl.
   • Eindeutiger Name: Dieser Name wird automatisch basierend auf dem Wert für Name und den Benennungsregeln des Felds generiert.
   • Beschreibung: (Optional) Eine Beschreibung für diese ausgehende Nachricht.
   • Endpoint URL: example.com. Diese temporäre URL wird später aktualisiert.
   • Benutzer zum Senden als: Geben Sie den Benutzer ein, der die ausgehende Nachricht sendet. Der Standardwert ist Ihr Salesforce-Benutzername.
   • Geschützte Komponente: Nicht ausgewählt.
   • Sitzungs-ID senden: Nicht ausgewählt.
   • Zu sendende Kontofelder: Wählen Sie die zu sendenden Objektfelder aus. In diesem Beispiel sind nur Name und Telefon ausgewählt. Das Feld ID wird automatisch ausgewählt, da es das Schlüsselfeld für das Objekt ist.

   

5. Klicken Sie auf der Seite Workflow Outbound Message Detail der Nachricht auf den Link Click for WSDL in der Zeile mit der Bezeichnung Endpoint WSDL (im Bild unten hervorgehoben).

   

6. Eine XML-Datei wird in einem neuen Browserfenster geöffnet. Speichern Sie die Datei mit einem .wsdl Erweiterung. Abhängig von Ihrem Operationssystem müssen Sie die Dateierweiterung möglicherweise nach dem Herunterladen festlegen.

7. Wählen Sie im Salesforce Browserfenster Setup > Plattformtools > 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 Tab Core, wählen Sie Record-Triggered 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 Konto ein.
    • Trigger konfigurieren: Wählen Sie für Flow auslösen, wenn Ein Datensatz erstellt oder aktualisiert wird.
    • Eingabebedingungen festlegen: Lassen Sie für Bedingungsanforderungen den Wert auf Keine.
    • Flow optimieren für: Wählen Sie Aktionen und zugehörige Datensätze.

    

11. Bewegen Sie den Mauszeiger auf der Seite Flow Builder über den Knoten zwischen Start und End (im Bild unten durch einen roten Pfeil gekennzeichnet) und klicken Sie dann auf Element hinzufügen.

    

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

    

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

    

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

    • Bezeichnung: Geben Sie eine Bezeichnung für die Aktion ein.
    • API Name: Dieser Name wird automatisch basierend auf dem Wert für Label und den Benennungsregeln des Felds 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 dann 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-Label und den Benennungsregeln des Felds generiert.
    • Beschreibung: (Optional) Geben Sie eine Beschreibung für diesen Flow ein.

    

Teil 2: Integration Studio Operationen

Definieren Sie die Operation „Salesforce Outbound Message“

1. Erstellen Sie ein neues Integration Studio Projekt.

2. Ziehen Sie eine SOAP Request-Aktivität aus der Design-Komponentenpalette und legen Sie es auf einer leeren Operation im Design-Canvas ab.

3. Legen Sie den Operation auf Salesforce Outbound Message fest.
4. Doppelklicken Sie im Operation auf die Aktivitätsinstanz SOAP -Anfrage, um den 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 restlichen Felder werden automatisch ausgefüllt und müssen nicht weiter bearbeitet werden.

7. Klicken Sie auf Weiter.

   

8. Klicken Sie in Schritt 2 auf Fertig.

   

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

10. Klicken Sie für das Schema auf Quellschema spiegeln.
11. Klicken Sie auf Genaue Übereinstimmungen automatisch zuordnen oder manuell zuordnen Quell- und Zielfelder.

12. Klicken Sie im Schema auf Schema bearbeiten, den Schema auf Upsert Schema festlegen und dann auf Änderungen speichern klicken.

    

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

    

14. Suchen Sie in der Kategorie Konnektoren der Komponentenpalette den Konnektor Variable und klicken Sie darauf.

15. Belassen Sie die Standardnamen für die Verbindungen und Variablen und klicken Sie dann auf Änderungen speichern.
16. Ziehen Sie eine Aktivität zum Schreiben von Variablen aus der Komponentenpalette und legen Sie es auf der Operation Salesforce Outbound Message rechts neben der Transformation ab.
17. Doppelklicken Sie auf die Aktivität Schreiben.

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

    

19. Klicken Sie in Schritt 2 auf Fertig.

    

    Die Salesforce Outbound Message Operation:

    

Definieren Sie die Operation „Salesforce Response“

1. Ziehen Sie eine SOAP Antwortaktivität aus der Komponentenpalette und legen Sie es auf einer leeren Operation auf der Design-Canvas ab.
2. Legen Sie den Operation auf Salesforce Response fest.
3. Doppelklicken Sie auf die Aktivität SOAP -Antwort.

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 links neben der Aktivität SOAP Antwort in der Operation Salesforce-Antwort eine neue Transformation hinzu.

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

   

   Die Salesforce Response- Operation:

   

Definieren Sie den Operation „Datenbank-Upsert“

1. Ziehen Sie eine Aktivität zum Lesen von Variablen aus der Komponentenpalette und legen Sie es auf einer leeren Operation auf der Design-Canvas ab.
2. Legen Sie den Operation auf Database Upsert fest.
3. Doppelklicken Sie auf die Aktivität Lesen.

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

   

5. Klicken Sie in Schritt 2 auf Fertig.

   

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

   

7. Ziehen Sie eine Database Upsert-Aktivität aus der Komponentenpalette und legen Sie sie auf der Database-Upsert- Operation rechts neben der **Read-Aktivität ab.

8. Doppelklicken Sie auf die Aktivität Upsert.

9. Klicken Sie in Schritt 1 auf Aktualisieren, wählen Sie die Zieldatenbanktabelle 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 im Operation Datenbank-Upsert eine neue Transformation zwischen den Aktivitäten Lesen und Upsert hinzu.

13. Manuell zuordnen Quell-Salesforce Objektfelder in Zieldatenbankspalten umzuwandeln, und schließen Sie dann die Transformation, um zum Workflow zurückzukehren.

    

    Der Datenbank-Upsert Operation:

    

Operationsaktionen und Bereitstellung

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

3. Klicken Sie auf + Aktion hinzufügen und schließen Sie dann den Bildschirm mit den Operation.

   

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

5. Wählen Sie die Tab Aktionen und legen Sie dann die folgenden Feldwerte fest:
   • Bedingung: Bei Erfolg.
   • Aktion: Vorgang ausführen.
   • Vorgang: Datenbank-Upsert.

6. Klicken Sie auf + Aktion hinzufügen und schließen Sie dann den Bildschirm mit den Operation.

   

   Das abgeschlossene Projekt vor der Bereitstellung:

   

7. Bereitstellen das Projekt.

Teil 3: API-Manager API

1. Im API-Manager, wählen Sie Meine APIs aus und klicken Sie dann auf Neue API.

2. Geben Sie in 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 Umfeld aus, in der die Integration Studio Projekt bereitgestellt wurde.

   • Service-Stamm: Belassen Sie den vom API Namen abgeleiteten Anfangswert.

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

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

   

3. Wählen Sie in Schritt 2 Custom API als Diensttyp aus und klicken Sie dann auf API Dienst hinzufügen. Geben Sie für den neuen API Dienst diese Werte in die folgenden Felder ein, klicken Sie auf Speichern und dann auf Weiter:

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

   • Dienstname: Geben Sie einen Dienstnamen ein.

   • Wählen Sie auf der Tab Vorgang diese Werte aus:

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

     • Operation(en) zuweisen:

       • Operation: Wählen Sie die Operation Ausgehende Salesforce-Nachricht aus.

       • Antworttyp: Wählen Sie Endziel als Antworttyp.

   

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

5. Klicken Sie in Schritt 4 auf Speichern und veröffentlichen.

   

6. Klicken Sie im Dialogfeld Alles bereit, Ihre API ist live! auf URL kopieren und dann auf Verwerfen.

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

1. Wählen Sie in Salesforce Setup > Plattformtools > 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 Felds Endpoint URL (im Bild unten hervorgehoben) durch die URL, die Sie am Ende des vorherigen Abschnitts kopiert haben, und klicken Sie dann auf Speichern.

   

4. Wählen Sie Setup > Plattformtools > Prozessautomatisierung > Flows.

5. Klicken Sie auf die Flow-Beschriftung 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 der Integration

Um dieses Integrationsentwurfsmuster zu testen, führen Sie die folgenden Schritte aus:

1. Öffnen Sie in Salesforce die App Service und wählen Sie dann die Tab Konten aus.
2. Bearbeiten Sie einen Kontokontakt und speichern Sie ihn.
3. Melden Sie sich bei Ihrer Datenbank an und Abfrage die Zieltabelle ab.