- Alcance técnico y concepto
- Instalación — instalar, actualizar y desinstalar
- Configuración — referencia de parámetros de conexión
- Acciones — las 51 acciones, agrupadas por categoría
- Actualización y migración
- Notas de la versión
- Preguntas frecuentes
Concepto y alcance técnico
El Automation CLI Action Pack es un conjunto de herramientas específico para gestionar y supervisar sistemas Broadcom Automic Automation desde la línea de comandos. Reúne 51 acciones listas para usar que cubren operaciones con objetos, estructuras de carpetas, control de tareas, planificación, análisis del sistema y transportes. El Automation CLI Action Pack funciona tanto de forma interactiva como en modo por lotes, por lo que resulta igualmente adecuado para las tareas de administración diarias y para rutinas de automatización desatendidas.
Qué es un Action Pack
Los Action Packs son módulos de integración predefinidos que se utilizan en plataformas de automatización como Automic Automation. Simplifican la integración y automatización de aplicaciones y servicios de terceros al proporcionar una colección de acciones reutilizables. El Automation CLI Action Pack sigue el mismo modelo: cada operación común de línea de comandos contra Automic se encapsula como una acción configurable y reutilizable que se puede integrar en cualquier flujo de trabajo.
Componentes y funciones principales
El Automation CLI Action Pack cubre tres áreas funcionales:
Objetos
- Crear, eliminar, modificar masivamente
- Importación y exportación entre entornos
- Combinar (fusionar calendarios, horarios, grupos de agentes)
- Convertir y transformar mediante scripts de cambio
- Leer y crear estructuras de carpetas
- Ejecutar objetos de forma masiva
Tareas
- Monitorizar tareas en ejecución e históricas
- Modificar estado, desactivar, cambiar códigos de estado
- Analizar a través del historial de tareas y mensajes.
- Leer, alternar y eliminar tareas, incluidas las tareas periódicas
Sistema
- Analizar estado y configuración del sistema
- Determinar referencias, dependencias y uso de objetos
- Gestionar transportes y limpiar los Transport Cases
- Leer y establecer autorizaciones de agentes
Acceso y permisos
Para usar el Automation CLI Action Pack, se requiere el siguiente acceso:
- Un usuario Automic con derechos amplios, suficientes para ejecutar las acciones relevantes en el cliente destino del sistema. Las acciones que tocan objetos a nivel de sistema (por ejemplo, acciones de transporte o análisis a nivel de inquilino) requieren los correspondientes derechos ampliados.
- Una clave de licencia válida para el Automation CLI Action Pack, proporcionada por Tricise. Las claves de prueba con tiempo limitado están disponibles bajo petición.
Requisitos y compatibilidad
Automic Automation
- Versión mínima: Automic Automation V24
- Punto final JCP accesible (host y puerto) para el cliente de destino
- Certificado de confianza para comunicación TLS
Entorno de ejecución de Java (JRE)
- Versión mínima: Java 11 (JRE o JDK)
- Disponible en el agente que ejecutará las acciones del Automation CLI Action Pack
- Disponible a través de la variable de entorno PATH o bien como una ruta completa (por ejemplo C:\Program Files\Java\jdk-17\bin)
ITPA Shared Action Pack
- El Automation CLI Action Pack depende del PCK.ITPA_SHARED Action Pack y debe instalarse primero si aún no está presente
Instalación
El Automation CLI Action Pack se instala mediante el mecanismo estándar de Action Packs de Automic. Se puede instalar en cualquier cliente del sistema Automic Automation excepto en el cliente 0. El mismo procedimiento se utiliza tanto para la instalación inicial como para las actualizaciones a una versión más reciente.
Instalar o actualizar
Desinstalar
Para eliminar el Automation CLI Action Pack de un cliente, siga estos pasos:
Referencia de configuración
Tras la instalación, el Automation CLI Action Pack requiere una configuración de conexión a un sistema Automic existente y uno de sus clientes. La configuración se crea ejecutando la acción CONFIGURATION_ADD desde la AWI. Se pueden crear múltiples configuraciones en paralelo, una por combinación de sistema Automic / cliente.
Proceso de configuración
Proporcione los detalles de conexión (ver la referencia de parámetros a continuación). Se recomienda la convención de nombres SYSTEMNAME_CLIENT (por ejemplo, AUTOMIC_0100).
Use CONFIGURATION_UPDATE para cambiar una configuración existente, y CONFIGURATION_REMOVE para eliminar una. Las nuevas configuraciones siempre se pueden agregar ejecutando CONFIGURATION_ADD nuevamente.
Parámetros de conexión
Parámetros requeridos de la acción CONFIGURATION_ADD / UPDATE:
| Parámetro | Descripción |
|---|---|
| Nombre de configuración | Nombre de texto libre para la conexión. Sintaxis recomendada: SYSTEMNAME_CLIENT, por ejemplo, AUTOMIC_0100. |
| Ejecutable de Java | Instalación de Java (JRE o JDK) utilizada por el agente en ejecución. Si Java está en el PATH, basta con java; de lo contrario, proporcione la ruta completa (por ejemplo, C:\Program Files\Java\jdk-17\bin). Versión mínima: Java 11. |
| Host | Nombre de host o FQDN del sistema Automic que ejecuta los JCP (por ejemplo, myserver.com). |
| Puerto | Puerto del JCP en el sistema Automic (por ejemplo 8443). |
| Cliente | Cliente de destino del sistema Automic (por ejemplo 0100). |
| Nombre de usuario | Nombre de usuario de Automic (por ejemplo UC). |
| Departamento | Departamento del usuario Automic (por ejemplo, UC). |
| Contraseña | Contraseña del usuario de Automic. CONFIGURATION_ADD y CONFIGURATION_UPDATE la cifran automáticamente; al actualizar una configuración, vuelva a introducir la contraseña. |
| Beneficios | Clave de licencia para el Automation CLI Action Pack, proporcionada por Tricise. Las claves de prueba por tiempo limitado están disponibles bajo petición. |
Parámetros opcionales
| Parámetro | Descripción |
|---|---|
| Registro | Patrón de ruta para los archivos de registro, por ejemplo ./log/AUT_CLI_log_##.txt. |
| Conteo de registros | Número máximo de archivos de registro para la rotación de registros. |
| Rastreo | Patrón de ruta para archivos de rastreo, por ejemplo ./log/AUT_CLI_trc_##.txt. |
| Conteo de rastreo | Número máximo de archivos de rastreo para la rotación de rastreo. |
| Lista de CP | Lista de procesos de comunicación alternativos además de Host/Puerto (por ejemplo, myserver.com:8444). |
| LogToStdOut | Imprimir la salida del registro en la línea de comandos. Establezca en 1 para habilitar. |
| Depurar | Activa el modo de depuración. Establézcalo en 1 para activarlo. Con el modo de depuración desactivado (0), la configuración no se escribe en el informe del job. |
| TrustedCertFolder | Carpeta que contiene los certificados de confianza del agente de ejecución (por ejemplo, C:\temp\myCerts). |
Referencia de acciones
El Automation CLI Action Pack incluye 51 acciones, agrupadas aquí por categoría funcional. Cada acción tiene un nombre de objeto de Automic completo que sigue el patrón PCK.TRICISE_AUT_CLI.PUB.ACTION.<NAME>. Todas las acciones pueden ejecutarse de forma interactiva desde la AWI o de forma desatendida en modo por lotes como parte de un workflow.
Gestión de configuración
Gestionar las configuraciones de conexión del propio Automation CLI Action Pack.
| Acción | Nombre del objeto | Descripción |
|---|---|---|
| Configuration Add / Update | CONFIGURACIÓN_AÑADIR CONFIGURACIÓN_ACTUALIZAR | Crear o actualizar una configuración de conexión con un sistema y un cliente de Automic concretos. La contraseña se cifra automáticamente. |
| Configuration Remove | CONFIGURATION_REMOVE | Eliminar una configuración de conexión existente. |
| Encrypt | ENCRYPT | Cifra las contraseñas con la misma técnica que los campos enmascarados de los PromptSets de Automic, para almacenarlas de forma segura en la configuración. |
| Generic Command | GENERICCOMMAND | Ejecuta cualquier módulo del Automation CLI Action Pack directamente a través de la sintaxis de la línea de comandos. Útil para usuarios avanzados que ya conocen los parámetros y quieren omitir la interfaz de usuario de PromptSet. |
Operaciones de objetos
Crear, modificar, eliminar, mover, ejecutar y analizar objetos y estructuras de carpetas de Automic desde la línea de comandos.
| Acción | Nombre del objeto | Descripción |
|---|---|---|
| Agentgroups Create | AGENTGROUPSCREATE | Crear en masa objetos de grupos de agentes a partir de un archivo de entrada estructurado. |
| Agentgroups Read | AGENTGROUPSREAD | Exporta la definición de los grupos de agentes existentes a un archivo de salida estructurado (compatible con Agentgroups Create). |
| Estructura de carpetas Crear | FOLDERSTRUCTURECREATE | Crear una estructura de carpetas a partir de un archivo de entrada estructurado, por ejemplo para preparar un cliente nuevo. |
| Estructura de carpetas Lectura | FOLDERSTRUCTUREREAD | Exportar la estructura de carpetas de un cliente a un archivo de salida estructurado (compatible con Folder Structure Create). |
| Logins Create | LOGINSCREATE | Creación masiva de objetos de inicio de sesión a partir de un archivo de entrada estructurado. Las contraseñas existentes se borrarán al reemplazarlas. |
| Logins Read | LOGINSREAD | Exporta la definición de objetos de inicio de sesión existentes a un archivo de salida estructurado (compatible con Logins Create). |
| Objects Add Filter | OBJECTSADDFILTER | Anexar objetos de filtro a objetos existentes basándose en un archivo de entrada estructurado. Los nuevos filtros se anexan al final de la lista de filtros. |
| Objects Add Script | OBJECTSADDSCRIPT | Agregar o insertar contenido de scripts en objetos existentes, basándose en un archivo de script y objetos de destino. |
| Objects Add Value | OBJECTSADDVALUE | Añadir valores a objetos de variable (VARA) desde un archivo de entrada. |
| Objects Delete | OBJECTSDELETE | Eliminar objetos basándose en una fuente de entrada estructurada (archivo, carpeta, objeto único o lista VARA), con filtros de inclusión / exclusión. |
| Objects Execute | OBJECTSEXECUTE | Ejecutar objetos de forma masiva, por ejemplo una lista de jobs o workflows en una sola ejecución. |
| Objects Link Delete | OBJECTSLINKDELETE | Eliminar vínculos / referencias de objetos entre objetos. |
| Objects Move | OBJECTSMOVE | Mueve objetos entre carpetas Automic, con selección de fuente de entrada y filtros. |
| Objects Relations | OBJECTSRELATIONS | Determinar y exportar las relaciones / dependencias de los objetos. |
| Objects Remove Filter | OBJECTSREMOVEFILTER | Eliminar objetos de filtro de objetos existentes basándose en un archivo de entrada estructurado. |
| Objects Remove Script | OBJECTSREMOVESCRIPT | Eliminar contenido de script de objetos existentes. |
| Objects Remove Value | OBJECTSREMOVEVALUE | Eliminar valores de objetos de variable (VARA) basándose en un archivo de entrada. |
| Objects Replace | OBJECTSREPLACE | Reemplace el contenido de las cadenas dentro de los objetos existentes según las reglas de búsqueda y reemplazo. |
| Objects Replace Attribute | OBJECTSREPLACEATTRIBUTE | Reemplace valores de atributos específicos en múltiples objetos en un solo lote. |
| Objects Usage | OBJECTSUSAGE | Analizar el cliente a nivel de objeto: estado de uso y recuentos de estadísticas. El resultado se escribe en un archivo (desde la versión 6.9.0; las versiones anteriores usaban un objeto VARA). Punto de partida ideal para campañas de limpieza. |
Importar, exportar y transportar
Mueve objetos entre entornos, transforma exportaciones y gestiona los Transport Cases de Automic.
| Acción | Nombre del objeto | Descripción |
|---|---|---|
| Objects Export | OBJECTSEXPORT | Exportar objetos del sistema Automic a una carpeta de destino. La fuente puede ser FILE, FOLDER, OBJECT o VARA, con filtros de inclusión/exclusión, opción recursiva, filtro de fecha de modificación y recuento de hilos configurable (se recomiendan de 10 a 20 hilos). |
| Objects Import | OBJECTSIMPORT | Importa objetos desde una estructura de carpetas previamente exportada. Soporta importación recursiva, reemplazo en caso de conflicto, filtros de exclusión y número de hilos configurable. |
| Export Change | EXPORTCHANGE | Modifica objetos XML exportados utilizando la misma sintaxis de archivo de script que la utilidad Automic Change. Útil para reescrituras específicas del entorno antes de volver a importar. |
| Objects Transport | OBJECTSTRANSPORT | Establecer el indicador de transporte en objetos de forma masiva, basándose en la entrada FILE / FOLDER / OBJECT / VARA con filtros de inclusión y exclusión. |
| Transport Clear | TRANSPORTCLEAR | Vacía el Transport Case del cliente referenciado por la conexión activa. No requiere parámetros. |
Calendarios y horarios
Fusionar y restablecer objetos de calendario y horario.
| Acción | Nombre del objeto | Descripción |
|---|---|---|
| Calendar Merge | CALENDARMERGE | Fusionar dos objetos de calendario en un nuevo tercer objeto de calendario, con reemplazo opcional. |
| Schedule Merge | SCHEDULEMERGE | Fusionar dos objetos de horario en un nuevo tercer objeto de horario, con reemplazo opcional. |
| Schedule Reset | SCHEDULERESET | Restablecer las entradas de objetos de horario activos dentro de una ventana de tiempo. Particularmente útil durante ventanas de mantenimiento prolongadas cuando las tareas individuales deben repetirse después de que el sistema vuelva a estar en funcionamiento. Use -ALL- para restablecer todos los horarios. |
Control de tareas
Leer, supervisar, modificar, alternar, desactivar y eliminar tareas (incluidas las tareas periódicas) desde la línea de comandos.
| Acción | Nombre del objeto | Descripción |
|---|---|---|
| Tasks Monitoring | TASKSMONITORING | Liste las tareas en el sistema Automic filtradas por nombre, tipo, código de estado o número de ejecución superior. Adecuado para supervisión y paneles de control guiados por scripts. |
| Tasks Modify State | TASKSMODIFYSTATE | Cambie el código de estado de las tareas (cualquier estado Automic válido, por ejemplo 1900 = ENDED_OK) con desactivación automática opcional después del cambio. |
| Tasks Deactivate | TASKSDEACTIVATE | Desactivar tareas masivamente, filtradas por nombre, tipo, agente o cola. |
| Tasks Read | TASKSREAD | Leer tareas con los filtros unificados TASKS*, por ejemplo para comprobar qué selecciona un filtro antes de ejecutar otra acción sobre tareas. |
| Tasks Toggle | TASKSTOGGLE | Alternar de forma masiva el estado de las tareas seleccionadas con los filtros unificados TASKS*. |
| Tareas Eliminar | TASKSREMOVE | Eliminar de forma masiva las tareas seleccionadas con los filtros unificados TASKS*. |
| Tasks Periodic Read | TASKSPERIODICREAD | Leer las tareas periódicas del cliente. |
| Tasks Periodic Execute | TASKSPERIODICEXECUTE | Iniciar tareas periódicas de forma masiva, por ejemplo a partir de una lista creada con Tasks Periodic Read. |
Edición de flujo de trabajo
Modificación programática de workflows: añadir, eliminar, cerrar y ajustar tareas dentro de los workflows.
| Acción | Nombre del objeto | Descripción |
|---|---|---|
| Workflow Add Task | WORKFLOWADDTASK | Agregar una tarea a un flujo de trabajo existente, con configuración de posicionamiento y dependencia. |
| Flujo de trabajo Eliminar tarea | WORKFLOWREMOVETASK | Eliminar una tarea de un workflow existente. |
| Workflow Close Tasks | WORKFLOWCLOSETASKS | Cerrar tareas dentro de flujos de trabajo en bloque. |
| Workflow Task Active | WORKFLOWTASKACTIVE | Establecer el indicador Active de las tareas del flujo de trabajo. |
| Workflow Task Earliest | WORKFLOWTASKEARLIEST | Establecer la hora de inicio más temprana en las tareas del flujo de trabajo. |
Sistema y seguridad
Estado del sistema, información, historial de mensajes, comprobación de autorizaciones de usuario y autorizaciones de agentes.
| Acción | Nombre del objeto | Descripción |
|---|---|---|
| Agent Authorizations Read | AGENTAUTHORIZATIONSREAD | Leer las autorizaciones de cliente de los objetos de agente. |
| Agent Authorizations Set | AGENTAUTHORIZATIONSSET | Establecer de forma masiva las autorizaciones de cliente de los objetos de agente. |
| SystemInfo | SYSTEMINFO | Prueba la conexión con el sistema configurado y muestra información básica del sistema. Se recomienda como comprobación de conectividad antes de ejecutar otras acciones. No requiere parámetros. |
| System Status | SYSTEMSTATUS | Establece el estado del cliente en GO o STOP: útil para ventanas de mantenimiento controladas. |
| Message History | MESSAGEHISTORY | Leer mensajes del sistema con filtros por usuario, indicador de administrador/seguridad, tipo de mensaje (ALL / ERROR / INFORMATION / FAILED / SUCCESS / WARNING), categoría, rango de fechas y resultados máximos. La salida se muestra en el informe del trabajo. |
| User Authorizations Check | USERAUTHORIZATIONSCHECK | Comprueba si algún usuario del cliente tiene derechos SUPERUSER. No requiere parámetros. Útil para auditorías de seguridad periódicas. |
Actualización y migración
Automation CLI Action Pack : las actualizaciones utilizan exactamente el mismo procedimiento que la instalación inicial: Administration → Packs → Install From File, seleccione el nuevo ZIP y confirme con Instalar. El mecanismo de Action Packs de Automic gestiona automáticamente el reemplazo de versiones.
Antes de actualizar
- Asegúrese de que el PCK.ITPA_SHARED Action Pack del que depende esté en una versión compatible con la nueva versión del Automation CLI Action Pack
- Haga una instantánea o copia de seguridad de la instalación actual si su entorno requiere pistas de auditoría
- Pause los flujos de trabajo programados que utilicen acciones del Automation CLI Action Pack, para evitar cambios de versión a mitad de ejecución
Después de actualizar
- Las configuraciones de conexión existentes siguen siendo válidas. Excepción: si actualiza desde una versión anterior a la 4.0.0, vuelva a introducir las contraseñas con CONFIGURATION_UPDATE, ya que el método de cifrado ha cambiado.
- Ejecute la acción SYSTEMINFO en cada conexión configurada como prueba de humo (smoke test)
- Reanude los flujos de trabajo pausados
Notas específicas de cada versión
- Versión 6.9.0: OBJECTSUSAGE escribe su resultado en un archivo en lugar de en un objeto VARA. Adapte los pasos posteriores que leen el objeto VARA.
- Versión 5.0.0: se cambió el nombre de varias acciones. Las acciones *TOFILE y *FROMFILE perdieron su sufijo, ANALYSEUSAGE pasó a ser OBJECTSUSAGE, READHOSTGROUPTOFILE y CREATEHOSTGROUPFROMFILE pasaron a ser AGENTGROUPSREAD y AGENTGROUPSCREATE, READLOGINTOFILE y CREATELOGINFROMFILE pasaron a ser LOGINSREAD y LOGINSCREATE, y MERGESCHEDULE y RESETSCHEDULE pasaron a ser SCHEDULEMERGE y SCHEDULERESET. Se eliminaron OBJECTSCREATE y OBJECTSRENAME. Los workflows que llaman a los nombres antiguos deben adaptarse.
- Versión 5.0.0: el parámetro MODE de AGENTGROUPSREAD y AGENTGROUPSCREATE admite ANY, LOAD, ALL, NEXT o FIRST en lugar de letras sueltas.
- Versión 3.7.2: el Action Pack pasó a llamarse PCK.TRICISE_AUT_CLI; los nombres de objeto de las instalaciones anteriores cambian en consecuencia.
Notas de la versión
Todas las versiones del Automation CLI Action Pack y los cambios de cada una. Las versiones anteriores a la 3.0.0 se publicaron con el nombre AEAPI.
v7.1.1 (actual) · 2026-10-06
| Versión | Tipo | Cambio |
|---|---|---|
| 7.1.1 2026-10-06 | Corregido | Workflow Add Task: corregido el desplazamiento de columnas |
| Modificado | Módulos de grupos de usuarios: se eliminan los campos obsoletos |
Versiones anteriores
Versiones 6.0.0 – 7.1.0 (2025–2026)
| Versión | Tipo | Cambio |
|---|---|---|
| 7.1.0 2026-05-20 | Corregido | Corrección de errores y refactorización del código base |
| 7.0.0 2025-12-04 | Modificado | Gestión de licencias ajustada; se requiere una clave de licencia válida |
| 6.9.0 2025-12-04 | Modificado | OBJECTSUSAGE escribe su salida en un archivo en lugar de en un objeto VARA |
| 6.8.0 2025-11-19 | Nuevo | Acción TASKSTOGGLE |
| 6.7.0 2025-11-19 | Modificado | Filtros unificados para todas las acciones TASKS* |
| 6.6.0 2025-11-15 | Nuevo | Acción TASKSREAD |
| 6.5.0 2025-11-14 | Nuevo | Acción OBJECTSEXECUTE |
| 6.4.0 2025-11-13 | Nuevo | Acciones TASKSPERIODICREAD y TASKSPERIODICEXECUTE |
| 6.3.0 2025-10-29 | Nuevo | Acciones AGENTAUTHORIZATIONSREAD y AGENTAUTHORIZATIONSSET |
| Corregido | La configuración ya no se muestra en el informe del job cuando el modo de depuración está desactivado | |
| 6.2.0 2025-10-13 | Modificado | Gestión de licencias ajustada |
| 6.1.0 2025-06-13 | Nuevo | Acciones FOLDERSTRUCTUREREAD y FOLDERSTRUCTURECREATE |
| 6.0.1 2025-06-12 | Corregido | OBJECTSMOVE: error en el método de procesamiento |
| Corregido | OBJECTSLINKDELETE: nombre de include incorrecto | |
| 6.0.0 2025-02-11 | Modificado | CONFIGURATION_ADD, CONFIGURATION_REMOVE y CONFIGURATION_UPDATE: «connection» pasa a llamarse «configuration» |
Versiones 4.0.0 – 5.1.2 (2024–2025)
| Versión | Tipo | Cambio |
|---|---|---|
| 5.1.2 2025-01-10 | Modificado | La comprobación de validez admite nombres de Automic SaaS ($@@$) |
| 5.1.1 2024-11-11 | Corregido | EXPORTCHANGE puede modificar atributos de tareas JSCH |
| 5.1.0 2024-11-11 | Nuevo | Acciones WORKFLOWREMOVETASK y TASKSREMOVE |
| 5.0.0 2024-11-07 | Modificado | Limpieza y cambio de nombre parcial de las acciones |
| Eliminado | Acciones OBJECTSCREATE y OBJECTSRENAME | |
| Modificado | Acciones *TOFILE y *FROMFILE renombradas sin el sufijo | |
| Modificado | ANALYSEUSAGE pasa a llamarse OBJECTSUSAGE | |
| Modificado | READHOSTGROUPTOFILE y CREATEHOSTGROUPFROMFILE pasan a llamarse AGENTGROUPSREAD y AGENTGROUPSCREATE | |
| Modificado | READLOGINTOFILE y CREATELOGINFROMFILE pasan a llamarse LOGINSREAD y LOGINSCREATE | |
| Modificado | MERGESCHEDULE y RESETSCHEDULE pasan a llamarse SCHEDULEMERGE y SCHEDULERESET | |
| Modificado | REMOVELINKSFROMFOLDER pasa a llamarse OBJECTSLINKDELETE | |
| Modificado | AGENTGROUPSREAD y AGENTGROUPSCREATE: MODE admite ANY, LOAD, ALL, NEXT o FIRST en lugar de letras sueltas | |
| Modificado | CALENDARMERGE y SCHEDULEMERGE: nuevo parámetro Replace | |
| Corregido | OBJECTSRELATIONS: el modo de transporte vuelve a funcionar | |
| 4.2.1 2024-11-05 | Corregido | CONFIGURATION_UPDATE: se elimina la variable CONFIG_NAME |
| 4.1.0 2024-09-12 | Nuevo | Acción para actualizar una configuración existente (hay que volver a introducir la contraseña) |
| 4.0.0 2024-09-09 | Modificado | ENCRYPT: nuevo método de cifrado, no compatible con el anterior |
| Modificado | Al añadir una configuración, el campo de contraseña se cifra automáticamente |
Versiones 3.0.0 – 3.9.0
| Versión | Tipo | Cambio |
|---|---|---|
| 3.9.0 2024-09-06 | Modificado | Variable JAVACMD: todas las acciones, CONFIGURATION_ADD y ENCRYPT pueden ejecutarse con un ejecutable de Java definido por el usuario |
| 3.8.0 2024-05-24 | Modificado | commons.io eliminado de las bibliotecas; EXPORTCHANGE utiliza en su lugar los valores predeterminados de Java |
| 3.7.2 2024-02-29 | Modificado | El Action Pack pasa a llamarse PCK.TRICISE_AUT_CLI |
| 3.7.1 2023-12-01 | Corregido | EXPORTCHANGE: los títulos con asterisco se procesaban dos veces |
| 3.7.0 2023-09-19 | Modificado | ANALYSEUSAGE: nuevos parámetros de entrada OBJECT, FILE, FOLDER y VARA |
| Nuevo | Acción OBJECTSRENAME (prefijo y sufijo, sin sustitución de referencias) | |
| 3.6.3 2023-06-16 | Modificado | WORKFLOWADDTASK: nuevos parámetros opcionales format, removeredundancies y closetasks |
| 3.6.2 2023-06-16 | Eliminado | Acción MOVEFROMFOLDER, sustituida por OBJECTSMOVE |
| 3.6.1 2023-06-15 | Nuevo | Acción OBJECTSMOVE |
| Corregido | Objects Delete: parámetro deletesource | |
| 3.6.0 2023-06-14 | Nuevo | Acciones WORKFLOWTASKACTIVE, WORKFLOWTASKEARLIEST y GENERICCOMMAND |
| 3.5.3 2023-03-29 | Modificado | Tasks Deactivate utiliza el filtro de la API en lugar de expresiones regulares |
| 3.5.2 2023-02-23 | Corregido | Objects Create puede crear únicamente carpetas |
| 3.5.1 2023-02-21 | Corregido | Los enlaces se añaden a ACTIONS/CUSTOM en lugar de a ACTIONS/CAPTURE, porque una exportación los eliminaba |
| 3.5.0 2023-02-16 | Modificado | Nuevo concepto de compilación con aut_cli.jar y aut_cli_base.jar |
| 3.4.1 2023-02-16 | Modificado | El Action Pack pasa a llamarse PCK.CAPTURE_AUT_CLI |
| 3.4.0 | Nuevo | Acción TASKSMONITORING |
| 3.3.0 | Nuevo | Acciones USERSETTITLE (ya no forma parte del pack) y USERCHECKAUTHORIZATIONS (hoy USERAUTHORIZATIONSCHECK) |
| 3.2.2 | Corregido | Schedule Reset: la hora de inicio debe ser mayor o igual que el inicio de la ventana |
| 3.2.1 | Corregido | Caché del árbol de carpetas: se revierte el cambio en la búsqueda de carpetas |
| 3.2.0 | Modificado | Objects Transport: se eliminan los parámetros includeArchiveKey1, includeArchiveKey2 y excludeName, se añade includeName y el transporte de carpetas es más rápido |
| 3.1.2 | Corregido | Encrypt: se elimina el campo de conexión |
| 3.1.1 | Corregido | Comprobación de licencia |
| 3.1.0 | Nuevo | Acciones CONFIGURATION_ADD (con cifrado automático de la contraseña) y CONFIGURATION_REMOVE |
| Modificado | ENCRYPT publica la variable &AUT_CLI_ENCRYPTED_PASSWORD# | |
| 3.0.2 | Modificado | Las actualizaciones ya no sobrescriben los objetos de configuración |
| 3.0.1 | Modificado | Se elimina @echo off |
| 3.0.0 | Modificado | Pasa a llamarse AUT_CLI (antes AEAPI); las bibliotecas pasan a llamarse aut_cli_base.jar y config.ini |
Versiones 2.1.0 – 2.4.0 (AEAPI)
| Versión | Tipo | Cambio |
|---|---|---|
| 2.4.0 | Modificado | Biblioteca reforzada (ofuscada) y renombrada como AutomicTools.jar |
| 2.3.1 | Modificado | Objects Remove Script: parámetros 4 y 5 opcionales; si no se indican, se elimina todo el script |
| Modificado | Los campos de fecha del PromptSet tienen como valor predeterminado 01/01/2000 | |
| Modificado | Las variables de fecha usan YYYY-MM-DD en lugar de YYMMDD | |
| 2.3.0 | Corregido | Si la licencia no es válida, las acciones terminan con error, como corresponde |
| Modificado | Se eliminan las entradas de clave del archivo de configuración | |
| 2.2.0 | Modificado | Biblioteca depurada |
| Nuevo | Message History | |
| 2.1.1 | Modificado | Objects Create: nuevos campos jobp.queue y jobp.children_queue; script, prescript y postscript con <br> |
| 2.1.0 | Nuevo | Entrada de lista de CP en el archivo de configuración (solo para el inicio de sesión inicial, sin rotación de CP) |
Preguntas frecuentes
Haga clic en cualquier pregunta para ver la respuesta.
¿Qué es el Automation CLI Action Pack y qué hace?
El Automation CLI Action Pack es un conjunto de herramientas específico de Tricise para gestionar y supervisar sistemas Automic Automation desde la línea de comandos. Reúne 51 acciones listas para usar que cubren operaciones con objetos (crear, eliminar, modificar, ejecutar, importar, exportar, reemplazar, transportar), estructuras de carpetas, control de tareas, gestión de objetos Calendar y Schedule, análisis del sistema, edición de workflows y comprobaciones de seguridad. Cada operación rutinaria de línea de comandos sobre Automic está disponible como una acción configurable y reutilizable que puede integrarse en cualquier workflow.
El Automation CLI Action Pack se ejecuta tanto interactivamente desde la AWI como sin supervisión en modo batch, lo que lo hace igualmente adecuado para la administración diaria y las rutinas automatizadas.
¿Qué versiones de Automic son compatibles?
El Automation CLI Action Pack requiere Automic Automation V24 o superior. La conexión utiliza la API Java estándar de Automic sobre un punto final JCP con comunicación segura TLS. Necesita un host y puerto JCP accesibles para el cliente de destino y un certificado de confianza para la conexión TLS.
¿Cuáles son los requisitos técnicos?
El Automation CLI Action Pack se ejecuta como parte de una instalación de Action Pack de Automic, por lo que los requisitos son:
- Automic Automation V24+ con un punto final de JCP accesible
- Java 11 o superior (JRE o JDK) en el agente de ejecución
- El Action Pack requerido PCK.ITPA_SHARED instalado en el mismo cliente
- Un usuario Automic con derechos suficientes para las acciones que pretende realizar
- Una clave de licencia válida de Tricise para el Automation CLI Action Pack
¿Cómo instalo el Automation CLI Action Pack?
Inicie sesión en cualquier cliente de Automic excepto el cliente 0, abra Administration → Packs, instale opcionalmente PCK.ITPA_SHARED primero y, a continuación, haga clic en Install From File y seleccione el ZIP del Automation CLI Action Pack entregado por Tricise. El instalador es el mismo para instalaciones nuevas y actualizaciones: basta con indicarle el nuevo ZIP. Tras la instalación, el Action Pack se encuentra dentro de la carpeta PACKAGES . No le cambie el nombre ni lo mueva.
¿Cómo se configura la conexión a Automic?
Ejecute la acción CONFIGURATION_ADD desde la carpeta del Automation CLI Action Pack instalado y rellene los campos obligatorios: nombre de la configuración (patrón recomendado: SYSTEMNAME_CLIENT), ruta del ejecutable de Java, host, puerto, cliente, nombre de usuario, departamento, contraseña y la clave de licencia de Tricise. Se pueden crear configuraciones de conexión múltiples en paralelo — una por combinación de sistema / cliente Automic. Utilice CONFIGURATION_UPDATE para modificar una y CONFIGURATION_REMOVE para eliminar una.
¿Cómo se almacenan las contraseñas en la configuración?
Las contraseñas introducidas en CONFIGURATION_ADD o CONFIGURATION_UPDATE se cifran automáticamente antes de guardarse en la configuración. Desde la versión 4.0.0, el Automation CLI Action Pack utiliza un método de cifrado que no es compatible con versiones anteriores; tras actualizar desde una versión más antigua, vuelva a introducir las contraseñas con CONFIGURATION_UPDATE. La acción específica ENCRYPT sigue disponible para cifrar valores por su cuenta.
¿Cómo muevo objetos entre entornos?
Utilice la OBJECTSEXPORT para exportar objetos desde el entorno de origen, y OBJECTSIMPORT en el entorno de destino para importarlos. Ambas acciones admiten la entrada por FILE, FOLDER, OBJECT o lista VARA, con filtros de inclusión/exclusión, soporte de carpetas recursivas, filtrado por fecha de modificación y recuentos de hilos configurables (se recomiendan entre 10 y 20 hilos para un rendimiento óptimo, pero vigile la carga en el sistema Automic de origen).
Si necesita reescribir valores durante la migración (cambio de nombre de host, rutas específicas del entorno), use EXPORTCHANGE en los archivos XML exportados antes de importarlos; utiliza la misma sintaxis de archivo de script que la utilidad Automic Change.
¿Puede el Automation CLI Action Pack ejecutarse de forma desatendida en modo por lotes?
Sí. Cada acción del Automation CLI Action Pack puede ejecutarse tanto interactivamente desde AWI como de forma desatendida como parte de un flujo de trabajo. Para uso por lotes, los valores de los parámetros normalmente se proporcionan a través del PromptSet de la acción, a través de variables del flujo de trabajo o, si ya conoce la sintaxis del módulo subyacente, directamente mediante la acción GENERICCOMMAND , que permite pasar una línea de comandos sin procesar.
¿Cómo limpio objetos no utilizados u obsoletos de forma segura?
El procedimiento recomendado consta de dos pasos. Primero, ejecute OBJECTSUSAGE sobre la carpeta o la lista de objetos de destino: analiza el estado de uso y los recuentos de estadísticas de cada objeto y escribe el resultado en un archivo (desde la versión 6.9.0; las versiones anteriores lo escribían en un objeto Variable). Revise el resultado para confirmar qué objetos se pueden eliminar realmente sin riesgo. A continuación, pase la lista confirmada a OBJECTSDELETE, que acepta un archivo como origen de entrada, para eliminar los objetos en un lote controlado y repetible.
¿Cómo realizo cambios masivos durante la exportación?
Utilice la EXPORTCHANGE del Automation CLI Action Pack. Modifica objetos XML exportados usando la misma sintaxis de archivo de script que la utilidad Automic Change: indíquele la carpeta de exportación y a un archivo de cambio con sus reglas, y opcionalmente habilite el procesamiento recursivo para subcarpetas. Perfecto para renombrar hosts, reescribir rutas y otras transformaciones específicas del entorno entre DEV, TEST y PROD.
¿Cómo desactivo o modifico estados de tareas en bloque?
Utilice TASKSDEACTIVATE para desactivación masiva, filtrada por nombre de tarea, tipo, agente o cola. Para cambiar los códigos de estado de las tareas (por ejemplo, para forzar una tarea a 1900 = ENDED_OK), use TASKSMODIFYSTATE — acepta cualquier código de estado Automic válido y ofrece una desactivación automática opcional después del cambio de estado. Para listar y supervisar sin modificar, use TASKSMONITORING.
Para eliminar tareas, utilice TASKSREMOVE; para cambiar su estado de forma masiva, utilice TASKSTOGGLE. Desde la versión 6.7.0, todas las acciones TASKS* comparten las mismas opciones de filtro.
¿Cómo compruebo si algún usuario de un cliente tiene derechos SUPERUSER?
Ejecute la acción USERAUTHORIZATIONSCHECK del Automation CLI Action Pack. Analiza todos los usuarios del cliente configurado y muestra los que tienen derechos SUPERUSER. La acción no requiere parámetros y es ideal como auditoría de seguridad programada.
¿Puedo leer mensajes del sistema con filtros?
Sí. La acción MESSAGEHISTORY lee los mensajes del sistema con amplias opciones de filtro: nombre de usuario, indicadores de mensajes de administración / seguridad, tipo de mensaje (ALL, ERROR, INFORMATION, FAILED, SUCCESS, WARNING), categoría (ALL, ACCESS TO HOST, LOGIN, MESSAGE, OBJECT_ACCESS, PRIVILEGE), fecha desde / hasta (formato YYYY-MM-DD) y un límite máximo de resultados. Los mensajes encontrados se muestran en el informe del job de Windows o Unix de Automic que ejecuta la acción.
¿Cómo se licencia el Automation CLI Action Pack?
El Automation CLI Action Pack se licencia como compra única por sistema Automic — sin suscripción recurrente, sin caducidad. El precio fijo se publica en la tienda Tricise. La licencia incluye soporte de producto de Tricise y actualizaciones de compatibilidad para la línea de versiones actual Automic V24+. Las claves de licencia de evaluación por tiempo limitado están disponibles bajo pedido para trabajos de prueba de concepto.