Hinzufügen von Konfigurationen zu benutzerdefinierten Aktionen für Integrationen

Hinweis: Dieser Artikel gilt für die Datenaktionsintegrationen AWS Lambda, Genesys Cloud, Google, Microsoft Dynamics 365, Salesforce, Webdienste und Zendesk.

Wenn Sie eine benutzerdefinierte Aktion erstellen, fügen Sie zunächst Verträge und dann die Konfiguration hinzu. Die Konfiguration legt fest, wie die Aktion die Verträge umsetzt. Weitere Informationen finden Sie unter Erstellen einer benutzerdefinierten Aktion und Hinzufügen von Verträgen zu benutzerdefinierten Aktionen

Hinweis: Sie können die Konfiguration ändern, nachdem Sie die Aktion veröffentlicht haben. Weitere Informationen finden Sie unter Ändern der Konfiguration in benutzerdefinierten Aktionen.

Klicken Sie auf die Registerkarte Konfiguration
Wählen Sie die HTTP-Methode.
Unter Anfragekonfigurieren Sie die Anfrage, die die Aktion an den Webdienst sendet. Genesys empfiehlt, die Anfrage mit Hilfe der Felder unter Simplezu konfigurieren.
Tipp: Klicken Sie auf die Eigenschaften unter Available Inputs , um sie zu kopieren und schnell in die Anfrage einzufügen Diese Eigenschaften stammen aus Ihrem Eingabevertrag. Weitere Informationen finden Sie unter Verträge zu benutzerdefinierten Aktionen hinzufügen. Sie können Makros mit den Vorlagen verwenden. Weitere Informationen finden Sie unter Velocity macros for data actions.

Geben Sie Informationen für die angezeigten Felder ein. Welche Felder angezeigt werden, hängt von der gewählten HTTP-Methode und den hinzugefügten Verträgen ab.
Notizen:
- Informationen zu den AWS Lambda-Datenaktionsintegrationen und Google Cloud Functions finden Sie im Folgenden Sonderwunschkonfigurationen Abschnitt.
- Übermäßig verschachtelte JSON-Objekte können die Leistung des Datenaktionsdienstes beeinträchtigen. Um die Leistung zu erhalten, ist die Tiefe der JSON-Objekte auf 50 Ebenen begrenzt. Weitere Informationen finden Sie unter Limits im Genesys Cloud Developer Center.

URL-Vorlage anfordern
Setzen Sie Request URL Template auf den entfernten Endpunkt, auf den Ihre HTTP-Anfrage trifft
Kopfzeilen (fakultativ)
Schlüssel-Wert-Paare, die als HTTP-Header der an den entfernten Endpunkt gesendeten Anfrage hinzugefügt werden.
Hinweis: Wenn Sie den Accept-Header setzen, müssen Sie einen JSON-Medientyp als Header-Wert verwenden.
Übertragung Kodierung
Wenn Ihr Webdienst Transfer-Encoding nicht unterstützt und auf chunkedeingestellt ist, fügen Sie Transfer-Encoding hinzu gepuffert unter Header Weitere Informationen finden Sie unter Benutzerdefinierte Aktion schlägt aus unerwartetem Grund fehl.
Autorisierung
Sie können Autorisierungsinformationen in die Anfragekonfiguration aufnehmen. Weitere Informationen finden Sie unter Verwendung des benutzerdefinierten Berechtigungstyps und Verwendung des benutzerdefinierten (OAuth) Berechtigungstyps

Sonderwunsch Konfiguration

Die Anforderungskonfiguration für benutzerdefinierte Aktionen, die mit den Datenaktionsintegrationen von Adobe oder AWS Lambda verknüpft sind oder die Google Cloud Functions ausführen, unterscheidet sich von der Standardanforderungskonfiguration für Webservices.

AWS Lambda
Google Cloud-Funktionen

URL-Vorlage anfordern
Setzen Sie Request URL Template auf den ARN Ihrer AWS Lambda-Funktion Weitere Informationen finden Sie unter IAM-Ressourcen zum Aufrufen von AWS Lambda-Funktionen erstellen.
Antragsart
Setzen Sie Request Type auf POST Diese HTTP-Methode stellt sicher, dass die Aktion einen beliebigen Anfragekörper mit der Anfragekonfiguration sendet.
Kopfzeilen
Schlüssel-Wert-Paare, die zu einer benutzerdefinierten Map auf dem clientContext Objekt hinzugefügt werden. Das Objekt clientContext ist wiederum ein Wert für das Objekt context des Aufrufs Wenn die folgenden Attribute vorhanden sind, werden sie automatisch auf das Objekt context gesetzt
- ININ-Organisation-Id
- ININ-Home-Organisation-Id
- ININ-Korrelation-Id
- ININ-Benutzer-Id
- ININ-Integration-Id
Ein Java-Beispiel für das Objekt clientContext finden Sie unter Interface ClientContext
Vorlage anfordern
Alle Werte, die Sie unter Request Template angeben, werden im Parameter event der aufgerufenen AWS Lambda-Funktion verfügbar sein.

URL-Vorlage anfordern
Setzen Sie Request URL Template auf den Speicherort der Google Cloud Function, die die Datenaktion ausführen soll https://{Ort der Funktion}-{Projekt-Eigentümerfunktion}/{Funktionsname}.
Antragsart
Setzen Sie Request Type auf POST
Vorlage anfordern
Setzen Sie Request Template auf ${input.rawRequest}.

Eine ausführliche Erläuterung der Teile der Anfrage finden Sie unter Anfragekonfiguration für Datenaktionen.

Erweiterte Benutzer (JSON)

Personen, die sich mit JSON auskennen, können die JSON-Eingabeoption verwenden. Verwenden Sie Anfragen in anderen Aktionen oder das folgende Beispiel als Anleitung für die Erstellung des JSON.

{
  "requestUrlTemplate": "https://www.example.com/health/check/services/${input.service}",
  "requestType": "GET",
  "headers": {},
  "requestTemplate": "${input.rawRequest}"
}

Fügen Sie unter Responsedie JSON-Konfiguration hinzu.
Die JSON-Konfiguration legt fest, wie die Antwort des Webservice oder der AWS Lambda-Funktion verarbeitet wird.

Sie können die Antwort in anderen Aktionen oder das folgende Beispiel als Anleitung für die Erstellung des JSON verwenden. Weitere Informationen zur Verwendung von Makros mit der Erfolgsvorlage finden Sie unter Velocity-Makros für Datenaktionen.

Tipp: Klicken Sie auf die Eigenschaften unter Available Outputs , um sie zu kopieren und schnell in die Antwort einzufügen Diese Eigenschaften sind in Ihrem Output-Vertrag enthalten. Weitere Informationen finden Sie unter Verträge zu benutzerdefinierten Aktionen hinzufügen.
```
{
      "translationMap": {
          "buildNumber": "$.Build-Version",
          "serviceName": "$.name",
          "status": "$.Status"
      },
      "successTemplate": "{\r\n      \t\"build\": ${buildNumber},\r\n      \t\"name\": ${serviceName},\r\n\"status\": ${status}\r\n      }"
 }
```
Eine ausführliche Erläuterung der Teile der Antwort finden Sie unter Antwortkonfiguration für Datenaktionen.

Anschließend testet die Aktion auf Validierungs- und Ausführungsfehler

Weitere Informationen finden Sie unter Über benutzerdefinierte Aktionen für Integrationen.

Weitere Informationen zu den Integrationen finden Sie unter Über die Integrationen von Datenaktionen.