Lea y revise la documentación de Automation Anywhere

Cerrar contenidos

Contenidos

Abrir contenidos

API de Enterprise Control Room para implementación de bots

  • Actualizado: 5/10/2019
    • 11.3.x
    • Explorar
    • Enterprise
    • Documentos de API

API de Enterprise Control Room para implementación de bots

Puede utilizar la API de implementación de bots de Enterprise Control Room para activar bots desde un sistema externo o una aplicación de terceros.

Para implementar bots en el entorno de automatización, actualmente el usuario tiene que iniciar sesión en Enterprise Control Room, seleccionar el bot y los Bot Runners y luego "Ejecutar/Programar" la tarea.

Sin embargo, a medida que los escenarios de automatización escalan, hay una necesidad cada vez mayor de implementar/activar bots desde una aplicación externa.

Para satisfacer este requisito empresarial, público interfaces de programación de aplicaciones (API) con las que un bot se puede activar desde un sistema externo.

Un usuario de Enterprise Control Room puede usar estas API para implementar bots (tareas) en instancias de Bot Runner al inicio de eventos especificados por una aplicación externa.

Nota: No se puede implementar bots supervisados desde Enterprise Control Room. Solo están disponibles los bots no supervisados para su implementación desde Enterprise Control Room.

Características clave y beneficios empresariales de las API de Enterprise Control Room

  • Los bots se pueden implementar desde sistemas externos con las API de .
  • La entrada y salida de las API se basa en JSON (el formato de intercambio de datos estándar en el sector).
  • La implementación de bots se puede organizar desde una aplicación/flujo de trabajo externos mediante una combinación de secuencias de comandos y API de .
Nota: La API de implementación de bots ÚNICAMENTE se puede invocar después de que el sistema o el usuario se haya autenticado con la API de autenticación

Además, el usuario deberá tener privilegios de "Ejecutar mis bots" y los privilegios de las instancias de Bot Runner en las que se implementará el bot.

API de implementación

La API de implementación se usa para implementar bots en instancias de Bot Runner.

API: <Enterprise Control Room URL>/v1/schedule/automations/deploy

Por ejemplo, si la dirección URL de Enterprise Control Room es https://www.ultron.com:81, la API de implementación de bots será https://www.ultron.com:81/v1/schedule/automations/deploy

El usuario puede pasar tres parámetros como una cadena JSON.

  1. Nombre de bot con ruta relativa. Esto es obligatorio.
  2. Lista de instancias de Bot Runner y usuarios en formato JSON. Esto es obligatorio.
  3. Use un enfoque basado en RDP. Esto es opcional y está configurado como Falso de forma predeterminada.

Escenario de implementación y cadena JSON correspondiente:

  1. Por ejemplo, el nombre del bot es Accountsbot.atmx y el bot está en "Mis tareas"
  2. El bot se implementará en 3 máquinas
    • Nombre de host de la primera máquina BR-1 con usuario U-1
    • Nombre de host de la segunda máquina BR-2 con usuario U-2
    • Nombre de host de la tercera máquina BR-3 con usuario U3
  3. La cadena JSON en el escenario anterior será:

    {

    "taskRelativePath":"My Tasks\\Accountsbot.atmx", "Bot Runners":

    [

    {

    "client":"BR-1", "user":"U-1"

    },

    {

    "client":"BR-2", "user":"U-2"

    },

    {

    "client":"BR-3", "user":"U-3"

    }

    ]

    }

Códigos de respuesta de API de implementación de bots

Código de estado Http(s) Respuesta - Descripción
200 Creación correcta de automatización.
400 Solicitud incorrecta
401 Autenticación requerida
403 Acceso no autorizado
409 Conflicto
500 Error de servidor interno
Enviar comentarios