Lesen und beachten Sie die Automation Anywhere-Dokumentation

Automation Anywhere Automation 360

Inhalt schließen

Inhalte

Inhalt öffnen

REST Web Service package

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

REST Web Service package

Verwenden Sie die actions in den REST Web Service package Methoden als (DELETE, GET, PATCH, POST oder PUT), um Anfragen an eine API zu senden und Antworten von dieser zu erhalten.

Arbeiten mit REST Web Service actions

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 Web Service actions 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 action dem REST Web Service actionein.
    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 Web Service action Ausgabe enthält.
    4. Weisen Sie den Wert jedes Schlüssels der Eingabeaufforderung USDzu.
    5. A Log To File actioneinfü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 action 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.

Actions Im REST Web Service package

Action 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 package den Proxyserver weitergeleitet. Einzelheiten finden Sie unter Stellen Sie über Bot agent einen Proxy eine Verbindung zu einem Gerät her.

Feedback senden