- Périmètre technique et concept
- Installation — installer, mettre à jour et désinstaller
- Configuration — référence des paramètres de connexion
- Actions — les 51 actions, regroupées par catégorie
- Mise à niveau et migration
- Notes de publication
- FAQ
Concept & portée technique
L'Automation CLI Action Pack est une boîte à outils dédiée à la gestion et à la surveillance des systèmes Broadcom Automic Automation en ligne de commande. Il regroupe 51 actions prêtes à l'emploi pour les opérations sur les objets, les arborescences de dossiers, le pilotage des tâches, la planification, l'analyse du système et les transports. L'Automation CLI Action Pack fonctionne en mode interactif comme en mode batch et convient donc aussi bien aux tâches d'administration quotidiennes qu'aux routines d'automatisation sans surveillance.
Ce qu'est un Action Pack
Les Action Packs sont des modules d'intégration préconstruits utilisés dans des plateformes d'automatisation telles qu'Automic Automation. Ils simplifient l'intégration et l'automatisation d'applications et de services tiers en fournissant une collection d'actions réutilisables. L'Automation CLI Action Pack suit le même modèle : chaque opération courante en ligne de commande sur Automic est encapsulée sous forme d'action configurable et réutilisable qui peut être intégrée dans n'importe quel workflow.
Composants principaux et fonctions
L'Automation CLI Action Pack couvre trois domaines fonctionnels :
Objets
- Créer, supprimer, modifier en masse
- Importation et exportation entre environnements
- Combiner (fusionner calendriers, plannings, groupes d'agents)
- Convertir et transformer via des scripts de modification
- Lire et créer des arborescences de dossiers
- Exécuter des objets en masse
Tâches
- Surveiller les tâches en cours et historiques
- Modifier l'état, désactiver, changer les codes d'état
- Analyse via l'historique des tâches et des messages
- Lire, basculer et supprimer des tâches, y compris les tâches périodiques
Système
- Analyser l'état et la configuration du système
- Déterminer les références, les dépendances et l'utilisation des objets
- Gérer les transports et vider les Conteneurs Transport
- Lire et définir les autorisations des agents
Accès et autorisations
Pour utiliser l'Automation CLI Action Pack, les accès suivants sont requis :
- Un utilisateur Automic disposant de droits étendus, suffisants pour exécuter les actions pertinentes dans le client cible du système. Les actions qui affectent des objets à l'échelle du système (par exemple, les actions de transport ou les analyses à l'échelle du locataire) nécessitent des droits d'accès élevés correspondants.
- Une clé de licence valide pour l'Automation CLI Action Pack, fournie par Tricise. Des clés de test à durée limitée sont disponibles sur demande.
Exigences et compatibilité
Automic Automation
- Version minimale : Automic Automation V24
- Point de terminaison JCP atteignable (hôte et port) pour le client cible
- Certificat de confiance pour la communication TLS
Environnement d'exécution Java (JRE)
- Version minimale : Java 11 (JRE ou JDK)
- Disponible sur l'agent qui exécutera les actions de l'Automation CLI Action Pack
- Soit disponible via la variable d'environnement PATH, soit sous forme de chemin complet (par exemple C:\Program Files\Java\jdk-17\bin)
ITPA Shared Action Pack
- L'Automation CLI Action Pack dépend de l'Action Pack PCK.ITPA_SHARED , qui doit être installé en premier s'il n'est pas déjà présent
Installation
L'Automation CLI Action Pack est installé via le mécanisme standard des Action Packs Automic. Il peut être installé dans n'importe quel client du système Automic Automation sauf le client 0. La même procédure est utilisée pour l'installation initiale et pour les mises à jour vers une version plus récente.
Installer ou mettre à jour
Désinstaller
Pour supprimer l'Automation CLI Action Pack d'un client, suivez ces étapes :
Référence de configuration
Après l'installation, l'outil Automation CLI Action Pack nécessite une configuration de connexion à un système Automic existant et à l'un de ses clients. La configuration est créée en exécutant l'action CONFIGURATION_ADD depuis l'AWI. Plusieurs configurations peuvent être créées en parallèle — une par combinaison système / client Automic.
Procédure de configuration
Fournissez les détails de connexion (voir la référence des paramètres ci-dessous). La convention de nommage SYSTEMNAME_CLIENT est recommandée (par exemple AUTOMIC_0100).
Utilisez CONFIGURATION_UPDATE pour modifier une configuration existante et CONFIGURATION_REMOVE pour en supprimer une. De nouvelles configurations peuvent toujours être ajoutées en exécutant à nouveau CONFIGURATION_ADD.
Paramètres de connexion
Paramètres requis de l'action CONFIGURATION_ADD / UPDATE :
| Paramètre | Description |
|---|---|
| Nom de la configuration | Nom libre de la connexion. Syntaxe recommandée : SYSTEMNAME_CLIENT, par exemple AUTOMIC_0100. |
| Exécutable Java | Installation Java (JRE ou JDK) utilisée par l'agent d'exécution. java suffit si Java est dans le PATH ; sinon, fournissez le chemin complet (par exemple C:\Program Files\Java\jdk-17\bin). Version minimale : Java 11. |
| Hôte | Nom d'hôte ou FQDN du système Automic avec des JCP en cours d'exécution (par exemple myserver.com). |
| Port | Port du JCP sur le système Automic (par exemple 8443). |
| Client | Client cible du système Automic (par exemple 0100). |
| Nom d'utilisateur | Nom d'utilisateur Automic (par exemple UC). |
| Département | Département de l'utilisateur Automic (par exemple UC). |
| Mot de passe | Mot de passe de l'utilisateur Automic. CONFIGURATION_ADD et CONFIGURATION_UPDATE le chiffrent automatiquement ; lorsque vous mettez à jour une configuration, saisissez à nouveau le mot de passe. |
| Clé | Clé de licence pour l'Automation CLI Action Pack, fournie par Tricise. Des clés d'essai limitées dans le temps sont disponibles sur demande. |
Paramètres optionnels
| Paramètre | Description |
|---|---|
| Journalisation | Modèle de chemin pour les fichiers journaux, par exemple ./log/AUT_CLI_log_##.txt. |
| Nombre de journaux | Nombre maximum de fichiers journaux pour la rotation des journaux. |
| Traçage | Modèle de chemin pour les fichiers de trace, par exemple ./log/AUT_CLI_trc_##.txt. |
| Nombre de traces | Nombre maximum de fichiers de trace pour la rotation des traces. |
| Liste CP | Liste des processus de communication alternatifs en plus de l'hôte/port (par exemple, myserver.com:8444). |
| LogToStdOut | Afficher la sortie du journal dans la ligne de commande. Définir sur 1 pour activer. |
| Déboguer | Active le mode débogage. Définissez la valeur 1 pour l'activer. Lorsque le mode débogage est désactivé (0), la configuration n'est pas écrite dans le rapport du job. |
| TrustedCertFolder | Dossier contenant les certificats de confiance de l'agent d'exécution (par exemple C:\temp\myCerts). |
Référence des actions
L'Automation CLI Action Pack est livré avec 51 actions, regroupées ici par catégorie fonctionnelle. Chaque action possède un nom d'objet Automic entièrement qualifié selon le modèle PCK.TRICISE_AUT_CLI.PUB.ACTION.<NAME>. Toutes les actions peuvent être exécutées de manière interactive depuis l'AWI ou sans surveillance en mode batch, dans le cadre d'un workflow.
Gestion de la configuration
Gérer les configurations de connexion de l'Automation CLI Action Pack lui-même.
| Action | Nom de l'objet | Description |
|---|---|---|
| Configuration Add / Update | CONFIGURATION_ADD CONFIGURATION_UPDATE | Crée ou met à jour une configuration de connexion vers un système et un client Automic donnés. Le mot de passe est chiffré automatiquement. |
| Configuration Remove | CONFIGURATION_REMOVE | Supprimer une configuration de connexion existante. |
| Encrypt | ENCRYPT | Chiffrez les mots de passe en utilisant la même technique que les champs masqués des PromptSets Automic, pour un stockage sécurisé dans la configuration. |
| Generic Command | GENERICCOMMAND | Exécutez directement n'importe quel module interne de l'Automation CLI Action Pack via la syntaxe de ligne de commande. Utile pour les utilisateurs expérimentés qui connaissent déjà les paramètres et souhaitent ignorer l'interface utilisateur PromptSet. |
Opérations sur les objets
Créez, modifiez, supprimez, déplacez, exécutez et analysez des objets Automic et des arborescences de dossiers depuis la ligne de commande.
| Action | Nom de l'objet | Description |
|---|---|---|
| Agentgroups Create | AGENTGROUPSCREATE | Créer en masse des objets de groupe d'agents à partir d'un fichier d'entrée structuré. |
| Agentgroups Read | AGENTGROUPSREAD | Exporter la définition des groupes d'agents existants dans un fichier de sortie structuré (compatible avec Agentgroups Create). |
| Structure des dossiers Créer | FOLDERSTRUCTURECREATE | Crée une arborescence de dossiers à partir d'un fichier d'entrée structuré, par exemple pour préparer un nouveau client. |
| Structure du dossier Lire | FOLDERSTRUCTUREREAD | Exporte l'arborescence de dossiers d'un client dans un fichier de sortie structuré (compatible avec Folder Structure Create). |
| Logins Create | LOGINSCREATE | Créer en masse des objets Login à partir d'un fichier d'entrée structuré. Les mots de passe existants sont effacés lors du remplacement. |
| Logins Read | LOGINSREAD | Exportez la définition des objets Login existants vers un fichier de sortie structuré (compatible avec Logins Create). |
| Objects Add Filter | OBJECTSADDFILTER | Ajouter des objets de filtre aux objets existants en fonction d'un fichier d'entrée structuré. Les nouveaux filtres sont ajoutés à la fin de la liste des filtres. |
| Objects Add Script | OBJECTSADDSCRIPT | Ajouter ou insérer du contenu de script dans des objets existants, basé sur un fichier de script et des objets cibles. |
| Objects Add Value | OBJECTSADDVALUE | Ajouter des valeurs aux objets de variable (VARA) à partir d'un fichier d'entrée. |
| Objects Delete | OBJECTSDELETE | Supprimer des objets en fonction d'une source d'entrée structurée (fichier, dossier, objet unique ou liste VARA), avec des filtres d'inclusion / exclusion. |
| Objects Execute | OBJECTSEXECUTE | Exécute des objets en masse, par exemple une liste de jobs ou de workflows en une seule fois. |
| Objects Link Delete | OBJECTSLINKDELETE | Supprimer les liens / références entre les objets. |
| Objects Move | OBJECTSMOVE | Déplacer des objets entre dossiers Automic, avec sélection de la source d'entrée et filtres. |
| Objects Relations | OBJECTSRELATIONS | Déterminer et exporter les relations / dépendances des objets. |
| Objects Remove Filter | OBJECTSREMOVEFILTER | Supprimer les objets de filtre des objets existants en fonction d'un fichier d'entrée structuré. |
| Objects Remove Script | OBJECTSREMOVESCRIPT | Supprimer le contenu des scripts des objets existants. |
| Objects Remove Value | OBJECTSREMOVEVALUE | Supprimer les valeurs des objets de variable (VARA) en fonction d'un fichier d'entrée. |
| Objects Replace | OBJECTSREPLACE | Remplacez le contenu des chaînes dans les objets existants en fonction des règles de recherche et remplacement. |
| Objects Replace Attribute | OBJECTSREPLACEATTRIBUTE | Remplacez les valeurs d'attributs spécifiques sur plusieurs objets en une seule opération groupée. |
| Objects Usage | OBJECTSUSAGE | Analyse le client au niveau des objets — état d'utilisation et compteurs de statistiques. Le résultat est écrit dans un fichier (depuis la version 6.9.0 ; les versions antérieures utilisaient un objet VARA). Point de départ idéal pour les campagnes de nettoyage. |
Importation, exportation et transport
Déplacez des objets entre des environnements, transformez des exportations et gérez les Conteneurs Transport Automic.
| Action | Nom de l'objet | Description |
|---|---|---|
| Objects Export | OBJECTSEXPORT | Exporter des objets du système Automic vers un dossier cible. La source peut être FILE, FOLDER, OBJECT ou VARA, avec des filtres inclure/exclure, une option récursive, un filtre de date de modification et un nombre de threads configurable (10 à 20 threads recommandés). |
| Objects Import | OBJECTSIMPORT | Importer des objets à partir d'une structure de dossiers précédemment exportée. Prend en charge l'importation récursive, le remplacement en cas de conflit, les filtres d'exclusion et le nombre de threads configurable. |
| Export Change | EXPORTCHANGE | Modifiez les objets XML exportés en utilisant la même syntaxe de fichier script que l'utilitaire Automic Change. Utile pour les réécritures spécifiques à l'environnement avant la réimportation. |
| Objects Transport | OBJECTSTRANSPORT | Définir l'indicateur de transport sur des objets en masse, à partir d'une entrée FILE / FOLDER / OBJECT / VARA avec des filtres d'inclusion et d'exclusion. |
| Transport Clear | TRANSPORTCLEAR | Vider le Conteneur Transport du client référencé par la connexion active. Ne prend aucun paramètre. |
Calendars et Schedules
Fusionner et réinitialiser les objets Calendar et Schedule.
| Action | Nom de l'objet | Description |
|---|---|---|
| Calendar Merge | CALENDARMERGE | Fusionner deux objets Calendar en un nouveau troisième objet Calendar, avec remplacement optionnel. |
| Schedule Merge | SCHEDULEMERGE | Fusionner deux objets Schedule en un nouveau troisième objet Schedule, avec remplacement optionnel. |
| Schedule Reset | SCHEDULERESET | Réinitialiser les entrées des objets de planification actifs dans une fenêtre temporelle. Particulièrement utile lors de longues fenêtres de maintenance lorsque des tâches individuelles doivent être réexécutées après le redémarrage du système. Utiliser -ALL- pour réinitialiser tous les Schedules. |
Contrôle des tâches
Lisez, surveillez, modifiez, basculez, désactivez et supprimez des tâches — y compris les tâches périodiques — depuis la ligne de commande.
| Action | Nom de l'objet | Description |
|---|---|---|
| Tasks Monitoring | TASKSMONITORING | Lister les tâches dans le système Automic filtrées par nom, type, code d'état ou numéro d'exécution supérieur. Adapté à la surveillance scriptée et aux tableaux de bord. |
| Tasks Modify State | TASKSMODIFYSTATE | Changer le code d'état des tâches (n'importe quel état Automic valide, par exemple 1900 = ENDED_OK) avec désactivation automatique facultative après le changement. |
| Tasks Deactivate | TASKSDEACTIVATE | Désactiver des tâches en masse, filtrées par nom, type, agent ou file d'attente. |
| Tasks Read | TASKSREAD | Lit les tâches avec les filtres TASKS* harmonisés, par exemple pour vérifier ce qu'un filtre sélectionne avant d'exécuter une autre action sur les tâches. |
| Tasks Toggle | TASKSTOGGLE | Bascule en masse l'état des tâches sélectionnées avec les filtres TASKS* harmonisés. |
| Tâches Supprimer | TASKSREMOVE | Supprime en masse les tâches sélectionnées avec les filtres TASKS* harmonisés. |
| Tasks Periodic Read | TASKSPERIODICREAD | Lit les tâches périodiques du client. |
| Tasks Periodic Execute | TASKSPERIODICEXECUTE | Démarre des tâches périodiques en masse, par exemple à partir d'une liste créée avec Tasks Periodic Read. |
Modification de workflows
Modification des workflows par programme — ajoutez, supprimez, fermez et ajustez des tâches dans les workflows.
| Action | Nom de l'objet | Description |
|---|---|---|
| Workflow Add Task | WORKFLOWADDTASK | Ajouter une tâche à un workflow existant, avec configuration de la position et de la dépendance. |
| Workflow Supprimer une tâche | WORKFLOWREMOVETASK | Supprime une tâche d'un workflow existant. |
| Workflow Close Tasks | WORKFLOWCLOSETASKS | Clôturer des tâches dans un workflow en masse. |
| Workflow Task Active | WORKFLOWTASKACTIVE | Définir le drapeau Actif des tâches du workflow. |
| Workflow Task Earliest | WORKFLOWTASKEARLIEST | Définir l'heure de début au plus tôt des tâches de workflow. |
Système et sécurité
État du système, informations, historique des messages, contrôle des autorisations des utilisateurs et autorisations des agents.
| Action | Nom de l'objet | Description |
|---|---|---|
| Agent Authorizations Read | AGENTAUTHORIZATIONSREAD | Lit les autorisations de client des objets Agent. |
| Agent Authorizations Set | AGENTAUTHORIZATIONSSET | Définit en masse les autorisations de client des objets Agent. |
| SystemInfo | SYSTEMINFO | Teste la connexion au système configuré et affiche des informations système de base. Idéal pour vérifier la connectivité avant d'exécuter d'autres actions. Ne prend aucun paramètre. |
| System Status | SYSTEMSTATUS | Définissez le statut du client sur GO ou STOP — utile pour les fenêtres de maintenance contrôlée. |
| Message History | MESSAGEHISTORY | Lire les messages système avec des filtres pour l'utilisateur, l'indicateur admin/sécurité, le type de message (ALL / ERROR / INFORMATION / FAILED / SUCCESS / WARNING), la catégorie, la plage de dates et le nombre maximum de résultats. La sortie est écrite dans le rapport du job. |
| User Authorizations Check | USERAUTHORIZATIONSCHECK | Vérifie tous les utilisateurs du client pour les droits SUPERUSER. Ne prend aucun paramètre. Utile pour les audits de sécurité périodiques. |
Mise à niveau et migration
Automation CLI Action Pack se met à niveau selon exactement la même procédure que l'installation initiale : Administration → Packs → Installer depuis un fichier, sélectionnez le nouveau fichier ZIP, confirmez avec Installer. Le mécanisme des Action Packs Automic gère automatiquement le remplacement de version.
Avant la mise à niveau
- Assurez-vous que l'Action Pack requis PCK.ITPA_SHARED est dans une version compatible avec la nouvelle version de l'Automation CLI Action Pack
- Prenez une capture instantanée ou une sauvegarde de l'installation actuelle si votre environnement nécessite des traces d'audit.
- Mettez en pause tous les workflows planifiés qui utilisent des actions de l'Automation CLI Action Pack pour éviter les changements de version en cours d'exécution.
Après la mise à niveau
- Les configurations de connexion existantes restent valides. Exception : si vous effectuez la mise à niveau depuis une version antérieure à 4.0.0, saisissez à nouveau les mots de passe avec CONFIGURATION_UPDATE, car la méthode de chiffrement a changé.
- Exécutez l'action SYSTEMINFO sur chaque connexion configurée comme smoke test
- Reprendre les workflows en pause
Remarques spécifiques aux versions
- Version 6.9.0 : OBJECTSUSAGE écrit son résultat dans un fichier au lieu d'un objet VARA. Adaptez les étapes en aval qui lisent la VARA.
- Version 5.0.0 : plusieurs actions ont été renommées. Les actions *TOFILE et *FROMFILE ont perdu leur suffixe, ANALYSEUSAGE est devenue OBJECTSUSAGE, READHOSTGROUPTOFILE et CREATEHOSTGROUPFROMFILE sont devenues AGENTGROUPSREAD et AGENTGROUPSCREATE, READLOGINTOFILE et CREATELOGINFROMFILE sont devenues LOGINSREAD et LOGINSCREATE, et MERGESCHEDULE et RESETSCHEDULE sont devenues SCHEDULEMERGE et SCHEDULERESET. OBJECTSCREATE et OBJECTSRENAME ont été supprimées. Les workflows qui appellent les anciens noms doivent être adaptés.
- Version 5.0.0 : le paramètre MODE de AGENTGROUPSREAD et AGENTGROUPSCREATE accepte ANY, LOAD, ALL, NEXT ou FIRST au lieu de lettres isolées.
- Version 3.7.2 : l'Action Pack a été renommé en PCK.TRICISE_AUT_CLI ; les noms d'objets des installations plus anciennes changent en conséquence.
Notes de publication
Toutes les versions de l'Automation CLI Action Pack et les modifications apportées par chacune d'elles. Les versions antérieures à 3.0.0 ont été publiées sous le nom AEAPI.
v7.1.1 (actuelle) · 2026-10-06
| Version | Type | Modification |
|---|---|---|
| 7.1.1 2026-10-06 | Corrigé | Workflow Add Task : décalage de colonnes corrigé |
| Modifié | Modules de groupes d'utilisateurs : champs obsolètes supprimés |
Versions antérieures
Versions 6.0.0 – 7.1.0 (2025–2026)
| Version | Type | Modification |
|---|---|---|
| 7.1.0 2026-05-20 | Corrigé | Corrections de bugs et refactorisation du code |
| 7.0.0 2025-12-04 | Modifié | Gestion des licences adaptée ; une clé de licence valide est requise |
| 6.9.0 2025-12-04 | Modifié | OBJECTSUSAGE écrit sa sortie dans un fichier au lieu d'un objet VARA |
| 6.8.0 2025-11-19 | Nouveau | Action TASKSTOGGLE |
| 6.7.0 2025-11-19 | Modifié | Filtres harmonisés pour toutes les actions TASKS* |
| 6.6.0 2025-11-15 | Nouveau | Action TASKSREAD |
| 6.5.0 2025-11-14 | Nouveau | Action OBJECTSEXECUTE |
| 6.4.0 2025-11-13 | Nouveau | Actions TASKSPERIODICREAD et TASKSPERIODICEXECUTE |
| 6.3.0 2025-10-29 | Nouveau | Actions AGENTAUTHORIZATIONSREAD et AGENTAUTHORIZATIONSSET |
| Corrigé | La configuration n'apparaît plus dans le rapport du job lorsque le mode débogage est désactivé | |
| 6.2.0 2025-10-13 | Modifié | Gestion des licences adaptée |
| 6.1.0 2025-06-13 | Nouveau | Actions FOLDERSTRUCTUREREAD et FOLDERSTRUCTURECREATE |
| 6.0.1 2025-06-12 | Corrigé | OBJECTSMOVE : erreur dans la méthode de traitement |
| Corrigé | OBJECTSLINKDELETE : nom d'include erroné | |
| 6.0.0 2025-02-11 | Modifié | CONFIGURATION_ADD, CONFIGURATION_REMOVE et CONFIGURATION_UPDATE : « connection » renommé en « configuration » |
Versions 4.0.0 – 5.1.2 (2024–2025)
| Version | Type | Modification |
|---|---|---|
| 5.1.2 2025-01-10 | Modifié | Le contrôle de validité prend en charge les noms Automic SaaS ($@@$) |
| 5.1.1 2024-11-11 | Corrigé | EXPORTCHANGE peut modifier les attributs des tâches JSCH |
| 5.1.0 2024-11-11 | Nouveau | Actions WORKFLOWREMOVETASK et TASKSREMOVE |
| 5.0.0 2024-11-07 | Modifié | Nettoyage et renommage partiel des actions |
| Supprimé | Actions OBJECTSCREATE et OBJECTSRENAME | |
| Modifié | Actions *TOFILE et *FROMFILE renommées sans le suffixe | |
| Modifié | ANALYSEUSAGE renommée en OBJECTSUSAGE | |
| Modifié | READHOSTGROUPTOFILE et CREATEHOSTGROUPFROMFILE renommées en AGENTGROUPSREAD et AGENTGROUPSCREATE | |
| Modifié | READLOGINTOFILE et CREATELOGINFROMFILE renommées en LOGINSREAD et LOGINSCREATE | |
| Modifié | MERGESCHEDULE et RESETSCHEDULE renommées en SCHEDULEMERGE et SCHEDULERESET | |
| Modifié | REMOVELINKSFROMFOLDER renommée en OBJECTSLINKDELETE | |
| Modifié | AGENTGROUPSREAD et AGENTGROUPSCREATE : MODE accepte ANY, LOAD, ALL, NEXT ou FIRST au lieu de lettres isolées | |
| Modifié | CALENDARMERGE et SCHEDULEMERGE : nouveau paramètre Replace | |
| Corrigé | OBJECTSRELATIONS : le mode transport fonctionne à nouveau | |
| 4.2.1 2024-11-05 | Corrigé | CONFIGURATION_UPDATE : variable CONFIG_NAME supprimée |
| 4.1.0 2024-09-12 | Nouveau | Action de mise à jour d'une configuration existante (le mot de passe doit être saisi à nouveau) |
| 4.0.0 2024-09-09 | Modifié | ENCRYPT : nouvelle méthode de chiffrement, incompatible avec la précédente |
| Modifié | L'ajout d'une configuration chiffre automatiquement le champ du mot de passe |
Versions 3.0.0 – 3.9.0
| Version | Type | Modification |
|---|---|---|
| 3.9.0 2024-09-06 | Modifié | Variable JAVACMD : toutes les actions, CONFIGURATION_ADD et ENCRYPT peuvent s'exécuter avec un exécutable Java défini par l'utilisateur |
| 3.8.0 2024-05-24 | Modifié | commons.io retiré des bibliothèques ; EXPORTCHANGE utilise à la place les fonctions standard de Java |
| 3.7.2 2024-02-29 | Modifié | Action Pack renommé en PCK.TRICISE_AUT_CLI |
| 3.7.1 2023-12-01 | Corrigé | EXPORTCHANGE : les titres contenant un astérisque étaient traités deux fois |
| 3.7.0 2023-09-19 | Modifié | ANALYSEUSAGE : nouveaux paramètres d'entrée OBJECT, FILE, FOLDER et VARA |
| Nouveau | Action OBJECTSRENAME (préfixe et suffixe, sans remplacement des références) | |
| 3.6.3 2023-06-16 | Modifié | WORKFLOWADDTASK : nouveaux paramètres facultatifs format, removeredundancies et closetasks |
| 3.6.2 2023-06-16 | Supprimé | Action MOVEFROMFOLDER, remplacée par OBJECTSMOVE |
| 3.6.1 2023-06-15 | Nouveau | Action OBJECTSMOVE |
| Corrigé | Objects Delete : paramètre deletesource | |
| 3.6.0 2023-06-14 | Nouveau | Actions WORKFLOWTASKACTIVE, WORKFLOWTASKEARLIEST et GENERICCOMMAND |
| 3.5.3 2023-03-29 | Modifié | Tasks Deactivate utilise le filtre de l'API au lieu d'expressions régulières |
| 3.5.2 2023-02-23 | Corrigé | Objects Create peut créer uniquement des dossiers |
| 3.5.1 2023-02-21 | Corrigé | Les liens sont ajoutés dans ACTIONS/CUSTOM au lieu de ACTIONS/CAPTURE, car un export les supprimait |
| 3.5.0 2023-02-16 | Modifié | Nouveau concept de build avec aut_cli.jar et aut_cli_base.jar |
| 3.4.1 2023-02-16 | Modifié | Action Pack renommé en PCK.CAPTURE_AUT_CLI |
| 3.4.0 | Nouveau | Action TASKSMONITORING |
| 3.3.0 | Nouveau | Actions USERSETTITLE (ne fait plus partie du pack) et USERCHECKAUTHORIZATIONS (aujourd’hui USERAUTHORIZATIONSCHECK) |
| 3.2.2 | Corrigé | Schedule Reset : l'heure de début doit être supérieure ou égale au début de la fenêtre |
| 3.2.1 | Corrigé | Cache de l'arborescence des dossiers : modification de la recherche de dossiers annulée |
| 3.2.0 | Modifié | Objects Transport : paramètres includeArchiveKey1, includeArchiveKey2 et excludeName supprimés, includeName ajouté, transport des dossiers plus rapide |
| 3.1.2 | Corrigé | Encrypt : champ de connexion supprimé |
| 3.1.1 | Corrigé | Contrôle de licence |
| 3.1.0 | Nouveau | Actions CONFIGURATION_ADD (avec chiffrement automatique du mot de passe) et CONFIGURATION_REMOVE |
| Modifié | ENCRYPT publie la variable &AUT_CLI_ENCRYPTED_PASSWORD# | |
| 3.0.2 | Modifié | Les objets de configuration ne sont plus écrasés lors des mises à jour |
| 3.0.1 | Modifié | @echo off supprimé |
| 3.0.0 | Modifié | Renommé en AUT_CLI (anciennement AEAPI) ; bibliothèques renommées en aut_cli_base.jar et config.ini |
Versions 2.1.0 – 2.4.0 (AEAPI)
| Version | Type | Modification |
|---|---|---|
| 2.4.0 | Modifié | Bibliothèque renforcée (obfusquée) et renommée en AutomicTools.jar |
| 2.3.1 | Modifié | Objects Remove Script : paramètres 4 et 5 facultatifs, sinon l'intégralité du script est supprimée |
| Modifié | Les champs de date du PromptSet ont pour valeur par défaut 01/01/2000 | |
| Modifié | Les variables de date utilisent YYYY-MM-DD au lieu de YYMMDD | |
| 2.3.0 | Corrigé | Les actions échouent comme prévu lorsque la licence n'est pas valide |
| Modifié | Entrées de clé supprimées du fichier de configuration | |
| 2.2.0 | Modifié | Bibliothèque nettoyée |
| Nouveau | Message History | |
| 2.1.1 | Modifié | Objects Create : nouveaux champs jobp.queue et jobp.children_queue ; script, prescript et postscript avec <br> |
| 2.1.0 | Nouveau | Entrée de liste de CP dans le fichier de configuration (connexion initiale uniquement, pas de rotation des CP) |
Questions fréquemment posées
Cliquez sur n'importe quelle question pour développer la réponse.
Qu'est-ce que l'Automation CLI Action Pack et que fait-il ?
L'Automation CLI Action Pack est une boîte à outils Tricise dédiée à la gestion et à la surveillance des systèmes Automic Automation en ligne de commande. Il regroupe 51 actions prêtes à l'emploi couvrant les opérations sur les objets (création, suppression, modification, exécution, import, export, remplacement, transport), les arborescences de dossiers, le pilotage des tâches, la gestion des calendriers et des plannings, l'analyse du système, l'édition des workflows et les contrôles de sécurité. Chaque opération courante en ligne de commande sur Automic est encapsulée dans une action configurable et réutilisable, intégrable dans n'importe quel workflow.
L'Automation CLI Action Pack s'exécute à la fois de manière interactive à partir de l'AWI et de manière autonome en mode batch, ce qui le rend adapté aussi bien à l'administration quotidienne qu'aux routines automatisées.
Quelles sont les versions d'Automic prises en charge ?
L'Automation CLI Action Pack nécessite Automic Automation V24 ou supérieur. La connexion utilise l'API Java standard Automic sur un point de terminaison JCP avec une communication sécurisée TLS. Vous avez besoin d'un hôte et d'un port JCP accessibles pour le client cible, et d'un certificat de confiance pour la connexion TLS.
Quelles sont les exigences techniques ?
L'Automation CLI Action Pack s'exécute dans le cadre d'une installation d'Action Pack Automic ; les exigences sont donc les suivantes :
- Automic Automation V24+ avec point d'accès JCP joignable
- Java 11 ou supérieur (JRE ou JDK) sur l'agent d'exécution
- L'Action Pack requis PCK.ITPA_SHARED installé dans le même client
- Un utilisateur Automic disposant des droits suffisants pour les actions que vous avez l'intention d'exécuter
- Une clé de licence valide d'Automation CLI Action Pack de Tricise
Comment installer l'Automation CLI Action Pack ?
Connectez-vous à n'importe quel client Automic sauf client 0, ouvrez Administration → Packs, installez éventuellement PCK.ITPA_SHARED d'abord, puis cliquez sur Install From File et sélectionnez le ZIP de l'Automation CLI Action Pack fourni par Tricise. L'installateur est le même pour les nouvelles installations et les mises à jour — pointez-le simplement vers le nouveau ZIP. Après l'installation, l'Action Pack se trouve dans le dossier PACKAGES . Ne le renommez pas et ne le déplacez pas.
Comment est configurée la connexion à Automic ?
Exécuter l'action CONFIGURATION_ADD depuis le dossier de l'Automation CLI Action Pack installé et remplissez les champs requis : nom de la configuration (modèle recommandé : SYSTEMNAME_CLIENT), le chemin de l'exécutable Java, l'hôte, le port, le client, le nom d'utilisateur, le département, le mot de passe et la clé de licence Tricise. Plusieurs configurations de connexion peuvent être créées en parallèle — une par combinaison système Automic / client. Utilisez CONFIGURATION_UPDATE pour en modifier une et CONFIGURATION_REMOVE pour en supprimer une.
Comment les mots de passe sont-ils stockés dans la configuration ?
Les mots de passe saisis dans CONFIGURATION_ADD ou CONFIGURATION_UPDATE sont chiffrés automatiquement avant d'être enregistrés dans la configuration. Depuis la version 4.0.0, l'Automation CLI Action Pack utilise une méthode de chiffrement incompatible avec les versions antérieures ; après une mise à niveau depuis une version plus ancienne, saisissez à nouveau les mots de passe avec CONFIGURATION_UPDATE. L'action dédiée ENCRYPT reste disponible pour chiffrer vous-même des valeurs.
Comment puis-je déplacer des objets entre environnements ?
Utilisez l'action OBJECTSEXPORT pour exporter les objets depuis l'environnement source, et OBJECTSIMPORT dans l'environnement cible pour les importer. Les deux actions prennent en charge une entrée par FILE, FOLDER, OBJECT ou liste VARA, avec des filtres d'inclusion/exclusion, la prise en charge de dossiers récursifs, le filtrage par date de modification et des nombres de threads configurables (10-20 threads recommandés pour les performances, mais surveillez la charge sur le système Automic source).
Si vous avez besoin de réécrire des valeurs pendant le déplacement (renommage d'hôtes, chemins spécifiques à l'environnement), utilisez EXPORTCHANGE sur les fichiers XML exportés avant l'importation - il utilise la même syntaxe de fichier script que l'utilitaire Automic Change.
L'Automation CLI Action Pack peut-il s'exécuter sans surveillance en mode batch ?
Oui. Chaque action de l'Automation CLI Action Pack peut être exécutée aussi bien de manière interactive à partir de l'AWI que sans surveillance dans le cadre d'un workflow. Pour une utilisation en mode batch, les valeurs des paramètres sont normalement fournies via le PromptSet de l'action, via des variables de workflow, ou — si vous connaissez déjà la syntaxe du module sous-jacent — directement via l'action GENERICCOMMAND , qui permet de passer une ligne de commande brute.
Comment nettoyer les objets inutilisés ou obsolètes en toute sécurité ?
La procédure recommandée se déroule en deux étapes. Exécutez d'abord OBJECTSUSAGE sur le dossier ou la liste d'objets cible : l'action analyse l'état d'utilisation et les compteurs de statistiques de chaque objet et écrit le résultat dans un fichier (depuis la version 6.9.0 ; les versions antérieures l'écrivaient dans un objet Variable). Examinez le résultat pour confirmer quels objets peuvent réellement être supprimés sans risque. Transmettez ensuite la liste confirmée à OBJECTSDELETE, qui accepte un fichier comme source d'entrée, afin de supprimer les objets en un lot contrôlé et reproductible.
Comment effectuer des modifications en masse lors de l'exportation ?
Utilisez l'action EXPORTCHANGE de l'Automation CLI Action Pack. Il modifie les objets XML exportés en utilisant la même syntaxe de fichier script que l'utilitaire Automic Change - pointez-le vers le dossier d'exportation et un fichier de modification avec vos règles, et activez éventuellement le traitement récursif pour les sous-dossiers. Parfait pour les renommages d'hôtes, les réécritures de chemins et autres transformations spécifiques à l'environnement entre DEV, TEST et PROD.
Comment désactiver ou modifier en bloc les états des tâches ?
Utilisation TASKSDEACTIVATE pour une désactivation en bloc, filtrée par nom de tâche, type, agent ou file d'attente. Pour modifier les codes d'état des tâches (par exemple, pour forcer une tâche à l'état 1900 = ENDED_OK), utilisez TASKSMODIFYSTATE - il accepte tout code d'état Automic valide et propose en option une désactivation automatique après le changement d'état. Pour lister et surveiller sans modification, utilisez TASKSMONITORING.
Pour supprimer des tâches, utilisez TASKSREMOVE ; pour changer leur état en masse, utilisez TASKSTOGGLE. Depuis la version 6.7.0, toutes les actions TASKS* partagent les mêmes options de filtre.
Comment vérifier si des utilisateurs d'un client ont les droits SUPERUSER ?
Exécutez l'action USERAUTHORIZATIONSCHECK de l'Automation CLI Action Pack. Elle analyse chaque utilisateur dans le client configuré et liste ceux qui ont des droits SUPERUSER. L'action ne prend aucun paramètre et est idéale comme audit de sécurité programmé.
Puis-je lire les messages du système avec des filtres ?
Oui. L'action MESSAGEHISTORY lit les messages système avec de nombreuses options de filtre : nom d'utilisateur, indicateurs de messages d'administration / de sécurité, type de message (ALL, ERROR, INFORMATION, FAILED, SUCCESS, WARNING), catégorie (ALL, ACCESS TO HOST, LOGIN, MESSAGE, OBJECT_ACCESS, PRIVILEGE), date de début / de fin (format YYYY-MM-DD) et un nombre maximal de résultats. Les messages trouvés sont restitués dans le rapport du job Automic Windows ou Unix qui exécute l'action.
Comment l'Automation CLI Action Pack est-il licencié ?
L'Automation CLI Action Pack est concédé sous licence sous la forme d'un achat unique par système Automic - pas d'abonnement récurrent, pas d'expiration. Le prix fixe est publié dans la boutique Tricise. La licence inclut le support produit Tricise et les mises à jour de compatibilité pour la ligne de produits Automic V24+ actuelle. Des clés de licence d'évaluation à durée limitée sont disponibles sur demande pour des travaux de validation de concept.