Lea y revise la documentación de Automation Anywhere

Automation Anywhere Automation 360

Cerrar contenidos

Contenidos

Abrir contenidos

Solicitar detalles del dispositivo

  • Actualizado: 2020/07/10
    • Automation 360 v.x
    • Explorar
    • Espacio de trabajo de RPA

Solicitar detalles del dispositivo

Utilice esta API para recuperar una lista de dispositivos que están disponibles para la implementación de bot.

Antes de empezar

Roles y licencias
Tiene que autenticarse como usuario con una licencia Ejecutor de Bot no supervisado.
  • Dirección URL:
    http://<your_control_room_url>/v2/devices/list
  • Método: PUBLICAR
Parámetros filtrables compatibles:
id
El identificador numérico de un dispositivo.
  • Campo: id
  • Tipo: entero
{
  "filter": {
    "operator": "eq",
    "value": "7",
    "field": "id"
  }
}
hostName
El nombre del dispositivo registrado.
  • Campo: hostName
  • Tipo: cadena
{
  "filter": {
    "operator": "substring",
    "value": "AA",
    "field": "hostName"
  }
}
userId
Identificador numérico único para el usuario asociado con el dispositivo registrado.
  • Campo: userId
  • Tipo: largo
{
  "filter": {
    "operator": "eq",
    "value": "13",
    "field": "userId"
  }
}
status
El estado de conexión del dispositivo.
  • Campo: status
  • Tipo: cadena
{
  "filter": {
     "operator": "eq",
     "value": "CONNECTED",
     "field": "status"
      }
}

Esta tarea solicita una lista de todos los dispositivos con una cadena específica en el parámetro hostname y estado específico del dispositivo. Utilice la lista en la respuesta para identificar qué dispositivos están conectados y disponibles para ejecutar bots.

Procedimiento

  1. Utilice el método POST para generar un Web Token JSON. Agregue el token de autenticación generado al encabezado de la solicitud.
  2. Seleccione el método POST.
  3. Introduzca la URL para la API:
    https://<your_control_room_url>/v2/devices/list
  4. En el cuerpo de la solicitud, agregue las reglas de filtrado, clasificación y paginación para recuperar la lista de dispositivos que desea implementar.
    Por ejemplo, este cuerpo de solicitud utiliza "y" como operador y el "estado" y "nombre de host" del dispositivo como campo para filtrar los resultados requeridos. Los resultados se ordenarán en orden “descendente” según el “estado”.
    {
      "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. Envíe la solicitud.
    • En un cliente REST, haga clic en ENVIAR.
    • En la interfaz de Swagger, haga clic en Ejecutar.

    Cuerpo de la respuesta:

    La respuesta devuelve los detalles de dos dispositivos que están en el estado "conectado" y para los cuales el nombre de host comienza con "ganar" según los criterios de filtro solicitados.
    {
      "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"
      }
    }

Qué hacer a continuación

Puede usar los ID de dispositivo recibidos en la respuesta para implementar bots en Bot Runners.
Enviar comentarios