Leggi e rivedi la documentazione di Automation Anywhere

Automation 360

Chiudi contenuti

Contenuti

Apri contenuti

Richiedi i dettagli del dispositivo

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

Richiedi i dettagli del dispositivo

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

Prerequisiti

Ruoli e licenze
È necessario autenticarsi come utente con licenza Licenza bot runner non presidiato.
  • URL:
    http://<your_control_room_url>/v2/devices/list
  • Metodo: POST
Parametri filtrabili supportati:
id
L'identificatore numerico di 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"
  }
}
ID utente
Un identificativo numerico unico per l'utente associato al dispositivo registrato.
  • Campo: ID utente
  • 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 nell'elemento hostname e uno specifico stato del dispositivo. Utilizzare l'elenco nella risposta per identificare i dispositivi collegati e disponibili per l'esecuzione. bots.

Procedura

  1. Utilizzare l'opzione POST per generare un token web JSON di autenticazione. Aggiungere il token di autenticazione generato all'intestazione della richiesta.
  2. Seleziona il metodo POST.
  3. Inserire l'URL dell'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 da distribuire.
    Nota: I campi nel corpo della richiesta non è attualmente supportato. Quando si invia il nome del campo nel corpo della richiesta per limitare il numero di campi nella risposta, la risposta non funziona come previsto e restituisce invece tutti i campi.
    Ad esempio, questo corpo della richiesta utilizza "and" come operatore e i dispositivi "status" e "hostname" 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. invia la richiesta.
    • In un client REST, fai clic su INVIA.
    • Nell'interfaccia Swagger fai clic su Esegui.

    Corpo della risposta:

    La risposta restituisce i dettagli di due dispositivi che si trovano nello stato "connesso". stato e per i quali il nome host 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

È possibile utilizzare gli ID del dispositivo ricevuti nella risposta per distribuire l'opzione bots su Bot Runners.
Invia feedback