Konfiguration externer Aktionen

Navigieren Sie Administration > Konfigurationen.

Klicken Sie Zwischenbereich auf Externe Aktionen“.

{width="800" modal="regular"}

Klicken oben auf „Aktion erstellen“.

Geben Sie die URL zur OpenAPI-Spezifikation für Ihren externen Service ein und klicken Sie auf Erstellen.

{width="500"}

Der externe Dienst muss live und erreichbar sein, damit dieser Schritt erfolgreich ist. Wenn ein Validierungsfehler auftritt, wird im Dialogfeld eine Meldung angezeigt, die den Fehler beschreibt, und ein Vorschlag zur Behebung des Fehlers. Weitere Informationen finden Sie unter Fehlerbehebung.

Wenn die URL erfolgreich aufgelöst wird, überprüfen Sie die Service-Details.

Die Service-Details werden direkt aus der OpenAPI-Spezifikation gelesen, wenn die Aktion erstellt wird. Sie können diese Eigenschaften nach der Erstellung in der Konfiguration nicht mehr ändern.

Geben Sie die Authentifizierung-Anmeldeinformationen für den externen Dienst (components.securitySchemes) ein.

{width="600" modal="regular"}

Sie können die Anmeldeinformationen nach Bedarf ändern, wenn sich die konfigurierte Aktion im Status Entwurf oder Aktiv befindet.

Klicken Sie auf Weiter.

Legen Sie die Konfigurationen-Eigenschaften fest, um festzulegen, wie die Aktion Daten mit dem externen Service austauscht.

• Action type (static) - Der unterstützte Journey-Knotentyp:

  • Externe Maßnahmen (enableSplitPath = false)
  • Aufspaltungspfad für externe Aktionen (enableSplitPath = true)

  Sie können den Aktionstyp nach der Erstellung der Aktionskonfiguration nicht ändern.

• Accessors (static) - (Nur Pfad für aufgeteilte externe Aktionen) Die Variablen, die vom externen Service zurückgegeben werden, sind als Pfadbedingungen in einem externen aufgeteilten Pfadknoten verfügbar. (invocationPayloadDef.accessorsMetadata)

• Journey-Kontext (static) - Der Umfang der Zielgruppendaten, die in der Anfrage gesendet werden (supportedEntityType):

  • Konto - Sendet nur Konten

  • Personen - Sendet nur Personen

  • Personen im Konto - Sendet Konten und kontobezogene Personen

• Ausgehende Felder - Ordnen Sie jedes Feld in der Tabelle einem XDM-Feld“ ​. Diese Felder werden im Anfragetext an den externen Service gesendet. Eigenschaften der Dienstdefinition: invocationPayloadDef.accountFields, invocationPayloadDef.fields.

  {width="600" modal="regular"}

• Eingehende Felder - Ordnen Sie jedes Feld in der Tabelle einem (​ XDM-Feld) ​. Diese Felder werden aus der Antwort des externen Services ausgefüllt. Eigenschaften der Dienstdefinition: callbackPayloadDef.accountFields, callbackPayloadDef.fields. Nach der Erstellung aktualisierbar.

• Kopfzeilenparameter - Geben Sie einen Wert für jede Zeile ein, die als HTTP-Kopfzeile in der Anfrage übergeben werden soll. Service-Definitionseigenschaft: invocationPayloadDef.headers.

• Zeitüberschreitung - Geben Sie die Anzahl der Minuten ein, die gewartet werden soll, bis der externe Service den Callback aufruft, bevor die Anfrage als fehlgeschlagen betrachtet wird. Service-Definitionseigenschaft: timeout.

• Globale Attribute - Geben Sie einen Wert für jede Zeile ein, die als statisches Feld in den Anfragetext aufgenommen werden soll. Service-Definitionseigenschaft: invocationPayloadDef.globalAttributes.

  {width="600" modal="regular"}

Klicken Sie auf Rückwärtspfeil, um zur Liste zurückzukehren und die Aktion in einem Entwurf zu belassen.

Oder klicken Sie auf Aktivieren, um die Aktionskonfiguration in den Status Aktiv zu ändern. Die konfigurierte externe Aktion muss aktiv sein, um sie für die Verwendung in Account Journey verfügbar zu machen.