REST-Webdienst Paket

Verwenden Sie die Aktionen im REST-Webdienst-Paket als Methoden (DELETE, GET, PATCH, POST oder PUT), um Anforderungen an eine API zu senden und Antworten von ihr zu erhalten.

Arbeiten mit REST-Webdienst-Aktionen

Geben Sie die folgenden Informationen an, um eine REST-Anforderung zu senden und eine Antwort zu erhalten. Nicht alle Parameter sind für alle Methoden erforderlich.

Den URI eingeben: Eindeutige Adresse für eine API-Ressource.

Proxy-Konfiguration: Um den Proxy einzustellen, wählen Sie die Registerkarte System oder Benutzerdefiniert der Proxy-Konfiguration.


Option	Beschreibung
System	Der Systemproxy ist der Proxy, der auf dem Bot Runner-Rechner konfiguriert ist, auf dem der Bot ausgeführt wird. Wenn diese Option ausgewählt ist, verwendet der Bot-Agent den Systemproxy.
Benutzerdefiniert	Diese Option ermöglicht es Ihnen, benutzerdefinierte Proxy-Einstellungen innerhalb der Aktionen von REST-Webdienst zu konfigurieren. Wenn beispielsweise eine REST-API über einen anderen Proxy als den Systemproxy geleitet werden soll, können Sie die Option Benutzerdefiniert auswählen und Proxy-Details innerhalb der REST-Aktionen angeben. Machen Sie die folgenden Angaben: Host: Der Hostname oder die IP-Adresse des Proxys Port: Die Portnummer des Proxys Nutzername (optional): Der für die Proxy-Authentifizierung verwendete Nutzername Kennwort (optional): Das für die Proxy-Authentifizierung verwendete Passwort Anmerkung: Wenn es sich bei dem zu konfigurierenden Proxy um einen authentifizierten Proxy handelt, müssen Sie die Authentifizierungsdaten in den Feldern Nutzername und Passwort angeben. Für die Felder Host, Port, Nutzername und Passwort wählen Sie die Registerkarte Anmeldedaten, Variable oder Unsichere Zeichenfolge: Anmeldedaten: Verwenden Sie einen im Credential Vault verfügbaren Wert. Variable: Verwenden Sie eine Variable, die einen Anmeldedatenwert in einer nutzerdefinierten Variable speichert. Unsichere Zeichenfolge: Geben Sie den Wert, den Sie verwenden möchten, manuell ein.

Authentifizierungsmodus: Es gibt drei unterstützte Authentifizierungsmodi:
- Keine Authentifizierung: Verwenden Sie diese Option, um auf die Endpunkte zuzugreifen, die keine Authentifizierung für den Zugriff auf ihre Server erfordern.
- Basic: Basic ist die einfachste Art, Nutzer zu authentifizieren. Wenn Sie diese Option wählen, müssen Sie den Nutzernamen und das Passwort eingeben. Bei dieser Technik wird ein Header namens Authorization verwendet, der eine base64-kodierte Darstellung des eingegebenen Nutzernamens und Passworts enthält.
- Angemeldeter AD-Nutzer: Active Directory-Nutzer, die zum Zugriff auf die entsprechende API berechtigt sind, werden über das AD authentifiziert. Für die Anforderung sind keine Anmeldedaten erforderlich.
- Authentifizierung über Windows NT LAN Manager (NTLM) (AD-Nutzer): Challenge/Response-Authentifizierungsmethode, mit der Clients ihren Nutzernamen und ihr Passwort als verschlüsselte Anmeldedaten oder als Klartext angeben können. Wir empfehlen, dass Sie Anmeldedaten verwenden, die im Automation Anywhere-Credential Vault gespeichert sind.
Header: Nicht alle Methoden benötigen einen Header. Ein Header enthält die mit der Anforderung verbundenen Metadaten.
Inhaltstyp: Wenn ein Header einen Inhaltstyp enthält, definiert dieser die Content Negotiation Inhaltsvereinbarung zwischen dem Client und dem Server. REST-Webdienst-Aktionen unterstützen folgende Dateitypen:
- application/x-www-form-urlencoded: Kodieren Sie die Parameter in der URL.
- JSON (application/json): Geben Sie einen Text für die JSON-Anforderung ein.
- XML (application/xml): Geben Sie einen Text für XML-Anforderung ein.
- Text (text/plain)
- XML (text/xml)
- HTML (text/html)
- multipart/form-data: Senden Sie Binärdaten, in den meisten Fällen zum Hochladen von Dateien auf den Server.
Ersatz hinzufügen: Ermöglicht die Eingabe von Variablen in den REST-Anforderungstext. Eine Variable ist eine symbolische Darstellung von Daten und ermöglicht es Ihnen, auf einen Wert zuzugreifen, ohne ihn manuell eingeben zu müssen, wo immer Sie ihn benötigen. Betrachten Sie zum Beispiel den folgenden REST-Anforderungstext:
```
{
   "name":"{{name}}",
   "email":"{{email}}",
   "status":"Active"
}
```
Im obigen Anforderungstext können Sie die in doppelten Klammern eingeschlossenen Variablen ersetzen, indem Sie auf Ersatz hinzufügen klicken und die erforderlichen Werte hinzufügen.
Erweiterte Optionen:
- Fehlerreaktion erfassen: Aktivieren Sie das Kontrollkästchen, um die Fehlerreaktion zu erfassen (mit Ausnahme der Antwort Erfolg/OK). Die Einzelheiten der Fehlerreaktion werden im Antwortkörper festgehalten.
- Unsichere Verbindung bei https erlauben: Aktivieren Sie das Kontrollkästchen, um eine unsichere Verbindung bei der Verwendung von https zu erlauben.
Auf Abschluss der Aktion warten: Sie können einen Timeout-Wert festlegen, wenn Sie eine REST-Anforderung senden und eine Antwort erhalten. Bei der Durchführung von Aktionen wie POST, PUT, DELETE, PATCH oder GET können sie in der Spalte Auf Abschluss der Aktion warten die Wartezeit in Millisekunden angeben. Standardmäßig beträgt die Wartezeit 60.000 Millisekunden.
Ausgabevariable: Die Antwortausgabe wird in einer Wörterbuchvariablen erfasst. Eine Wörterbuchvariable ist ein Paar aus Schlüssel und Wert. Verwenden Sie den Namen des Antwort-Headers als Schlüssel, um den Header-Wert zurückzugeben, oder verwenden Sie „Body“ als Schlüssel, um den Antwortkörper zurückzugeben.
Anmerkung: Der Antwortschlüssel mit seinem Wert ist in der Wörterbuchvariablen verfügbar, um den Antwortstatus der REST-API anzuzeigen.
Führen Sie die folgenden Schritte aus, um eine Liste der Header-Namen für die API-Ressource zu erhalten:
1. Fügen Sie nach der REST-Webdienst-Aktion eine Schleife-Aktion ein.
2. Wählen Sie den Iterator Für jeden Schlüssel im Wörterbuch aus.
3. Wählen Sie im Feld Wörterbuchvariable die Variable aus, die als Ausgabe die REST-Webdienst-Aktion enthält.
4. Weisen Sie $prompt-assignment$ den Wert jedes Schlüssels zu.
5. Fügen Sie eine In Datei protokollieren-Aktion ein.
6. Geben Sie den Dateipfad zu einer Textdatei an, die die Liste der Header-Namen enthält.
7. Fügen Sie $prompt-assignment$ im Feld Zum Protokollieren Text eingeben ein.
8. Wählen Sie die Option Vorhandene Datei überschreiben.
9. Klicken Sie auf Speichern.
  Wenn Sie den Bot ausführen, druckt er die Header-Namen aus der API-Ressource in die ausgewählte Datei.

Werte sicher übermitteln

Sie können Werte sicher vom Credential Vault an den Webdienst übermitteln, indem Sie den Locker, die Anmeldedaten und das Attribut in den folgenden unterstützten Aktion-Feldern angeben:

URI
Benutzerdefinierte Header
Textkörper: Für den Inhaltstyp application/x-www-form-urlencoded klicken Sie auf Parameter hinzufügen, um den Wert aus dem Credential Vault auszuwählen.
Für alle anderen Inhaltstypen wählen Sie die Option Anmeldedaten als Parameter auswählen und klicken Sie auf Wählen.

Aktionen im REST-Webdienst-Paket


Aktion	Beschreibung
DELETE-Methode	Entfernt die Ressource, die durch den URI identifiziert wird.
GET-Methode	Ruft Informationen ab, die durch die im URI enthaltenen Parameter identifiziert werden. Es gibt keinen Inhaltstyp für die GET-Methode, da alle Parameter als Teil des URI übergeben werden. Die GET-Methode hat folgende Beschränkungen und Merkmale: Die URI-Länge ist auf 2048 Zeichen begrenzt. Alle Parameter werden im URI übergeben. Die GET-Methode gibt Daten preis, die im URI enthalten sind. Sie ist daher weniger sicher als die POST-Methode. Die GET-Methode ändert keine Daten und ist daher für alle Nutzer unabhängig von deren Berechtigung sicher. Einzelheiten finden Sie unter Using the Get method.
Patch-Methode	Ändert die Ressource, die durch den URI identifiziert wird.
POST-Methode	Erzeugt eine neue Ressource im URI. Die Parameter werden im Anforderungstext übergeben. Es gibt keine Längenbeschränkung für einen Anforderungstext. Einzelheiten finden Sie unter Using the Post method.
PUT-Methode	Aktualisiert oder ersetzt eine Ressource anhand von Parametern, die im URI oder im Textkörper übergeben werden. Einzelheiten finden Sie unter Verwendung der PUT-Methode.

Proxy support

If your device is configured with a proxy, all outbound requests from this Paket are routed through the proxy server. See Den Bot-Agent mit einem Gerät mit Proxy verbinden.

Automation 360

REST-Webdienst Paket