Menüleiste - XWiki

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.

(% style="text-align:center" %)

47

[[image:CC_Eigenschaften_Optionen.PNG||alt="63_ClientCommands_ClientCommandEditor_Menüleiste_667.png"]]

48

49

50

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

59

60

61

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.

79

80

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

81

82

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

83

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

84

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

85

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

86

* Ü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"]]

87

88

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

89

90

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.

91

92

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

93

94

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

95

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

96

97

98

(% style="text-align:center" %)

99

[[image:Eigenschaften Parameter.PNG]]

100

101

102

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

(% style="text-align:center" %)

112

[[image:Parameter Text.PNG]]

Parameter-Typ: Text

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

120

121

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.

122

123

124

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.

129

130

131

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.

132

133

134

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

(% style="text-align:center" %)

142

[[image:Combobox.PNG]]

143

144

145

Parameter-Typ: Combobox

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

150

151

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

152

153

154

(% style="text-align:center" %)

155

[[image:Combobox Werte.PNG]]

156

157

158

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

(% style="text-align:center" %)

168

[[image:Checkbox.PNG]]

169

170

171

Parameter-Typ: Checkbox

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

176

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.

177

178

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.

179

180

=== Änderungen an den Parametern ===

181

182

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:

183

184

|=Änderungen|=Auswirkungen

185

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

186

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

187

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

188

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

189

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

190

**Checkbox:**

191

192

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

203

204

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

205

206

//Einen bereits bestehenden Eintrag löschen//

207

208

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

209

210

//Einen Defaulteintrag löschen//

211

212

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.

213

214

//Den Wert eines Eintrags ändern//

215

216

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

217

218

//Einen bereits bestehenden Eintrag umbenennen//

219

220

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

221

222

//Den Defaulteintrag wechseln//

223

224

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

225

)))

226

227

== Version allgemein (Versionsspezifisch) ==

228

229

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.

230

231

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]]).

232

233

234

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.

240

241

242

(% style="text-align:center" %)

243

[[image:CC_Eigenschaften_Bedingungen.PNG]]

244

245

246

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.

251

252

Im Folgenden werden die verschiedenen Conditions genauer erläutert:

253

254

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

255

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

256

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

257

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

258

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

259

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

260

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

261

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

262

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

263

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

264

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

265

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

266

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

267

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

268

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

269

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

270

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

271

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

272

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

273

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

274

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

275

276

= Variablen bearbeiten =

277

278

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

279

280

|(((

281

(% style="text-align:center" %)

282

[[image:https://manual.aagon.com/acmp/de/61/variable_project.png||alt="Variable_Project" height="32" width="32"]]

283

)))|(((

284

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

285

)))

286

|(((

287

(% style="text-align:center" %)

288

[[image:https://manual.aagon.com/acmp/de/61/variable_global.png||alt="Variable_Global" height="32" width="32"]]

289

)))|(((

290

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

291

)))

292

|(((

293

(% style="text-align:center" %)

294

[[image:https://manual.aagon.com/acmp/de/61/variable_system.png||alt="Variable_System" height="32" width="32"]]

295

)))|(((

296

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.

297

)))

298

|(((

299

(% style="text-align:center" %)

300

[[image:https://manual.aagon.com/acmp/de/61/variable_quickcommand.png||alt="Variable_QuickCommand" height="32" width="32"]]

301

)))|

302

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

303

304

305

(% style="text-align:center" %)

306

[[image:63_ClientCommand_Variablenbearbeiten_668.png]]

307

308

309

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.

314

315

316

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

317

318

319

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.

320

321

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

322

323

324

FOR %%i IN %%list DO (

echo %%i

)

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

333

334

335

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.

343

344

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.

345

346

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.

347

348

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.

349

350

351

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

352

353

354

== Nutzung von Variablen ==

355

356

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.

357

358

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‘);

368

369

CurrentVarContent := IncludeTrailingPathDelimiter(CurrentVarContent);

370

371

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:

381

382

383

Value=www.aagon.com,ClickedButton=ok

384

385

386

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

387

388

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

389