Changes for page Client Commands neu hinzufügen

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -4,11 +4,11 @@
4	4
5	5	{{aagon.floatingbox/}}
6	6
7		-Um ein neues Client Command zu erstellen, wählen Sie den Ordner aus, in welchem das Client Command gespeichert werden soll. Anschließend klicken Sie auf Neues Client Command in der Schnellwahlleiste. Es wird der Client Command Editor geöffnet, über welchen Sie das neue Client Command entwerfen können. Weitere Informationen zum Client Command Editor finden Sie im Kapitel [[Client Command Editor>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.WebHome]].
	7	+Um ein neues Client Command zu erstellen, wählen Sie den Ordner aus, in welchem das Client Command gespeichert werden soll. Anschließend klicken Sie auf Neues Client Command in der Schnellwahlleiste. Es wird der Client Command Editor geöffnet, über welchen Sie das neue Client Command entwerfen können. Weitere Informationen zum Client Command Editor finden Sie im Kapitel [[Client Command Editor>>doc:ACMP.67.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.WebHome]].
8	8
9	9	Im Folgenden wird nun die Erstellung und Konfiguration eines Client Command anhand des bereits bestehenden Client Command Dienste auslesen erläutert. Das fertige Client Command soll dazu gedacht sein, auf einem Client dessen Dienste auszulesen und zu speichern, um Sie später über eine Abfrage aufrufen zu können.
10	10
11		-Nachdem Sie auf Neues Client Command geklickt haben, sehen Sie die Standardoberfläche des Client Command Editor und es kann sofort begonnen werden, das Client Command zu erstellen. Generell empfiehlt es sich, zunächst die Eigenschaften des neuen Client Command (siehe [[Eigenschaften>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome||anchor="HEigenschaften"]]) zu konfigurieren. Im Fall des Client Command Dienste auslesen müssen hier jedoch keine weiteren Einstellungen vorgenommen werden.
	11	+Nachdem Sie auf Neues Client Command geklickt haben, sehen Sie die Standardoberfläche des Client Command Editor und es kann sofort begonnen werden, das Client Command zu erstellen. Generell empfiehlt es sich, zunächst die Eigenschaften des neuen Client Command (siehe [[Eigenschaften>>doc:ACMP.67.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome||anchor="HEigenschaften"]]) zu konfigurieren. Im Fall des Client Command Dienste auslesen müssen hier jedoch keine weiteren Einstellungen vorgenommen werden.
12	12
13	13	= Consolen Skript konfigurieren =
14	14
...	...	@@ -30,8 +30,7 @@
30	30
31	31	Unter dem Tab //Eingabeeinstellungen// werden keine Konfigurationen vorgenommen, da keine weiteren Eingaben vom Benutzer erwartet werden, als ein Klick auf OK oder Abbrechen.
32	32
33		-(% style="text-align:center" %)
34		-[[image:63_ClientCommands_ClientCommandsneuhinzufügen_924.png||alt="Einen Dialog hinzufügen"]]
	33	+[[image:63_ClientCommands_ClientCommandsneuhinzufügen_924.png||alt="Einen Dialog hinzufügen" data-xwiki-image-style-alignment="center"]]
35	35
36	36
37	37	Einen Dialog hinzufügen
...	...	@@ -75,10 +75,10 @@
75	75
76	76	== Zeit erfassen ==
77	77
78		-Als erstes sollte die Zeit erfasst werden. Dazu ziehen Sie das Kommando Get date/time per Drag-and-Drop aus der Commandliste in den Skript–Bereich. Im Details Tab geben Sie an, dass Sie die/das Aktuelle Zeit/Datum nutzen wollen. Als Format wählen Sie dd.mm.yyyy, hh.nn. Somit erhalten Sie z.B. das Datum 09.02.2017, 16.31, welches in einer Variablen gespeichert wird. Diese Variable geben Sie im unteren Dialogbereich an. Erstellen Sie dazu eine Variable TIME (siehe [[Variablen>>doc:ACMP.65.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome||anchor="HVariablenbearbeiten"]]).
	77	+Als erstes sollte die Zeit erfasst werden. Dazu ziehen Sie das Kommando Get date/time per Drag-and-Drop aus der Commandliste in den Skript–Bereich. Im Details Tab geben Sie an, dass Sie die/das Aktuelle Zeit/Datum nutzen wollen. Als Format wählen Sie dd.mm.yyyy, hh.nn. Somit erhalten Sie z.B. das Datum 09.02.2017, 16.31, welches in einer Variablen gespeichert wird. Diese Variable geben Sie im unteren Dialogbereich an. Erstellen Sie dazu eine Variable TIME (siehe [[Variablen>>doc:ACMP.67.ACMP-Solutions.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome||anchor="HVariablenbearbeiten"]]).
79	79
80	80	(% style="text-align:center" %)
81		-[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_aa5d9278.png||alt="5.3.1.2 - Zeit" height="483" width="552"]]
	80	+[[image:XWiki.Images.WebHome@hmfile_hash_aa5d9278.png||alt="5.3.1.2 - Zeit" height="483" width="552"]]
82	82	Zeit erfassen
83	83
84	84	== Variable setzen ==
...	...	@@ -86,7 +86,7 @@
86	86	Als nächstes ist eine Variable zu setzen. Dies ist nötig, da die alten Daten vor dem Speichern des ersten ausgelesenen Dienstes gelöscht werden müssen, um keine doppelten oder veralteten Einträge zu besitzen. Später dürfen die neu gelesenen und eingetragenen Dienste aber nicht vom folgenden Dienst beim Speichern gelöscht werden.
87	87
88	88	(% style="text-align:center" %)
89		-[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_44b6c198.png||alt="Variable setzen" height="449" width="467"]]
	88	+[[image:XWiki.Images.WebHome@hmfile_hash_44b6c198.png||alt="Variable setzen" height="449" width="467"]]
90	90	Variable setzen
91	91
92	92	Um eine Variable zu setzen, wählen Sie das Kommando Set project variable und ziehen es per Drag-and-Drop in den Skript–Bereich. Erzeugen Sie über den sich öffnenden Dialog eine Variable mit dem Namen COUNT. Anschließend geben Sie als Inhalt eine 1 ein.
...	...	@@ -96,7 +96,7 @@
96	96	Nun werden die Dienste des Clients ausgelesen. Dazu verwenden Sie das Kommando WMI Query welches Sie per Drag-and-Drop in den Skript–Bereich ziehen.
97	97
98	98	(% style="text-align:center" %)
99		-[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_e3fc5cf5.png||alt="Auslesen der Dienste" height="518" width="599"]]
	98	+[[image:XWiki.Images.WebHome@hmfile_hash_e3fc5cf5.png||alt="Auslesen der Dienste" height="518" width="599"]]
100	100	Auslesen der Dienste
101	101
102	102	Geben Sie unter dem Tab Details den Einfachen Modus an. Wählen Sie als Namespace den DropDown–Eintrag root\CIMV2. Die dazu gehörige WMI Klasse ist Win32_Service und kann manuell oder über den nebenstehenden Button eingetragen werden. Bei der Nutzung des Buttons erscheint ein Dialog mit einer Auflistung aller WMI Klassen des gewählten Namespace. Eine Angabe von Bedingungen ist nicht notwendig, da alle Daten der Dienste ausgelesen werden sollen.
...	...	@@ -114,7 +114,7 @@
114	114	Falls die gerade definierte Bedingung zutrifft (Count=1), werden alle Kommandos ausgeführt, welche dem If–Kommando (mit Hilfe der Pfeil-Button) untergeordnet werden.
115	115
116	116	(% style="text-align:center" %)
117		-[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_d8eee91a.png||alt="Then - Folge / Daten speichern" height="572" width="536"]]
	116	+[[image:XWiki.Images.WebHome@hmfile_hash_d8eee91a.png||alt="Then - Folge / Daten speichern" height="572" width="536"]]
118	118	Then-Folge / Daten speichern
119	119
120	120	Um die Daten des eben ausgelesenen Dienstes zu speichern, ziehen Sie das Kommando Store Value on server (Client) in das Skript. Unter dem Tab Details stellen Sie die Option auf Mehrfachwert auf dem Server sichern. Ganz wichtig ist nun die Option Alte Werte löschen, welche Sie aktivieren. Somit werden die alten Daten der Dienste gelöscht, bevor neue Daten gespeichert werden. Ebenso ist genau diese Option der Grund für die Variable COUNT sowie die If-Else-Verzweigung. Da die Variable Count später erhöht wird, wird dieses Kommando nicht wieder ausgeführt. Dazu später mehr.
...	...	@@ -151,8 +151,7 @@
151	151
152	152	Nun werden alle Kommandos ausgeführt, welche dem Else–Kommando (mit Hilfe der Pfeil-Buttons untergeordnet werden.
153	153
154		-(% style="text-align:center" %)
155		-[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_034a5ea8.png||alt="5.3.1.2 - alteWerteLöschen" height="57" width="409"]]
	153	+[[image:XWiki.Images.WebHome@hmfile_hash_034a5ea8.png||alt="5.3.1.2 - alteWerteLöschen" data-xwiki-image-style-alignment="center" height="57" width="409"]]
156	156
157	157	Um die Daten des eben ausgelesenen Dienstes zu speichern, ziehen Sie das Kommando Store Value on server (Client) in das Skript. Unter dem Tab Details stellen Sie die Option auf Mehrfachwert auf dem Server sichern. Die Option Alte Werte löschen aktivieren Sie diesmal nicht. Somit werden die neuen Daten der Dienste gespeichert, ohne dass die alten gelöscht werden.
158	158
...	...	@@ -182,29 +182,27 @@
182	182
183	183	Damit die alten Daten nur einmal, nämlich im ersten Durchlauf, gelöscht werden, muss die Variable COUNT erhöht werden. Erst dann funktioniert der gesamte Aufbau mit dem If–Else–Konstrukt. Ziehen Sie hierzu das Kommando Increase Variable in das Skript und ordnen Sie es mit Hilfe der Pfeil-Button in der gleichen Spalte wie das If–Kommando an. Geben Sie unter dem Tab Details als Variablenname die Variable COUNT an und als Schritt 1.
184	184
185		-(% style="text-align:center" %)
186		-[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_e2dff2a0.png||alt="5.3.1.2 - Ergebnis" height="641" width="1065"]]
	183	+[[image:XWiki.Images.WebHome@hmfile_hash_e2dff2a0.png||alt="5.3.1.2 - Ergebnis" data-xwiki-image-style-alignment="center" height="641" width="1065"]]
187	187
188	188	Das Client Command ist nun vollständig und kann lokal getestet werden.
189	189
190	190	= Skripte testen =
191	191
192		-Um nun zu testen, ob das Client Command bzw. die einzelnen Skripte ordnungsgemäß funktionieren, lassen Sie zunächst eine Syntaxüberprüfung durchlaufen. Klicken Sie dazu auf das entsprechende Icon ([[image:https://manual.aagon.com/acmp/de/61/check_green_zoom20.png||alt="Check_Green" height="6" width="6"]]) in der Schnellwahlleiste. Anschließend wird die Syntax des Skripts automatisch geprüft, wonach Sie per Dialog über das Ergebnis informiert werden.
	189	+Um nun zu testen, ob das Client Command bzw. die einzelnen Skripte ordnungsgemäß funktionieren, lassen Sie zunächst eine Syntaxüberprüfung durchlaufen. Klicken Sie dazu auf das entsprechende Icon ([[image:XWiki.Images.WebHome@check_green.png||alt="Check_Green" height="15" width="15"]]) in der Schnellwahlleiste. Anschließend wird die Syntax des Skripts automatisch geprüft, wonach Sie per Dialog über das Ergebnis informiert werden.
193	193
194	194	Setzen Sie einen Breakpoint in der achten (letzten) Zeile. Klicken Sie dazu einfach neben die Zeilennummer. Es erscheint ein roter Punkt an dieser Stelle. Ebenso können Sie die verwendeten Variablen über einen Rechtsklick in den Variablenverlauf eintragen. Somit lassen sich die Werte der Variablen anzeigen.
195	195
196	196	(% style="text-align:center" %)
197		-[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_c2571d62.png||alt="Breakpoint setzen" height="52" width="401"]]
	194	+[[image:XWiki.Images.WebHome@hmfile_hash_c2571d62.png||alt="Breakpoint setzen" height="52" width="401"]]
198	198	Breakpoint setzen
199	199
200	200
201	201	(% style="text-align:center" %)
202		-[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_0932c6e4.png||alt="Variable hinzufügen" height="93" width="323"]]
	199	+[[image:XWiki.Images.WebHome@hmfile_hash_0932c6e4.png||alt="Variable hinzufügen" height="93" width="323"]]
203	203	Variable hinzufügen
204	204
205		-Lassen Sie das Skript nun laufen, indem Sie auf das Start–Icon ([[image:https://manual.aagon.com/acmp/de/61/clientcommandphase_execute_zoom20.png||alt="ClientCommandPhase_Execute" height="6" width="6"]]) klicken. Sie sehen anhand der Statusspalte im Skript, dass nur der erste Teil der If-Else–Verzweigung ausgeführt wurde, im Ablauflog die bisherigen Aktionen zu sehen sind und im Variablenlog die aktuellen Werte eingetragen sind.
	202	+Lassen Sie das Skript nun laufen, indem Sie auf das Start–Icon ([[image:XWiki.Images.WebHome@clientcommandphase_execute_zoom20.png||alt="ClientCommandPhase_Execute" height="19" width="19"]]) klicken. Sie sehen anhand der Statusspalte im Skript, dass nur der erste Teil der If-Else–Verzweigung ausgeführt wurde, im Ablauflog die bisherigen Aktionen zu sehen sind und im Variablenlog die aktuellen Werte eingetragen sind.
206	206
207		-(% style="text-align:center" %)
208		-[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_85a8ec5e.png||alt="5.3.1.3 - Test" height="674" width="852"]]
	204	+[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_85a8ec5e.png||alt="5.3.1.3 - Test" data-xwiki-image-style-alignment="center" height="674" width="852"]]
209	209
210	210	Klicken Sie nochmals auf Start und Sie sehen anhand der Statusspalte des Skripts, dass dieses Mal der zweite Teil der If-Else–Verzweigung ausgeführt wurde. Ebenso lassen sich wieder die bisherigen Aktionen und Variablenzustände einsehen. Verläuft das Skript/Client Command korrekt, speichern Sie dieses über das entsprechende Icon und lassen sich evtl. eine Zusammenfassung ausgeben. Schließen Sie nun den Editor.