Leggi e rivedi la documentazione di Automation Anywhere

Automation Anywhere Automation 360

Chiudi contenuti

Contenuti

Apri contenuti

Richiedi dettagli dispositivo

  • Aggiornato: 2020/07/10

    Richiedi dettagli dispositivo

    Utilizza questa API per recuperare un elenco di dispositivi disponibili per la bot distribuzione.

    Prerequisiti

    Ruoli e licenze
    Devi autenticarti come utente con una licenza di esecutore di bot non assistito.
    • URL:
      http://<your_control_room_url>/v2/devices/list
    • Metodo: PUBBLICAZIONE
    Parametri filtrabili supportati:
    ID
    L'identificatore numerico per un dispositivo.
    • Campo: id
    • Tipo: intero
    {
      "filter": {
        "operator": "eq",
        "value": "7",
        "field": "id"
      }
    }
    Nome host
    Il nome del dispositivo registrato.
    • Campo: nome host
    • Tipo: stringa
    {
      "filter": {
        "operator": "substring",
        "value": "AA",
        "field": "hostName"
      }
    }
    IDutente
    Un identificatore numerico univoco per l'utente associato al dispositivo registrato.
    • Campo: userId
    • Tipo: lungo
    {
      "filter": {
        "operator": "eq",
        "value": "13",
        "field": "userId"
      }
    }
    stato
    Lo stato di connessione del dispositivo.
    • Campo: stato
    • Tipo: stringa
    {
      "filter": {
         "operator": "eq",
         "value": "CONNECTED",
         "field": "status"
          }
    }

    Questo task richiede un elenco di tutti i dispositivi con una stringa specifica nel parametro hostname e uno stato specifico del dispositivo. Utilizza l'elenco nella risposta per identificare quali dispositivi sono connessi e disponibili per l'esecuzione di bots.

    Procedura

    1. Utilizza il metodo POST per generare un token Web JSON di autenticazione. Aggiungere il token di autenticazione generato all'intestazione della richiesta.
      API di autenticazione
    2. Selezionare il metodo POST.
    3. Immettere l'URL per l'API:
      https://<your_control_room_url>/v2/devices/list
    4. Nel corpo della richiesta, aggiungere le regole di filtraggio, ordinamento e paginazione per recuperare l'elenco dei dispositivi che si desidera distribuire.
      Ad esempio, questo corpo della richiesta utilizza "e" come operatore e lo "stato" e "nome host" del dispositivo come campo per filtrare i risultati richiesti. I risultati saranno ordinati in ordine decrescente in base allo "stato".
      {
        "sort": [
          {
            "field": "status",
            "direction": "desc"
          }
        ],
        "filter": {
          "operator": "and",
          "operands": [
            {
              "operator": "eq",
              "value": "CONNECTED",
              "field": "status"
            },
            {
              "operator": "substring",
              "value": "win",
              "field": "hostName"
            }
          ]
        },
        "fields": [
          
        ],
        "page": {
          "offset": 0,
          "total": 71,
          "totalFilter": 18,
          "length": 100
        }
      }
    5. Inviare la richiesta.
      • In un client REST, fare clic su INVIA.
      • Nell'interfaccia Swagger, fare clic su Esegui.

      Corpo della risposta:

      La risposta restituisce i dettagli di due dispositivi che si trovano nello stato "connesso" e per i quali l'hostName inizia con "win" in base ai criteri di filtro richiesti.
      {
        "page": {
          "offset": 0,
          "total": 71,
          "totalFilter": 7
        },
        "list": [{
          "id": "163",
          "type": "ATTENDED_BOT_RUNNER",
          "hostName": "winwlm-2",
          "userId": "",
          "userName": "",
          "status": "CONNECTED",
          "poolName": "",
          "fullyQualifiedHostName": "-",
          "updatedBy": "b2",
          "updatedOn": "2020-07-07T08:24:56.091061Z",
          "botAgentVersion": "12.1"
        }, {
          "id": "162",
          "type": "ATTENDED_BOT_RUNNER",
          "hostName": "winwlm-1",
          "userId": "",
          "userName": "",
          "status": "CONNECTED",
          "poolName": "",
          "fullyQualifiedHostName": "-",
          "updatedBy": "b1",
          "updatedOn": "2020-07-07T08:24:55.982047Z",
          "botAgentVersion": "12.1"
        }
      }

    Fasi successive

    Puoi utilizzare gli ID dispositivo ricevuti nella risposta per distribuire su bots Bot Runners.
    Invia feedback