Saltar a contenido

Automatizaciones

En las siguientes secciones, encontrarás información sobre cómo crear y gestionar Automatizaciones.

Captura de pantalla del Orquestador de BotCity, en el menú Automatizaciones, presentando la lista de automatizaciones disponibles con información en columnas: Ícono, Nombre, Label, Descripción, ID del Robot, Repositorio, Avisos y menú de acciones. Encima de la lista, barra de búsqueda, filtros y ordenación. Junto a los filtros, los botones de Nueva automatización, Importar y Acciones en masa.

Anatomía de una Automatización

Una automatización es uno de los elementos más importantes del Orquestador BotCity. Caracteriza un proceso a ser ejecutado.

La automatización es responsable de vincular el Robot (script, software o código de un proceso) con los Runners (instancias del servicio BotCity Runner). De esta forma, al crear una nueva tarea, la automatización contendrá la información sobre qué robot utilizar y a cuál Runner debe dirigirse la tarea.

Diagrama que ilustra el flujo de orquestación de BotCity en tres etapas: 1) Desarrollar el robot, representado por un ícono de Python con el texto "Bot"; 2) Configurar la automatización, representada por el Orquestador BotCity (ícono de nube azul) que contiene una Automatización que vincula el Robot a una Tarea; 3) Ejecutar, representada por el BotCity Runner recibiendo la Tarea de la cola y ejecutándola.

Más información

Aprende más sobre:

Una automatización puede contener más información y configuraciones sobre un proceso a ejecutar.

La información está separada en 3 pestañas: Vista General, Desarrollo y Política de ejecución.

Vista General

En esta pestaña encontrarás la información general sobre la Automatización, separada en bloques:

  • Sobre la automatización
    • Nombre: El nombre descriptivo de la automatización.
    • Label: El identificador único de la automatización (el label es único; incluso si eliminas la automatización, no podrás volver a usarlo).
    • Repositorio: Selección del repositorio donde se alojará la automatización.
    • Descripción: Una breve descripción del proceso de automatización.
  • Gestión de tareas
    • Prioridad: La prioridad de ejecución predeterminada de este proceso.
    • Runners vinculados: Selección de Runners asociados a esta automatización. Si hay más de un Runner adjunto, la tarea se asignará al primer BotCity Runner libre que esté en línea y disponible.
  • Notificaciones
    • Usuarios a notificar: Selección de usuarios a notificar cuando ocurra una alerta de notificación de un tipo determinado.
    • Tipo de notificación: Los tipos de notificación de alerta para notificar a los usuarios.

Notificaciones

Los usuarios seleccionados en el campo Notificar usuarios recibirán una notificación por correo electrónico cada vez que la automatización emita una alerta por código.

Consulta más en:

Captura de pantalla del Orquestador de BotCity, presentando el formulario de creación de Nueva Automatización, en la pestaña Vista General. El formulario está dividido en tres secciones: "Sobre la automatización", con los campos Nombre, Label, Repositorio y Descripción; "Gestión de tareas", con los campos Prioridad y Runners vinculados; y "Notificaciones", con los campos Usuarios a notificar y Tipo de notificación. En la esquina superior derecha, los botones de Cancelar y Guardar. En la parte superior de la página, las pestañas de navegación: Vista General (seleccionada), Desarrollo y Política de ejecución.

Desarrollo

En esta pestaña encontrarás información de desarrollo de la automatización, separada en bloques:

  • Información del Bot
    • Robot vinculado: El código de un proceso o software asociado a esta automatización.
    • Tecnología: Tecnología o lenguaje de programación utilizado en la automatización.
  • Parámetros: Información dinámica que puede ser utilizada por el Robot vinculado.

Parámetros

Las automatizaciones pueden parametrizarse para mayor flexibilidad y código más dinámico.

Los parámetros se definen en la sección Parámetros de la automatización al crearla o editarla.

En la pestaña Desarrollo, haz clic en el botón Editar para habilitar los campos de edición, luego haz clic en el botón Agregar + para añadir un nuevo parámetro.

Un parámetro se define por los siguientes elementos:

  • Nombre: El nombre descriptivo del parámetro.
  • Label: El identificador único del parámetro.
  • Descripción: Una breve descripción del parámetro.
  • Tipo: Selección del tipo de dato del parámetro, que puede ser:
    • Text: Tipo de entrada de texto.
    • Integer: Tipo de entrada de número entero.
    • Double: Tipo de entrada de número decimal.
    • Date: Tipo de entrada de fecha.
  • Intervalo: Indica el valor mínimo y máximo para la entrada de datos numéricos.
  • Valor predeterminado: Indica qué valor de entrada está definido como predeterminado para el campo.
  • Obligatorio:
    • Sí: Es obligatorio proporcionar un valor para el campo al crear una tarea.
    • No: Es opcional proporcionar un valor para el campo al crear una tarea.
  • Acciones:
    • Eliminar: Elimina el parámetro.
    • Editar: Abre la edición del parámetro.
    • Cancelar: Cancela la edición del parámetro.
    • Guardar: Guarda la edición del parámetro.

Tipo de dato

El Tipo determinará cómo se mostrará el parámetro al crear una nueva tarea en el Orquestador BotCity.

Consulta más detalles sobre cómo crear y acceder a Parámetros a través del SDK.

Captura de pantalla del Orquestador de BotCity, presentando el formulario de creación de Nueva Automatización, en la pestaña Desarrollo (seleccionada). El formulario está dividido en dos secciones: "Información del Bot", con los campos Bot y Tecnología del Bot; y "Parámetros", con un enlace "¿Cómo usar parámetros?", el botón "Agregar +" y una tabla con las columnas Nombre, Label, Descripción, Tipo, Intervalo, Valor Predeterminado, Obligatorio y Acciones. En la esquina superior derecha, los botones de Cancelar y Guardar. En la parte superior de la página, las pestañas de navegación: Vista General, Desarrollo (seleccionada) y Política de ejecución.

Política de Ejecución

En esta pestaña tienes la opción de definir el tiempo máximo esperado para que una tarea de esta automatización se ejecute.

Cuando el timeout está habilitado, puedes seleccionar la opción de tiempo esperado en:

  • Minuto
  • Hora
  • Día

El valor de tiempo debe definirse con un mínimo de 1 minuto y un máximo de 1 día.

¡Atención!

  • El timeout se aplicará a las nuevas tareas de esta automatización. Si ya hay tareas en cola, no se verán afectadas.
  • El tiempo definido en timeout comienza a contar desde el momento en que la tarea inicia su ejecución por el Runner. El tiempo en cola no se considera.

Captura de pantalla del Orquestador de BotCity, presentando el formulario de creación de Nueva Automatización, en la pestaña Política de ejecución (seleccionada). El formulario muestra la sección "Timeout". Debajo, un botón de alternancia habilitado con el texto "Habilitar timeout en esta automatización" y el campo "Timeout esperado" con dos campos de selección: unidad de tiempo y valor numérico. En la esquina superior derecha, los botones de Cancelar y Guardar. En la parte superior de la página, las pestañas de navegación: Vista General, Desarrollo y Política de ejecución (seleccionada).

Acciones

Puedes realizar algunas acciones en el menú de Automatizaciones.

Crear

Para crear una automatización, sigue los pasos:

  • Accede al menú Automatizaciones en el Orquestador BotCity
  • Haz clic en el botón + Nueva Automatización en la esquina superior derecha
  • Completa la información de:
  • Haz clic en el botón Guardar en la esquina superior derecha

Campos obligatorios

Los campos obligatorios son: Nombre, Label, Repositorio y Descripción.

El resto de la información puede completarse posteriormente. Sin embargo, para la ejecución de tareas de esta automatización, es necesario tener el Robot y al menos un Runner vinculado.

Otra forma de crear

Las automatizaciones también pueden crearse de forma simplificada a través del Easy Deploy.

¡Avisos!

Puedes ver un panel de avisos cuando la automatización no está completamente configurada.

Captura de pantalla del Orquestador de BotCity, presentando la página de detalles de una automatización. Destaca un panel de avisos en amarillo con el título "3 Avisos para esta automatización" y los siguientes avisos: 1) "No reportando ítems" - la automatización no está reportando ítems y, por lo tanto, no está alimentando los indicadores de eficiencia, con enlace "Aprende cómo reportar"; 2) "Ningún runner vinculado" - la automatización no tiene runner vinculado, con enlace "Vincular runner(s)"; 3) "Ningún bot vinculado" - la automatización no tiene bot vinculado, con enlace "Vincular bot". En la esquina superior derecha de la página, los botones de Compartir, Eliminar, Editar y Exportar.

Los avisos hacen referencia a la falta de información importante en la automatización que debe completarse para el correcto funcionamiento, entre ellos:

  • No reportando ítems. La automatización no está reportando ítems y, por lo tanto, no está alimentando los indicadores de eficiencia. Aprende cómo reportar.

    • Utilizar este recurso en tu proceso de automatización te permite tener información sobre los ítems procesados con éxito o fallo por cada tarea ejecutada.

    BotCity Insights

    Este recurso forma parte de BotCity Insights, un módulo dedicado a reportar y mostrar datos referentes a tu iniciativa de automatización.

    Consulta más en:

  • Ningún runner adjunto. Esta automatización no tiene runner adjunto.

    Consulta más en:

  • Ningún bot adjunto. Esta automatización no tiene bot adjunto.

    Consulta más en:

GIF que demuestra cómo crear una nueva automatización. Flujo accediendo al menú Automatizaciones, hace clic en + Nueva Automatización, completa los campos obligatorios del formulario: Nombre, Label, Repositorio y Descripción. Finaliza haciendo clic en el botón Guardar en la esquina superior derecha.

Editar

Tras crear una automatización, puedes seguir los pasos para editarla:

  • Accede al menú Automatizaciones en el Orquestador BotCity
  • Accede a los detalles haciendo clic en el nombre de la automatización
  • Haz clic en el botón Editar en la esquina superior derecha
  • Modifica los valores de los campos deseados
  • Haz clic en Guardar en la esquina superior derecha

GIF que demuestra cómo editar una automatización. Flujo accediendo al menú Automatizaciones, hace clic en una Automatización existente, navega hasta la pestaña de política de ejecución y deshabilita el timeout. Finaliza haciendo clic en el botón Guardar en la esquina superior derecha.

Exportar

Puedes exportar la información de una automatización de un workspace para usarla en otros.

Para exportar, puedes seguir los pasos:

  • Accede al menú Automatizaciones en el Orquestador BotCity
  • Accede a los detalles haciendo clic en el nombre de la automatización
  • Haz clic en el botón Exportar en la esquina superior derecha
  • La descarga del archivo debería comenzar automáticamente

GIF que demuestra cómo exportar una automatización. Flujo accediendo al menú Automatizaciones, hace clic en una Automatización existente, hace clic en el botón Exportar en la esquina superior derecha.

Importar

Puedes importar la información de una Automatización de un workspace para usarla en otros, sin necesidad de pasar por la etapa de creación.

Para importar, puedes seguir los pasos:

  • Exporta la automatización desde otro workspace
  • Accede al menú Automatizaciones en el Orquestador BotCity
  • Haz clic en el botón + Importar en la esquina superior derecha
  • Selecciona el archivo .json de la automatización
  • Selecciona el repositorio para esta automatización
  • Haz clic en el botón + Importar

Archivo JSON

El archivo .json contiene la información de una automatización para ser importada en otro workspace. Sin embargo, es necesario vincular los Runners y Robots de esta automatización después de la importación.

Ejemplo de archivo 
    {
      "label" : "demo",
      "name" : "Automation Demo",
      "description" : "Automation used as an example.",
      "parameters" : [ {
        "defaultValue" : "value",
        "description" : "Demo Param",
        "label" : "paran",
        "name" : "Param",
        "required" : true,
        "resourceLabel" : null,
        "rules" : { },
        "type" : "TEXT"
      } ],
      "notification" : {
        "monitored_types" : [ "INFO", "WARN", "ERROR" ],
        "users" : [ 9314 ]
      },
      "status" : null,
      "priority" : 0,
      "automationExists" : false
    }

GIF que demuestra cómo importar una automatización. Flujo accediendo al menú Automatizaciones, hace clic en + Importar para abrir una ventana modal con el formulario de importación. En la ventana, selecciona el archivo de importación con extensión ".json", selecciona el repositorio para la automatización y finaliza haciendo clic en "Importar" al final del formulario.

Mover de Repositorio

Las automatizaciones pueden reubicarse en otro repositorio. Para ello, sigue los pasos:

  • Accede al menú Automatizaciones en el Orquestador BotCity
  • Encuentra la automatización que deseas mover
  • Haz clic en el menú de opciones de esa automatización
  • Selecciona Mover a repositorio
  • Selecciona el nuevo repositorio
  • Haz clic en Confirmar

Atención

Esta acción también moverá los robots, agendamientos y otros recursos que están vinculados a esta automatización.

GIF que demuestra cómo mover una automatización de repositorio. Flujo accediendo al menú Automatizaciones, hace clic en el menú de acciones de una automatización para abrir las opciones, selecciona "Mover a repositorio" para abrir una ventana modal. En la ventana, selecciona el nuevo repositorio para esta automatización y hace clic en Confirmar.

Búsqueda y filtros

Es posible combinar varios filtros para realizar búsquedas en el menú Automatizaciones, según tus necesidades.

Búsqueda por:

  • Automatización: Búsqueda por el nombre o label de la Automatización.

Filtros disponibles:

  • Label: Selecciona uno o más labels.
  • Nombre: Selecciona uno o más nombres.
  • Repositorio: Selecciona un repositorio específico.

Ordenación:

  • Alfabéticamente
  • Más reciente primero
  • Más antiguo primero

GIF del Orquestador de BotCity, en el menú Automatizaciones, presentando los filtros para búsqueda de automatizaciones. Muestra los tres campos principales disponibles para filtro: Búsqueda por automatización, Filtro, Ordenación.