Wiki source code of AutoMATE anwenden

Last modified by Sabrina V. on 2026/08/03 08:12

version	line-number	content
1.1	1	{{aagon.floatingbox/}}
	2
22.4	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.
1.1	4
	5	{{aagon.infobox}}
22.4	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.
1.1	9	{{/aagon.infobox}}
	10
22.4	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.
1.1	12
	13	{{aagon.infobox}}
22.4	14	We recommend executing aAmp utoMATE on a Core client so that any existing files and folders do not negatively affect the installation.
1.1	15	{{/aagon.infobox}}
	16
22.4	17	To use acmp AutoMATE, execute ACMPAutoMATE.exe.
1.1	18
	19	(% style="text-align:center" %)
13.1	20	[[image:XWiki.Images.WebHome@automate_zoom80.png\|\|alt="ACMP AutoMATE" height="502" width="717"]]
22.4	21	acmp AutoMATE
1.1	22
22.4	23	The ribbon bar displays all functions available in acmp AutoMATE.
1.1	24
	25	(% style="width:1033px" %)
	26	\|(((
13.1	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"]]
1.1	28	)))\|(% style="width:952px" %)(((
22.4	29	Opens a new script.
1.1	30	)))
	31	\|(((
13.1	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"]]
1.1	33	)))\|(% style="width:952px" %)(((
22.4	34	Opens File Explorer to open a previously saved script. The script must be in *.ams format.
1.1	35	)))
	36	\|(((
13.1	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"]]
1.1	38	)))\|(% style="width:952px" %)(((
22.4	39	Saves the current script.
1.1	40	)))
	41	\|(((
13.1	42	[[image:automate_saveas.png\|\|alt="AutoMATE_SaveAs" data-xwiki-image-style-alignment="center" height="32" width="32"]]
1.1	43	)))\|(% style="width:952px" %)(((
22.4	44	Opens File Explorer to save the script in *.ams format.
1.1	45	)))
	46	\|(((
13.1	47	[[image:add.png\|\|alt="add" data-xwiki-image-style-alignment="center" height="32" width="32"]]
1.1	48	)))\|(% style="width:952px" %)(((
22.4	49	Opens a dialog box to add an action.
1.1	50	)))
	51	\|(((
13.1	52	[[image:XWiki.Images.WebHome@edit.png\|\|alt="Edit" data-xwiki-image-style-alignment="center" height="32" width="32"]]
1.1	53	)))\|(% style="width:952px" %)(((
22.4	54	Allows you to edit an existing action.
1.1	55	)))
	56	\|(((
13.1	57	[[image:XWiki.Images.WebHome@delete_button_error.png\|\|alt="delete_button_error" data-xwiki-image-style-alignment="center" height="32" width="32"]]
1.1	58	)))\|(% style="width:952px" %)(((
22.4	59	Deletes the selected action.
1.1	60	)))
	61	\|(((
13.1	62	[[image:XWiki.Images.WebHome@modify-delete-duplicate.png\|\|alt="modify-delete-duplicate" data-xwiki-image-style-alignment="center" height="32" width="32"]]
1.1	63	)))\|(% style="width:952px" %)(((
22.4	64	Duplicates the selected action.
1.1	65	)))
13.1	66	\|[[image:XWiki.Images.WebHome@action-record_zoom50.png\|\|data-xwiki-image-style-alignment="center" height="21" width="19"]]\|(% style="width:952px" %)(((
22.4	67	Starts or pauses a recording.
1.1	68	)))
	69	\|(((
13.1	70	[[image:XWiki.Images.WebHome@action-play.png\|\|alt="action-play" data-xwiki-image-style-alignment="center" height="32" width="32"]]
1.1	71	)))\|(% style="width:952px" %)(((
22.4	72	Runs the current script.
1.1	73	)))
	74
22.4	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.
1.1	76
22.4	77	If acmp AutoMATE is not executing in an administrative context, you can restart it.
1.1	78
	79	(% style="text-align:center" %)
13.1	80	[[image:XWiki.Images.WebHome@hmfile_hash_f3430620.png\|\|alt="ACMP AutoMATE mit administrativen Rechten neu starten" height="502" width="717"]]
22.4	81	Restart acmp AutoMATE with administrative rights
1.1	82
22.4	83	= System Menu =
1.1	84
22.4	85	The System Menu is divided into three sections.
1.1	86
	87	(% style="text-align:center" %)
13.1	88	[[image:XWiki.Images.WebHome@hmfile_hash_8ee3293f.png\|\|alt="Systemmenü" height="455" width="657"]]
22.4	89	System menu
1.1	90
22.4	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.
1.1	92
	93	{{aagon.infobox}}
22.4	94	If you want to close ACMP AutoMATE while there is unsaved data, you must confirm the closure again or save the data.
1.1	95	{{/aagon.infobox}}
	96
	97
	98
22.4	99	= Create a Script =
1.1	100
22.4	101	ACMP AutoMATE allows you to record software installations and uninstallations, thereby automating these repetitive tasks across the network.
1.1	102
	103
	104
22.4	105	== Recording an Installation Script ==
1.1	106
22.4	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.
1.1	108
22.4	109	Now copy the setup file and the AutoMATE files.
1.1	110
22.4	111	Next, run the setup file for the software you want to install without clicking anything, and then launch acmp AutoMATE.
1.1	112
	113	{{aagon.infobox}}
22.4	114	The setup must be started without AutoMATE, as it will be launched later in the wizard via the “Shell Execute Command.”
1.1	115	{{/aagon.infobox}}
	116
22.4	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.
1.1	118
22.4	119	Minimize AutoMATE and execute the setup. Click only on the elements relevant to the installation and avoid unnecessary clicks.
1.1	120
22.4	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.
1.1	122
22.4	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}}
1.1	126
22.4	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
1.1	134	{{aagon.infobox}}
22.4	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.
1.1	136	{{/aagon.infobox}}
	137
22.4	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.
1.1	139
22.4	140	Once the uninstallation is finished, pause the recording and save the script you created.
1.1	141
	142
	143
22.4	144	= Edit Script =
1.1	145
22.4	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.
1.1	147
22.4	148	== Using Placeholders in Searches ==
1.1	149
22.4	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.
1.1	151
22.4	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.
1.1	155
22.4	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	)))
1.1	162
22.4	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
1.1	171	{{aagon.infobox}}
22.4	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.
1.1	173	{{/aagon.infobox}}
	174
22.4	175	Once the installation or uninstallation has been finished using the saved script, acmp AutoMATE will stop automatically.
1.1	176
	177
	178
22.4	179	= Integrating the Script into ACMP =
1.1	180
22.4	181	After you have created and successfully tested the installation or uninstall script, you can integrate it into ACMP for distribution.
1.1	182
22.4	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.
1.1	184
22.4	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
5.1	189	[[image:35_64_Client Commands_Windows Paket Wizard_1918.png\|\|alt="Paket Wizard für Windows starten" data-xwiki-image-style-alignment="center"]]
1.1	190
	191
22.4	192	Start the package wizard for Windows
1.1	193
22.4	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.
1.1	195
	196	(% style="text-align:center" %)
13.1	197	[[image:XWiki.Images.WebHome@hmfile_hash_edfe4dc6.png\|\|alt="Skript auswählen" height="484" width="733"]]
22.4	198	Select Script
1.1	199
	200	{{aagon.infobox}}
22.4	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.
1.1	202	{{/aagon.infobox}}
	203
	204
	205
22.4	206	== Import Script into Client Command Editor ==
1.1	207
22.4	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
1.1	213	(% style="text-align:center" %)
13.1	214	[[image:XWiki.Images.WebHome@hmfile_hash_7ce5faa5.png\|\|alt="Skript in Client Command Editor importieren" height="416" width="768"]]
22.4	215	Importing a Script into the Client Command Editor
1.1	216
22.4	217	All recorded steps of the script will now be displayed. Save the Client Command before using it for distribution.
1.1	218
22.4	219	== Lock User Interactions ==
1.1	220
22.4	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.
1.1	222
	223	(% style="text-align:center" %)
13.1	224	[[image:XWiki.Images.WebHome@hmfile_hash_17e4b193.png\|\|alt="Benutzereingaben sperren" height="443" width="387"]]
22.4	225	Lock User Input
1.1	226
	227	{{aagon.infobox}}
22.4	228	To ensure that the execution of the recorded installation is not disrupted, you must disable the “Show dialog” checkbox in the command.
1.1	229	{{/aagon.infobox}}
	230
22.4	231	After the imported AutoMATE script, insert the “Unlock manual input” command to enable user interactions.
1.1	232
	233	= FAQs =
	234
22.4	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	)))
1.1	259
	260	{{aagon.infobox}}
22.4	261	To prevent AutoMATE’s mouse control from being overridden, do not move the mouse while playing back a recording.
1.1	262	{{/aagon.infobox}}
	263
19.1	264	[[image:XWiki.Images.WebHome@aesb-faq-1.png\|\|alt="aesb-faq-1" data-xwiki-image-style-alignment="center" height="256" width="529"]]
1.1	265
	266