- Technischer Umfang & Konzept
- Installation — installieren, aktualisieren und deinstallieren
- Konfiguration — Referenz der Verbindungsparameter
- Aktionen — alle 51 Aktionen, nach Kategorien gruppiert
- Upgrade & Migration
- Versionshinweise
- FAQ
Konzept & technischer Umfang
Das Automation CLI Action Pack ist ein spezialisiertes Toolkit, mit dem Sie Broadcom Automic Automation-Systeme über die Kommandozeile verwalten und überwachen. Es bündelt 51 sofort einsetzbare Aktionen für Objektoperationen, Ordnerstrukturen, Task-Steuerung, Zeitplanung, Systemanalyse und Transporte. Das Automation CLI Action Pack läuft sowohl interaktiv als auch im Batch-Modus und eignet sich damit gleichermaßen für tägliche Administrationsaufgaben wie für unbeaufsichtigte Automatisierungsroutinen.
Was ein Action Pack ist
Action Packs sind vorgefertigte Integrationsmodule, die in Automatisierungsplattformen wie Automic Automation eingesetzt werden. Sie vereinfachen die Integration und Automatisierung von Drittanbieter-Anwendungen und -Services, indem sie eine Sammlung wiederverwendbarer Aktionen bereitstellen. Das Automation CLI Action Pack folgt demselben Modell: Jede routinemäßige Kommandozeilenoperation in Automic steht als konfigurierbare, wiederverwendbare Aktion bereit, die sich in jeden beliebigen Workflow einbinden lässt.
Hauptkomponenten & Funktionen
Das Automation CLI Action Pack deckt drei funktionale Bereiche ab:
Objekte
- Anlegen, Löschen, Massenänderungen
- Import und Export zwischen Umgebungen
- Kombinieren (Calendar-, Schedule- und Agentgroup-Objekte zusammenführen)
- Konvertieren und Transformieren über Change-Skripte
- Ordnerstrukturen lesen und anlegen
- Objekte gesammelt ausführen
Tasks
- Laufende und historische Tasks überwachen
- Status ändern, deaktivieren, Statuscodes anpassen
- Analyse über Task- und Meldungshistorie
- Tasks lesen, umschalten und entfernen, einschließlich periodischer Tasks
System
- Systemstatus und Konfiguration analysieren
- Referenzen, Abhängigkeiten und Objektnutzung ermitteln
- Transporte verwalten und Transportfälle leeren
- Agentenberechtigungen lesen und setzen
Zugang & Berechtigungen
Für die Nutzung des Automation CLI Action Pack sind die folgenden Zugriffe erforderlich:
- Ein Automic-Benutzer mit weitreichenden Rechten, die ausreichen, um die relevanten Aktionen im Zielmandanten des Systems auszuführen. Aktionen, die systemweite Objekte betreffen (z. B. Transport-Aktionen oder mandantenübergreifende Analysen), erfordern entsprechend erhöhte Rechte.
- Ein gültiger Lizenzschlüssel für das Automation CLI Action Pack, bereitgestellt durch Tricise. Zeitlich begrenzte Testschlüssel sind auf Anfrage erhältlich.
Anforderungen & Kompatibilität
Automic Automation
- Mindestversion: Automic Automation V24
- Erreichbarer JCP-Endpunkt (Host und Port) für den Zielmandanten
- Vertrauenswürdiges Zertifikat für die TLS-Kommunikation
Java Runtime Environment (JRE)
- Mindestversion: Java 11 (JRE oder JDK)
- Verfügbar auf dem Agenten, der die Aktionen des Automation CLI Action Pack ausführen wird
- Entweder über die Umgebungsvariable PATH erreichbar oder als voll qualifizierter Pfad angegeben (zum Beispiel C:\Program Files\Java\jdk-17\bin)
ITPA Shared Action Pack
- Das Automation CLI Action Pack hängt vom Action Pack PCK.ITPA_SHARED ab und sollte zuerst installiert werden, falls es noch nicht vorhanden ist
Installation
Das Automation CLI Action Pack wird über den standardmäßigen Automic-Action-Pack-Mechanismus installiert. Es kann in jedem Mandanten des Automic-Automation-Systems installiert werden, außer in Mandant 0. Dieselbe Vorgehensweise gilt sowohl für die Erstinstallation als auch für Updates auf eine neuere Version.
Installieren oder aktualisieren
Deinstallieren
So entfernen Sie das Automation CLI Action Pack aus einem Mandanten:
Konfigurationsreferenz
Nach der Installation benötigt das Automation CLI Action Pack eine Verbindungskonfiguration zu einem bestehenden Automic-System und einem seiner Mandanten. Die Konfiguration wird durch Ausführen der Aktion CONFIGURATION_ADD aus dem AWI heraus angelegt. Mehrere Konfigurationen können parallel erstellt werden — eine pro Kombination aus Automic-System und Mandant.
Einrichtungs-Workflow
Geben Sie die Verbindungsdetails ein (siehe Parameterreferenz unten). Die Namenskonvention SYSTEMNAME_CLIENT wird empfohlen (zum Beispiel AUTOMIC_0100).
Mit CONFIGURATION_UPDATE ändern Sie eine bestehende Konfiguration, mit CONFIGURATION_REMOVE löschen Sie eine Konfiguration. Neue Konfigurationen lassen sich jederzeit durch erneutes Ausführen von CONFIGURATION_ADD hinzufügen.
Verbindungsparameter
Pflichtparameter der Aktion CONFIGURATION_ADD / UPDATE:
| Parameter | Beschreibung |
|---|---|
| Configuration Name | Freitextname für die Verbindung. Empfohlene Syntax: SYSTEMNAME_CLIENT, zum Beispiel AUTOMIC_0100. |
| Java Executable | Java-Installation (JRE oder JDK), die vom ausführenden Agenten verwendet wird. java genügt, wenn Java im PATH liegt; andernfalls den vollständigen Pfad angeben (zum Beispiel C:\Program Files\Java\jdk-17\bin). Mindestversion: Java 11. |
| Host | Hostname oder FQDN des Automic-Systems mit laufenden JCPs (zum Beispiel myserver.com). |
| Port | Port des JCP auf dem Automic-System (zum Beispiel 8443). |
| Client | Zielmandant des Automic-Systems (zum Beispiel 0100). |
| User Name | Automic-Benutzername (zum Beispiel UC). |
| Department | Abteilung des Automic-Benutzers (zum Beispiel UC). |
| Password | Passwort des Automic-Benutzers. CONFIGURATION_ADD und CONFIGURATION_UPDATE verschlüsseln es automatisch; wenn Sie eine Konfiguration aktualisieren, geben Sie das Passwort erneut ein. |
| Key | Lizenzschlüssel für das Automation CLI Action Pack, bereitgestellt durch Tricise. Zeitlich begrenzte Testschlüssel sind auf Anfrage erhältlich. |
Optionale Parameter
| Parameter | Beschreibung |
|---|---|
| Logging | Pfadmuster für Log-Dateien, zum Beispiel ./log/AUT_CLI_log_##.txt. |
| Log Count | Maximale Anzahl der Log-Dateien für die Log-Rotation. |
| Tracing | Pfadmuster für Trace-Dateien, zum Beispiel ./log/AUT_CLI_trc_##.txt. |
| Trace Count | Maximale Anzahl der Trace-Dateien für die Trace-Rotation. |
| CP List | Liste alternativer Kommunikationsprozesse (CPs) zusätzlich zu Host/Port (zum Beispiel myserver.com:8444). |
| LogToStdOut | Log-Ausgabe auf der Kommandozeile ausgeben. Zum Aktivieren auf 1 setzen. |
| Debug | Debug-Modus aktivieren. Zum Aktivieren auf 1 setzen. Bei ausgeschaltetem Debug-Modus (0) wird die Konfiguration nicht in den Job-Report geschrieben. |
| TrustedCertFolder | Ordner mit vertrauenswürdigen Zertifikaten des ausführenden Agenten (zum Beispiel C:\temp\myCerts). |
Aktionsreferenz
Das Automation CLI Action Pack enthält 51 Aktionen, die hier nach Funktionsbereichen gruppiert sind. Jede Aktion hat einen vollqualifizierten Automic-Objektnamen nach dem Muster PCK.TRICISE_AUT_CLI.PUB.ACTION.<NAME>. Alle Aktionen lassen sich interaktiv aus dem AWI oder unbeaufsichtigt im Batch-Modus als Teil eines Workflows ausführen.
Konfigurationsmanagement
Verbindungskonfigurationen des Automation CLI Action Pack selbst verwalten.
| Aktion | Objektname | Beschreibung |
|---|---|---|
| Configuration Add / Update | CONFIGURATION_ADD CONFIGURATION_UPDATE |
Verbindungskonfiguration zu einem bestimmten Automic-System und Mandanten anlegen oder aktualisieren. Das Passwort wird automatisch verschlüsselt. |
| Configuration Remove | CONFIGURATION_REMOVE | Eine bestehende Verbindungskonfiguration entfernen. |
| Encrypt | ENCRYPT | Passwörter mit derselben Technik verschlüsseln, die auch maskierte Felder in Automic-PromptSets verwenden — zur sicheren Ablage in der Konfiguration. |
| Generic Command | GENERICCOMMAND | Ein beliebiges internes Modul des Automation CLI Action Pack direkt über Kommandozeilen-Syntax ausführen. Nützlich für Power-User, die die Parameter bereits kennen und die PromptSet-UI überspringen möchten. |
Objektoperationen
Automic-Objekte und Ordnerstrukturen über die Kommandozeile anlegen, ändern, löschen, verschieben, ausführen und analysieren.
| Aktion | Objektname | Beschreibung |
|---|---|---|
| Agentgroups Create | AGENTGROUPSCREATE | Agentgroup-Objekte gesammelt aus einer strukturierten Eingabedatei anlegen. |
| Agentgroups Read | AGENTGROUPSREAD | Die Definition bestehender Agentgroups in eine strukturierte Ausgabedatei exportieren (kompatibel mit Agentgroups Create). |
| Folder Structure Create | FOLDERSTRUCTURECREATE | Ordnerstruktur aus einer strukturierten Eingabedatei anlegen, zum Beispiel um einen neuen Mandanten vorzubereiten. |
| Folder Structure Read | FOLDERSTRUCTUREREAD | Ordnerstruktur eines Mandanten in eine strukturierte Ausgabedatei exportieren (kompatibel mit Folder Structure Create). |
| Logins Create | LOGINSCREATE | Login-Objekte gesammelt aus einer strukturierten Eingabedatei anlegen. Bestehende Passwörter werden beim Ersetzen zurückgesetzt. |
| Logins Read | LOGINSREAD | Die Definition bestehender Login-Objekte in eine strukturierte Ausgabedatei exportieren (kompatibel mit Logins Create). |
| Objects Add Filter | OBJECTSADDFILTER | Filterobjekte basierend auf einer strukturierten Eingabedatei an bestehende Objekte anhängen. Neue Filter werden am Ende der Filterliste angehängt. |
| Objects Add Script | OBJECTSADDSCRIPT | Skriptinhalte in bestehende Objekte einfügen oder anhängen — basierend auf einer Skriptdatei und den Zielobjekten. |
| Objects Add Value | OBJECTSADDVALUE | Werte aus einer Eingabedatei zu Variablenobjekten (VARA) hinzufügen. |
| Objects Delete | OBJECTSDELETE | Objekte basierend auf einer strukturierten Eingabequelle (Datei, Ordner, Einzelobjekt oder VARA-Liste) löschen — mit Include-/Exclude-Filtern. |
| Objects Execute | OBJECTSEXECUTE | Objekte gesammelt ausführen, zum Beispiel eine Liste von Jobs oder Workflows in einem Lauf. |
| Objects Link Delete | OBJECTSLINKDELETE | Objektverknüpfungen / Referenzen zwischen Objekten entfernen. |
| Objects Move | OBJECTSMOVE | Objekte zwischen Automic-Ordnern verschieben — mit Auswahl der Eingabequelle und Filtern. |
| Objects Relations | OBJECTSRELATIONS | Die Beziehungen / Abhängigkeiten von Objekten ermitteln und exportieren. |
| Objects Remove Filter | OBJECTSREMOVEFILTER | Filterobjekte aus vorhandenen Objekten entfernen, basierend auf einer strukturierten Eingabedatei. |
| Objects Remove Script | OBJECTSREMOVESCRIPT | Skriptinhalte aus vorhandenen Objekten entfernen. |
| Objects Remove Value | OBJECTSREMOVEVALUE | Werte aus Variablenobjekten (VARA) basierend auf einer Eingabedatei entfernen. |
| Objects Replace | OBJECTSREPLACE | Zeichenketteninhalte innerhalb bestehender Objekte basierend auf Such- und Ersetzungsregeln ersetzen. |
| Objects Replace Attribute | OBJECTSREPLACEATTRIBUTE | Bestimmte Attributwerte in mehreren Objekten in einem Batch ersetzen. |
| Objects Usage | OBJECTSUSAGE | Mandanten auf Objektebene analysieren – Verwendungsstatus und Anzahl der Statistikeinträge. Das Ergebnis wird in eine Datei geschrieben (seit Version 6.9.0; frühere Versionen nutzten ein VARA-Objekt). Ideale Grundlage für Aufräumaktionen. |
Import, Export & Transport
Objekte zwischen Umgebungen verschieben, Exporte transformieren und Automic-Transportfälle verwalten.
| Aktion | Objektname | Beschreibung |
|---|---|---|
| Objects Export | OBJECTSEXPORT | Objekte aus dem Automic-System in einen Zielordner exportieren. Quelle kann FILE, FOLDER, OBJECT oder VARA sein — mit Include-/Exclude-Filtern, Option für rekursive Verarbeitung, Filter nach Änderungsdatum und konfigurierbarer Thread-Anzahl (10–20 Threads empfohlen). |
| Objects Import | OBJECTSIMPORT | Objekte aus einer zuvor exportierten Ordnerstruktur importieren. Unterstützt rekursiven Import, Ersetzen bei Konflikten, Exclude-Filter und konfigurierbare Thread-Anzahl. |
| Export Change | EXPORTCHANGE | Exportierte XML-Objekte mit derselben Skriptdatei-Syntax wie das Dienstprogramm Automic Change ändern. Nützlich für umgebungsspezifische Anpassungen vor dem erneuten Import. |
| Objects Transport | OBJECTSTRANSPORT | Das Transport-Flag für Objekte gesammelt setzen — basierend auf den Eingaben FILE / FOLDER / OBJECT / VARA mit Include- und Exclude-Filtern. |
| Transport Clear | TRANSPORTCLEAR | Den Transportfall des Mandanten leeren, auf den die aktive Verbindung verweist. Benötigt keine Parameter. |
Calendar- & Schedule-Objekte
Calendar- und Schedule-Objekte zusammenführen und zurücksetzen.
| Aktion | Objektname | Beschreibung |
|---|---|---|
| Calendar Merge | CALENDARMERGE | Zwei Calendar-Objekte zu einem neuen dritten Calendar-Objekt zusammenführen — mit optionalem Replace. |
| Schedule Merge | SCHEDULEMERGE | Zwei Schedule-Objekte zu einem neuen dritten Schedule-Objekt zusammenführen — mit optionalem Replace. |
| Schedule Reset | SCHEDULERESET | Einträge aktiver Schedule-Objekte innerhalb eines Zeitfensters zurücksetzen. Besonders nützlich bei langen Wartungsfenstern, wenn einzelne Tasks nach der Wiederherstellung des Systems erneut ausgeführt werden müssen. Verwenden Sie -ALL- zum Zurücksetzen aller Schedules. |
Task-Steuerung
Tasks – einschließlich periodischer Tasks – über die Kommandozeile lesen, überwachen, ändern, umschalten, deaktivieren und entfernen.
| Aktion | Objektname | Beschreibung |
|---|---|---|
| Tasks Monitoring | TASKSMONITORING | Tasks im Automic-System nach Name, Typ, Statuscode oder höchster Ausführungsnummer auflisten. Geeignet für skriptgesteuertes Monitoring und Dashboards. |
| Tasks Modify State | TASKSMODIFYSTATE | Den Statuscode von Tasks ändern (ein beliebiger gültiger Automic-Status, zum Beispiel 1900 = ENDED_OK) mit optionaler automatischer Deaktivierung nach der Änderung. |
| Tasks Deactivate | TASKSDEACTIVATE | Tasks gesammelt deaktivieren, gefiltert nach Name, Typ, Agent oder Queue. |
| Tasks Read | TASKSREAD | Tasks mit den einheitlichen TASKS*-Filtern lesen, zum Beispiel um vor einer weiteren Task-Aktion zu prüfen, was ein Filter auswählt. |
| Tasks Toggle | TASKSTOGGLE | Zustand von Tasks gesammelt umschalten, ausgewählt über die einheitlichen TASKS*-Filter. |
| Tasks Remove | TASKSREMOVE | Tasks gesammelt entfernen, ausgewählt über die einheitlichen TASKS*-Filter. |
| Tasks Periodic Read | TASKSPERIODICREAD | Periodische Tasks des Mandanten lesen. |
| Tasks Periodic Execute | TASKSPERIODICEXECUTE | Periodische Tasks gesammelt starten, zum Beispiel aus einer mit Tasks Periodic Read erstellten Liste. |
Workflow-Bearbeitung
Programmatische Änderung von Workflows – Tasks in Workflows hinzufügen, entfernen, schließen und anpassen.
| Aktion | Objektname | Beschreibung |
|---|---|---|
| Workflow Add Task | WORKFLOWADDTASK | Einen Task zu einem bestehenden Workflow hinzufügen — mit Konfiguration von Positionierung und Abhängigkeiten. |
| Workflow Remove Task | WORKFLOWREMOVETASK | Task aus einem bestehenden Workflow entfernen. |
| Workflow Close Tasks | WORKFLOWCLOSETASKS | Tasks in Workflows gesammelt schließen. |
| Workflow Task Active | WORKFLOWTASKACTIVE | Das Aktiv-Flag von Workflow-Tasks setzen. |
| Workflow Task Earliest | WORKFLOWTASKEARLIEST | Die früheste Startzeit von Workflow-Tasks festlegen. |
System & Sicherheit
Systemstatus, Systeminformationen, Meldungshistorie, Prüfung von Benutzerberechtigungen und Agentenberechtigungen.
| Aktion | Objektname | Beschreibung |
|---|---|---|
| Agent Authorizations Read | AGENTAUTHORIZATIONSREAD | Mandantenberechtigungen von Agentenobjekten lesen. |
| Agent Authorizations Set | AGENTAUTHORIZATIONSSET | Mandantenberechtigungen von Agentenobjekten gesammelt setzen. |
| SystemInfo | SYSTEMINFO | Die Verbindung zum konfigurierten System testen und grundlegende Systeminformationen ausgeben. Eignet sich am besten als Verbindungsprüfung vor der Ausführung anderer Aktionen. Benötigt keine Parameter. |
| System Status | SYSTEMSTATUS | Den Mandantenstatus auf GO oder STOP setzen – nützlich für kontrollierte Wartungsfenster. |
| Message History | MESSAGEHISTORY | Systemmeldungen mit Filtern für Benutzer, Admin-/Sicherheits-Flag, Meldungstyp (ALL / ERROR / INFORMATION / FAILED / SUCCESS / WARNING), Kategorie, Datumsbereich und maximale Anzahl der Ergebnisse lesen. Die Ausgabe wird im Job-Report dargestellt. |
| User Authorizations Check | USERAUTHORIZATIONSCHECK | Alle Benutzer im Mandanten auf SUPERUSER-Rechte prüfen. Benötigt keine Parameter. Nützlich für regelmäßige Sicherheitsüberprüfungen. |
Upgrade & Migration
Automation CLI Action Pack aktualisieren: Das Verfahren ist dasselbe wie bei der Erstinstallation. Öffnen Sie Administration → Packs → Install From File, wählen Sie die neue ZIP-Datei aus und bestätigen Sie mit Install. Der Automic-Action-Pack-Mechanismus ersetzt Versionen automatisch.
Vor dem Upgrade
- Stellen Sie sicher, dass das benötigte PCK.ITPA_SHARED Action Pack in einer mit dem neuen Release des Automation CLI Action Pack kompatiblen Version vorliegt
- Erstellen Sie einen Snapshot oder ein Backup der aktuellen Installation, falls Ihre Umgebung Audit-Nachweise erfordert
- Pausieren Sie alle geplanten Workflows, die Aktionen des Automation CLI Action Pack verwenden, um Versionswechsel während eines Laufs zu vermeiden
Nach dem Upgrade
- Bestehende Verbindungskonfigurationen bleiben gültig. Ausnahme: Bei einem Upgrade von einer Version vor 4.0.0 geben Sie die Passwörter mit CONFIGURATION_UPDATE erneut ein, da sich das Verschlüsselungsverfahren geändert hat.
- Führen Sie die Aktion SYSTEMINFO für jede konfigurierte Verbindung als Smoke-Test aus
- Setzen Sie alle pausierten Workflows fort
Versionsspezifische Hinweise
- Version 6.9.0: OBJECTSUSAGE schreibt sein Ergebnis in eine Datei statt in ein VARA-Objekt. Passen Sie Folgeschritte an, die das VARA-Objekt lesen.
- Version 5.0.0: Mehrere Aktionen wurden umbenannt. Die Aktionen *TOFILE und *FROMFILE haben ihr Suffix verloren, aus ANALYSEUSAGE wurde OBJECTSUSAGE, aus READHOSTGROUPTOFILE und CREATEHOSTGROUPFROMFILE wurden AGENTGROUPSREAD und AGENTGROUPSCREATE, aus READLOGINTOFILE und CREATELOGINFROMFILE wurden LOGINSREAD und LOGINSCREATE, und aus MERGESCHEDULE und RESETSCHEDULE wurden SCHEDULEMERGE und SCHEDULERESET. OBJECTSCREATE und OBJECTSRENAME wurden entfernt. Workflows, die die alten Namen aufrufen, müssen angepasst werden.
- Version 5.0.0: Der Parameter MODE von AGENTGROUPSREAD und AGENTGROUPSCREATE akzeptiert ANY, LOAD, ALL, NEXT oder FIRST statt einzelner Buchstaben.
- Version 3.7.2: Das Action Pack wurde in PCK.TRICISE_AUT_CLI umbenannt; die Objektnamen älterer Installationen ändern sich entsprechend.
Versionshinweise
Alle Versionen des Automation CLI Action Pack und was sich jeweils geändert hat. Versionen vor 3.0.0 erschienen unter dem Namen AEAPI.
v7.1.1 (aktuell) · 2026-10-06
| Version | Typ | Änderung |
|---|---|---|
| 7.1.1 2026-10-06 | Behoben | Workflow Add Task: Spaltenverschiebung korrigiert |
| Geändert | Module für Benutzergruppen: veraltete Felder entfernt |
Frühere Versionen
Versionen 6.0.0 – 7.1.0 (2025–2026)
| Version | Typ | Änderung |
|---|---|---|
| 7.1.0 2026-05-20 | Behoben | Fehlerbehebungen und Refactoring der Codebasis |
| 7.0.0 2025-12-04 | Geändert | Lizenzverarbeitung angepasst; ein gültiger Lizenzschlüssel ist erforderlich |
| 6.9.0 2025-12-04 | Geändert | OBJECTSUSAGE schreibt seine Ausgabe in eine Datei statt in ein VARA-Objekt |
| 6.8.0 2025-11-19 | Neu | Aktion TASKSTOGGLE |
| 6.7.0 2025-11-19 | Geändert | Einheitliche Filter für alle TASKS*-Aktionen |
| 6.6.0 2025-11-15 | Neu | Aktion TASKSREAD |
| 6.5.0 2025-11-14 | Neu | Aktion OBJECTSEXECUTE |
| 6.4.0 2025-11-13 | Neu | Aktionen TASKSPERIODICREAD und TASKSPERIODICEXECUTE |
| 6.3.0 2025-10-29 | Neu | Aktionen AGENTAUTHORIZATIONSREAD und AGENTAUTHORIZATIONSSET |
| Behoben | Die Konfiguration wird bei ausgeschaltetem Debug-Modus nicht mehr im Job-Report angezeigt | |
| 6.2.0 2025-10-13 | Geändert | Lizenzverarbeitung angepasst |
| 6.1.0 2025-06-13 | Neu | Aktionen FOLDERSTRUCTUREREAD und FOLDERSTRUCTURECREATE |
| 6.0.1 2025-06-12 | Behoben | OBJECTSMOVE: Fehler in der Prozessmethode |
| Behoben | OBJECTSLINKDELETE: falscher Include-Name | |
| 6.0.0 2025-02-11 | Geändert | CONFIGURATION_ADD, CONFIGURATION_REMOVE und CONFIGURATION_UPDATE: „connection“ in „configuration“ umbenannt |
Versionen 4.0.0 – 5.1.2 (2024–2025)
| Version | Typ | Änderung |
|---|---|---|
| 5.1.2 2025-01-10 | Geändert | Gültigkeitsprüfung unterstützt Namen aus Automic SaaS ($@@$) |
| 5.1.1 2024-11-11 | Behoben | EXPORTCHANGE kann Attribute von JSCH-Tasks ändern |
| 5.1.0 2024-11-11 | Neu | Aktionen WORKFLOWREMOVETASK und TASKSREMOVE |
| 5.0.0 2024-11-07 | Geändert | Bereinigung und teilweise Umbenennung der Aktionen |
| Entfernt | Aktionen OBJECTSCREATE und OBJECTSRENAME | |
| Geändert | Aktionen *TOFILE und *FROMFILE umbenannt (Suffix entfernt) | |
| Geändert | ANALYSEUSAGE in OBJECTSUSAGE umbenannt | |
| Geändert | READHOSTGROUPTOFILE und CREATEHOSTGROUPFROMFILE in AGENTGROUPSREAD und AGENTGROUPSCREATE umbenannt | |
| Geändert | READLOGINTOFILE und CREATELOGINFROMFILE in LOGINSREAD und LOGINSCREATE umbenannt | |
| Geändert | MERGESCHEDULE und RESETSCHEDULE in SCHEDULEMERGE und SCHEDULERESET umbenannt | |
| Geändert | REMOVELINKSFROMFOLDER in OBJECTSLINKDELETE umbenannt | |
| Geändert | AGENTGROUPSREAD und AGENTGROUPSCREATE: MODE akzeptiert ANY, LOAD, ALL, NEXT oder FIRST statt einzelner Buchstaben | |
| Geändert | CALENDARMERGE und SCHEDULEMERGE: neuer Parameter Replace | |
| Behoben | OBJECTSRELATIONS: Transportmodus funktioniert wieder | |
| 4.2.1 2024-11-05 | Behoben | CONFIGURATION_UPDATE: Variable CONFIG_NAME entfernt |
| 4.1.0 2024-09-12 | Neu | Aktion zum Aktualisieren einer bestehenden Konfiguration (das Passwort muss erneut eingegeben werden) |
| 4.0.0 2024-09-09 | Geändert | ENCRYPT: neues Verschlüsselungsverfahren, nicht kompatibel mit dem bisherigen |
| Geändert | Beim Hinzufügen einer Konfiguration wird das Passwortfeld automatisch verschlüsselt |
Versionen 3.0.0 – 3.9.0
| Version | Typ | Änderung |
|---|---|---|
| 3.9.0 2024-09-06 | Geändert | Variable JAVACMD: Alle Aktionen, CONFIGURATION_ADD und ENCRYPT können mit einer selbst definierten ausführbaren Java-Datei laufen |
| 3.8.0 2024-05-24 | Geändert | commons.io aus den Bibliotheken entfernt; EXPORTCHANGE verwendet stattdessen Java-Standardfunktionen |
| 3.7.2 2024-02-29 | Geändert | Action Pack in PCK.TRICISE_AUT_CLI umbenannt |
| 3.7.1 2023-12-01 | Behoben | EXPORTCHANGE: Titel mit Sternchen wurden doppelt verarbeitet |
| 3.7.0 2023-09-19 | Geändert | ANALYSEUSAGE: neue Eingabeparameter OBJECT, FILE, FOLDER und VARA |
| Neu | Aktion OBJECTSRENAME (Präfix und Suffix, ohne Ersetzen von Referenzen) | |
| 3.6.3 2023-06-16 | Geändert | WORKFLOWADDTASK: neue optionale Parameter format, removeredundancies und closetasks |
| 3.6.2 2023-06-16 | Entfernt | Aktion MOVEFROMFOLDER, ersetzt durch OBJECTSMOVE |
| 3.6.1 2023-06-15 | Neu | Aktion OBJECTSMOVE |
| Behoben | Objects Delete: Parameter deletesource | |
| 3.6.0 2023-06-14 | Neu | Aktionen WORKFLOWTASKACTIVE, WORKFLOWTASKEARLIEST und GENERICCOMMAND |
| 3.5.3 2023-03-29 | Geändert | Tasks Deactivate verwendet den API-Filter statt regulärer Ausdrücke |
| 3.5.2 2023-02-23 | Behoben | Objects Create kann auch nur Ordner anlegen |
| 3.5.1 2023-02-21 | Behoben | Links werden in ACTIONS/CUSTOM statt in ACTIONS/CAPTURE angelegt, da ein Export sie gelöscht hat |
| 3.5.0 2023-02-16 | Geändert | Neues Build-Konzept mit aut_cli.jar und aut_cli_base.jar |
| 3.4.1 2023-02-16 | Geändert | Action Pack in PCK.CAPTURE_AUT_CLI umbenannt |
| 3.4.0 | Neu | Aktion TASKSMONITORING |
| 3.3.0 | Neu | Aktionen USERSETTITLE (nicht mehr Teil des Packs) und USERCHECKAUTHORIZATIONS (heute USERAUTHORIZATIONSCHECK) |
| 3.2.2 | Behoben | Schedule Reset: Die Startzeit darf nicht vor dem Beginn des Zeitfensters liegen |
| 3.2.1 | Behoben | Cache des Ordnerbaums: Änderung bei der Ordnersuche zurückgenommen |
| 3.2.0 | Geändert | Objects Transport: Parameter includeArchiveKey1, includeArchiveKey2 und excludeName entfernt, includeName hinzugefügt, schnellerer Transport von Ordnern |
| 3.1.2 | Behoben | Encrypt: Verbindungsfeld entfernt |
| 3.1.1 | Behoben | Lizenzprüfung |
| 3.1.0 | Neu | Aktionen CONFIGURATION_ADD (mit automatischer Passwortverschlüsselung) und CONFIGURATION_REMOVE |
| Geändert | ENCRYPT veröffentlicht die Variable &AUT_CLI_ENCRYPTED_PASSWORD# | |
| 3.0.2 | Geändert | Die Konfigurationsobjekte werden bei Updates nicht mehr überschrieben |
| 3.0.1 | Geändert | @echo off entfernt |
| 3.0.0 | Geändert | In AUT_CLI umbenannt (früher AEAPI); Bibliotheken in aut_cli_base.jar und config.ini umbenannt |
Versionen 2.1.0 – 2.4.0 (AEAPI)
| Version | Typ | Änderung |
|---|---|---|
| 2.4.0 | Geändert | Bibliothek gehärtet (obfuskiert) und in AutomicTools.jar umbenannt |
| 2.3.1 | Geändert | Objects Remove Script: Parameter 4 und 5 optional, andernfalls wird das gesamte Script entfernt |
| Geändert | Datumsfelder im PromptSet standardmäßig auf 01/01/2000 gesetzt | |
| Geändert | Datumsvariablen verwenden YYYY-MM-DD statt YYMMDD | |
| 2.3.0 | Behoben | Die Aktionen brechen korrekt ab, wenn die Lizenz ungültig ist |
| Geändert | Schlüsseleinträge aus der Konfigurationsdatei entfernt | |
| 2.2.0 | Geändert | Bibliothek bereinigt |
| Neu | Message History | |
| 2.1.1 | Geändert | Objects Create: neue Felder jobp.queue und jobp.children_queue; Script, Prescript und Postscript mit <br> |
| 2.1.0 | Neu | Eintrag für die CP-Liste in der Konfigurationsdatei (nur für die erste Anmeldung, keine CP-Rotation) |
Häufig gestellte Fragen
Klicken Sie auf eine Frage, um die Antwort aufzuklappen.
Was ist das Automation CLI Action Pack und was leistet es?
Das Automation CLI Action Pack ist ein spezialisiertes Toolkit von Tricise, mit dem Sie Automic-Automation-Systeme über die Kommandozeile verwalten und überwachen. Es bündelt 51 sofort einsetzbare Aktionen für Objektoperationen (Anlegen, Löschen, Ändern, Ausführen, Importieren, Exportieren, Ersetzen, Transportieren), Ordnerstrukturen, Task-Steuerung, die Verwaltung von Calendar- und Schedule-Objekten, Systemanalyse, Workflow-Bearbeitung und Sicherheitsprüfungen. Jede routinemäßige Kommandozeilenoperation in Automic steht als konfigurierbare, wiederverwendbare Aktion bereit, die sich in jeden Workflow einbinden lässt.
Das Automation CLI Action Pack läuft sowohl interaktiv aus dem AWI als auch unbeaufsichtigt im Batch-Modus, wodurch es sich gleichermaßen für die tägliche Administration und für automatisierte Routinen eignet.
Welche Automic-Versionen werden unterstützt?
Das Automation CLI Action Pack erfordert Automic Automation V24 oder höher. Die Verbindung nutzt die Standard-Java-API von Automic über einen JCP-Endpunkt mit TLS-gesicherter Kommunikation. Sie benötigen einen erreichbaren JCP-Host und -Port für den Zielmandanten sowie ein vertrauenswürdiges Zertifikat für die TLS-Verbindung.
Was sind die technischen Anforderungen?
Das Automation CLI Action Pack läuft als Teil einer Automic-Action-Pack-Installation, daher gelten folgende Voraussetzungen:
- Automic Automation V24+ mit erreichbarem JCP-Endpunkt
- Java 11 oder höher (JRE oder JDK) auf dem ausführenden Agenten
- Das benötigte Action Pack PCK.ITPA_SHARED im selben Mandanten installiert
- Ein Automic-Benutzer mit ausreichenden Rechten für die Aktionen, die Sie ausführen möchten
- Ein gültiger Lizenzschlüssel von Tricise für das Automation CLI Action Pack
Wie installiere ich das Automation CLI Action Pack?
Melden Sie sich an einem beliebigen Automic-Mandanten an – außer Mandant 0, öffnen Sie Administration → Packs, installieren Sie optional PCK.ITPA_SHARED zuerst, klicken Sie dann auf Install From File und wählen Sie die von Tricise bereitgestellte ZIP-Datei des Automation CLI Action Pack aus. Das Installationsprogramm ist dasselbe für Neuinstallationen und Updates – geben Sie einfach die neue ZIP-Datei an. Nach der Installation befindet sich das Action Pack im Ordner PACKAGES und darf weder umbenannt noch verschoben werden.
Wie wird die Verbindung zu Automic konfiguriert?
Führen Sie die Aktion CONFIGURATION_ADD aus dem Ordner des installierten Automation CLI Action Pack aus und füllen Sie die erforderlichen Felder aus: Konfigurationsname (empfohlenes Muster: SYSTEMNAME_CLIENT), Pfad zur ausführbaren Java-Datei, Host, Port, Mandant, Benutzername, Abteilung, Passwort und Lizenzschlüssel von Tricise. Es können mehrere Verbindungskonfigurationen parallel angelegt werden – eine pro Kombination aus Automic-System und Mandant. Verwenden Sie CONFIGURATION_UPDATE zum Ändern einer Konfiguration und CONFIGURATION_REMOVE zum Löschen.
Wie werden Passwörter in der Konfiguration gespeichert?
In CONFIGURATION_ADD oder CONFIGURATION_UPDATE eingegebene Passwörter werden automatisch verschlüsselt, bevor sie in der Konfiguration gespeichert werden. Seit Version 4.0.0 verwendet das Automation CLI Action Pack ein Verschlüsselungsverfahren, das mit früheren Versionen nicht kompatibel ist; geben Sie die Passwörter nach einem Upgrade von einer älteren Version mit CONFIGURATION_UPDATE erneut ein. Die separate Aktion ENCRYPT steht weiterhin zur Verfügung, um Werte selbst zu verschlüsseln.
Wie verschiebe ich Objekte zwischen Umgebungen?
Verwenden Sie die OBJECTSEXPORT Aktion zum Exportieren von Objekten aus der Quellumgebung und OBJECTSIMPORT in der Zielumgebung zum Importieren. Beide Aktionen unterstützen die Eingabe über FILE, FOLDER, OBJECT oder VARA-Liste, mit Include-/Exclude-Filtern, rekursiver Ordnerunterstützung, Filterung nach Änderungsdatum und konfigurierbaren Thread-Anzahlen (10–20 Threads für optimale Leistung empfohlen, aber achten Sie auf die Auslastung des Automic-Quellsystems).
Wenn Sie beim Verschieben Werte ändern müssen (Host-Umbenennungen, umgebungsspezifische Pfade), verwenden Sie EXPORTCHANGE vor dem Import für die exportierten XML-Dateien — die Aktion verwendet dieselbe Skriptdatei-Syntax wie das Dienstprogramm Automic Change.
Kann das Automation CLI Action Pack unbeaufsichtigt im Batch-Modus ausgeführt werden?
Ja. Jede Aktion des Automation CLI Action Pack kann sowohl interaktiv aus dem AWI als auch unbeaufsichtigt als Teil eines Workflows ausgeführt werden. Für den Batch-Betrieb werden Parameterwerte normalerweise über das PromptSet der Aktion, über Workflowvariablen oder – wenn die zugrunde liegende Modulsyntax bereits bekannt ist – direkt über die Aktion GENERICCOMMAND bereitgestellt, mit der Sie eine Kommandozeile unverändert übergeben können.
Wie kann ich nicht mehr benötigte oder veraltete Objekte sicher bereinigen?
Empfohlen ist ein Vorgehen in zwei Schritten. Führen Sie zuerst OBJECTSUSAGE für den Zielordner oder die Objektliste aus – die Aktion analysiert jedes Objekt auf Verwendungsstatus und Anzahl der Statistikeinträge und schreibt das Ergebnis in eine Datei (seit Version 6.9.0; frühere Versionen schrieben es in ein Variablenobjekt). Prüfen Sie das Ergebnis, um festzustellen, welche Objekte sich tatsächlich gefahrlos entfernen lassen. Übergeben Sie die bestätigte Liste anschließend an OBJECTSDELETE, das eine Datei als Eingabequelle akzeptiert, um die Objekte kontrolliert und reproduzierbar in einem Batch zu entfernen.
Wie führe ich Massenänderungen beim Export durch?
Verwenden Sie die EXPORTCHANGE Aktion des Automation CLI Action Pack. Sie modifiziert exportierte XML-Objekte mit derselben Skriptsyntax wie das Dienstprogramm Automic Change – geben Sie den Exportordner und eine Änderungsdatei mit Ihren Regeln an und aktivieren Sie optional die rekursive Verarbeitung für Unterordner. Perfekt für Host-Umbenennungen, Pfadkorrekturen und andere umgebungsspezifische Transformationen zwischen DEV, TEST und PROD.
Wie kann ich Tasks gesammelt deaktivieren oder ihren Status ändern?
Verwenden Sie TASKSDEACTIVATE für Massendeaktivierungen, gefiltert nach Task-Name, Typ, Agent oder Queue. Wenn Sie Statuscodes von Tasks ändern möchten (zum Beispiel zum Erzwingen von 1900 = ENDED_OK), verwenden Sie TASKSMODIFYSTATE — die Aktion akzeptiert jeden gültigen Automic-Statuscode und bietet eine optionale automatische Deaktivierung nach der Statusänderung. Für Auflistung und Überwachung ohne Änderung verwenden Sie TASKSMONITORING.
Zum Entfernen von Tasks verwenden Sie TASKSREMOVE; um ihren Zustand gesammelt umzuschalten, verwenden Sie TASKSTOGGLE. Seit Version 6.7.0 nutzen alle TASKS*-Aktionen dieselben Filteroptionen.
Wie überprüfe ich, ob Benutzer in einem Mandanten SUPERUSER-Rechte haben?
Führen Sie die Aktion USERAUTHORIZATIONSCHECK des Automation CLI Action Pack aus. Sie scannt jeden Benutzer im konfigurierten Mandanten und listet diejenigen mit SUPERUSER-Rechten auf. Die Aktion benötigt keine Parameter und ist ideal als geplante Sicherheitsüberprüfung.
Kann ich Systemmeldungen mit Filtern lesen?
Ja. Die Aktion MESSAGEHISTORY liest Systemmeldungen mit umfangreichen Filteroptionen: Benutzername, Kennzeichen für Admin- und Sicherheitsmeldungen, Meldungstyp (ALL, ERROR, INFORMATION, FAILED, SUCCESS, WARNING), Kategorie (ALL, ACCESS TO HOST, LOGIN, MESSAGE, OBJECT_ACCESS, PRIVILEGE), Von- und Bis-Datum (Format YYYY-MM-DD) und eine Obergrenze für die Anzahl der Ergebnisse. Die gefundenen Meldungen werden in den Job-Report des Windows- oder Unix-Jobs in Automic geschrieben, der die Aktion ausführt.
Wie wird das Automation CLI Action Pack lizenziert?
Das Automation CLI Action Pack wird als Einmalkauf pro Automic-System lizenziert – ohne wiederkehrendes Abonnement, ohne Ablaufdatum. Den Festpreis finden Sie im Tricise-Shop. Die Lizenz umfasst den Produktsupport von Tricise sowie Kompatibilitätsupdates für die aktuelle Release-Linie Automic V24+. Zeitlich begrenzte Testlizenzschlüssel für Proof-of-Concept-Projekte sind auf Anfrage erhältlich.