Leggi e rivedi la documentazione di Automation Anywhere

Automation Anywhre Automation 360

Chiudi contenuti

Contenuti

Apri contenuti

Richiedi dettagli dispositivo

  • Aggiornato: 7/10/2020
    • Automation 360 v.x
    • Esplora
    • Spazio di lavoro RPA

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 bot.

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 bot Bot Runner.
Invia feedback