AutoIt Library - Versionsgeschichte

Cg: Weiterleitung nach AutoIt Library/en erstellt

2016-12-06T19:01:49Z

Weiterleitung nach AutoIt Library/en erstellt

← Nächstältere Version		Version vom 6. Dezember 2016, 19:01 Uhr
Zeile 1:		Zeile 1:
			#redirect [[AutoIt_Library/en]]
	== Introduction ==
	AutoIt is a freeware BASIC-like scripting language designed for automating the Windows GUI and general scripting. It uses a combination of simulated keystrokes, mouse movement and window/control manipulation in order to automate tasks in a way not possible or reliable with other languages (e.g. VBScript and SendKeys).

	AutoIt was initially designed for PC "roll out" situations to reliably automate and configure thousands of PCs. Over time it has become a powerful language that supports complex expressions, user functions, loops and everything else that veteran scripters would expect.

	The expecco autoIt plugin wraps some of those low level functions into easier to use building blocks. This makes it a powerful combination:

	* allows for non-programmers to create scripts which remote-control other applications

	* integrates smoothly with web-application tests (for example, to automate native-window dialog boxes which pop up from web applications - especially: certificate and single-sign on queries)

	* integrates smoothly with database, telecom or automation scenarios.

	No attempt was made to support AutoIt's scripting facilities. These are better implemented using Expecco's own mechanisms for looping, alternatives, assertions etc.

	== Installation ==

	The autoIt package itself is not part of the expecco installation package. It must be downloaded separately from the AutoIt web page (https://www.autoitscript.com/site/autoit/downloads).

	Download the autoIt package and install it with its default settings.
	Typically, the software is installed in "<code>C:\Program Files\AutoIt3</code>".
	The only component needed by expecco is the autoIt dll, which should be in "<code>C:\Program Files\AutoIt3\AutoItX\AutoItX3.dll</code>".

	If this is in your path (try "set" on the cmd.com command line), you are ready to use it. Otherwise, either change the path setting, or go to the expecco dll-mapping settings, and add a corresponding entry to the mapping table:

	[[Datei:DLL_AutoIt_Mapping.png]]
	<p>
	Notice that the low-level interface to the autoIt library is implemented in the expecco action block library by DLL-calling action blocks. There, only the name of the library (not its absolute path) is defined. This avoids the need to change the library when the dll is located at a different location. Also notice, that the DLL-mapping is stored in the user settings, not in the project itself.

	== Command Overview ==

	The following overview only describes the most useful building blocks.
	Please refer to the [http://www.autoitscript.com/autoit3/docs Official AutoIt Documentation] and [http://www.autoitscript.com/autoit3/docs/functions.htm The Function Reference] for a full list and more detailed description.

	Be aware, that not all functions of the library are present in the xpecco action block library. For many, corresponding action blocks are already present in the standard library (math, timing, file access etc.).

	Only the window handling actions are present and each is implemented as a DLL-calling block. For example, the "WinActivate" block (as described below) is:

	[[Datei:AutoIt_DLL_Block_Example.png]]

	If any function is missing, take those as a guide on how to add your own autoIt calling action block.

	=== Connect / Disconnect ===
	* [[AutoIt Connect \|'''AutoIt [ Connect ]''' ]]<br/> Connects to the remote autoit server or local dll and returns a handle to the interface
	* [[AutoIt Disconnect \|'''AutoIt [ Disonnect ]''']]<br/> Closes the connection to the interface

	=== Window Specific Functions ===
	* [[AutoIt WinActivate \|'''AutoIt [ Activate ]''' ]]<br/> Activates (gives focus to) a window.
	* [[AutoIt WinActive \|'''AutoIt [ Active ]''' ]]<br/> Checks to see if a specified window exists and is currently active.
	* [[AutoIt WinClose \|'''AutoIt [ Close ]''' ]]<br/> Closes a window.
	* [[AutoIt WinExists \|'''AutoIt [ Exists ]''' ]]<br/> Checks to see if a specified window exists.
	* [[AutoIt WinSetState \|'''AutoIt [ SetState ]''' ]]<br/> Shows, hides, minimizes, maximizes, or restores a window.
	* [[AutoIt WinMinimizeAll \|'''AutoIt [ MinimizeAll ]''' ]]<br/> Minimizes all windows.
	* [[AutoIt WinMinimizeAllUndo\|'''AutoIt [ MinimizeAllUndo ]''']]<br/> Undoes a previous WinMinimizeAll function.
	* [[AutoIt WinWait \|'''AutoIt [ Wait ]''' ]]<br/> Pauses execution of the script until the requested window exists.
	* [[AutoIt WinWaitActive \|'''AutoIt [ WaitActive ]''' ]]<br/> Pauses execution of the script until the requested window is active.
	* [[AutoIt WinWaitClose \|'''AutoIt [ WaitClose ]''' ]]<br/> Pauses execution of the script until the requested window does not exist.
	* [[AutoIt WinMenuSelectItem \|'''AutoIt [ MenuSelectItem ]''' ]]<br/> Selects a specific menu item.

	=== Window Control Specific Functions ===
	* [[AutoIt Click \|'''AutoIt [ Click ]''']]<br/> Sends a mouse click command to a given control.
	* [[AutoIt Send \|'''AutoIt [ Send ]''']]<br/> Sends a string as keyboard input to a given control.
	* [[AutoIt GetText\|'''AutoIt [ GetText ]''']]<br/> Retrieves text from a control.
	* [[AutoIt SetText\|'''AutoIt [ SetText ]''']]<br/> Sets text of a control.

	=== Option Setting ===
	* [[AutoIt Opt \|'''AutoIt [ Option ]''']]<br/> Changes the operation of various AutoIt functions/parameters.

	=== Process Handling ===
	* [[AutoIt Run\|'''AutoIt [ Run ]''']]<br/> Runs an external program.

	== Tips & Tricks ==

	=== Local vs. Remote Applications ===
	You can access and control both local and remote applications via this plugin. When interfacing to a local application, expecco uses the autoIt-dll to directly interact with the tested application. To control remote applications, the AutoIt proxy "autoitRemoteServer.com" must be up and running on that host(s). This proxy implements a message-passing interface via a socket interface to forward autoIt commands from the expecco-host to the application's host. The proxy must be started on the target host with:
	autoitRemoteServer.com hostnameOrIpAddress portNumber

	Notice that the "autoitRemoteServer.com" possibly opens a security leak, as it allows for external programs to connect and control/manipulate the windows on the screen. Therefore, it is recommended to restrict the access and make sure that only the test-system on which expecco runs gains access to it. The parameter "''hostnameOrIpAddress''" restricts remote access to that single host. Use "localhost" or "127.0.0.0" if you want to deny any external access, and only allow the expecco which runs on the same host to connect to it. Otherwise specify your own hostname or ip address.
	The "portNumber" parameter is optional. The default is 9998.<br/>

	So, if the application to be tested executes on "hostA", and expecco on "hostE", open a command interface on "hostA" and enter "<code>autoitRemoteServer.com hostE</code>". Use "hostA" as the destination-parameter of the connect block.

	If you use "localhost" as destination parameter to the connect block, the autoIt local interface (without remote proxy) will be used. In that case no autoitRemoteServer needs to be run on the local host. Otherwise the connect block try to connect to autoitRemoteServer on the specified host.<br/>

	Please note, that the autoitRemoteServer may provide only a reduced set of the autoIt functions. Please refer to the Interface Plugin Library for more information.

	=== Applications and Windows Versions ===

	Notice that many Microsoft applications may show different control ids in their components in different Windows versions and/or language settings. For example, the "calculator.exe" application looks similar in a German language setting to its English counterpart. However, the control keys are different. It is important to keep this in mind and prepare the testsuite, for it to remain portable across different (also future) windows versions.
	A good strategy is to build an application specific control key library or specify the control keys in an environment. This can then be modified, or loaded depending on the OS version. We highly recommend the use of attachment files to keep that information separate from the actual test sequence.

	== Examples ==

	==== Waiting for an Application's Window to Appear ====

	The following little network waits for a window (given by its window-title) to appear.
	It does this in an endless loop, so the caller must take care to shut it down after a while.
	Here is a "Wait for Window to Appear" implementation:

	[[Datei:AutoIt_WaitForWindow1.png]]

	==== Confirming a Password Dialog in a Web-Browser Session ====

	Using the previous block, we can automatically answer a password request, which might pop up when a web-application session is started in selenium. The following example is especially interesting, as it combines web-browser interaction, using selenium with low-level windows automation, using AutoIt.

	So, we combine the web-login with the dialog-confirmer as follows:

	[[Datei:WebLogin_with_ConfirmPassword1.png]]

	Notice, that in this real-world example, three autoIt dialog confirmers are started in parallel. They execute concurrently with the web-browser's login procedure. These parallel processing threads are cancelled when the login step has finished. The three confirmers care for different types of boxes which appear depending on the type of browser used: as it happened in that particular application, firefox was asking for the chip-card password, whereas Internet Explorer wanted the user to confirm the use of a particular certificate. Some of these dialogs only appear once per session, as the browsers seem to cache this data. Thus, if the browser does not ask for a password (in a second run, for example), the login step succeeds immediately and terminates the box-wait actions.

	The three dialog-confirmer look very similar; here is the "Answer Firefox Password Dialog" block's implementation:

	[[Datei:AutoIt_ConfirmPassword1.png]]


	<hr>
	Back to [[Online_Documentation#Library_and_Plugin_Overview \| Online Documentation]].

Cg: /* Command Overview */

2016-11-26T17:21:58Z

Command Overview

← Nächstältere Version		Version vom 26. November 2016, 17:21 Uhr
Zeile 34:		Zeile 34:

	Be aware, that not all functions of the library are present in the xpecco action block library. For many, corresponding action blocks are already present in the standard library (math, timing, file access etc.).		Be aware, that not all functions of the library are present in the xpecco action block library. For many, corresponding action blocks are already present in the standard library (math, timing, file access etc.).

⚫	~~Only the window handling actions are wrapped as DLL-calling blocks.~~ If any function is missing, take those as a guide on how to add your own autoIt calling action block.
	For example, the "WinActivate" ~~action~~ block (as described below) is:~~<p>~~		Only the window handling actions are present and each is implemented as a DLL-calling block. For example, the "WinActivate" block (as described below) is:

	[[Datei:AutoIt_DLL_Block_Example.png]]		[[Datei:AutoIt_DLL_Block_Example.png]]

		⚫	If any function is missing, take those as a guide on how to add your own autoIt calling action block.

	=== Connect / Disconnect ===		=== Connect / Disconnect ===

Cg: /* Command Overview */

2016-11-26T17:19:40Z

Command Overview

← Nächstältere Version		Version vom 26. November 2016, 17:19 Uhr
Zeile 35:		Zeile 35:
	Be aware, that not all functions of the library are present in the xpecco action block library. For many, corresponding action blocks are already present in the standard library (math, timing, file access etc.).		Be aware, that not all functions of the library are present in the xpecco action block library. For many, corresponding action blocks are already present in the standard library (math, timing, file access etc.).
	Only the window handling actions are wrapped as DLL-calling blocks. If any function is missing, take those as a guide on how to add your own autoIt calling action block.		Only the window handling actions are wrapped as DLL-calling blocks. If any function is missing, take those as a guide on how to add your own autoIt calling action block.
	For example, the "WinActivate" action block (as described below) is:		For example, the "WinActivate" action block (as described below) is:<p>
	[[Datei:AutoIt_DLL_Block_Example.png]]		[[Datei:AutoIt_DLL_Block_Example.png]]


	=== Connect / Disconnect ===		=== Connect / Disconnect ===
	* [[AutoIt Connect \|'''AutoIt [ Connect ]''' ]]<br/> Connects to the remote autoit server or local dll and returns a handle to the interface		* [[AutoIt Connect \|'''AutoIt [ Connect ]''' ]]<br/> Connects to the remote autoit server or local dll and returns a handle to the interface

Cg: /* Command Overview */

2016-11-26T17:16:12Z

Command Overview

← Nächstältere Version		Version vom 26. November 2016, 17:16 Uhr
Zeile 35:		Zeile 35:
	Be aware, that not all functions of the library are present in the xpecco action block library. For many, corresponding action blocks are already present in the standard library (math, timing, file access etc.).		Be aware, that not all functions of the library are present in the xpecco action block library. For many, corresponding action blocks are already present in the standard library (math, timing, file access etc.).
	Only the window handling actions are wrapped as DLL-calling blocks. If any function is missing, take those as a guide on how to add your own autoIt calling action block.		Only the window handling actions are wrapped as DLL-calling blocks. If any function is missing, take those as a guide on how to add your own autoIt calling action block.
			For example, the "WinActivate" action block (as described below) is:

			[[Datei:AutoIt_DLL_Block_Example.png]]
	=== Connect / Disconnect ===		=== Connect / Disconnect ===
	* [[AutoIt Connect \|'''AutoIt [ Connect ]''' ]]<br/> Connects to the remote autoit server or local dll and returns a handle to the interface		* [[AutoIt Connect \|'''AutoIt [ Connect ]''' ]]<br/> Connects to the remote autoit server or local dll and returns a handle to the interface

Cg: /* Installation */

2016-11-26T17:13:58Z

Installation

← Nächstältere Version		Version vom 26. November 2016, 17:13 Uhr
Zeile 25:		Zeile 25:

	[[Datei:DLL_AutoIt_Mapping.png]]		[[Datei:DLL_AutoIt_Mapping.png]]
			<p>

	Notice that low-level interface to the autoIt library is implemented ~~as DLL-calling action blocks~~ in the expecco action block library. There, only the name of the library (not its absolute path) is defined. This avoids the need to change the library when the dll is located at a different location. Also notice, that the DLL-mapping is stored in the user settings, not in the project itself.		Notice that the low-level interface to the autoIt library is implemented in the expecco action block library by DLL-calling action blocks. There, only the name of the library (not its absolute path) is defined. This avoids the need to change the library when the dll is located at a different location. Also notice, that the DLL-mapping is stored in the user settings, not in the project itself.

	== Command Overview ==		== Command Overview ==

Cg: /* Installation */

2016-11-26T17:09:23Z

Installation

← Nächstältere Version		Version vom 26. November 2016, 17:09 Uhr
Zeile 25:		Zeile 25:

	[[Datei:DLL_AutoIt_Mapping.png]]		[[Datei:DLL_AutoIt_Mapping.png]]

			Notice that low-level interface to the autoIt library is implemented as DLL-calling action blocks in the expecco action block library. There, only the name of the library (not its absolute path) is defined. This avoids the need to change the library when the dll is located at a different location. Also notice, that the DLL-mapping is stored in the user settings, not in the project itself.

	== Command Overview ==		== Command Overview ==

Cg: /* Command Overview */

2016-11-26T16:13:18Z

Command Overview

← Nächstältere Version		Version vom 26. November 2016, 16:13 Uhr
Zeile 28:		Zeile 28:
	== Command Overview ==		== Command Overview ==

	The following overview only ~~descripes~~ the most ~~used~~ building blocks.		The following overview only describes the most useful building blocks.
	Please refer to the [http://www.autoitscript.com/autoit3/docs Official AutoIt Documentation] and		Please refer to the [http://www.autoitscript.com/autoit3/docs Official AutoIt Documentation] and [http://www.autoitscript.com/autoit3/docs/functions.htm The Function Reference] for a full list and more detailed description.

	especially [http://www.autoitscript.com/autoit3/docs/functions.htm The Function Reference] for a full list and more detailed description.
			Be aware, that not all functions of the library are present in the xpecco action block library. For many, corresponding action blocks are already present in the standard library (math, timing, file access etc.).
			Only the window handling actions are wrapped as DLL-calling blocks. If any function is missing, take those as a guide on how to add your own autoIt calling action block.

	=== Connect / Disconnect ===		=== Connect / Disconnect ===

Cg: /* Command Overview */

2016-11-26T16:09:22Z

Command Overview

← Nächstältere Version		Version vom 26. November 2016, 16:09 Uhr
Zeile 30:		Zeile 30:
	The following overview only descripes the most used building blocks.		The following overview only descripes the most used building blocks.
	Please refer to the [http://www.autoitscript.com/autoit3/docs Official AutoIt Documentation] and		Please refer to the [http://www.autoitscript.com/autoit3/docs Official AutoIt Documentation] and
	~~especcially~~ [http://www.autoitscript.com/autoit3/docs/functions.htm The Function Reference] for a full list and more detailed description.		especially [http://www.autoitscript.com/autoit3/docs/functions.htm The Function Reference] for a full list and more detailed description.

	=== Connect / Disconnect ===		=== Connect / Disconnect ===

Cg: /* Installation */

2016-11-26T16:04:42Z

Installation

← Nächstältere Version		Version vom 26. November 2016, 16:04 Uhr
Zeile 19:		Zeile 19:

	Download the autoIt package and install it with its default settings.		Download the autoIt package and install it with its default settings.
	Typically, the software is installed in "C:\Program Files\AutoIt3".		Typically, the software is installed in "<code>C:\Program Files\AutoIt3</code>".
	The only component needed by expecco is the autoIt dll, which should be in "C:\Program Files\AutoIt3\AutoItX\AutoItX3.dll".		The only component needed by expecco is the autoIt dll, which should be in "<code>C:\Program Files\AutoIt3\AutoItX\AutoItX3.dll</code>".

	If this is in your path (try "set" on the cmd.com command line), you are ready to use it. Otherwise, either change the path setting, or go to the expecco dll-mapping settings, and add a corresponding entry to the mapping table:		If this is in your path (try "set" on the cmd.com command line), you are ready to use it. Otherwise, either change the path setting, or go to the expecco dll-mapping settings, and add a corresponding entry to the mapping table:

Cg: /* Installation */

2016-11-26T16:03:25Z

Installation

← Nächstältere Version		Version vom 26. November 2016, 16:03 Uhr
Zeile 16:		Zeile 16:
	== Installation ==		== Installation ==

	The autoIt ~~oackage~~ itself is not part of the expecco installation package. It must be downloaded from the AutoIt web page (https://www.autoitscript.com/site/autoit/downloads ~~at the time this document was written~~).		The autoIt package itself is not part of the expecco installation package. It must be downloaded separately from the AutoIt web page (https://www.autoitscript.com/site/autoit/downloads).

	If this link does not work, google for "autoit download".
		⚫	Download the autoIt package and install it with its default settings.
	<P>
⚫	Download the autoIt package and ~~intall~~ it with its default settings.
	Typically, the software is installed in "C:\Program Files\AutoIt3".		Typically, the software is installed in "C:\Program Files\AutoIt3".
	The only component needed by expecco is the autoIt dll, which should be in "C:\Program Files\AutoIt3\AutoItX\AutoItX3.dll".		The only component needed by expecco is the autoIt dll, which should be in "C:\Program Files\AutoIt3\AutoItX\AutoItX3.dll".

	<P>
	If this is in your path (try "set" on the cmd.com command line), you are ready to use it. Otherwise, either change the path setting, or go to the expecco dll-mapping settings, and add a corresponding entry to the mapping table:		If this is in your path (try "set" on the cmd.com command line), you are ready to use it. Otherwise, either change the path setting, or go to the expecco dll-mapping settings, and add a corresponding entry to the mapping table:

	<p>
	[[Datei:DLL_AutoIt_Mapping.png]]		[[Datei:DLL_AutoIt_Mapping.png]]