Konfigurieren Sie ausgehende Nachrichten mit einer API-Manager API in Jitterbit Design Studio

Einführung

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

Notiz

Geänderte Salesforce Objektdatensätze über den API-Manager an eine Datenbank senden ist ein ähnliches Integrationsdesignmuster, das Integration Studio verwendet.

Um dieses Muster einzurichten, folgen Sie den folgenden Abschnitten der Reihe nach:

Teil 1: Richten Sie in Salesforce eine Workflow-Regel ein, um eine ausgehende Nachricht zu senden, wenn sich ein Objekt ändert, und laden Sie die WSDL-Datei herunter, die die Nachricht definiert.
Teil 2: Richten Sie in Design Studio eine Operation ein, um die ausgehende Salesforce-Nachricht zu empfangen und die zugeordneten Werte in einer Datenbank zu speichern.
Teil 3: Richten Sie im API-Manager eine API als Endpoint für Salesforce ein.
Teil 4: Kehren Sie zu Salesforce zurück, um die Endpoint URL der ausgehenden Nachricht zu aktualisieren, die ausgehende Nachricht zu aktivieren und dann das fertige Integrationsentwurfsmuster zu testen.

Teil 1: Einrichten einer Salesforce Workflow-Regel und Herunterladen der WSDL-Datei

Wählen Sie in Salesforce Setup > Plattformtools > Prozessautomatisierung > Workflow.
Klicken Sie auf der Seite Workflow-Regeln auf die Schaltfläche Neue Regel (im Bild unten hervorgehoben). Wenn das Dialogfeld Im Flow Builder ausprobieren geöffnet wird, klicken Sie auf Mit Workflow-Regeln fortfahren.
Klicken Sie auf der Seite Neue Workflow-Regel auf das Menü Objekt, wählen Sie Konto aus und klicken Sie dann auf Weiter.
Geben Sie auf der Seite Konto Werte für Folgendes ein und klicken Sie dann auf Speichern & Weiter:
- Regelname: Der Name Ihrer Wahl.
- Beschreibung: (Optional) Eine Beschreibung für diese Regel.
- Bewertungskriterien: Erstellt und jedes Mal bearbeitet.
- Regelkriterien: Klicken Sie auf Diese Regel ausführen, wenn und wählen Sie dann Formel ergibt „Wahr“ aus.
- Geben Sie im Formelfeld true ein.
Klicken Sie auf der Seite Regel bearbeiten auf Workflow-Aktion hinzufügen und wählen Sie dann Neue ausgehende Nachricht aus (im Bild unten hervorgehoben).
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.
Klicken Sie auf der Seite Regel bearbeiten auf Fertig.
Klicken Sie auf der Seite Workflow-Regel im Abschnitt Sofortige Workflow-Aktionen auf den Beschreibungslink für die ausgehende Nachricht (im Bild unten hervorgehoben).
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).
Eine XML-Datei wird in einem neuen Browserfenster geöffnet. Speichern Sie die Datei mit einem .wsdl Erweiterung. Je nach Betriebssystem müssen Sie die Dateierweiterung nach dem Herunterladen möglicherweise festlegen.

Teil 2: Design Studio-Operationen

Definieren Sie den Operation „Salesforce Outbound Message“.

Erstellen Sie ein neues Design Studio Projekt.
Klicken Sie in der Projektelementliste links mit der rechten Maustaste auf Operationen und wählen Sie dann Neue Operation.
Wählen Sie im Dialogfeld Typ auswählen die Option Script aus und klicken Sie dann auf Weiter.
Legen Sie im Fenster Operationen den Operation auf Salesforce Outbound Message fest.
Doppelklicken Sie auf die Script-Aktivität der Operation und klicken Sie dann auf Neues Jitterbit Script erstellen.
Legen Sie im Fenster Neues Script die folgenden Werte fest, klicken Sie auf Speichern und schließen Sie dann das Script:
- Name: Salesforce Ausgehende Nachricht empfangen_
- Bearbeiten Sie das Script, sodass es mit Folgendem übereinstimmt:
```
<trans>
$org.api.salesforce.request=$jitterbit.api.request.body;
</trans>
```
Dadurch wird eine globale Variable erstellt und setzt ihn auf den Wert der vordefinierten globalen Variable jitterbit.api.request.body.
Klicken Sie im Operation Salesforce Outbound Message auf Speichern.
Klicken Sie in der Projektelementliste links mit der rechten Maustaste auf Quellen und wählen Sie dann Neue Quelle.
Wählen Sie im Dialogfeld Typ auswählen die Option Globale Variable aus und klicken Sie dann auf Weiter.
Legen Sie im Fenster Neue Quelle die folgenden Werte fest, klicken Sie auf Speichern und schließen Sie dann das Quellfenster:
- Name: Salesforce API -Anfrage
- Typ: Globale Variable
- Name der globalen Variable: org.api.salesforce.request

Definieren Sie den Operation „API -Antwort senden“.

Erstellen Sie eine neue Operation vom Typ Transformation. Legen Sie den Operation auf API Antwort senden_ fest.
Doppelklicken Sie auf Transformation. Klicken Sie im Dialogfeld Transformation auswählen auf Neue Transformation erstellen.
Geben Sie im Schritt NAME des Fensters Neue Transformation Werte für Folgendes ein und klicken Sie dann auf Weiter >:
- Name: API Antwort senden_.
- Quelle: (Keine).
- Ziel: SOAP/WSDL-Antwort.
Wählen Sie im Schritt ZIEL die Option Lokale WSDL-Datei auswählen, klicken Sie auf Durchsuchen..., wählen Sie die zuvor heruntergeladene WSDL-Datei aus, klicken Sie anschließend auf Weiter > und warten Sie auf die Dateivalidierung.
Klicken Sie im Schritt ZIEL auf Weiter >.
Klicken Sie auf der Seite Optionen auf Fertig.
Erweitern Sie im Transformation Send API Response alle Knoten, bis das Element [EV?] Ack (Boolean)ist sichtbar, dann doppelklicken Sie darauf.
Bearbeiten Sie im Formel-Generator das Script wie folgt und klicken Sie dann auf OK, um den Script Editor zu schließen:
```
<trans>
true
</trans>
```
Dies ist die Antwort auf die Salesforce SOAP Anfrage.
Klicken Sie im Transformations API -Antwort senden auf Speichern und schließen Sie dann das Fenster.
Klicken Sie im Operation API -Antwort senden mit der rechten Maustaste auf das Element Ziel, wählen Sie API -Antwort verwenden und klicken Sie dann auf Speichern:

Die Operation Salesforce Outbound Message:
Öffnen Sie die Operation Salesforce Outbound Message, wählen Sie den Abwärtspfeil neben dem Operation und dann Bei Erfolg > Operation > Vorhandenes auswählen....
Wählen Sie im Dialogfeld Erfolgreiche Operation auswählen die Option API -Antwort senden aus und klicken Sie dann auf OK.
Klicken Sie im Operation Salesforce Outbound Message auf Speichern.

Definieren Sie den Operation „Upsert Database“

Erstellen Sie eine neue Operation vom Typ Transformation. Legen Sie den Operation auf Upsert Database fest.
Doppelklicken Sie auf die Aktivität Quelle.
Wählen Sie im Dialogfeld Quelle auswählen die Option Salesforce API -Anforderung aus und klicken Sie dann auf OK.
Doppelklicken Sie auf das Ziel-Element.
Klicken Sie im Dialogfeld Ziel auswählen auf Neues Ziel erstellen.
Legen Sie im Fenster Neues Ziel die folgenden Werte fest, klicken Sie auf Verbindung testen und schließen Sie dann das Fenster Datenbank:
- Name: Datenbank-Endpunkt.
- Typ: Datenbank.
- Verbindungsparameter: Legen Sie die Parameter für Ihre Datenbank fest. (In diesem Beispiel wird eine Verbindung zu einem PostgreSQL Server gezeigt.)
Doppelklicken Sie auf das Element Transformation.
Klicken Sie im Dialogfeld Transformation auswählen auf Neue Transformation erstellen.
Geben Sie im Fenster Neue Transformation Werte für Folgendes ein und klicken Sie dann auf Weiter >:
- Name: Upsert-Datenbank.
- Quelle: SOAP/WSDL-Anfrage.
Wählen Sie im Schritt QUELLE die Option Vorhandene WSDL-Datei auswählen aus, wählen Sie anschließend die zuvor hochgeladene WSDL-Datei aus, klicken Sie auf Weiter > und warten Sie auf die Dateivalidierung.
Sobald die Datei validiert ist, klicken Sie auf Weiter >.
Klicken Sie auf der Optionsseite auf Weiter >.
Klicken Sie im Schritt ZIEL auf Tabellenliste herunterladen. Wählen Sie die Zieldatenbanktabelle aus, klicken Sie auf den Rechtspfeil, um sie in die Liste Ausgewählte Tabellen zu verschieben, und klicken Sie anschließend auf Weiter >.
Stellen Sie im Schritt TARGET sicher, dass Einfügen/Aktualisieren ausgewählt ist, und klicken Sie anschließend auf Fertig.
Erweitern Sie im Transformation Upsert Database die Quell- und Zielbäume, ordnen Sie Felder per Drag & Drop zu, klicken Sie dann auf Save und schließen Sie das Transformation.
Klicken Sie im Fenster „Datenbank Operation “ auf „Speichern“ und schließen Sie das Fenster.
Doppelklicken Sie im Operation Ausgehende Salesforce-Nachricht auf die Aktivität Ausgehende Salesforce-Nachricht empfangen.

Bearbeiten Sie das Script im Script wie folgt, klicken Sie dann auf Speichern und schließen Sie das Fenster:

<trans>
$org.api.salesforce.request=$jitterbit.api.request.body;
RunOperation("<TAG>Operations/Upsert Database</TAG>")
</trans>

Klicken Sie im Operation Salesforce Outbound Message auf Speichern.
Wählen Sie Aktionen > Bereitstellen. Wählen Sie im Dialogfeld Bereitstellen unter Bereitstellungstyp auswählen die Option Alles aus und klicken Sie anschließend auf Bereitstellen.

Teil 3: API-Manager API

Im API-Manager, wählen Sie APIs aus und klicken Sie dann auf Neue API.
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 das Design Studio-Projekt bereitgestellt wurde.
- Service Root: Belassen Sie den aus dem API -Namen abgeleiteten Anfangswert.
- Versionsnummer: (Optional) Geben Sie eine API Versionsnummer ein.
- Beschreibung: (Optional) Geben Sie eine Beschreibung für diese API ein.
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: Wählen Sie im Menü die POST-Anforderungsmethode für den API Dienst aus. 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 aus.
  - Operation(en) zuweisen:
    - Vorgang: Wählen Sie den Operation Ausgehende Salesforce-Nachricht aus.
    - Antworttyp: Wählen Sie Endziel als Antworttyp.
Klicken Sie in Schritt 3 auf Diesen Schritt überspringen.
Klicken Sie in Schritt 4 auf Speichern und veröffentlichen.
Klicken Sie im Dialogfeld mit dem Titel Alles bereit, Ihre API ist live! auf URL kopieren und dann auf Verwerfen.

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

Wählen Sie in Salesforce Setup > Plattformtools > Prozessautomatisierung > Workflow-Aktionen > Ausgehende Nachrichten.
Klicken Sie auf der Seite Ausgehende Nachrichten für Ihre ausgehende Nachricht auf Bearbeiten.
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.
Klicken Sie im Abschnitt Workflow-Regeln, die diese ausgehende Nachricht verwenden auf Aktivieren für die Regel (im Bild unten hervorgehoben).

Testen der Integration

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

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