Wiki source code of AutoMATE anwenden

Last modified by Sabrina V. on 2026/08/03 08:12
Show last authors
1 {{aagon.floatingbox/}}
2
3 acmp AutoMATE allows you to record actions on a Windows client. The recording can later be executed via acmp on managed network clients, allowing, for example, software installations to be performed automatically and unattended.
4
5 {{aagon.infobox}}
6 acmp AutoMATE can be used without any issues on Windows 10 and later. If you use acmp AutoMATE on Windows 8.1, some features may be limited, and it is therefore not supported.
7
8 The use of acmp AutoMATE on operating systems older than Windows 8 is generally not supported.
9 {{/aagon.infobox}}
10
11 Click the //Copy AutoMATE// icon ([[image:automate.png]]) to open a folder containing all the necessary files for acmp AutoMATE. You can copy these files to launch acmp AutoMATE on a Client that does not have any additional software installed.
12
13 {{aagon.infobox}}
14 We recommend executing aAmp utoMATE on a Core client so that any existing files and folders do not negatively affect the installation.
15 {{/aagon.infobox}}
16
17 To use acmp AutoMATE, execute ACMPAutoMATE.exe.
18
19 (% style="text-align:center" %)
20 [[image:XWiki.Images.WebHome@automate_zoom80.png||alt="ACMP AutoMATE" height="502" width="717"]]
21 acmp AutoMATE
22
23 The ribbon bar displays all functions available in acmp AutoMATE.
24
25 (% style="width:1033px" %)
26 |(((
27 [[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"]]
28 )))|(% style="width:952px" %)(((
29 Opens a new script.
30 )))
31 |(((
32 [[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"]]
33 )))|(% style="width:952px" %)(((
34 Opens File Explorer to open a previously saved script. The script must be in *.ams format.
35 )))
36 |(((
37 [[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"]]
38 )))|(% style="width:952px" %)(((
39 Saves the current script.
40 )))
41 |(((
42 [[image:automate_saveas.png||alt="AutoMATE_SaveAs" data-xwiki-image-style-alignment="center" height="32" width="32"]]
43 )))|(% style="width:952px" %)(((
44 Opens File Explorer to save the script in *.ams format.
45 )))
46 |(((
47 [[image:add.png||alt="add" data-xwiki-image-style-alignment="center" height="32" width="32"]]
48 )))|(% style="width:952px" %)(((
49 Opens a dialog box to add an action.
50 )))
51 |(((
52 [[image:XWiki.Images.WebHome@edit.png||alt="Edit" data-xwiki-image-style-alignment="center" height="32" width="32"]]
53 )))|(% style="width:952px" %)(((
54 Allows you to edit an existing action.
55 )))
56 |(((
57 [[image:XWiki.Images.WebHome@delete_button_error.png||alt="delete_button_error" data-xwiki-image-style-alignment="center" height="32" width="32"]]
58 )))|(% style="width:952px" %)(((
59 Deletes the selected action.
60 )))
61 |(((
62 [[image:XWiki.Images.WebHome@modify-delete-duplicate.png||alt="modify-delete-duplicate" data-xwiki-image-style-alignment="center" height="32" width="32"]]
63 )))|(% style="width:952px" %)(((
64 Duplicates the selected action.
65 )))
66 |[[image:XWiki.Images.WebHome@action-record_zoom50.png||data-xwiki-image-style-alignment="center" height="21" width="19"]]|(% style="width:952px" %)(((
67 Starts or pauses a recording.
68 )))
69 |(((
70 [[image:XWiki.Images.WebHome@action-play.png||alt="action-play" data-xwiki-image-style-alignment="center" height="32" width="32"]]
71 )))|(% style="width:952px" %)(((
72 Runs the current script.
73 )))
74
75 acmp AutoMATE must be executed in the same context as the setup file to ensure error-free recording. This typically involves executing the program with administrative rights.
76
77 If acmp AutoMATE is not executing in an administrative context, you can restart it.
78
79 (% style="text-align:center" %)
80 [[image:XWiki.Images.WebHome@hmfile_hash_f3430620.png||alt="ACMP AutoMATE mit administrativen Rechten neu starten" height="502" width="717"]]
81 Restart acmp AutoMATE with administrative rights
82
83 = System Menu =
84
85 The System Menu is divided into three sections.
86
87 (% style="text-align:center" %)
88 [[image:XWiki.Images.WebHome@hmfile_hash_8ee3293f.png||alt="Systemmenü" height="455" width="657"]]
89 System menu
90
91 The //Info// item displays both the installed version and the build number. Select //Help// to access the online help, and the //Exit// menu item closes ACMP AutoMATE.
92
93 {{aagon.infobox}}
94 If you want to close ACMP AutoMATE while there is unsaved data, you must confirm the closure again or save the data.
95 {{/aagon.infobox}}
96
97
98
99 = Create a Script =
100
101 ACMP AutoMATE allows you to record software installations and uninstallations, thereby automating these repetitive tasks across the network.
102
103
104
105 == Recording an Installation Script ==
106
107 To prepare for recording an installation, make sure your system is similar to the target system. This includes having the same operating system and the same software already installed.
108
109 Now copy the setup file and the AutoMATE files.
110
111 Next, run the setup file for the software you want to install without clicking anything, and then launch acmp AutoMATE.
112
113 {{aagon.infobox}}
114 The setup must be started without AutoMATE, as it will be launched later in the wizard via the “Shell Execute Command.”
115 {{/aagon.infobox}}
116
117 To start recording, click //Record// in the ribbon bar; this will begin the recording. ACMP AutoMATE will now record every mouse click and keystroke until you pause the recording.
118
119 Minimize AutoMATE and execute the setup. Click only on the elements relevant to the installation and avoid unnecessary clicks.
120
121 After you have completed the installation, pause the recording in AutoMATE and save the script. If you want to change the automatically created script, click //Edit// on the ribbon bar. Using this function, you can, for example, correct a value for the //Key// field if you made a typo when entering information and want to manually customize the key press ( ([[Virtual-Key Code>>https://docs.microsoft.com/en-us/windows/win32/inputdev/virtual-key-codes]]). Using //Add//, you can add a new value to the script if you want to specify a continuing step manually.
122
123 {{aagon.infobox}}Please note that the values in the linked Virtual Key Codes list are specified as hexadecimal numbers. If you want to use these in ACMP AutoMATE, you must first convert them to the decimal system so that they are entered correctly. It is not the symbol (e.g., the keystroke) that you enter that matters, but rather the keyboard identifier. This is intended to counteract problems arising from different keyboard layouts (e.g., the key assignments for the Y and Z keys on German and English keyboards).{{/aagon.infobox}}{{figure}}[[image:63_ClientCommands_AutoMATE_905.png||data-xwiki-image-style-alignment="center"]]{{figureCaption}}
124 Recorded Installation Script
125 {{/figureCaption}}{{/figure}}
126
127 (((
128
129
130 == Recording an Uninstallation Script ==
131
132 To record an uninstallation script, first determine the uninstall string for the software you want to record the uninstallation for.
133
134 {{aagon.infobox}}
135 A software’s uninstall string is stored in the registry under Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\%Software%. Save the value for later use, for example, in a text file.
136 {{/aagon.infobox}}
137
138 Now enter the uninstall string without clicking anything. Launch acmp AutoMATE and start recording by clicking //Record// on the ribbon bar. Now perform the uninstallation, clicking only on the elements necessary for uninstallation.
139
140 Once the uninstallation is finished, pause the recording and save the script you created.
141
142
143
144 = Edit Script =
145
146 You can edit the details of a recorded script. To do this, select the action you want to edit in AutoMATE and click //Edit// on the ribbon bar. This opens the action in the editing window, where you can customize it.
147
148 == Using Placeholders in Searches ==
149
150 You can use various placeholders to customize the details for the window name, UI element name, and UI element value. If you do not know the exact name or spelling, the placeholders can help you find the correct items. The wildcards “*” and “?” are supported.
151
152 |(% style="width:114px" %)**Placeholder**|(% style="width:1578px" %)**Description**
153 |(% style="width:114px" %)*|(% style="width:1578px" %)(((
154 The * placeholder is used to match a string and access existing values.
155
156 You can insert this character anywhere within a string.
157 )))
158 |(% style="width:114px" %)?|(% style="width:1578px" %)(((
159 The ? placeholder is used to match a single character. You can then access the existing values. 
160 This character corresponds to a single character at a specific position.
161 )))
162
163
164
165 = Testing a Script =
166
167 To test a saved script, first launch the setup or open the uninstallation string without clicking anything yet.
168
169 Now open acmp AutoMATE, open the saved script, and click //Play// on the ribbon bar.
170
171 {{aagon.infobox}}
172 The script may take longer to identify the windows to be used. Please wait until the action is finished. If the button or the action to be executed is not found after 5 minutes, the script will automatically be canceled.
173 {{/aagon.infobox}}
174
175 Once the installation or uninstallation has been finished using the saved script, acmp AutoMATE will stop automatically.
176
177
178
179 = Integrating the Script into ACMP =
180
181 After you have created and successfully tested the installation or uninstall script, you can integrate it into ACMP for distribution.
182
183 To do this, first navigate to //Client Commands// -> //Create// in the navigation pane and select the directory where you want to integrate the script. Now click //Package Wizard for Windows// on the ribbon bar.
184
185 On the first page, enter a name and an optional description. You can still customize the output directory here if necessary.
186
187 In the lower section of the window, select “I have ACMP AutoMATE files” for the installation type and click //Next//.
188
189 [[image:35_64_Client Commands_Windows Paket Wizard_1918.png||alt="Paket Wizard für Windows starten" data-xwiki-image-style-alignment="center"]]
190
191
192 Start the package wizard for Windows
193
194 In the upper section, add the installation files by clicking “Add File.” In the lower section, specify the saved scripts and finish the wizard.
195
196 (% style="text-align:center" %)
197 [[image:XWiki.Images.WebHome@hmfile_hash_edfe4dc6.png||alt="Skript auswählen" height="484" width="733"]]
198 Select Script
199
200 {{aagon.infobox}}
201 If you want to include only an uninstall script, open the Client Command you just added in the Client Command Editor. Here, in the Shell Execute Command (located on line 119), you must add the uninstall string as the file name. Save the Client Command, release it, and execute it on test clients.
202 {{/aagon.infobox}}
203
204
205
206 == Import Script into Client Command Editor ==
207
208 As an alternative to using the package wizard for Windows, you can also import a saved script directly into the Client Command Editor.
209
210 To do this, navigate to //Client Commands// -> //Create// and click //Add Client Command// on the ribbon bar. The Client Command Editor will now open. Select the option to create a client script, and then click //Import// on the menu bar.
211
212
213 (% style="text-align:center" %)
214 [[image:XWiki.Images.WebHome@hmfile_hash_7ce5faa5.png||alt="Skript in Client Command Editor importieren" height="416" width="768"]]
215 Importing a Script into the Client Command Editor
216
217 All recorded steps of the script will now be displayed. Save the Client Command before using it for distribution.
218
219 == Lock User Interactions ==
220
221 To prevent users from interfering with the installation progress via mouse clicks or keystrokes while the Client Command is running, add the “Lock manual input” command before importing the AutoMATE script.
222
223 (% style="text-align:center" %)
224 [[image:XWiki.Images.WebHome@hmfile_hash_17e4b193.png||alt="Benutzereingaben sperren" height="443" width="387"]]
225 Lock User Input
226
227 {{aagon.infobox}}
228 To ensure that the execution of the recorded installation is not disrupted, you must disable the “Show dialog” checkbox in the command.
229 {{/aagon.infobox}}
230
231 After the imported AutoMATE script, insert the “Unlock manual input” command to enable user interactions.
232
233 = FAQs =
234
235 |**Question / Problem**|**Answer**
236 |(((
237 An action or window cannot be found when executed via Client Command, but it works in ACMPAutoMATE. How is this possible?
238 )))|(((
239 Uncheck the “UI Element Value” box in the AutoMATE script. This disables that part, and the action will then be found again via Client Command.
240 )))
241 |(((
242 The Comboboxes are not being recognized correctly. Why is that?
243 )))|(((
244 If you want to record Comboboxes, you must always click exactly on the arrows.
245 )))
246 |(((
247 My drop-down lists are not being recognized correctly.
248 )))|(((
249 If you want to record drop-down lists, you must click on the corresponding text.
250 )))
251 |(((
252 How do I specify a path correctly?
253 )))|You should always enter paths using “Set Value.”
254 |(((
255 I’d like to add a screen lock to my ACMP AutoMATE wizard package so the user can’t click anything in between. What’s the best way to do this?
256 )))|(((
257 It’s best to place the commands before the “Shell execute command” command and after the last “UI Interaction” command. You can find these on the Client Script page in the “Switch ~(%INSTALLMODE%)” within the “Case (install)” section.
258 )))
259
260 {{aagon.infobox}}
261 To prevent AutoMATE’s mouse control from being overridden, do not move the mouse while playing back a recording.
262 {{/aagon.infobox}}
263
264 [[image:XWiki.Images.WebHome@aesb-faq-1.png||alt="aesb-faq-1" data-xwiki-image-style-alignment="center" height="256" width="529"]]
© Aagon GmbH 2026
Besuchen Sie unsere aagon-Community