Wiki source code of AutoMATE anwenden

Last modified by Steffi F on 2025/05/05 09:16
Show last authors
1 {{aagon.floatingbox/}}
2
3 ACMP AutoMATE ermöglicht die Aufzeichnung von Aktionen auf einem Windows-Client. Die Aufzeichnung kann später über ACMP auf verwalteten Netzwerkclients ausgeführt werden, sodass zum Beispiel Softwareinstallationen automatisiert und unbeaufsichtigt durchgeführt werden können.
4
5 {{aagon.infobox}}
6 Die Verwendung von ACMP AutoMATE ist ab Windows 10 bedenkenlos möglich.Wenn Sie ACMP AutoMATE unter Windows 8.1 verwenden kann es zu Funktionseinschränkungen kommen und wird daher nicht unterstützt.
7 Die Verwendung von ACMP AutoMATE unter Betriebssystemen < Windows 8 wird generell nicht unterstützt.
8 {{/aagon.infobox}}
9
10 Über das Icon //AutoMATE kopieren// ([[image:automate.png]]) öffnen Sie ein Verzeichnis, in welchem alle notwendigen Dateien für ACMP AutoMATE hinterlegt sind. Diese können Sie kopieren um ACMP AutoMATE auf einem Client zu starten, auf dem keine zusätzliche Software vorhanden ist.
11
12 {{aagon.infobox}}
13 Wir empfehlen die Ausführung des ACMP AutoMATE auf einem Core-Client, sodass ggf. vorhandene Dateien und Ordner die Installation nicht negativ beeinflussen.
14 {{/aagon.infobox}}
15
16 Zur Verwendung des ACMP AutoMATE starten Sie die ACMPAutoMATE.exe.
17
18 (% style="text-align:center" %)
19 [[image:XWiki.Images.WebHome@automate_zoom80.png||alt="ACMP AutoMATE" height="502" width="717"]]
20 ACMP AutoMATE
21
22 Über die Ribbonleiste werden Ihnen alle Funktionen angezeigt, die beim ACMP AutoMATE verwendet werden können.
23
24 (% style="width:1033px" %)
25 |(((
26 [[image:ACMP.63.First Steps im ACMP.Aufbau der Console.Ribbonleiste.Stammdaten.WebHome@file_add.png||alt="File_Add" data-xwiki-image-style-alignment="center" height="32" width="32"]]
27 )))|(% style="width:952px" %)(((
28 Öffnet ein neues Script.
29 )))
30 |(((
31 [[image:ACMP.63.First Steps im ACMP.Aufbau der Console.Ribbonleiste.Stammdaten.WebHome@folder.png||alt="Folder" data-xwiki-image-style-alignment="center" height="32" width="32"]]
32 )))|(% style="width:952px" %)(((
33 Öffnet den Explorer zum Öffnen eines zuvor gespeicherten Scripts. Dieses muss im Format *.ams vorliegen.
34 )))
35 |(((
36 [[image:ACMP.63.First Steps im ACMP.Aufbau der Console.Ribbonleiste.Stammdaten.WebHome@save.png||alt="save" data-xwiki-image-style-alignment="center" height="32" width="32"]]
37 )))|(% style="width:952px" %)(((
38 Speichert das aktuelle Script.
39 )))
40 |(((
41 [[image:automate_saveas.png||alt="AutoMATE_SaveAs" data-xwiki-image-style-alignment="center" height="32" width="32"]]
42 )))|(% style="width:952px" %)(((
43 Öffnet den Explorer zum Speichern des Scipts im *.ams-Format.
44 )))
45 |(((
46 [[image:add.png||alt="add" data-xwiki-image-style-alignment="center" height="32" width="32"]]
47 )))|(% style="width:952px" %)(((
48 Öffnet ein Dialogfenster zum Hinzufügen einer Aktion.
49 )))
50 |(((
51 [[image:XWiki.Images.WebHome@edit.png||alt="Edit" data-xwiki-image-style-alignment="center" height="32" width="32"]]
52 )))|(% style="width:952px" %)(((
53 Ermöglicht das Bearbeiten einer vorhandenen Aktion.
54 )))
55 |(((
56 [[image:XWiki.Images.WebHome@delete_button_error.png||alt="delete_button_error" data-xwiki-image-style-alignment="center" height="32" width="32"]]
57 )))|(% style="width:952px" %)(((
58 Löscht die markierte Aktion.
59 )))
60 |(((
61 [[image:XWiki.Images.WebHome@modify-delete-duplicate.png||alt="modify-delete-duplicate" data-xwiki-image-style-alignment="center" height="32" width="32"]]
62 )))|(% style="width:952px" %)(((
63 Dupliziert die markierte Aktion
64 )))
65 |[[image:XWiki.Images.WebHome@action-record_zoom50.png||data-xwiki-image-style-alignment="center" height="21" width="19"]]|(% style="width:952px" %)(((
66 Startet bzw. pausiert eine Aufnahme.
67 )))
68 |(((
69 [[image:XWiki.Images.WebHome@action-play.png||alt="action-play" data-xwiki-image-style-alignment="center" height="32" width="32"]]
70 )))|(% style="width:952px" %)(((
71 Spielt das aktuelle Script ab.
72 )))
73
74 ACMP AutoMATE muss für die fehlerfreie Aufzeichnung im gleichen Kontext gestartet werden wie die Setup-Datei. Hierbei handelt es sich in der Regel um die Ausführung mit administrativen Rechten.
75
76 Wenn ACMP AutoMATE nicht im administrativen Kontext ausgeführt wird, können Sie einen Neustart durchführen.
77
78 (% style="text-align:center" %)
79 [[image:XWiki.Images.WebHome@hmfile_hash_f3430620.png||alt="ACMP AutoMATE mit administrativen Rechten neu starten" height="502" width="717"]]
80 ACMP AutoMATE mit administrativen Rechten neu starten
81
82 = Systemmenü =
83
84 Das Systemmenü ist in drei Bereiche unterteilt.
85
86 (% style="text-align:center" %)
87 [[image:XWiki.Images.WebHome@hmfile_hash_8ee3293f.png||alt="Systemmenü" height="455" width="657"]]
88 Systemmenü
89
90 Der Punkt //Informationen// zeigt Ihnen neben der installierten Version auch die Buildnummer an. Über //Hilfe //rufen Sie die Onlinehilfe auf und der Menüpunkt //Beenden //schließt ACMP AutoMATE.
91
92 {{aagon.infobox}}
93 Sollten Sie ACMP AutoMATE schließen wollen, obwohl ungespeicherte Daten vorhanden sind, müssen Sie das Schließen erneut bestätigen oder die Daten speichern.
94 {{/aagon.infobox}}
95
96 = Skript erstellen =
97
98 ACMP AutoMATE bietet Ihnen die Möglichkeit Software-Installationen und Software-Deinstallationen aufzuzeichnen und so diese wiederholenden Aufgaben netzwerkweit zu automatisieren.
99
100 == Aufzeichnung eines Installations-Skripts ==
101
102 Zur Vorbereitung der Aufzeichnung einer Installation vergewissern Sie sich, dass Ihr System dem des zukünftigen Systems ähnelt. Hierbei ist ein identischen Betriebssystem sowie bereits installierte Software relevant.
103
104 Kopieren Sie nun die Setup-Datei sowie die AutoMATE-Dateien.
105
106 Starten Sie nun die Setup-Datei der zu installierenden Software ohne etwas anzuklicken und starten Sie anschließend ACMP AutoMATE.
107
108 {{aagon.infobox}}
109 Das Setup muss ohne AutoMATE gestartet werden, da der Aufruf später im Wizard per Shell execute Command durchgeführt wird.
110 {{/aagon.infobox}}
111
112 Zum Aufzeichnen klicken Sie nun in der Ribbonleiste auf //Aufnehmen//, wodurch die Aufnahme gestartet wird. ACMP AutoMATE zeichnet nun jeden Mausklick und jeden Tastaturanschlag auf bis Sie die Aufnahme pausieren.
113
114 Minimieren Sie AutoMATE und führen Sie das Setup aus. Klicken Sie hierbei nur die zur Installation relevanten Elemente an und vermeiden Sie unnötige Klicks.
115
116 Nachdem Sie die Installation beendet haben, pausieren Sie die Aufzeichnung im AutoMATE und speichern das Skript. Möchten Sie das automatisch erstellte Skript ändern, klicken Sie in der Ribbonleiste auf //Bearbeiten//. Über diese Funktion können Sie beispielsweise auch einen Wert für das Feld //Taste //korrigieren, falls Sie sich in Ihrer Eingabe vertippt haben und den Tastendruck ([[Virtual-Key Code>>https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes]]) manuell anpassen möchten. Über //Hinzufügen// können Sie einen neuen Wert innerhalb des Skriptes ergänzen, falls Sie einen weiteren Schritt händisch angeben möchten.
117
118 {{aagon.infobox}}
119 Bitte beachten Sie, dass die Werte der verlinkten Virtual-Key Codes-Liste als Hexadezimalzahlen angegeben sind. Möchten Sie diese im ACMP AutoMATE verwenden, müssen Sie diese erst ins Dezimalsystem umrechnen, damit sie korrekt angegeben werden. Es gilt nicht das Symbol (z.B. der Tastendruck), welches Sie eingeben, sondern der Identifikator der Tastatur. Damit sollen beispielsweise Probleme verschiedener Layouts von Tastaturen (z.B. die Tastaturbelegungen der Positionen von Y und Z der deutschen und englischen Tastaturen) entgegengewirkt werden.
120 {{/aagon.infobox}}
121
122 {{figure}}
123 [[image:63_ClientCommands_AutoMATE_905.png||data-xwiki-image-style-alignment="center"]]
124
125 {{figureCaption}}
126 Aufgezeichnetes Installationsskript
127 {{/figureCaption}}
128 {{/figure}}
129
130 == Aufzeichnung eines Deinstallations-Skripts ==
131
132 Zur Aufzeichnung eines Deinstallations-Skripts ermitteln Sie zunächst den Uninstallstring der Software, für die Sie die Deinstallation aufzeichnen wollen.
133
134 {{aagon.infobox}}
135 Der Uninstallstring einer Software ist in der Registry unter Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\%Software% hinterlegt. Speichern Sie den Wert für die spätere Verwendung in z.B. einer Textdatei.
136 {{/aagon.infobox}}
137
138 Rufen Sie nun den Uninstallstring auf ohne etwas zu klicken. Starten Sie ACMP AutoMATE und beginnen Sie mit der Aufzeichnung, indem Sie in der Ribbonleiste //Aufnehmen //klicken. Führen Sie nun die Deinstallation durch und klicken Sie hierbei nur die zur Deinstallation notwendigen Elemente an.
139
140 Wenn die Deinstallation abgeschlossen ist, pausieren Sie die Aufnahme und speichern das erstellte Skript.
141
142 = Skript bearbeiten =
143
144 Sie haben die Möglichkeit die Details eines aufgezeichneten Skripts zu bearbeiten. Hierzu markieren Sie im AutoMATE die Aktion, die Sie bearbeiten wollen und klicken in der Ribbonleiste auf //Bearbeiten//. Hierdurch wird die Aktion im Bearbeitungsfenster geöffnet und Sie können individuelle Anpassungen vornehmen.
145
146 == Verwendung von Platzhaltern bei der Suche ==
147
148 Sie können für die Anpassung der Details für den Namen des Fensters, Name des UI-Elements und den Wert des UI-Elements verschiedene Platzhalter nutzen. Sollten Sie nicht den exakten Namen oder Schreibweise wissen, können die Platzhalter dabei helfen, die richtigen Einträge zu finden. Es werden die Wildcards "*" und "?" unterstützt.
149
150 |**Platzhalter**|**Beschreibung**
151 |*|Der Platzhalter * wird genutzt, um eine Zeichenkette aufzurufen und auf vorhandene Werte zuzugreifen.
152 Sie können dieses Zeichen an einer beliebigen Stelle einer Zeichenkette einsetzen.
153 |?|Der Platzhalter ? wird genutzt, um ein einzelnes Zeichen aufzurufen. Danach können Sie auf die vorhandenen Werte zugreifen.
154 Dieses Zeichen entspricht einem einzelnen Zeichen an einer bestimmten Stelle.
155
156 = Skript testen =
157
158 Zum Testen eines gespeicherten Skripts starten Sie zunächst das Setup bzw. rufen den Deinstallationsstring auf ohne bereits etwas zu klicken.
159
160 Öffnen Sie nun ACMP AutoMATE, öffnen das gespeicherte Skript und klicken in der Ribbonleiste auf //Abspielen//.
161
162 {{aagon.infobox}}
163 Es kann sein, dass das Skript zur Ermittlung der zu verwendeten Fenster länger benötigt. Warten Sie bitte, bis die Aktion abgeschlossen ist. Wenn der Button oder die auszuführende Aktion nach 5 Minuten nicht gefunden wurde, wird das Skript automatisch abgebrochen.
164 {{/aagon.infobox}}
165
166 Wenn die Installation bzw. Deinstallation anhand des gespeicherten Skipts abgeschlossen wurde, stoppt ACMP AutoMATE selbstständig.
167
168 = Skript in ACMP einbinden =
169
170 Nachdem Sie Installations- bzw. Deinstallationsskript erstellt und erfolgreich getestet haben, können Sie dieses zur Verteilung in ACMP einbinden.
171
172 Navigieren Sie hierzu zunächst in der Navigation zu //Client Commands// -> //Erstellen// und markieren das Verzeichnis, in welchem Sie das Skript einbinden wollen. Klicken Sie nun in der Ribbonleiste auf //Paket Wizard für Windows//.
173
174 Auf der ersten Seite vergeben Sie einen Namen sowie eine optionale Beschreibung. Den Zielordner können Sie bei Bedarf hier noch anpassen.
175
176 Im unteren Bereich des Fensters wählen Sie beim Installationstyp Ich habe ACMP AutoMATE Dateien aus und klicken auf //Weiter//.
177
178 [[image:35_64_Client Commands_Windows Paket Wizard_1918.png||alt="Paket Wizard für Windows starten" data-xwiki-image-style-alignment="center"]]
179
180
181 Paket Wizard für Windows starten
182
183 Im oberen Bereich fügen Sie nun die Installationsdateien hinzu, indem Sie auf Datei hinzufügen klicken. Im unteren Bereich geben Sie die gespeicherten Skripte an und beenden den Wizard.
184
185 (% style="text-align:center" %)
186 [[image:XWiki.Images.WebHome@hmfile_hash_edfe4dc6.png||alt="Skript auswählen" height="484" width="733"]]
187 Skript auswählen
188
189 {{aagon.infobox}}
190 Wollen Sie ausschließlich ein Deinstallationsskript einbinden, öffnen Sie das gerade hinzugefügte Client Command im Client Command Editor. Hier müssen Sie im Shell Execute Command (dieses ist in Zeile 119) den Uninstallstring als Dateiname hinzufügen.Speichern Sie das Client Command, geben Sie dieses frei und führen es auf Testclients aus.
191 {{/aagon.infobox}}
192
193 == Skript in Client Command Editor importieren ==
194
195 Alternativ zur Verwendung des Paket Wizards für Windows können Sie ein gespeichertes Skript auch direkt in den Client Command Editor importieren.
196
197 Navigieren Sie hierzu in der Navigation zu //Client Commands// -> //Erstellen //und klicken in der Ribbonleiste auf //Client Command hinzufügen//. Es öffnet sich nun der Client Command Editor. Entscheiden Sie sich für die Erstellung eines Client Skripts und klicken Sie anschließend in der Menüleiste auf //Import//.
198
199 (% style="text-align:center" %)
200 [[image:XWiki.Images.WebHome@hmfile_hash_7ce5faa5.png||alt="Skript in Client Command Editor importieren" height="416" width="768"]]
201 Skript in Client Command Editor importieren
202
203 Ihnen werden nun alle aufgezeichnetes Schritte des Skripts angezeigt. Speichern Sie das Client Command, bevor Sie es zur Verteilung verwenden.
204
205 == Benutzerinteraktionen sperren ==
206
207 Um zu verhindern, dass Benutzer bei der Ausfühung des Client Commands durch Mausklicke oder Tastenanschläge den Fortschritt der Installation beeinträchtigen, fügen Sie vor dem importieren AutoMATE-Skript den Befehl "Lock manual input" hinzu.
208
209 (% style="text-align:center" %)
210 [[image:XWiki.Images.WebHome@hmfile_hash_17e4b193.png||alt="Benutzereingaben sperren" height="443" width="387"]]
211 Benutzereingaben sperren
212
213 {{aagon.infobox}}
214 Damit die Ausführung der Aufgezeichneten Installation nicht beeinträchtigt wird müssen Sie im Befehl die Checkbox für Dialog anzeigen deaktivieren.
215 {{/aagon.infobox}}
216
217 Nach dem importierten AutoMATE-Skript fügen Sie den Befehl Unlock manual input ein, um Benutzerinteraktionen wieder zu aktivieren.
218
219 = FAQs =
220
221 |**Frage/Problem**|**Antwort**
222 |Eine Aktion bzw. ein Fenster wird bei der Ausführung via Client Command nicht gefunden, aber im ACMPAutoMATE funktioniert es. Wie kann das sein?|Entfernen Sie den Haken UI Element Value aus dem AutoMATE-Skript. Hierdurch wird dieser Teil deaktiviert und die Aktion wird auch wieder via Client Command gefunden.
223 |Die Comboboxen werden nicht richtig erkannt. Wie kann das sein?|Wenn Sie Comboboxen aufzeichnen wollen, müssen Sie immer exakt die Pfeile anklicken.
224 |Meine Dropdownlisten werden nicht richtig erkannt.|Wenn Sie Dropdownlisten aufzeichnen wollen, müssen Sie auf den entsprechenden Text klicken.
225 |Wie gebe ich einen Pfad richtig an?|Pfadeingaben sollten Sie immer über Wert setzen durchführen.
226 |Ich möchte in mein ACMP AutoMATE Wizard Paket gerne eine Bildschirmsperre einbauen, damit der User nicht dazwischen klicken kann. Wie gehe ich am besten vor?|Am besten positioniert man die Befehle vor dem Befehl "Shell execute command/ Befehl ausführen" und nach dem letzten "UI Interaction / " Befehl. Diese finden Sie auf der Client Skript Seite im "Switch ~(%INSTALLMODE%) im Case (install).
227
228 {{aagon.infobox}}
229 Um Übersteuerungen der Maussteuerung von AutoMATE zu verhindern, sollten Sie beim Abspielen einer Aufzeichnung die Maus nicht bewegen.
230 {{/aagon.infobox}}
231
232 [[image:XWiki.Images.WebHome@aesb-faq-1.png||alt="aesb-faq-1" data-xwiki-image-style-alignment="center" height="256" width="529"]]
233
234 In dem Befehl "Lock manual input / Manuelle Eingaben sperren" muss noch die Option Dialog anzeigen deaktiviert werden damit AutoMATE ohne Probleme die Buttons in den Installationen drücken kann.
235
236 [[image:XWiki.Images.WebHome@aesb-faq-2.png||alt="aesb-faq-2" data-xwiki-image-style-alignment="center" height="406" width="480"]]
237
238 |**Frage/Problem**|**Antwort**
239 |Ich möchte gerne die Deinstallation auch mit dem AutoMATE aufzeichnen. Allerdings verfügt die Installation über keinen Deinstallation Funktion. Wie gehe ich am besten vor?|Meist gibt es für jedes Programm eine eigene Deinstallation z.B. eine Unistall.exe. Diese wird übrigens auch vom ACMP ausgelesen und kann in der Inventarisierung (//Client Details// > //Software //> //Installierte Software// > //Setup //> //Deinstallationspfad//) nachgeschaut werden. Wenn man diese Identifiziert hat sollte man am besten diese mit dem AutoMATE aufzeichnen. Eventuell verfügt die Deinstallation auch über Silent Parameter obwohl die Installation keine hat. Wenn Sie die Deinstallation auch auf gezeichnet haben, können Sie nun das Deinstallations-Skript auch im Paket Wizard angeben.Anschließend müssen Sie nur über den Client Command Editor die Datei ändern die bei der Deinstallation aufgerufen wird.
240 \\Diese finden Sie auf der Client Skript Seite im "Switch ~(%INSTALLMODE%) im Case (uninstall). Hier müssen Sie unter dem Befehl  "Shell execute command/ Befehl ausführen" den Dateinamen ändern.(((
241 [[image:XWiki.Images.WebHome@aesb-faq-3.png||alt="aesb-faq-3" data-xwiki-image-style-alignment="center" height="520" width="602"]]
242 )))
243 |Beim Durchlaufen der aufgezeichneten Installation auf den Systemen sind die Installationsdialoge nur als Rahmen oder ähnliches zu erkennen. Somit sieht der User nicht ob etwas passiert. Kann ich dies ändern?(((
244 (% id="cke_bm_14145S" style="display:none" %) (%%)Beispiel 1:
245
246 [[image:XWiki.Images.WebHome@aesb-faq-4.png||alt="aesb-faq-4" data-xwiki-image-style-alignment="center" height="181" width="331"]]
247
248
249 Beispiel 2:
250
251 [[image:XWiki.Images.WebHome@aesb-faq-5.png||alt="aesb-faq-5" data-xwiki-image-style-alignment="center" height="419" width="496"]]
252 )))|Hier kann eine Änderung der Ausführungsoptionen helfen. Grundsätzlich ist zu empfehlen z.B. über einen Dialog den Start und das Ende des Skriptes für den User klar zu kommunizieren. Während die Installation läuft sollten am besten die Eingaben gesperrt werden ("Lock manual input / Manuelle Eingaben sperren")  und über ein Fortschrittsfenster ("Show progressform" und "Set progressform properties") sollte eine Status Information angezeigt werden. Um die eigentliche Installation wieder anzuzeigen, muss meist die Option "Fenster auf Benutzerdesktop anzeigen"  im Befehl  "Shell execute command/ Befehl ausführen" geändert werden.(((
253 [[image:XWiki.Images.WebHome@aesb-faq-6_zoom80.png||alt="aesb-faq-6" data-xwiki-image-style-alignment="center" height="503" width="622"]]
254
255
256 Damit dann das AutoMATE aber wieder die Fenster sieht und findet stellt man einfach ein das diese als Benutzer ausgeführt werden. Hierbei werden dann die entsprechenden Aktionen auf dem grade angemeldeten User Desktop ausgeführt mit den Berechtigungen die unter dem Tab "Ausführen als" eingetragen sind.
257 \\
258
259 [[image:XWiki.Images.WebHome@aesb-faq-7_zoom80.png||alt="aesb-faq-7" data-xwiki-image-style-alignment="center" height="503" width="617"]]
260 )))
© Aagon GmbH 2025
Besuchen Sie unsere neue Aagon-Community