- Ambito tecnico e concetto
- Installazione — installa, aggiorna e disinstalla
- Configurazione — riferimento parametri di connessione
- Azioni — tutte le 51 azioni, raggruppate per categoria
- Aggiornamento e migrazione
- Note di rilascio
- FAQ
Concetto e ambito tecnico
L'Automation CLI Action Pack è un toolkit dedicato alla gestione e al monitoraggio dei sistemi Broadcom Automic Automation dalla riga di comando. Raccoglie 51 azioni pronte all'uso per operazioni sugli oggetti, strutture di cartelle, controllo dei task, pianificazione, analisi del sistema e trasporti. L'Automation CLI Action Pack funziona sia in modalità interattiva sia in modalità batch ed è quindi adatto sia alle attività di amministrazione quotidiane sia alle routine di automazione non presidiate.
Cos'è un Action Pack
Gli Action Pack sono moduli di integrazione predefiniti utilizzati nelle piattaforme di automazione, come Automic Automation. Semplificano l'integrazione e l'automazione di applicazioni e servizi di terze parti fornendo una raccolta di azioni riutilizzabili. L'Automation CLI Action Pack segue lo stesso modello: ogni operazione da riga di comando di routine su Automic è racchiusa come un'azione configurabile e riutilizzabile che può essere integrata in qualsiasi workflow.
Componenti principali e funzioni
L'Automation CLI Action Pack copre tre aree funzionali:
Oggetti
- Crea, elimina, modifica in massa
- Importa ed esporta tra ambienti
- Combinare (unire calendari, pianificazioni, gruppi di agenti)
- Converti e trasforma tramite script di modifica
- Leggere e creare strutture di cartelle
- Eseguire oggetti in blocco
Task
- Monitorare attività in esecuzione e storiche
- Modifica stato, disattiva, cambia codici di stato
- Analisi tramite cronologia dei task e dei messaggi
- Leggere, commutare e rimuovere task, compresi i task periodici
Sistema
- Analizzare stato e configurazione del sistema
- Determinare riferimenti, dipendenze e utilizzo degli oggetti
- Gestisci trasporti e svuota i casi di trasporto
- Leggere e impostare le autorizzazioni degli agenti
Accesso e autorizzazioni
Per utilizzare l'Automation CLI Action Pack, è richiesto il seguente accesso:
- Un utente Automic con ampi diritti, sufficienti per eseguire le azioni pertinenti nel client di destinazione del sistema. Le azioni che riguardano oggetti a livello di sistema (ad esempio azioni di trasporto o analisi a livello di tenant) richiedono diritti elevati di conseguenza.
- Una chiave di licenza valida per Automation CLI Action Pack, fornita da Tricise. Chiavi di prova a tempo limitato sono disponibili su richiesta.
Requisiti e compatibilità
Automic Automation
- Versione minima: Automic Automation V24
- Endpoint JCP raggiungibile (host e porta) per il client di destinazione
- Certificato attendibile per la comunicazione TLS
Ambiente di esecuzione Java (JRE)
- Versione minima: Java 11 (JRE o JDK)
- Disponibile sull'agente che eseguirà le azioni dell'Automation CLI Action Pack
- O tramite la variabile d'ambiente PATH o come percorso completo (ad esempio C:\Program Files\Java\jdk-17\bin)
ITPA Shared Action Pack
- L'Automation CLI Action Pack dipende da PCK.ITPA_SHARED Action Pack e dovrebbe essere installato per primo, se non è già presente
Installazione
L'Automation CLI Action Pack viene installato tramite il meccanismo standard degli Action Pack di Automic. Può essere installato in qualsiasi client del sistema Automic Automation eccetto il client 0. La stessa procedura viene utilizzata sia per l'installazione iniziale sia per gli aggiornamenti a una versione più recente.
Installa o aggiorna
Disinstalla
Per rimuovere l'Automation CLI Action Pack da un client, segui questi passaggi:
Riferimento alla configurazione
Dopo l'installazione, l'Automation CLI Action Pack richiede una configurazione di connessione a un sistema Automic esistente e a uno dei suoi client. La configurazione viene creata eseguendo l'azione CONFIGURATION_ADD da AWI. È possibile creare più configurazioni in parallelo, una per combinazione di sistema / client Automic.
Procedura di configurazione
Fornire i dettagli della connessione (vedere il riferimento dei parametri qui sotto). La convenzione di denominazione NOME_SISTEMA_CLIENT è raccomandata (ad esempio AUTOMIC_0100).
Utilizza CONFIGURATION_UPDATE per modificare una configurazione esistente e CONFIGURATION_REMOVE per eliminarne una. Le nuove configurazioni possono essere sempre aggiunte eseguendo nuovamente CONFIGURATION_ADD.
Parametri di connessione
Parametri richiesti dell'azione CONFIGURATION_ADD / UPDATE:
| Parametro | Descrizione |
|---|---|
| Configuration Name | Nome di testo libero per la connessione. Sintassi consigliata: NOME_SISTEMA_CLIENT, ad esempio AUTOMIC_0100. |
| Java Executable | Installazione Java (JRE o JDK) utilizzata dall'agente in esecuzione. java è sufficiente se Java è sul PATH; altrimenti fornire il percorso completo (ad esempio C:\Program Files\Java\jdk-17\bin). Versione minima: Java 11. |
| Host | Nome host o FQDN del sistema Automic con JCP in esecuzione (ad esempio myserver.com). |
| Port | Porta del JCP sul sistema Automic (ad esempio 8443). |
| Client | Client di destinazione del sistema Automic (ad esempio 0100). |
| User Name | Nome utente Automic (ad esempio UC). |
| Dipartimento | Dipartimento dell'utente Automic (ad esempio UC). |
| Password | Password dell'utente Automic. CONFIGURATION_ADD e CONFIGURATION_UPDATE la cifrano automaticamente; quando aggiorni una configurazione, inserisci di nuovo la password. |
| Chiave | Chiave di licenza per l'Automation CLI Action Pack, fornita da Tricise. Le chiavi di test a tempo limitato sono disponibili su richiesta. |
Parametri opzionali
| Parametro | Descrizione |
|---|---|
| Logging | Modello di percorso per i file di log, ad esempio ./log/AUT_CLI_log_##.txt. |
| Log Count | Numero massimo di file di log per la rotazione dei log. |
| Tracing | Modello di percorso per i file di traccia, ad esempio ./log/AUT_CLI_trc_##.txt. |
| Trace Count | Numero massimo di file di traccia per la rotazione della traccia. |
| CP List | Elenco di processi di comunicazione alternativi oltre a Host/Port (ad esempio myserver.com:8444). |
| LogToStdOut | Stampa l'output del log sulla riga di comando. Imposta a 1 per abilitare. |
| Debug | Attiva la modalità di debug. Imposta 1 per attivarla. Con la modalità di debug disattivata (0), la configurazione non viene scritta nel report del job. |
| TrustedCertFolder | Cartella contenente i certificati attendibili dell'agente in esecuzione (ad esempio C:\temp\myCerts). |
Riferimento azioni
L'Automation CLI Action Pack include 51 azioni, qui raggruppate per categoria funzionale. Ogni azione ha un nome oggetto Automic completo secondo lo schema PCK.TRICISE_AUT_CLI.PUB.ACTION.<NAME>. Tutte le azioni possono essere eseguite in modo interattivo dall'AWI oppure senza presidio in modalità batch all'interno di un workflow.
Gestione della configurazione
Gestisci le configurazioni di connessione dell'Automation CLI Action Pack stesso.
| Azione | Nome dell'oggetto | Descrizione |
|---|---|---|
| Configuration Add / Update | CONFIGURATION_ADD CONFIGURATION_UPDATE | Crea o aggiorna una configurazione di connessione verso un sistema e un client Automic specifici. La password viene cifrata automaticamente. |
| Configuration Remove | CONFIGURATION_REMOVE | Rimuovere una configurazione di connessione esistente. |
| Encrypt | ENCRYPT | Crittografa le password usando la stessa tecnica dei campi mascherati dei PromptSet Automic, per archiviarle in modo sicuro nella configurazione. |
| Generic Command | GENERICCOMMAND | Esegui qualsiasi modulo interno dell'Automation CLI Action Pack direttamente tramite sintassi da riga di comando. Utile per utenti esperti che conoscono già i parametri e vogliono saltare l'interfaccia utente PromptSet. |
Operazioni sugli oggetti
Creazione, modifica, eliminazione, spostamento, esecuzione e analisi di oggetti Automic e strutture di cartelle dalla riga di comando.
| Azione | Nome dell'oggetto | Descrizione |
|---|---|---|
| Agentgroups Create | AGENTGROUPSCREATE | Crea in blocco oggetti per gruppi di agenti da un file di input strutturato. |
| Agentgroups Read | AGENTGROUPSREAD | Esporta la definizione dei gruppi di agenti esistenti in un file di output strutturato (compatibile con Agentgroups Create). |
| Folder Structure Create | FOLDERSTRUCTURECREATE | Crea una struttura di cartelle a partire da un file di input strutturato, ad esempio per preparare un nuovo client. |
| Folder Structure Read | FOLDERSTRUCTUREREAD | Esporta la struttura di cartelle di un client in un file di output strutturato (compatibile con Folder Structure Create). |
| Logins Create | LOGINSCREATE | Crea in blocco oggetti di login da un file di input strutturato. Le password esistenti vengono cancellate al momento della sostituzione. |
| Logins Read | LOGINSREAD | Esporta la definizione degli oggetti di login esistenti in un file di output strutturato (compatibile con Logins Create). |
| Objects Add Filter | OBJECTSADDFILTER | Aggiunge oggetti filtro a oggetti esistenti in base a un file di input strutturato. I nuovi filtri vengono aggiunti alla fine dell'elenco dei filtri. |
| Objects Add Script | OBJECTSADDSCRIPT | Aggiungi o inserisci il contenuto di uno script in oggetti esistenti, basandoti su un file di script e sugli oggetti di destinazione. |
| Objects Add Value | OBJECTSADDVALUE | Aggiungere valori agli oggetti Variable (VARA) da un file di input. |
| Objects Delete | OBJECTSDELETE | Elimina oggetti in base a una sorgente di input strutturata (file, cartella, singolo oggetto o elenco VARA), con filtri di inclusione/esclusione. |
| Objects Execute | OBJECTSEXECUTE | Esegue oggetti in blocco, ad esempio un elenco di job o workflow in un'unica esecuzione. |
| Objects Link Delete | OBJECTSLINKDELETE | Rimuovere collegamenti / riferimenti tra oggetti. |
| Objects Move | OBJECTSMOVE | Sposta oggetti tra cartelle Automic, con selezione della fonte di input e filtri. |
| Objects Relations | OBJECTSRELATIONS | Determinare ed esportare le relazioni / dipendenze degli oggetti. |
| Objects Remove Filter | OBJECTSREMOVEFILTER | Rimuovere oggetti filtro da oggetti esistenti in base a un file di input strutturato. |
| Objects Remove Script | OBJECTSREMOVESCRIPT | Rimuovere il contenuto dello script dagli oggetti esistenti. |
| Objects Remove Value | OBJECTSREMOVEVALUE | Rimuovere valori dagli oggetti Variable (VARA) in base a un file di input. |
| Objects Replace | OBJECTSREPLACE | Sostituisci il contenuto di stringa all'interno di oggetti esistenti in base a regole di ricerca e sostituzione. |
| Objects Replace Attribute | OBJECTSREPLACEATTRIBUTE | Sostituisci valori di attributi specifici su più oggetti in un unico batch. |
| Objects Usage | OBJECTSUSAGE | Analizza il client a livello di oggetto: stato di utilizzo e numero di statistiche. Il risultato viene scritto in un file (dalla versione 6.9.0; le versioni precedenti usavano un oggetto VARA). Input ideale per le campagne di pulizia. |
Importazione, esportazione e trasporto
Sposta oggetti tra ambienti, trasforma esportazioni e gestisci casi di trasporto Automic.
| Azione | Nome dell'oggetto | Descrizione |
|---|---|---|
| Objects Export | OBJECTSEXPORT | Esporta oggetti dal sistema Automic in una cartella di destinazione. L'origine può essere FILE, FOLDER, OBJECT o VARA, con filtri include/exclude, opzione ricorsiva, filtro data di modifica e numero di thread configurabile (si consigliano 10-20 thread). |
| Objects Import | OBJECTSIMPORT | Importa oggetti da una struttura di cartelle precedentemente esportata. Supporta l'importazione ricorsiva, la sostituzione in caso di conflitto, i filtri di esclusione e il numero di thread configurabile. |
| Export Change | EXPORTCHANGE | Modifica oggetti XML esportati usando la stessa sintassi di file script dell'utility Change di Automic. Utile per riscritture specifiche dell'ambiente prima di reimportare. |
| Objects Transport | OBJECTSTRANSPORT | Imposta il flag di trasporto sugli oggetti in blocco, basato sull'input di FILE / FOLDER / OBJECT / VARA con filtri di inclusione ed esclusione. |
| Transport Clear | TRANSPORTCLEAR | Svuota il Transport Case del client a cui si fa riferimento nella connessione attiva. Non accetta parametri. |
Calendari e pianificazioni
Unisci e reimposta gli oggetti calendario e pianificazione.
| Azione | Nome dell'oggetto | Descrizione |
|---|---|---|
| Calendar Merge | CALENDARMERGE | Unisci due oggetti calendario in un nuovo terzo oggetto calendario, con sostituzione opzionale. |
| Schedule Merge | SCHEDULEMERGE | Unisci due oggetti pianificazione in un nuovo terzo oggetto pianificazione, con la possibilità di sovrascrivere. |
| Schedule Reset | SCHEDULERESET | Azzerare le voci degli oggetti di pianificazione attivi entro una finestra temporale. Particolarmente utile durante lunghe finestre di manutenzione quando attività individuali devono essere rieseguite dopo il ripristino del sistema. Usare -ALL- per reimpostare tutte le pianificazioni. |
Controllo dei task
Lettura, monitoraggio, modifica, commutazione, disattivazione e rimozione dei task, compresi i task periodici, dalla riga di comando.
| Azione | Nome dell'oggetto | Descrizione |
|---|---|---|
| Tasks Monitoring | TASKSMONITORING | Elenca attività nel sistema Automic filtrate per nome, tipo, codice di stato o numero di esecuzione superiore. Adatto per monitoraggio e dashboard tramite script. |
| Tasks Modify State | TASKSMODIFYSTATE | Cambia lo stato delle attività (qualsiasi stato Automic valido, ad esempio 1900 = ENDED_OK) con disattivazione automatica opzionale dopo il cambio. |
| Tasks Deactivate | TASKSDEACTIVATE | Disattiva attività in blocco, filtrate per nome, tipo, agente o coda. |
| Tasks Read | TASKSREAD | Legge i task con i filtri TASKS* unificati, ad esempio per verificare cosa seleziona un filtro prima di eseguire un'altra azione sui task. |
| Tasks Toggle | TASKSTOGGLE | Commuta in blocco lo stato dei task selezionati con i filtri TASKS* unificati. |
| Tasks Remove | TASKSREMOVE | Rimuove in blocco i task selezionati con i filtri TASKS* unificati. |
| Tasks Periodic Read | TASKSPERIODICREAD | Legge i task periodici del client. |
| Tasks Periodic Execute | TASKSPERIODICEXECUTE | Avvia in blocco i task periodici, ad esempio da un elenco creato con Tasks Periodic Read. |
Modifica del flusso di lavoro
Modifica programmatica dei workflow — aggiunta, rimozione, chiusura e adattamento dei task all'interno dei workflow.
| Azione | Nome dell'oggetto | Descrizione |
|---|---|---|
| Workflow Add Task | WORKFLOWADDTASK | Aggiungere un'attività a un flusso di lavoro esistente, con configurazione di posizionamento e dipendenza. |
| Workflow Remove Task | WORKFLOWREMOVETASK | Rimuove un task da un workflow esistente. |
| Workflow Close Tasks | WORKFLOWCLOSETASKS | Chiudere attività all'interno dei flussi di lavoro in blocco. |
| Workflow Task Active | WORKFLOWTASKACTIVE | Imposta il flag Attivo delle attività del flusso di lavoro. |
| Workflow Task Earliest | WORKFLOWTASKEARLIEST | Imposta "Ora inizio più presto" sui task del workflow. |
Sistema e sicurezza
Stato del sistema, informazioni, cronologia dei messaggi, verifiche delle autorizzazioni utente e autorizzazioni degli agenti.
| Azione | Nome dell'oggetto | Descrizione |
|---|---|---|
| Agent Authorizations Read | AGENTAUTHORIZATIONSREAD | Legge le autorizzazioni per client degli oggetti Agent. |
| Agent Authorizations Set | AGENTAUTHORIZATIONSSET | Imposta in blocco le autorizzazioni per client degli oggetti Agent. |
| SystemInfo | SYSTEMINFO | Verifica la connessione al sistema configurato ed emette informazioni di base sul sistema. Ideale come controllo di connettività prima di eseguire altre azioni. Non accetta parametri. |
| System Status | SYSTEMSTATUS | Imposta lo stato del client su GO o STOP — utile per finestre di manutenzione controllata. |
| Message History | MESSAGEHISTORY | Leggi i messaggi di sistema con filtri per utente, flag admin/sicurezza, tipo di messaggio (ALL / ERROR / INFORMATION / FAILED / SUCCESS / WARNING), categoria, intervallo di date e numero massimo di risultati. L'output viene renderizzato nel report del job. |
| User Authorizations Check | USERAUTHORIZATIONSCHECK | Controlla tutti gli utenti nel client per i diritti di SUPERUSER. Non accetta parametri. Utile per audit di sicurezza periodici. |
Aggiornamento e migrazione
Automation CLI Action Pack — per gli aggiornamenti si utilizza esattamente la stessa procedura dell'installazione iniziale: Amministrazione → Pacchetti → Installa da file, seleziona il nuovo ZIP, conferma con Installa. Il meccanismo Automic Action Pack gestisce la sostituzione delle versioni automaticamente.
Prima dell'aggiornamento
- Assicurati che l'Action Pack dipendente PCK.ITPA_SHARED sia in una versione compatibile con la nuova release dell'Automation CLI Action Pack
- Scatta un'istantanea o effettua un backup dell'installazione corrente se il tuo ambiente richiede tracce di audit
- Metti in pausa eventuali flussi di lavoro pianificati che utilizzano azioni di Automation CLI Action Pack, per evitare modifiche alla versione durante l'esecuzione
Dopo l'aggiornamento
- Le configurazioni di connessione esistenti restano valide. Eccezione: se aggiorni da una versione precedente alla 4.0.0, inserisci di nuovo le password con CONFIGURATION_UPDATE, perché il metodo di cifratura è cambiato.
- Esegui l'azione SYSTEMINFO su ogni connessione configurata come smoke test
- Riprendi tutti i flussi di lavoro in pausa
Note specifiche per versione
- Versione 6.9.0: OBJECTSUSAGE scrive il risultato in un file anziché in un oggetto VARA. Adatta i passaggi successivi che leggono la VARA.
- Versione 5.0.0: diverse azioni sono state rinominate. Le azioni *TOFILE e *FROMFILE hanno perso il suffisso, ANALYSEUSAGE è diventata OBJECTSUSAGE, READHOSTGROUPTOFILE e CREATEHOSTGROUPFROMFILE sono diventate AGENTGROUPSREAD e AGENTGROUPSCREATE, READLOGINTOFILE e CREATELOGINFROMFILE sono diventate LOGINSREAD e LOGINSCREATE, mentre MERGESCHEDULE e RESETSCHEDULE sono diventate SCHEDULEMERGE e SCHEDULERESET. OBJECTSCREATE e OBJECTSRENAME sono state rimosse. I workflow che richiamano i vecchi nomi devono essere adattati.
- Versione 5.0.0: il parametro MODE di AGENTGROUPSREAD e AGENTGROUPSCREATE accetta ANY, LOAD, ALL, NEXT o FIRST anziché singole lettere.
- Versione 3.7.2: l'Action Pack è stato rinominato in PCK.TRICISE_AUT_CLI; i nomi degli oggetti delle installazioni precedenti cambiano di conseguenza.
Note di rilascio
Tutte le versioni dell'Automation CLI Action Pack e le modifiche introdotte in ciascuna. Le versioni precedenti alla 3.0.0 sono state rilasciate con il nome AEAPI.
v7.1.1 (attuale) · 2026-10-06
| Versione | Tipo | Modifica |
|---|---|---|
| 7.1.1 2026-10-06 | Corretto | Workflow Add Task: corretto lo spostamento delle colonne |
| Modificato | Moduli dei gruppi di utenti: rimossi i campi obsoleti |
Versioni precedenti
Versioni 6.0.0 – 7.1.0 (2025–2026)
| Versione | Tipo | Modifica |
|---|---|---|
| 7.1.0 2026-05-20 | Corretto | Correzioni di bug e refactoring del codice |
| 7.0.0 2025-12-04 | Modificato | Gestione delle licenze adattata; è necessaria una chiave di licenza valida |
| 6.9.0 2025-12-04 | Modificato | OBJECTSUSAGE scrive l'output in un file anziché in un oggetto VARA |
| 6.8.0 2025-11-19 | Nuovo | Azione TASKSTOGGLE |
| 6.7.0 2025-11-19 | Modificato | Filtri uniformati per tutte le azioni TASKS* |
| 6.6.0 2025-11-15 | Nuovo | Azione TASKSREAD |
| 6.5.0 2025-11-14 | Nuovo | Azione OBJECTSEXECUTE |
| 6.4.0 2025-11-13 | Nuovo | Azioni TASKSPERIODICREAD e TASKSPERIODICEXECUTE |
| 6.3.0 2025-10-29 | Nuovo | Azioni AGENTAUTHORIZATIONSREAD e AGENTAUTHORIZATIONSSET |
| Corretto | La configurazione non viene più mostrata nel report del job quando la modalità di debug è disattivata | |
| 6.2.0 2025-10-13 | Modificato | Gestione delle licenze adattata |
| 6.1.0 2025-06-13 | Nuovo | Azioni FOLDERSTRUCTUREREAD e FOLDERSTRUCTURECREATE |
| 6.0.1 2025-06-12 | Corretto | OBJECTSMOVE: errore nel metodo di elaborazione |
| Corretto | OBJECTSLINKDELETE: nome dell'include errato | |
| 6.0.0 2025-02-11 | Modificato | CONFIGURATION_ADD, CONFIGURATION_REMOVE e CONFIGURATION_UPDATE: “connection” rinominato in “configuration” |
Versioni 4.0.0 – 5.1.2 (2024–2025)
| Versione | Tipo | Modifica |
|---|---|---|
| 5.1.2 2025-01-10 | Modificato | Il controllo di validità supporta i nomi Automic SaaS ($@@$) |
| 5.1.1 2024-11-11 | Corretto | EXPORTCHANGE può modificare gli attributi dei task JSCH |
| 5.1.0 2024-11-11 | Nuovo | Azioni WORKFLOWREMOVETASK e TASKSREMOVE |
| 5.0.0 2024-11-07 | Modificato | Riordino e ridenominazione parziale delle azioni |
| Rimosso | Azioni OBJECTSCREATE e OBJECTSRENAME | |
| Modificato | Azioni *TOFILE e *FROMFILE rinominate senza il suffisso | |
| Modificato | ANALYSEUSAGE rinominata in OBJECTSUSAGE | |
| Modificato | READHOSTGROUPTOFILE e CREATEHOSTGROUPFROMFILE rinominate in AGENTGROUPSREAD e AGENTGROUPSCREATE | |
| Modificato | READLOGINTOFILE e CREATELOGINFROMFILE rinominate in LOGINSREAD e LOGINSCREATE | |
| Modificato | MERGESCHEDULE e RESETSCHEDULE rinominate in SCHEDULEMERGE e SCHEDULERESET | |
| Modificato | REMOVELINKSFROMFOLDER rinominata in OBJECTSLINKDELETE | |
| Modificato | AGENTGROUPSREAD e AGENTGROUPSCREATE: MODE accetta ANY, LOAD, ALL, NEXT o FIRST anziché singole lettere | |
| Modificato | CALENDARMERGE e SCHEDULEMERGE: nuovo parametro Replace | |
| Corretto | OBJECTSRELATIONS: la modalità di trasporto funziona di nuovo | |
| 4.2.1 2024-11-05 | Corretto | CONFIGURATION_UPDATE: variabile CONFIG_NAME rimossa |
| 4.1.0 2024-09-12 | Nuovo | Azione per aggiornare una configurazione esistente (la password deve essere inserita di nuovo) |
| 4.0.0 2024-09-09 | Modificato | ENCRYPT: nuovo metodo di cifratura, non compatibile con il precedente |
| Modificato | Quando si aggiunge una configurazione, il campo della password viene cifrato automaticamente |
Versioni 3.0.0 – 3.9.0
| Versione | Tipo | Modifica |
|---|---|---|
| 3.9.0 2024-09-06 | Modificato | Variabile JAVACMD: tutte le azioni, CONFIGURATION_ADD e ENCRYPT possono essere eseguite con un eseguibile Java definito dall'utente |
| 3.8.0 2024-05-24 | Modificato | commons.io rimossa dalle librerie; EXPORTCHANGE usa invece le funzioni standard di Java |
| 3.7.2 2024-02-29 | Modificato | Action Pack rinominato in PCK.TRICISE_AUT_CLI |
| 3.7.1 2023-12-01 | Corretto | EXPORTCHANGE: i titoli con un asterisco venivano elaborati due volte |
| 3.7.0 2023-09-19 | Modificato | ANALYSEUSAGE: nuovi parametri di input OBJECT, FILE, FOLDER e VARA |
| Nuovo | Azione OBJECTSRENAME (prefisso e suffisso, senza sostituzione dei riferimenti) | |
| 3.6.3 2023-06-16 | Modificato | WORKFLOWADDTASK: nuovi parametri opzionali format, removeredundancies e closetasks |
| 3.6.2 2023-06-16 | Rimosso | Azione MOVEFROMFOLDER, sostituita da OBJECTSMOVE |
| 3.6.1 2023-06-15 | Nuovo | Azione OBJECTSMOVE |
| Corretto | Objects Delete: parametro deletesource | |
| 3.6.0 2023-06-14 | Nuovo | Azioni WORKFLOWTASKACTIVE, WORKFLOWTASKEARLIEST e GENERICCOMMAND |
| 3.5.3 2023-03-29 | Modificato | Tasks Deactivate usa il filtro API anziché le espressioni regolari |
| 3.5.2 2023-02-23 | Corretto | Objects Create può creare anche soltanto cartelle |
| 3.5.1 2023-02-21 | Corretto | I link vengono aggiunti in ACTIONS/CUSTOM anziché in ACTIONS/CAPTURE, perché un'esportazione li eliminava |
| 3.5.0 2023-02-16 | Modificato | Nuovo concetto di build con aut_cli.jar e aut_cli_base.jar |
| 3.4.1 2023-02-16 | Modificato | Action Pack rinominato in PCK.CAPTURE_AUT_CLI |
| 3.4.0 | Nuovo | Azione TASKSMONITORING |
| 3.3.0 | Nuovo | Azioni USERSETTITLE (non fa più parte del pack) e USERCHECKAUTHORIZATIONS (oggi USERAUTHORIZATIONSCHECK) |
| 3.2.2 | Corretto | Schedule Reset: l'ora di inizio deve essere maggiore o uguale all'inizio della finestra |
| 3.2.1 | Corretto | Cache dell'albero delle cartelle: annullata la modifica alla ricerca delle cartelle |
| 3.2.0 | Modificato | Objects Transport: parametri includeArchiveKey1, includeArchiveKey2 e excludeName rimossi, includeName aggiunto, trasporto delle cartelle più veloce |
| 3.1.2 | Corretto | Encrypt: rimosso il campo della connessione |
| 3.1.1 | Corretto | Verifica della licenza |
| 3.1.0 | Nuovo | Azioni CONFIGURATION_ADD (con cifratura automatica della password) e CONFIGURATION_REMOVE |
| Modificato | ENCRYPT pubblica la variabile &AUT_CLI_ENCRYPTED_PASSWORD# | |
| 3.0.2 | Modificato | Gli oggetti di configurazione non vengono più sovrascritti dagli aggiornamenti |
| 3.0.1 | Modificato | @echo off rimosso |
| 3.0.0 | Modificato | Rinominato in AUT_CLI (in precedenza AEAPI); librerie rinominate in aut_cli_base.jar e config.ini |
Versioni 2.1.0 – 2.4.0 (AEAPI)
| Versione | Tipo | Modifica |
|---|---|---|
| 2.4.0 | Modificato | Libreria protetta (offuscata) e rinominata in AutomicTools.jar |
| 2.3.1 | Modificato | Objects Remove Script: parametri 4 e 5 facoltativi, altrimenti viene rimosso l'intero script |
| Modificato | I campi data del PromptSet hanno come valore predefinito 01/01/2000 | |
| Modificato | Le variabili di data usano YYYY-MM-DD anziché YYMMDD | |
| 2.3.0 | Corretto | Le azioni terminano correttamente con errore se la licenza non è valida |
| Modificato | Voci delle chiavi rimosse dal file di configurazione | |
| 2.2.0 | Modificato | Libreria ripulita |
| Nuovo | Message History | |
| 2.1.1 | Modificato | Objects Create: nuovi campi jobp.queue e jobp.children_queue; script, prescript e postscript con <br> |
| 2.1.0 | Nuovo | Voce con l'elenco dei CP nel file di configurazione (solo per il login iniziale, nessuna rotazione dei CP) |
Domande frequenti
Clicca su una domanda qualsiasi per espandere la risposta.
Cos'è e cosa fa l'Automation CLI Action Pack?
L'Automation CLI Action Pack è un toolkit Tricise dedicato alla gestione e al monitoraggio dei sistemi Automic Automation dalla riga di comando. Raccoglie 51 azioni pronte all'uso che coprono operazioni sugli oggetti (creazione, eliminazione, modifica, esecuzione, importazione, esportazione, sostituzione, trasporto), strutture di cartelle, controllo dei task, gestione di Calendar e Schedule, analisi del sistema, modifica dei workflow e controlli di sicurezza. Ogni operazione di routine da riga di comando su Automic è racchiusa in un'azione configurabile e riutilizzabile, che può essere inserita in qualsiasi workflow.
L'Automation CLI Action Pack viene eseguito sia interattivamente dall'AWI che in modo automatico in modalità batch, rendendolo ugualmente adatto per l'amministrazione quotidiana e le routine automatizzate.
Quali versioni di Automic sono supportate?
L'Automation CLI Action Pack richiede Automic Automation V24 o superiore. La connessione utilizza l'API Java standard Automic su un endpoint JCP con comunicazione protetta da TLS. Sono necessari un host e una porta JCP raggiungibili per il client di destinazione e un certificato attendibile per la connessione TLS.
Quali sono i requisiti tecnici?
L'Automation CLI Action Pack funziona come parte di un'installazione Automic Action Pack, quindi i requisiti sono:
- Automic Automation V24+ con endpoint JCP raggiungibile
- Java 11 o superiore (JRE o JDK) sull'agente in esecuzione
- L'Action Pack dipendente PCK.ITPA_SHARED installato nello stesso client
- Un utente Automic con diritti sufficienti per le azioni che si intendono eseguire
- Una chiave di licenza valida per Automation CLI Action Pack di Tricise
Come si installa l'Automation CLI Action Pack?
Accedi a qualsiasi client Automic eccetto il client 0, apri Amministrazione → Pacchetti, installa facoltativamente PCK.ITPA_SHARED prima, poi fai clic su Install From File e seleziona lo ZIP Automation CLI Action Pack fornito da Tricise. Il programma di installazione è lo stesso sia per le nuove installazioni che per gli aggiornamenti: basta puntare al nuovo ZIP. Dopo l'installazione, l'Action Pack si trova all'interno della cartella PACKAGES . Non rinominarlo né spostarlo.
Come è configurata la connessione a Automic?
Eseguire l'azione CONFIGURATION_ADD dalla cartella dell'Automation CLI Action Pack installato e compila i campi richiesti: nome della configurazione (schema consigliato: SYSTEMNAME_CLIENT), il percorso dell'eseguibile Java, l'host, la porta, il client, il nome utente, il dipartimento, la password e la chiave di licenza Tricise. È possibile creare più configurazioni di connessione in parallelo, una per ogni combinazione sistema Automic / client. Usa CONFIGURATION_UPDATE per modificarne una e CONFIGURATION_REMOVE per eliminarne una.
Come vengono memorizzate le password nella configurazione?
Le password inserite in CONFIGURATION_ADD o CONFIGURATION_UPDATE vengono cifrate automaticamente prima di essere salvate nella configurazione. Dalla versione 4.0.0 l'Automation CLI Action Pack utilizza un metodo di cifratura non compatibile con le versioni precedenti; dopo l'aggiornamento da una release più vecchia, inserisci di nuovo le password con CONFIGURATION_UPDATE. L'azione dedicata ENCRYPT è ancora disponibile per cifrare i valori autonomamente.
Come si spostano gli oggetti tra gli ambienti?
Utilizzare il OBJECTSEXPORT per esportare oggetti dall'ambiente di origine, e OBJECTSIMPORT nell'ambiente di destinazione per importarli. Entrambe le azioni supportano l'input per elenco di FILE, FOLDER, OBJECT o VARA, con filtri di inclusione/esclusione, supporto di cartelle ricorsive, filtraggio della data di modifica e conteggi di thread configurabili (10-20 thread consigliati per le prestazioni, ma attenzione al carico sul sistema Automic di origine).
Se è necessario riscrivere i valori durante lo spostamento (rinominazione di host, percorsi specifici per l'ambiente), usare EXPORTCHANGE sui file XML esportati prima di importarli; utilizza la stessa sintassi dei file di script dell'utilità Automic Change.
L'Automation CLI Action Pack può essere eseguito in modalità batch senza supervisione?
Sì. Ogni azione dell'Automation CLI Action Pack può essere eseguita sia in modo interattivo dall'AWI sia in modo automatico come parte di un flusso di lavoro. Per l'uso batch, i valori dei parametri vengono normalmente forniti tramite il PromptSet dell'azione, tramite variabili di flusso di lavoro o — se si conosce già la sintassi del modulo sottostante — direttamente tramite l'azione GENERICCOMMAND che consente di passare una riga di comando grezza.
Come posso ripulire oggetti non utilizzati o obsoleti in modo sicuro?
La procedura consigliata prevede due passaggi. Per prima cosa esegui OBJECTSUSAGE sulla cartella o sull'elenco di oggetti di destinazione: l'azione analizza ogni oggetto in base allo stato di utilizzo e al numero di statistiche e scrive il risultato in un file (dalla versione 6.9.0; le versioni precedenti lo scrivevano in un oggetto Variable). Esamina il risultato per stabilire quali oggetti si possono davvero rimuovere senza rischi. Quindi passa l'elenco confermato a OBJECTSDELETE, che accetta un file come sorgente di input, per rimuovere gli oggetti in un batch controllato e ripetibile.
Come posso apportare modifiche massive durante l'esportazione?
Utilizzare il EXPORTCHANGE dell'Automation CLI Action Pack. Modifica oggetti XML esportati utilizzando la stessa sintassi di file di script del tool Automic Change: puntalo alla cartella di esportazione e a un file di modifica con le tue regole, e abilita opzionalmente l'elaborazione ricorsiva per le sottocartelle. Ideale per rinominare host, riscrivere percorsi e altre trasformazioni specifiche dell'ambiente tra DEV, TEST e PROD.
Come posso disattivare o modificare gli stati delle attività in blocco?
Usa TASKSDEACTIVATE per la disattivazione in massa, filtrata per nome attività, tipo, agente o coda. Per modificare i codici di stato delle attività (ad esempio per forzare un'attività in 1900 = ENDED_OK), utilizzare TASKSMODIFYSTATE — accetta qualsiasi codice di stato Automic valido e offre la disattivazione automatica opzionale dopo il cambio di stato. Per elencare e monitorare senza modifiche, utilizzare TASKSMONITORING.
Per rimuovere i task usa TASKSREMOVE; per cambiarne lo stato in blocco usa TASKSTOGGLE. Dalla versione 6.7.0 tutte le azioni TASKS* condividono le stesse opzioni di filtro.
Come si fa a verificare se gli utenti di un client hanno i diritti di SUPERUSER?
Esegui l'azione USERAUTHORIZATIONSCHECK dell'Automation CLI Action Pack. Scansiona ogni utente nel client configurato ed elenca quelli con diritti di SUPERUSER. L'azione non richiede parametri ed è ideale come audit di sicurezza programmato.
Posso leggere i messaggi di sistema con i filtri?
Sì. L'azione MESSAGEHISTORY legge i messaggi di sistema con ampie opzioni di filtro: nome utente, flag per messaggi di amministrazione / sicurezza, tipo di messaggio (ALL, ERROR, INFORMATION, FAILED, SUCCESS, WARNING), categoria (ALL, ACCESS TO HOST, LOGIN, MESSAGE, OBJECT_ACCESS, PRIVILEGE), data da / a (formato YYYY-MM-DD) e un limite massimo di risultati. I messaggi trovati vengono riportati nel report del job Automic Windows o Unix che esegue l'azione.
Come viene concessa la licenza per l'Automation CLI Action Pack?
L'Automation CLI Action Pack è concesso in licenza d'uso come acquisto una tantum per sistema Automic — nessun abbonamento ricorrente, nessuna scadenza. Il prezzo fisso è pubblicato nel negozio Tricise. La licenza include il supporto ai prodotti Tricise e gli aggiornamenti di compatibilità per la linea di rilascio corrente Automic V24+. Le chiavi di licenza di valutazione a tempo limitato sono disponibili su richiesta per lavori di proof-of-concept.