Lesen und beachten Sie die Automation Anywhere-Dokumentation

Automation Anywhere Automation 360

Inhalt schließen

Inhalte

Inhalt öffnen

REST-Webdienst Paket

  • Aktualisiert: 12/01/2020
    • Automation 360 v.x
    • Erstellen
    • RPA Workspace

REST-Webdienst Paket

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

Arbeiten mit REST-Webdienst Aktionen

Geben Sie die folgenden Informationen an, um eine REST-Anfrage zu senden und eine Antwort zu erhalten. Nicht alle Parameter sind für alle Methoden erforderlich.
  • URI: Eine eindeutige Adresse für eine API-Ressource.
  • Authentifizierungsmodus: Es gibt drei unterstützte Authentifizierungsmodi:
    • Grundausstattung: Für die einfache Authentifizierung können Textzeichenfolgen verwendet werden.
    • Angemeldeter AD-Nutzer Active Directory (AD)-Benutzer, die berechtigt sind, auf die zugehörige API zuzugreifen, werden über AD authentifiziert. Für die Anforderung sind keine Anmeldeinformationen erforderlich.
    • Windows NT LAN Manager (NTLM)-Authentifizierung (AD-Benutzer): Eine Authentifizierungsmethode für Sicherheitsfragen/Antworten, mit der Clients ihren Benutzernamen und ihr Kennwort als verschlüsselte Anmeldeinformationen oder als Klartext angeben können. Wir empfehlen, dass Sie Anmeldeinformationen verwenden, die im Automation Anywhere Credential Vaultgespeichert sind.
  • Kopfzeile: Nicht alle Methoden erfordern eine Kopfzeile. Kopfzeilen stellen die Metadaten dar, die mit der Anforderung verknüpft sind.
    Anmerkung: Um einen API-Schlüssel in Ihrer Anfrage zu verwenden, geben Sie API_Key in das Feld Name der Kopfzeile und den Schlüsselwert in das Feld Wert ein.
  • Erfassungsfehler Antwort: Aktivieren Sie das Kontrollkästchen, um die Fehlerantwort mit Ausnahme der erfolgreichen/OK -Antwort zu erfassen. Die Details der Fehlerantwort werden im Antwortgremium erfasst.
  • Inhaltstyp: Wenn ein Header einen Inhaltstyp enthält, definiert er die Inhaltsverhandlung zwischen dem Client und dem Server. REST-Webdienst Aktionen Unterstützen Sie die folgenden Inhaltstypen:
    • Anwendung/json
    • Anwendung/XML
    • Text/plain
    • Text/HTML
    • Text/XML
  • Ausgangsvariable: Die Antwortausgabe wird in einer Wörterbuchvariable erfasst. Eine Wörterbuchvariable ist ein Schlüssel-Wert-Paar. Verwenden Sie den Namen des Antwortkopfs als Schlüssel, um den Kopfzeilenwert zurückzugeben, oder „body“ als Schlüssel, um den Antwortkörper zurückzugeben.
    Anmerkung: Der Antwortschlüssel mit seinem Wert ist in der Wörterbuchvariable verfügbar, um den Antwortstatus der REST-API anzuzeigen.
    Führen Sie die folgenden Schritte aus, um eine Liste der Kopfzeilennamen für die API-Ressource zu erhalten:
    1. Fügen Sie nach Loop Aktion dem REST-Webdienst Aktionein.
    2. Wählen Sie für jeden Schlüssel im Iterator des Wörterbuchs die Option aus.
    3. Wählen Sie im Feld Variable Wörterbuch die Variable aus, die die REST-Webdienst Aktion Ausgabe enthält.
    4. Weisen Sie den Wert jedes Schlüssels der Eingabeaufforderung USDzu.
    5. A In Datei protokollieren Aktioneinfügen.
    6. Geben Sie den Dateipfad zu einer Textdatei an, in der die Liste der Kopfzeilennamen enthalten ist.
    7. Geben Sie in das Feld Text in Protokoll eingeben den Betrag für die Eingabeaufforderung ein.
    8. Wählen Sie die Option vorhandene Datei überschreiben.
    9. Klicken Sie auf Speichern.

      Wenn Sie das Botausführen, werden die Kopfzeilennamen von der API-Ressource in die ausgewählte Datei gedruckt.

Werte sicher übergeben

Sie können Werte vom sicher Credential Vault an den Web-Service übergeben, indem Sie die Anmeldedaten Lockerund das Attribut in den folgenden unterstützten Aktion Feldern angeben:
  • URI
  • Benutzerdefinierte Header
  • Textkörper: Klicken Sie für den Inhaltstyp Application/x-www-Form-urlencoded auf Parameter hinzufügen , um den Wert aus dem Credential Vaultauszuwählen.

    Wählen Sie für alle anderen Inhaltstypen die Option Anmeldeinformationen als Parameter auswählen aus, und klicken Sie auf Auswählen.

Aktionen Im REST-Webdienst Paket

Aktion Beschreibung
DELETE-Methode Entfernt die durch den URI identifizierte Ressource.
GET-Methode Ruft Informationen ab, die durch die in der URI enthaltenen Parameter identifiziert werden. Es gibt keinen Inhaltstyp für die GET-Methode, da alle Parameter als Teil der URI übergeben werden.

Zu den Einschränkungen und Eigenschaften der GET -Methode gehören:

  • Die URI-Länge ist auf 2048 Zeichen begrenzt.
  • Alle Parameter werden in der URI übergeben.
  • Die GET -Methode stellt Daten in der URI bereit, was sie weniger sicher als die POST -Methode macht.
  • GET ändert keine Daten, wodurch sie für alle Benutzer unabhängig von der Autorisierung sicher sind.
Patch-Methode Ändert die durch den URI identifizierte Ressource.
POST-Methode Erstellt eine neue Ressource im URI.
  • Parameter werden im Anforderungskörper übergeben.
  • Für eine Anforderungsstelle gibt es keine Längenbeschränkung.
PUT-Methode Aktualisiert oder ersetzt eine Ressource basierend auf Parametern, die im URI oder Body übergeben wurden.

Proxy-Unterstützung

Wenn Ihr Gerät mit einem Proxy konfiguriert ist, werden alle ausgehenden Anforderungen von diesem über Paket den Proxyserver weitergeleitet. Einzelheiten finden Sie unter Stellen Sie über Bot-Agent einen Proxy eine Verbindung zu einem Gerät her.

Feedback senden