Lesen und beachten Sie die Automation Anywhere-Dokumentation

Automation Anywhere Automation 360

Inhalt schließen

Inhalte

Inhalt öffnen

Audit-API

  • Aktualisiert: 1/20/2021
    • Automation 360 v.x
    • Managen
    • RPA Workspace
    • API-Dokumente

Audit-API

Verwenden Sie die Audit-API, um Audit-Daten für eine bestimmte Eingabekombination aus Datumsfilter, Sortiermechanismus und Paginierung anzufordern.

Vorbereitungen

Anmerkung: Sie können die Control Room APIs im anzeigen Community Edition, aber die API-Funktionalität ist eingeschränkt. Sie benötigen eine lizenzierte Automation 360 Edition, um auf die volle Funktionalität der APIs zugreifen zu können.
  • Verwenden Sie die Authentifizierungs -API, um ein JSON-Webtoken zu generieren.
  • Benutzer mit der AAE_Admin Rolle oder Benutzer mit der Berechtigung Alle Überwachungsprotokollaktionen anzeigen können Überwachungsprotokolle für das Control Roomanzeigen.

Prozedur

  1. Verwenden Sie die Authentifizierungs -API, um ein JSON-Webtoken zu generieren.
  2. Wenden Sie Filter an, um grundlegende bedingte Abfragen und die Seiteninierungssteuerung für die Verarbeitung von Webseiten durchzuführen.
    Es gibt drei grundlegende Funktionen im Zusammenhang mit dem Filtern: Filterbedingungen, Sortieren von Spalten und Paginierungsparameter.

    Filter in einem API-Anforderungskörper

  3. Verwenden Sie die POST-Methode und die Endpunkt-URL: <Your_Control_Room_url>/v1/Audit/messages/list.
    Im folgenden Beispiel werden fehlgeschlagene Anmeldeversuche für den Monat Dezember 2019 angefordert.

    Anforderungsorgan:

    {
      "sort": [
        {
          "field": "createdOn",
          "direction": "desc"
        }
      ],
      "filter": {
        "operator": "and",
        "operands": [
          {
            "operator": "gt",
            "field": "createdOn",
            "value": "2019-12-01T00:00:00.001Z"
          },
          {
            "operator": "lt",
            "field": "createdOn",
            "value": "2019-12-31T23:59:59.999Z"
          },
          {
            "operator": "eq",
            "field": "status",
            "value": "Unsuccessful"
          },
          {
            "operator": "substring",
            "field": "activityType",
            "value": "LOGIN"
          },
          {
            "operator": "substring",
            "field": "userName",
            "value": "joe.typical@myemiil.com"
          }
        ]
      },
      "fields": [],
      "page": {
        "length": "1000",
        "offset": "0"
      }
    }
  4. Senden Sie die Anfrage.
    Die Antwort für dieses Beispiel gibt Daten für den Datumsfilter, die Sortierung und die Seitennummerierung zurück. Wenn in der Anforderung keine Filterung verwendet wird, gibt eine erfolgreiche Antwort alle Seiten für die angegebene Control Roomzurück.
    Antwortgremium:
    {
      "page": {
        "offset": 0,
        "total": 731064850,
        "totalFilter": 9
      },
      "list": [
        {
          "id": "XlHj6G4BFXSpOOji5B7S",
          "eventDescription": "User does not exist in Control Room.",
          "activityType": "LOGIN",
          "environmentName": "",
          "hostName": "12.xxx.xx.x",
          "userName": "joe.typical@myemiil.com",
          "status": "Unsuccessful",
          "source": "Control Room",
          "objectName": "N/A",
          "detail": "",
          "createdOn": "2019-12-09T04:21:19Z",
          "requestId": "04965c2e-82e0-4ce4-a88d-bebe1dc3a2a8",
          "createdBy": "0"
        },
        {
          "id": "g1Hj6G4BFXSpOOji2Rwx",
          "eventDescription": "User does not exist in Control Room.",
          "activityType": "LOGIN",
          "environmentName": "",
          "hostName": "12.xxx.xx.x",
          "userName": "joe.typical@myemiil.com",
          "status": "Unsuccessful",
          "source": "Control Room",
          "objectName": "N/A",
          "detail": "",
          "createdOn": "2019-12-09T04:21:16Z",
          "requestId": "61672553-477d-4012-ab47-2a27f6553c4e",
          "createdBy": "0"
        },
        ..............................
        {
          "id": "ETyk6G4BFXSpOOjiaJjt",
          "eventDescription": "User does not exist in Control Room.",
          "activityType": "LOGIN",
          "environmentName": "",
          "hostName": "12.xxx.xx.x",
          "userName": "joe.typical@myemiil.com",
          "status": "Unsuccessful",
          "source": "Control Room",
          "objectName": "N/A",
          "detail": "",
          "createdOn": "2019-12-09T03:11:58Z",
          "requestId": "ebeb01de-1f81-4a7c-8978-405806e146bd",
          "createdBy": "0"
        }
      ]
    }
Die REST-API antwortet auf jede Anforderung mit einem HTTP-Antwortcode. Antwortcodes finden Sie unter API-Antwortcodes.
Feedback senden