Massenerstellung und -änderung von Objekten (Webinaraufzeichnung)

Automic-Objekte massenhaft erstellen und ändern

Eine lange Liste von Jobs, Scripts oder Workflows einzeln im Automic Web Interface anzulegen, kostet viel Zeit und erhöht das Fehlerrisiko. In dieser Webinar-Aufzeichnung zeigen wir, wie sich Automic-Objekte mit PowerShell und der REST API automatisiert erstellen und bearbeiten lassen. Dafür benötigen wir keine komplexe Softwareentwicklung: Einige Programmiergrundlagen, ein strukturiertes Vorgehen und ein Verständnis des Automic-Objektformats reichen für den Einstieg aus.

Automic-Objekte als JSON und XML verstehen

Zunächst untersuchen wir, wie Automic Objekte über die REST API in JSON und XML dargestellt werden. Wir exportieren mehrere Varianten eines Workflows und vergleichen sie in Visual Studio Code. So erkennen wir, welche Werte sich verändern, wenn wir beispielsweise eine Verbindung hinzufügen, einen Task verschieben oder Workflow Conditions konfigurieren.

Der Vergleich hilft uns dabei:

• relevante Attribute und Datenstrukturen zu identifizieren,
• Unterschiede zwischen JSON und XML nachzuvollziehen,
• geeignete Pfade für gezielte Änderungen zu finden,
• unveränderte Bereiche eines Objekts beizubehalten.

Online-Patching mit PowerShell und Automic REST API

Anschließend entwickeln wir ein PowerShell-Script, das ein vorhandenes Objekt direkt aus Automic abruft. Mit Invoke-RestMethod lesen wir die JSON-Daten ein, verändern gezielt einzelne Eigenschaften und schreiben das Ergebnis über die REST API zurück in das System.

Im Webinar ändern wir unter anderem allgemeine Attribute und den Process-Teil eines Objekts. Dabei sehen wir, wie verschachtelte JSON-Strukturen in PowerShell angesprochen werden und warum beim Konvertieren die benötigte Verarbeitungstiefe berücksichtigt werden muss. Das Vorgehen bildet die Grundlage, um dieselbe Änderung später auf viele Objekte anzuwenden.

Massenänderungen und Massenerstellung automatisieren

Aus einem einzelnen funktionierenden Request entsteht durch Schleifen und variable Eingabewerte eine wiederverwendbare Lösung. Wir können Objektnamen aus einer Liste verarbeiten, ein vorhandenes Objekt als Vorlage nutzen und definierte Eigenschaften für jede neue Variante anpassen.

Typische Anwendungsfälle sind:

• gleichartige Jobs oder Scripts aus einer Vorlage erzeugen,
• Attribute in mehreren Automic-Objekten vereinheitlichen,
• Process-Scripts automatisiert ersetzen oder ergänzen,
• wiederkehrende Änderungen reproduzierbar durchführen.

Workflow Conditions mit XML und XPath kopieren

Komplexer wird es bei Workflow Conditions. Hier verwenden wir XML und XPath, um die relevanten Knoten gezielt auszuwählen. Wir übernehmen Postconditions aus einem Quell-Task, entfernen vorhandene Bedingungen am Ziel und fügen den kopierten XML-Knoten an der gewünschten Position ein. So lassen sich auch umfangreiche Workflow-Konfigurationen automatisiert vervielfältigen.

Massenänderungen sicher vorbereiten

Automatisierte Änderungen können viele Objekte innerhalb kurzer Zeit beeinflussen. Deshalb sollten wir Ausgangsobjekte sichern, Scripts zuerst in einem Testmandanten ausführen und Ergebnisse sorgfältig kontrollieren. Die Beispiele verwenden PowerShell Core ab Version 7 und können damit auch auf Linux-Systemen eingesetzt werden.