Verwendung des benutzerdefinierten Berechtigungstyps

Hinweis: Dieser Artikel bezieht sich auf die Integration von Web Services Data Actions.

Wenn Sie die Integration von Webdienstdatenaktionen hinzufügen, können Sie einen Berechtigungstyp auswählen: Basic Auth, Benutzerdefiniert oder Benutzerdefiniert (OAuth). Weitere Informationen finden Sie unter Add a data actions integration und Credential types

In diesem Artikel wird die Verwendung des Typs "Benutzerdefinierte Berechtigung" erläutert.

Wenn Sie die Integration hinzufügen, konfigurieren Sie die benutzerdefinierten Anmeldedaten.
Fügen Sie Feldnamen für die von Ihnen verwendete API und Werte für diese Feldnamen hinzu.
Verwenden Sie Feldnamen aus Ihren Anmeldeinformationen in den Anforderungen aller benutzerdefinierten Aktionen, die Sie erstellen.
Das folgende Beispiel ist eine Anfrage für eine benutzerdefinierte Aktion namens Get Weather. credentials ist ein statisches Schlüsselwort, das Sie mit anderen Velocity-Makros verwenden können API_Key ist der Feldname, den Sie der Konfiguration der Anmeldeinformationen hinzugefügt haben Weitere Informationen finden Sie unter Velocity macros for data actions.

Obwohl die Integration die Werte der Feldnamen schwärzt, erscheinen die tatsächlichen Werte in Ihrem Webdienst. Wenn z. B. der Wert für API_Key 12345 ist, dann ist das requestUrlTemplate, das Sie in Ihrem Webdienst sehen, "https://api.openweathermap.org/data/2.5/weather?q=London&APPID=12345", wenn die Aktion ausgeführt wird Weitere Informationen finden Sie unter Erstellen einer benutzerdefinierten Aktion, Konfiguration zu benutzerdefinierten Aktionen hinzufügenund Konfiguration anfordern.
Warnung: Achten Sie darauf, jede Verwendung von Eingabe- oder Ausgabevariablen innerhalb von requestTemplate, successTemplate, oder requestUrlTemplatezu entschlüsseln. Wenn Sie Variablen mit Sonderzeichen nicht richtig entschlüsseln, werden Ihre Datenaktionen bei der Ausführung fehlschlagen.
- Verwenden Sie esc.jsonString , um Zeichenketten in JSON-Bodies zu entschlüsseln
  Weitere Informationen finden Sie im Abschnitt esc.jsonString in Velocity macros for data actions.
- Verwenden Sie esc.url() oder urlTool.optionalQueryParam() , um Pfad- oder Abfrageparameter für ein requestUrlTemplate oder requestTemplate richtig zu entschlüsseln, wenn x-www.form-urlencoded Werte verwendet werden.
  Weitere Informationen finden Sie im Abschnitt über die String-Escaping-Bibliothek unter Velocity-Makros für Datenaktionen.
Da Escaping kontextspezifisch für JSON ist, wird im folgenden Beispiel absichtlich kein Escaping gezeigt.
```
{
  "requestUrlTemplate": "https://api.openweathermap.org/data/2.5/weather?q=London&APPID=${credentials.API_Key}",
  "requestType": "GET",
  "headers": {},
  "requestTemplate": "${input.rawRequest}"
}
```
Hinweis: Wenn Sie eine benutzerdefinierte Aktion testen, werden bei der Integration alle Berechtigungsinformationen unkenntlich gemacht. Weitere Informationen finden Sie unter Testen Sie eine benutzerdefinierte Aktion.

Weitere Informationen über die Integration finden Sie unter Über die Integration von Web Services Data Actions.