Erstellen einer API-Aufgabe (API-Aufgabe in Formular)

Erstellen Sie einen API-Aufgabe mit den im Control Room verfügbaren Paketen im API-Aufgabe-Editor. Sie können einen API-Aufgabe mit Aktionen aus Paketen erstellen, die auf Automation 360 Cloud unterstützt werden.

Vorbereitungen

Sie müssen über eine Bot Creator-Lizenz verfügen.
In diesem Thema wird beschrieben, wie eine API-Aufgabe mithilfe einer API erstellt wird, die eine Postleitzahl in den USA als Eingabe annimmt und die Namen für Ort und Staat als Ausgabe zurückgibt. Sie können einen API-Aufgabe mit den Aktionen erstellen, die für Ihren Anwendungsfall spezifisch sind.

Prozedur

  1. Melden Sie sich bei Ihrem Automation Anywhere Control Room als Bot Creator an:
  2. Erstellen sie eine neue API-Aufgabe:
    1. Klicken Sie im linken Fensterbereich auf Automatisierung.
    2. Klicken Sie auf Neu erstellen > API-Aufgabe.
    3. Geben Sie im Fenster API-Aufgabe erstellen einen Namen für den API-Aufgabe ein.
    4. Bestätigen Sie den Standardordner: \Bots\.
      Klicken Sie auf Auswählen und folgen Sie den Anweisungen, um den Speicherort Ihres API-Aufgabes zu ändern.
    5. Klicken Sie auf Erstellen und bearbeiten.
  3. Erstellen Sie eine ZipCode-Variable als Eingabe, die in der ZIP-Code-URL verwendet wird.
  4. Verwenden Sie die Aktion GET-Methode, um Ort und Staat einer Postleitzahl abzurufen.
    Anmerkung: Für die meisten gängigen Unternehmensanwendungen gibt es vorkonfigurierte Pakete. Eine Liste der unterstützten Pakete finden Sie unter FAQs zur API-Aufgabe (.30-Inhalt).
    1. Doppelklicken Sie auf oder ziehen Sie die Aktion REST Web Services > GET-Methode.
      REST Web Services – Get-Methode
    2. Geben Sie den folgenden URI ein. $ZipCode$ im URI ist die in Schritt 3erstellte Eingabevariable. 
      https://api.zippopotam.us/us/$ZipCode$
      Anmerkung:

      Sie können mehrere Bedingungen innerhalb einer einzigen API-AufgabeWenn konfigurieren. Dies kann Ihre Automatisierung vereinfachen und den Bedarf an mehreren separaten Aufgaben verringern. Sie können zum Beispiel API 1 aufrufen, um Produktdaten abzurufen, API 2, um Preisdaten abzurufen, und dann API 3, um ein Angebot innerhalb desselben API-Aufgabezu erstellen.

    3. Wählen Sie im Dropdown-Menü Authentifizierungsmodus die Option Keine Authentifizierung, weil für diesen Endpunkt keine Authentifizierung erforderlich ist.
      Anmerkung: In der Regel erfordern Endpunkte eine Authentifizierung, sodass nur autorisierte Anwendungen auf die Daten zugreifen können. Wählen Sie einen geeigneten Authentifizierungsmechanismus, um den Zugriff auf den gewünschten Endpunkt zu erlauben.
    4. Erstellen Sie die Variable pDictZipCodeApiResponse im Feld Ausgabe zu einer Variablen zuweisen. Weitere Informationen zur Erstellung von Variablen finden Sie unter Erstellen von Variablen.
      Anmerkung:
      • Die vollständige API-JSON-Antwort wird dieser Wörterbuchvariable zugewiesen: pDictZipCodeApiResponse.
      • Die folgenden Variablentypen werden für API-Aufgaben nicht unterstützt: Datei, Fenster und Formular.
  5. Ziehen Sie die Aktion JSON > Sitzung starten aus dem Bereich „Aktionen“ und legen Sie sie auf der Leinwand unter der Aktion REST Web Services ab.
    1. Wählen Sie im Feld Datenquelle die Option Text aus und geben Sie $pDictZipCodeApiResponse{Body}$ ein.
    2. Wählen Sie im Feld JSON-Objektsitzung die Option Lokale Sitzung aus und geben Sie Default ein.

      API-Aufgaben-Wörterbuch
      Sie haben jetzt den gesamten Body. Die nächste Aufgabe besteht darin, die erforderlichen Felder aus dem Textkörper zu extrahieren. Im Folgenden wird ein Beispiel für einen Body in JSON gezeigt:
      {
    "post code": "90210",
    "country": "United States",
    "country abbreviation": "US",
    "places": [
        {
            "place name": "Beverly Hills",
            "longitude": "-118.4065",
            "state": "California",
            "state abbreviation": "CA",
            "latitude": "34.0901"
        }
    ]
}
  6. Extrahieren Sie place name aus dem JSON-Body.
    1. Ziehen Sie die Aktion Aktion JSON > Knotenwert abrufen aus dem Bereich „Aktionen“ und legen Sie sie auf der Leinwand unter der Aktion JSON > Sitzung starten ab.
    2. Geben Sie an, welche Knoten extrahiert werden sollen. Um zum Beispiel den Ort zu extrahieren, können Sie places[0].["place name"] verwenden.
    3. Erstellen Sie die Variable Ort und weisen Sie die Ausgabe dieser Variablen zu.
  7. Extrahieren Sie state aus dem JSON-Body.
    1. Ziehen Sie die Aktion Aktion JSON > Knotenwert abrufen aus dem Bereich „Aktionen“ und legen Sie sie auf der Leinwand unter der Aktion JSON > Sitzung starten ab.
    2. Geben Sie an, welche Knoten extrahiert werden sollen. Um zum Beispiel den Ort zu extrahieren, können Sie places[0].["state"] verwenden.
    3. Erstellen Sie die Variable Staat und weisen Sie die Ausgabe dieser Variablen zu.
  8. Klicken Sie auf Speichern.
    Um den API-Aufgabe zu testen, klicken Sie auf Debugger. Während der Fehlersuche wird das lokale Gerät zur Ausführung des API-Aufgabes verwendet. Der in diesem Beispiel erstellte API-Aufgabe ruft den Ort und den Staat für alle Postleitzahleneingaben ab.