In der Menüleiste des Client Command Editor finden Sie einige grundlegende Einstellungen zum Editor selbst, wie auch zum aktuell geladenen Client Command. Als Einträge sind Projekt, Ansicht sowie Fenster in der Menüleiste zu finden.

Projekt

Im Menüpunkt Projekt haben Sie grundsätzlich die Möglichkeiten, das aktuell geladene Client Command zu Speichern und den Editor zu Schließen. Des Weiteren können Sie hier die Eigenschaften des Client Command editieren. Ebenso können Sie die ACMP–Variablen editieren. Lesen Sie hierzu mehr den Abschnitt Variablen.

Ansicht

Über das Menü Ansicht lassen sich verschiedene Bereiche des Editors ab- und auch wieder zuschalten. Ebenso lässt sich angeben, welche Spalten im Skript – Bereich angezeigt werden sollen.
Zusätzlich lässt sich ein Kompatibilitätsmodus einschalten. Auf diese Weise lassen sich gezielt Client Commands ausblenden, die nicht zu einer bestimmten Windows Version kompatibel sind.
Mit dem Menüpunkt Sprache können Sie die Anzeigesprache der verfügbaren Befehle von englisch auf deutsch umstellen. Die Standardansichtssprache ist englisch.

Fenster

Über das Menü Fenster lässt sich die Anordnung der verschiedenen Bereiche ändern. Weiterhin können Sie zwischen mehreren geöffneten Commands umschalten.

Eigenschaften

In den Eigenschaften eines Client Command können Sie allgemeine Informationen hinterlegen, wie auch bestimmte Optionen und Bedingungen für das Client Command setzen. Allgemeine Informationen beziehen sich dabei auf das gesamte Client Command, wohingegen die Informationen Allgemeine Version und Bedingungen nur eine bestimmte Version des Client Command betreffen.

Allgemein

Unter Allgemein können Sie den Namen des Client Command angeben, sowie die Client Command-ID einsehen. Zusätzlich werden das Erstelldatum und das Datum der letzten Änderung angezeigt.

Optionen

Unter Optionen können Sie das Client Command zur interaktiven Benutzung freigeben, was dem User eines Clients gestattet, dieses Client Command selbstständig über den Command Launcher auszuführen. Wenn Sie das Client Command als QuickCommand anzeigen lassen, können Sie es über das Kontextmenü einer Abfrage der Abfrageverwaltung ausführen (siehe Jobs ausführen). Zusätzlich können Sie sich das Client Command direkt in Abfrageergebnissen anzeigen lassen. Markieren Sie dazu nur den entsprechenden Punkt Im Ribbon Tap "Abfrageaktionen" anzeigen in den Optionen.

Ab ACMP 4.0 lassen sich Client Commands parallel ausführen. Auf diese Weise wird verhindert, dass langlaufende Client Commands die Ausführung von kurzen Client Commands blockieren. Das bedeutet, dass grundsätzlich nicht alle Client Commands parallel laufen soll. Entsprechende Client Commands müssen explizit als parallel lauffähig in den Optionen markiert werden.

Es müssen jedoch einige Faktoren bei der parallelen Ausführung von Client Commands beachtet werden. Zunächst muss sichergestellt werden, dass Client Commands, die auf die gleichen Ressourcen (z.B. Dateien, Prozesse) zugreifen, nicht als parallel ausführbar markiert werden. Deshalb sollte  speziell die parallele Ausführung von MSI-Installationen vermieden werden.

Client Commands werden parallel ausgeführt, unabhängig davon, ob sie manuell oder automatisch über einen Client Task gestartet worden sind. Auch werden parallele Client Commands ausgeführt, wenn bereits ein nicht parallelfähiges Client Command ausgeführt wird. Um zu verhindern, dass zwei Client Commands auf die selbe Resource zugreifen, darf also keines der beiden als parallelfähig markiert sein.

Als Log-Optionen können Sie angeben, ob generell ein Log gespeichert werden soll. Über die DropDown-Liste Erweitertes Log speichern können Sie angeben, welche Daten geloggt werden sollen. Zusätzlich gibt es noch die DropDown-Liste ACMP Console Log anzeigen, über welche ausgewählt werden kann, wann ein Log der Console angezeigt wird.

Sicherheit

Unter Sicherheit haben Sie die Möglichkeit, das Client Command durch ein Passwort zu schützen, so dass es von keiner weiteren Person editiert werden kann. Weiterhin können Sie bestimmten Usern und Gruppen Rechte an diesem Client Command erteilen oder entziehen. Dies funktioniert ebenso wie das Sicherheitsmanagement bei Abfragen (siehe Sicherheit).

Icon

Unter Icon können Sie ein spezielles Icon für Ihr Client Command wählen. Dazu können Sie auch ein neues Icon hinzufügen oder bestehende Icons editieren bzw. löschen. Als Formate für eigene Icons werden *.bmp-und *.ico-Dateien mit 16x16 Pixeln unterstützt. Das neue Icon wird in die ACMP integriert. Wird kein Icon ausgewählt, wird das Standardicon für Client Commands gesetzt.

Info

Unter Info können Sie den Firmennamen bzw. den Ersteller des Client Commands, sowie eventuelle Markenzeichen eintragen.

Kommentare

Unter Kommentare können Sie einen beliebigen Text als Kommentar zum Client Command eintragen. Dabei werden die Kommentare intern im Client Command gespeichert, wodurch sich eine Chronik ergibt, durch welche z.B. Änderungen nachvollzogen werden können.

Parameter

Mithilfe von Parametern auf Basis von CC Projektvariablen können Sie einem Client Command Werte übergeben. So können aus der ACMP Console heraus Client Command Jobs über die Parameter gesteuert werden, ohne vorher das Console Skript des CCs ausführen zu müssen.

Die Parameter selber können im ACMP überall dort genutzt werden, wo auch Jobs benötigt und eingesetzt werden:

• Über die manuelle Ausführung von Job ausführen
• Über die Einbindung in Job Collections
• Über die Nutzung in Containern
• Über vorab getroffene Einstellungen im ACMP Kiosk
• Über die Commands Enqueue ACMP Jobs und Run Client Command

Benutzerdefinierte Parameter definieren

Sie haben die Möglichkeit, Parameter für ein Client Command auf Basis einer CC Projektvariable zu definieren. Diese sind dann Client Command spezifische Einstellungen, die nur diesem CC mitgegeben werden.

Definiert werden die Parameter hierfür im Client Command Center bzw. Editor. Zum Hinzufügen von Parameterwerten können Sie über 2 Wege gehen:

1. In der Navigation über Client Commands > Erstellen > Rechtsklick auf einen bereits bestehenden CC > Eigenschaften > Client Command spezifisch > Parameter.
2. Über einen Doppelklick auf ein bereits bestehendes CC oder ein neu erstelltes > Oberhalb der Befehle auf Eigenschaften > Client Command spezifisch > Parameter.

In diesem Bereich werden alle bestehenden Parameter angezeigt. Über  fügen Sie dem CC einen neuen Parameter hinzu, über   löschen Sie den Parameter, über  editieren Sie die Parameter. Beim Hinzufügen gibt es 3 Typen von Parametern, zwischen denen Sie auswählen können:

1. Text

Bei diesem Parameter-Typen können Sie die Parameterwerte über einen Freitext angeben.

Unter Variablenname wählen Sie eine CC Projektvariable aus, die Sie über  im CC Editor ausgewählt haben oder geben Sie direkt den Namen der CC Projektvariable ein.

Geben Sie dann eine deutsche oder eine englische Bezeichnung an, je nachdem, welche Sprache in der ACMP Console eingestellt ist. Die Bezeichnung ist der Text, der beim Anlegen eines Jobs für den Parameter angezeigt wird. Über die Einstellung Option wird die Sichtbarkeit des CCs für den Endbenutzer im ACMP Kiosk eingestellt. Sie haben die Auswahl aus Unsichtbar für Endanwender, Nur lesbar für Endanwender und Editierbar für Endanwender. Über Standardwert geben Sie einen Wert in Form eines Freitextes an, der standardmäßig eingestellt sein soll.

2. Combobox

Bei diesem Parameter-Typen können Sie die Parameterwerte über eine Combobox angeben.

Unter Variablenname wählen Sie eine CC Projektvariable aus, die Sie über  im CC Editor ausgewählt haben oder geben direkt den Namen der CC Projektvariable ein. Geben Sie dann eine deutsche oder eine englische Bezeichnung an, je nachdem, welche Sprache in der ACMP Console eingestellt ist. Die Bezeichnung ist der Text, der beim Anlegen eines Jobs für den Parameter angezeigt wird. Über die Einstellung Option wird die Sichtbarkeit des CCs für den Endbenutzer im ACMP Kiosk eingestellt. Sie haben die Auswahl aus Unsichtbar für Endanwender, Nur lesbar für Endanwender und Editierbar für Endanwender. In Combobox-Konfiguration können die möglichen Combobox-Elemente konfiguriert werden. Geben Sie über Hinzufügen den Wert des Eintrags ein, d.h., das, was konkret bei der Ausführung an das Client Skript übergeben wird. I.d.R. handelt es sich dabei um Software, die installiert oder deinstalliert werden soll. Sprechende Werte dafür wären „Installieren“ und „Deinstallieren“.

Die Reihenfolge, in der die Combobox-Einträge beim Erstellen von Jobs angezeigt werden, kann angepasst werden sowie welcher Eintrag der Standardwert des neuen Jobs ist.

3. Checkbox

Bei diesem Parameter-Typen können Sie die Parameterwerte in einer Checkbox angeben.
Unter Variablenname wählen Sie eine CC Projektvariable aus, die Sie über   im CC Editor ausgewählt haben oder geben direkt den Namen der CC Projektvariable ein. Geben Sie dann eine deutsche und eine englische Bezeichnung an. Über die Einstellung Option wird die Sichtbarkeit des CCs für den Endbenutzer im ACMP Kiosk eingestellt. Sie haben die Auswahl aus Unsichtbar für Endanwender, Nur lesbar für Endanwender und Editierbar für Endanwender. In der Checkbox-Konfiguration können Sie einstellen, welcher Wert, also 1 oder 0, an das CC übergeben werden soll. Über den Standardwert legen Sie fest, ob standardmäßig der Wert 1 für „angekreuzt“ oder 0 für „Nicht angekreuzt“ voreingestellt ist. 

Klicken Sie in allen drei Fällen des Parameter-Typs auf Speichern. Anschließend können Sie über das Anlegen von neu erstellten oder Auswählen von bereits angelegten Client Command Jobs die Parameter anwenden.

Änderungen an den Parametern

Da Parameter Client Command spezifisch sind, wirken sich jegliche Änderungen immer auf alle Versionen des CCs aus. Folgende Fälle und ihre Auswirkungen kann dies für das CC bedeuten:

Version allgemein (Versionsspezifisch)

Unter Version allgemein können Sie eine Beschreibung hinterlegen und das Level des erhöhen. Diese Angaben beziehen sich dabei allerdings nur auf die aktuelle Version des Client Command, von der Sie diese Eigenschaften aufgerufen haben.

Der Level dient dazu, dass ein Client Command u.a. im CommandLauncher so angezeigt wird, als wäre es noch nicht ausgeführt worden. Ebenso werden Client Commands erneut ausgeführt, welche einem Container mit der Option "Einmalig ausführen" zugewiesen wurden (siehe Client Commands).

Bedingungen

Unter Bedingungen können Sie zusätzliche Bedingungen angeben, welche bei der Ausführung des Commands berücksichtigt werden sollen.

Dazu ziehen Sie einen Befehl von der linken Seite per Drag-and-Drop auf die rechte Seite auf die ODER- bzw. die UND-Bedingung. Dies ist ähnlich den Filtern, welche bei einer Abfrage gesetzt werden können. So benötigen Sie mindestens zwei Bedingungen, damit diese Einstellungen Sinn machen. Sie können die Bedingungen auch verschachteln, so dass eine Bedingung z.B. nach dem Muster X ODER (Y UND Z) entsteht. Ziehen Sie z.B. eine Bedingung auf eine bereits bestehende UND-Bedingung, so werden diese beiden Bedingungen in den Kontext mit einer ODER-Bedingung gesetzt. Bedingungen können für jede Version eines Client Command angepasst werden.

Im Folgenden werden die verschiedenen Conditions genauer erläutert:

Variablen bearbeiten

Variablen dienen dazu, bestimmte Werte zu speichern. Dabei gibt es Projekt-, Console-, System- und globale ACMP Variablen. Diese unterscheiden sich in der Verwendung:

Variablen können auch direkt mit der Schreibweise %VARIABLENAME% verwendet werden. Auf diese Weise wird bei der Ausgabe direkt der Inhalt der Variablen eingefügt.

Auf diese Weise wird nicht der Inhalt der Variable, sondern der Name der Variablen angezeigt. Beachten Sie außerdem, dass das %-Zeichen bei normaler Verwendung immer mit einem weiteren vorangestellten %-Zeichen geschrieben wird. Somit wird verhindert, dass ACMP versucht den Text als Variable zu interpretieren.

Dies ist besonders wichtig, wenn Sie Execute batch-file command oder ähnliche Kommandos verwenden, in denen Sie Quellcode angeben. Achten Sie darauf alle %-Zeichen, zu escapen, da ansonsten das Skript nicht korrekt interpretiert und ausgeführt wird. Hierzu zählen insbesondere Variablen in Shellskripten, wie z.B.:

Um obenstehende Beispiel zu erhalten, geben Sie folgenden Quellcode an:

Über das Menü Projekt im Client Command Editor erreichen Sie die Option Variablen editieren. Dort finden Sie alle ACMP Variablen (Name) mit Ihrem aktuellen Wert und einer Option, welche angibt, ob die Variable veränderbar (Beschreibbar) ist.

Um eine neue Variable hinzuzufügen, tragen Sie den Variablennamen und eventuell einen Standartwert ein. Über den +-Button rechts neben dem Variablennamen fügen Sie die Variable den ACMP Variablen hinzu und können diese in Ihren Commands nutzen.

Bei der Erstellung von Funktionen (siehe Funktionen verwalten) gibt es zusätzlich die Möglichkeit, eine Variable als Parameter zu markieren. Solche Variablen können dynamisch mit Werten belegt werden.

Falls Sie auf den Button rechts neben der Eingabe für den Standardwert klicken, wird der eingegebene Wert als aktueller Wert für die markierte Variable gesetzt. So können Sie z.B. einen Startwert und einen Standardwert (Ersatzwert) wählen.

Nutzung von Variablen

Variablen können Werte an Kommandos übergeben oder als Ergebnisvariablen agieren, deren Inhalt in den folgenden Kommandos wiederum Werte übergibt. Sie können Variablenwerte in Ihren Client Commands ändern, indem Sie die Funktionen Set projekt variables nutzen. Handelt es sich um Variablen mit einem Zahlenwert, z.B. eine Zählvariable in einer Schleife, kann der Wert erhöht oder verringert werden, indem die Kommandos Increase Variable bzw. Decrease Variable genutzt werden.

Enthält eine Variable eine Pfadangabe, sollten Sie überprüfen, ob die Pfadangabe mit oder ohne Backslash endet. Dies ist wichtig, falls Sie die Pfadangabe manuell um eine Unterorderstruktur erweitern, wie z.B. %windir%\system32\calc.exe. Dabei schließen ACMP-interne Pfadangaben immer mit einem Backslash ab, wohingegen Umgebungsvariablen des Betriebssystems nicht immer einen abschließenden Backslash enthalten. Wenn Sie sich nicht sicher sind, können Sie automatisch einen abschließenden Backslash einbinden, indem Sie ein Delphi Skript mit folgendem Inhalt in ein Client Command oder eine Funktion einfügen:

Wenn Sie eine Variable in einem Kommando eintragen wollen, erreichen Sie eine Auflistung aller verfügbaren Variablen, indem Sie die Tastenkombination Strg + Leertaste verwenden. Falls Sie Variablen per Hand eintragen, verwenden Sie das Format %Variablenname%. Benötigen Sie einen speziellen Wert einer gesetzten Variablen, können Sie diesen über das Format %Variablenname.Eigenschaft% aufrufen.

Ein Beispiel:

In einem Client Command wollen Sie die Variable URL mit mehreren Werten beschreiben. Dazu erstellen Sie eine Variable mit dem Namen URL und geben Eigenschaften im folgenden Format an:

Mehrere Eigenschaften werden hierbei durch ein Komma ohne folgendes Leerzeichen getrennt.

Einzelne Werte erreichen Sie nun über den Namen der Variablen mit Ihrer Eigenschaft:

Variablen sollten kein Gleichheitszeichen oder Komma enthalten, da es sonst auf Grund des Parsings von Delphi zu Problemen kommen kann.