Rebooting the Computer During Automated Testing

About RebootAndContinue

Logging In After Restart

How RebootAndContinue Works

Requirements

To reboot the computer during automated testing, use the aqEnvironment.RebootAndContinue method. In keyword tests, you can call this method using the Call Object Method or Run Code Snippet operation.

aqEnvironment.RebootAndContinue("UnitName.FunctionName", "password", "username", "domain")

The aqEnvironment.RebootAndContinue method reboots the computer, logs in and continues the test run from the specified script function of the current test project. This function must meet the following conditions:

• It must have no parameters. To pass data to this function, you can use project or project suite variables, or read data from a file.

• It must prepare the environment and the tested application for further testing: run the tested application, bring it to the needed state, initialize global script variables and so on.

The aqEnvironment.RebootAndContinue method lets you log in using the credentials of the current user account or of another account.

To log in using the current account, specify just the password:

aqEnvironment.RebootAndContinue("UnitName.FunctionName", "password")

If the current account has empty password, do not specify any user account information:

aqEnvironment.RebootAndContinue("UnitName.FunctionName")

To log in using another user account, specify the domain, user name and password:

aqEnvironment.RebootAndContinue("UnitName.FunctionName", "password", "user", "domain")

The aqEnvironment.RebootAndContinue method does the following:

• Saves the user account information to this registry key:

  HKEY_USERS\{USER_SID}\Software\Microsoft\Windows\CurrentVersion\RunOnce

  where {USER_SID} is the ID of this user account.

• Logs off the current user.

• Reboots the computer.

• Logs in automatically using the account saved in the registry.

• Starts TestComplete.

• Removes its data from the above-mentioned registry key.

  Note:

  If this data is not removed (for example, if TestComplete was terminated or if the logged in user does not have permissions for this key), this user account may be used next time Windows starts.

• Opens the same test project in TestComplete and runs the specified script function.

• You must run TestComplete as an administrator to use RebootAndContinue.

• The following registry key must exist:

  HKEY_USERS\{USER_SID}\Software\Microsoft\Windows\CurrentVersion\RunOnce

  where {USER_SID} is the ID of the user account used to log in after restart. This user must have permissions to create and delete values in this key.

• Windows must not show a legal notice message before the logon screen is displayed (this message cannot be closed automatically). To disable the legal notice, set blank values for the following registry keys:

  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\LegalNoticeCaption
  HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon\LegalNoticeText