REST-Internetdienst Paket

Verwenden Sie die Aktionen im REST-Internetdienst-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-Internetdienst-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-Internetdienst 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.
    • Nutzertoken für Control Room: Die REST-Internetdienst-Aktionen nutzen das Token, das bei der Anmeldung im Control Room generiert wurde, um auf die Endpunkte zuzugreifen.
    • 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.
    • OAuth2 – Control Room verwaltet: Wenn Sie OAuth in den Control Room integrieren, können Sie Token, die zur Authentifizierung bei Drittanbietern verwendet werden, zentral verwalten und sicher speichern. Sie müssen den Webdienst konfigurieren und die Authentifizierungsdetails (wie etwa Client-ID, Geheimer Clientschlüssel, Autorisierungs-URL usw.) notieren, um die OAuth-Verbindung im Control Room zu nutzen. Weitere Details finden Sie unter Konfigurieren Sie OAuth-Verbindungen im Control Room

      Das folgende Video zeigt, wie Sie die OAuth-Verbindung in REST-Internetdienst nutzen können:

  • 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-Internetdienst Aktionen unterstützen die folgenden Inhaltstypen:
    • 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. Sie werden in Fällen verwendet, in denen Sie mehrere Teile in einer einzigen Anforderung senden, die in der Regel Textdaten (wie Formularfelder) und möglicherweise einen Dateiupload umfasst. Sie können auch eine FileStream-Variable verwenden. Weitere Informationen finden Sie unten.
      • FileStream: Der FileStream kann nach der Zuweisung zu einer Variablen gelesen werden. Sie können beispielsweise einen FileStream lesen, der einer Variablen in einem OneDrive-Speicherort zugewiesen ist. Weitere Informationen finden Sie unter Aktion „Datei zuweisen“.FileStream für REST Web Services
    • Binär: Verwenden Sie die Option Binary, um RAW-Dateien wie Bilder, Videos und Audiodateien zu senden. Wenn Sie Binary auswählen, können Sie eine Binärdatei hochladen (als Variable, Control Room-Datei oder Desktop-Datei).
    • Benutzerdefiniert
      Benutzerdefiniert: Fügen Sie benutzerdefinierte Inhalte hinzu, die nicht unter den Standard-Inhaltstyp fallen. Wenn Sie beispielsweise von v.11.x auf Automation 360 migrieren, fällt der folgende Wert nicht unter einen der Standard-Inhaltstypen: application/vnd.whispir.message-v1+json
  • 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.
    • Cookies akzeptieren: Aktivieren Sie das Kontrollkästchen, um Sitzungs-Cookies automatisch aus Serverantworten zu erfassen.
      • Erfassen: Wenn diese Funktion aktiviert ist, werden die in den Serverantworten enthaltenen Sitzungscookies erfasst.
      • Sicherer Speicher: Erfasste Cookies werden im Prozessspeicher verschlüsselt, sodass sie niemals dauerhaft gespeichert werden und außerhalb Ihrer Automatisierungssitzung unzugänglich sind.
      • Wiederverwenden: Cookies werden automatisch in nachfolgende REST-Aufrufe einbezogen, wodurch die manuelle Handhabung von Cookies entfällt und die Zuverlässigkeit der Automatisierung verbessert wird.
      • Handhabung mehrerer Cookies: Die Funktion verarbeitet nahtlos mehrere vom Server zurückgegebene Cookies und stellt sicher, dass alle erforderlichen Authentifizierungsdaten enthalten sind.
      • Vernichtung: Erfasste Cookies werden automatisch vernichtet, wenn die Automatisierungssitzung endet oder der Bot die Ausführung beendet, sodass Datensicherheit und Datenschutz gewährleistet sind.
      Anmerkung: Die erfassten Cookies sind spezifisch für die Domäne, aus der sie stammen, und werden nicht automatisch für nachfolgende REST-Aufrufe verwendet, die in anderen Domänen erfolgen. Das bedeutet, dass Cookies, die von domainA.com erfasst wurden, nicht für Anfragen an domainB.com verwendet werden.
  • 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 Schleife-Aktion eine REST-Internetdienst-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-Internetdienst-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 und wählen Sie den Wert aus dem Credential Vault.

    Für alle anderen Inhaltstypen wählen Sie die Option Anmeldedaten als Parameter auswählen und klicken Sie auf Wählen.

Aktionen im REST-Internetdienst-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 Verwendung der GET-Methode.
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 Verwendung der POST-Methode.
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

Wenn Ihr Gerät mit einem Proxy konfiguriert ist, werden alle ausgehenden Anforderungen von diesem Paket über den Proxyserver geleitet. Einzelheiten finden Sie unter Den Bot-Agent mit einem Gerät mit Proxy verbinden.