Menüleiste

1

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.

8

9

=== Projekt ===

10

11

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>>doc:||anchor="HEigenschaften"]] des Client Command editieren. Ebenso können Sie die ACMP–Variablen editieren. Lesen Sie hierzu mehr den Abschnitt [[Variablen>>doc:||anchor="HVariablenbearbeiten"]].

=== 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.

16

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.

17

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>>doc:ACMP.65.ACMP-Solutions.Client Commands.Jobs ausführen.WebHome]]). 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.

34

35

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.

36

37

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.

38

39

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.

40

41

42

ACMP beschränkt weder die Anzahl der parallel laufenden Client Commands, noch wird eine Überprüfung der Client Commands vorgenommen. Es muss also sichergestellt werden, dass nicht gleichzeitig auf die selben Ressourcen zugegriffen wird.

[[image:CC_Eigenschaften_Optionen.PNG||alt="63_ClientCommands_ClientCommandEditor_Menüleiste_667.png" data-xwiki-image-style-alignment="center"]]

47

48

49

Client Command Optionen

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>>doc:ACMP.65.ACMP-Solutions.Client-Management.Abfrageverwaltung.Abfragen erstellen.WebHome]]).

58

59

60

Das Passwort können Sie wieder entfernen, indem Sie ein leeres Passwort festlegen.

== 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.

78

79

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

80

81

* Über die manuelle Ausführung von [[Job ausführen>>doc:ACMP.65.ACMP-Solutions.Jobs.WebHome]]

82

* Über die Einbindung in [[Job Collections>>doc:ACMP.65.ACMP-Solutions.Jobs.Job Collections.WebHome]]

83

* Über die Nutzung in [[Containern>>doc:ACMP.65.ACMP-Solutions.Client-Management.Container.WebHome]]

84

* Über vorab getroffene Einstellungen im [[ACMP Kiosk>>doc:ACMP.65.ACMP-Solutions.Client-Management.ACMP Kiosk.WebHome]]

85

* Über die Commands [[Enqueue ACMP Jobs>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Commandlist.ACMP.WebHome||anchor="HEnqueueACMPJob"]] und [[Run Client Command>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Commandlist.ACMP.WebHome||anchor="HRunClientCommand"]]

86

87

=== **Benutzerdefinierte Parameter definieren** ===

88

89

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.

90

91

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

92

93

1. In der Navigation über //Client Commands > Erstellen > Rechtsklick auf einen bereits bestehenden CC > Eigenschaften > Client Command spezifisch > Parameter//.

94

1. Über einen Doppelklick auf ein bereits bestehendes CC oder ein neu erstelltes > Oberhalb der Befehle auf// Eigenschaften //> //Client Command spezifisch > Parameter//.

95

96

97

[[image:Eigenschaften Parameter.PNG||data-xwiki-image-style-alignment="center"]]

98

99

100

Parameterwerte definieren

In diesem Bereich werden alle bestehenden Parameter angezeigt. Über [[image:image-20230710101736-1.png||height="20" width="21"]] fügen Sie dem CC einen neuen Parameter hinzu, über [[image:1688977083738-222.png]] löschen Sie den Parameter, über [[image:1688977109352-790.png]] editieren Sie die Parameter. Beim Hinzufügen gibt es 3 Typen von Parametern, zwischen denen Sie auswählen können:

**~1. Text**

[[image:Parameter Text.PNG||data-xwiki-image-style-alignment="center"]]

Parameter-Typ: Text

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

117

118

Unter //Variablenname //wählen Sie eine CC Projektvariable aus, die Sie über [[image:image-20230710101949-5.png]] im CC Editor ausgewählt haben oder geben Sie direkt den Namen der CC Projektvariable ein.

119

120

121

Beachten Sie, dass Sie für die Parameter ausschließlich CC Projektvariablen auswählen können.

Für jeden Parameter kann als Basis nur eine einzige CC Projektvariable dienen.

126

127

128

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.

129

130

131

Dieser Wert ist nicht der Standardwert der CC Projektvariable. Dieser Wert wird bei der Ausführung des CC Jobs an das CC Skript übergeben und überschreibt somit den Standardwert der CC Projektvariablen.

**2. Combobox**

[[image:Combobox.PNG||data-xwiki-image-style-alignment="center"]]

139

140

141

Parameter-Typ: Combobox

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

146

147

Unter //Variablenname// wählen Sie eine CC Projektvariable aus, die Sie über [[image:image-20230710131034-1.png]] 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“.

148

149

150

[[image:Combobox Werte.PNG||data-xwiki-image-style-alignment="center"]]

151

152

153

Bezeichnungen hinzufügen

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**

[[image:Checkbox.PNG||data-xwiki-image-style-alignment="center"]]

163

164

165

Parameter-Typ: Checkbox

Bei diesem Parameter-Typen können Sie die Parameterwerte in einer Checkbox angeben.

170

Unter //Variablenname// wählen Sie eine CC Projektvariable aus, die Sie über [[image:image-20230710101949-5.png]] 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.

171

172

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 >>doc:ACMP.65.ACMP-Solutions.Jobs.WebHome||anchor="HParameterfFCrClientCommandJobseinstellen"]]die Parameter anwenden.

173

174

=== Änderungen an den Parametern ===

175

176

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:

177

178

|=Änderungen|=Auswirkungen

179

|Parameter wird hinzugefügt|Für bereits bestehende Jobs wird der zum Zeitpunkt der Erstellung des Parameters geltende Defaultwert des neuen Parameters verwendet.

180

|Parameter wird entfernt|Der Parameter wird auch bei bestehenden Jobs nicht mehr verwendet. Das kann zu fehlschlagenden alten CC Versionen führen.

181

|Defaultwert wird geändert|Es ändert sich nichts an den bestehenden Jobs. Bei neu erstellten Jobs wird dann der neue Defaultwert angewendet.

182

|Name des Parameters wird geändert|Es ändert sich nichts an den bestehenden Jobs. Der Name ist nicht relevant für die Ausführung.

183

|Mögliche Werte des Parameters werden geändert|(((

184

**Checkbox:**

185

186

Es werden die neu eingestellten Werte verwendet, auch bei bestehenden Jobs. Das kann zu fehlschlagenden alten CC Versionen führen.

)))

| |(((

**Text:**

Jegliche Änderungen am Freitext ändern nur den Defaultwert. Sie ändern nichts an bestehenden Jobs. Bei neuen Jobs wird dann der neue Default angewendet.

)))

| |(((

**Combobox:**

//Einen neuen Eintrag hinzufügen//

197

198

Es ändert sich nichts an bestehenden Jobs. Bei neuen Jobs oder beim Editieren bestehender Jobs ist der neue Eintrag verfügbar.

199

200

//Einen bereits bestehenden Eintrag löschen//

201

202

Bei Jobs, bei denen der gelöschte Eintrag eingestellt war, wird stattdessen der Defaulteintrag des Parameters verwendet.

203

204

//Einen Defaulteintrag löschen//

205

206

Wenn der Defaulteintrag gelöscht wird, muss ein neuer Defaulteintrag ausgewählt werden. Bei Jobs, bei denen der gelöschte Eintrag eingestellt war, wird stattdessen der neue Defaulteintrag des Parameters verwendet.

207

208

//Den Wert eines Eintrags ändern//

209

210

Es wird der neu eingestellte Wert verwendet, auch bei bestehenden Jobs. Das kann zu fehlschlagenden alten CC Versionen führen.

211

212

//Einen bereits bestehenden Eintrag umbenennen//

213

214

Es ändert sich nichts an den bestehenden Jobs. Der Name ist nicht relevant für die Ausführung.

215

216

//Den Defaulteintrag wechseln//

217

218

Es ändert sich nichts an den bestehenden Jobs. Bei neuen Jobs wird der neue Defaulteintrag vorausgewählt.

219

)))

220

221

== Version allgemein (Versionsspezifisch) ==

222

223

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.

224

225

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>>doc:ACMP.65.ACMP-Solutions.Client-Management.Container.Die Detailansicht.WebHome]]).

226

227

228

Das Level dient der Abwärtskompatibilität zu älteren ACMP Versionen. Verwenden Sie bitte die Versionierung, um eine neue Version eines Client Commands zu erstellen.

== Bedingungen ==

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

234

235

236

[[image:CC_Eigenschaften_Bedingungen.PNG||data-xwiki-image-style-alignment="center"]]

237

238

239

Versionsspezifische Bedingungen des Client Commands

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.

244

245

Im Folgenden werden die verschiedenen Conditions genauer erläutert:

246

247

|**Conditions**|**Bedingung**

248

|**Is CPU speed**|Mit dieser Bedingung können Sie den CPU-Takt überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung wozu Sie noch den passenden Takt in Hz (Hertz) angeben.

249

|**Is file date**|Mit dieser Bedingung können Sie das Änderungsdatum einer Datei überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung wozu Sie noch die passende Datei auswählen und das Änderungsdatum im Format dd.mm.yy hh:mm:ss angeben.

250

|**Is file version**|Mit dieser Bedingung können Sie die Dateiversion überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung wozu Sie noch die passende Datei auswählen und die Dateiversion angeben. Nur ausführbare Dateien haben eine Versionsnummer.

251

|**If machine is in domain**|Mit dieser Bedingung können Sie prüfen, ob ein Client zur angegebenen Domain gehört. Dazu geben Sie einfach eine Domain an. Der Button neben dem Eingabefeld listet Ihnen dazu alle verfügbaren Domains auf.

252

|**Is logon user**|Mit dieser Bedingung können Sie überprüfen, ob ein bestimmter Benutzer am Client angemeldet ist. Klicken Sie auf den Button rechts neben dem Eingabefeld und es werden Ihnen alle vorhandenen und bekannten User einer Domain aufgelistet. Markieren Sie einen entsprechenden User und klicken Sie auf Hinzufügen. Wenn Sie alle nötigen User hinzugefügt haben klicken Sie auf OK.

253

|**If registry value name exists**|Mit dieser Bedingung können Sie überprüfen, ob ein bestimmter Schlüssel der Registry existiert und einen bestimmten Wert besitzt. Geben Sie dazu aus dem DropDown – Feld den Hauptschlüssel und anschließend den Unterschlüssel an. Den Wert tragen Sie ebenfalls ein.

254

Über den Button unter den Eingabefeldern öffnet Sich ein Registryeditor, womit Sie einen Schlüssel direkt auswählen können.

255

|**If command has been executed**|Mit dieser Bedingung können Sie überprüfen, ob ein bestimmtes ClientCommand zuvor ausgeführt wurde. Weiterhin können Sie überprüfen, ob das Client Command die richtige Version besaß. In der Dropdown Box haben sie die Möglichkeit, das Prüfverhalten zu wählen. Hier stehen ihnen die Optionen "Automatic", "Machine and User", "Only User" und "Only Machine" zur Auswahl.

256

|**Is RAM capacity**|Mit dieser Bedingung können Sie den freien Arbeitsspeicher überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung wozu Sie noch die Größe des RAM angeben.

257

|**Is free disk space**|Mit dieser Bedingung können Sie den freien Speicher einer Partition der Festplatte überprüfen. Dazu stehen Ihnen die mathematischen Operatoren zur Verfügung wozu Sie noch die Größe des Speichers sowie die Partition angeben.

258

|**If directory exists**|Mit dieser Bedingung können Sie überprüfen, ob ein bestimmtes Verzeichnis existiert. Dazu geben Sie einfach das entsprechende Verzeichnis an.

259

|**If file exists**|Mit dieser Bedingung können Sie überprüfen, ob eine bestimmte Datei existiert. Dazu geben Sie die entsprechende Datei.

260

|**Is user in group**|Mit dieser Bedingung können Sie überprüfen, ob der am Client angemeldete Benutzer in einer bestimmte Gruppe der Domain ist. Klicken Sie auf den Button rechts neben dem Eingabefeld und es werden Ihnen alle vorhandenen Gruppen einer Domain aufgelistet, Markieren Sie eine Gruppe und klicken Sie auf Hinzufügen. Wenn Sie alle nötigen Gruppen hinzugefügt haben klicken Sie auf OK.

261

|**If registry key exists**|Mit dieser Bedingung können Sie überprüfen, ob ein bestimmter Schlüssel der Registry existiert. Geben Sie dazu aus dem DropDown – Feld den Hauptschlüssel und anschließend den Unterschlüssel an. Über den Button unter den Eingabefeldern öffnet Sich ein Registryeditor, womit Sie einen Schlüssel direkt auswählen können.

262

|**If ADS container / Property match**|Mit dieser Bedingung können Sie überprüfen, ob der aktuelle Benutzer bzw. der Client in einem bestimmten ActiveDirectory – Container liegt oder eine bestimmte Eigenschaft besitzt. Um die AD – Container bzw. die Eigenschaften auszuwählen, klicken Sie auf den Button rechts neben dem Eingabefeld.

263

|**Is user local admin**|Mit dieser Bedingung können Sie überprüfen, ob der angemeldete Benutzer lokale Administratorrechte besitzt.

264

|**Is operating system**|Mit dieser Bedingung können Sie überprüfen, ob das Betriebssystem eine bestimmte Version besitzt, z.B. Windows XP oder Windows 8. Wählen Sie dazu einfach die passende Version aus dem DropDown–Feld.

265

|**Is machine name**|Mit dieser Bedingung können Sie überprüfen, ob der Rechnername gleich einem angegebenen Namen ist. Dazu klicken Sie auf den Button rechts neben dem Eingabefeld. Dort werden Ihnen alle Rechner einer Domain aufgelistet. Klicken Sie auf den Button darunter, werden ihnen nur Rechner aufgelistet, welche im ACMP inventarisiert sind.

266

|**Is in container**|Mit dieser Bedingung können Sie überprüfen, ob der inventarisierte Rechner in einem bestimmten Container (siehe 6. Containers) liegt. Markieren Sie dazu die entsprechenden Container.

267

|**Compare strings**|Mit dieser Bedingung können Sie überprüfen, ob zwei Zeichenketten gleich sind. So können Sie z.B. als erste Zeichenkette eine ACMP – Variable eingeben und als zweite Zeichenkette einen bestimmten Wert. Variablen werden im Format %Variablenname% angegeben. Variablen finden Sie unter dem Punkt Variablen editieren im Menüpunkt Programm.

268

269

= Variablen bearbeiten =

270

271

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

272

273

|(((

274

[[image:https://manual.aagon.com/acmp/de/61/variable_project.png||alt="Variable_Project" data-xwiki-image-style-alignment="center" height="32" width="32"]]

275

)))|(((

276

Diese Variablen bestehen nur in dem aktuellen Projekt und können nicht in anderen Projekten genutzt werden.

277

)))

278

|(((

279

[[image:https://manual.aagon.com/acmp/de/61/variable_global.png||alt="Variable_Global" data-xwiki-image-style-alignment="center" height="32" width="32"]]

280

)))|(((

281

Diese Variablen stehen im gesamten ACMP–Umfeld zur Verfügung und können in allen Projekten genutzt werden, müssen jedoch explizit angelegt werden.

282

)))

283

|(((

284

[[image:https://manual.aagon.com/acmp/de/61/variable_system.png||alt="Variable_System" data-xwiki-image-style-alignment="center" height="32" width="32"]]

285

)))|(((

286

Diese Variablen beschreiben das aktuelle System, auf welchem das Client Command ausgeführt werden soll. So lassen sich einfach Rechnerbezogene Werte auslesen (Name, Verzeichnisse, Betriebssystem). Diese Variablen können nur gelesen werden.

287

)))

288

|(((

289

[[image:https://manual.aagon.com/acmp/de/61/variable_quickcommand.png||alt="Variable_QuickCommand" data-xwiki-image-style-alignment="center" height="32" width="32"]]

290

)))|

291

Diese Variablen beschreiben Eigenschaften der Console und können nur gelesen werden.

292

293

294

[[image:63_ClientCommand_Variablenbearbeiten_668.png||data-xwiki-image-style-alignment="center"]]

295

296

297

Projektvariablen bearbeiten

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.

302

303

304

Falls eine Variable nicht aufgelöst werden soll, verwenden Sie folgende Schreibweise:%%VARIABLENAME%%

305

306

307

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.

308

309

Dies ist besonders wichtig, wenn Sie [[Execute batch-file command>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Commandlist.Processes and Shell.WebHome||anchor="HExecutebatch-filecommand"]] 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.:

310

311

312

FOR %%i IN %%list DO (

echo %%i

)

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

321

322

323

FOR %%%%i IN %%%%list DO (

echo %%%%i

)

Ü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.

331

332

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.

333

334

Bei der Erstellung von Funktionen (siehe [[Funktionen verwalten>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command erstellen.Werkzeuge.WebHome||anchor="HFunktionen"]]) gibt es zusätzlich die Möglichkeit, eine Variable als Parameter zu markieren. Solche Variablen können dynamisch mit Werten belegt werden.

335

336

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.

337

338

339

Seit ACMP 4.0 enthält die Systemvariable LOGGEDONUSER_NAME den Wert 'SYSTEM', falls kein Benutzer auf dem Client angemeldet ist.

340

341

342

== Nutzung von Variablen ==

343

344

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.

345

346

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:

Var

CurrentVarContent, NewVarContent: String;

Begin

CurrentVarContent := GetVarContent(‘Name der zu prüfenden Variable‘);

356

357

CurrentVarContent := IncludeTrailingPathDelimiter(CurrentVarContent);

358

359

GetVarContent(‘Name der zu prüfenden Variable‘, CurrentVarContent);

End

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:

369

370

371

Value=www.aagon.com,ClickedButton=ok

372

373

374

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

375

376

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

377