Registering Your Testing Agent

You must register the Testing Agent after OpenText Functional Testing is installed. If your application installation installs and registers the agent before OpenText Functional Testing is installed, repeat the registration after installing OpenText Functional Testing.

Registration API methods

The OpenText Functional Testing Extensibility SDK provides C functions that you can use to register and unregister the Testing Agent, and to check whether OpenText Functional Testing is installed. Create an application that uses these functions to register and unregister your agent. Your code must:

  • Link to the <Testing_Extensibility_SDK_installdir>\SDK\lib\<VS version>\TEASDK.lib library

  • Include < Testing_Extensibility_SDK_installdir>\SDK\include\RegisterAUT.h

Back to top

Using the RegisterTeaAut function

Call RegisterTeaAut when you install the Testing Agent.

long RegisterTeaAut (const wchar_t* environmentID, const wchar_t* szEnvDisplayName, const wchar_t* progid);

The function returns ERROR_SUCCESS (0) if it succeeds in registering the Testing Agent.

It receives the following null-terminated, Unicode, string arguments:

  • environmentID. The name that OpenText Functional Testing uses to identify your testing environment. The value of this argument must be the same as the PackageName attribute (TypeInformation element) in the Environment XML file.

  • szEnvDisplayName. The name of the environment that OpenText Functional Testing displays to the user in dialog boxes that display a list of supported environments. The value of this argument must be the same as the AddinName attribute (TypeInformation element) in the Environment XML file.

  • progid. The program ID with which the Testing Agent COM object registered on the computer. OpenText Functional Testing uses this program ID to launch the Testing Agent.

Back to top

Using the UnRegisterTeaAut function

Call UnRegisterTeaAut when you uninstall the Testing Agent.

long UnRegisterTeaAut (const wchar_t* environmentId);

The function returns ERROR_SUCCESS (0) if it succeeds in unregistering the Testing Agent.

It receives the following (null-terminated Unicode string) argument:

environmentID. The environment ID that was used to register the Testing Agent.

Back to top

Checking Whether OpenText Functional Testing Is Installed

If you want to avoid installing or registering the Testing Agent when OpenText Functional Testing is not installed on the computer, you can check whether OpenText Functional Testing is installed on the computer using function IsQTPInstalled.

long IsQTPInstalled();

This function returns ERROR_SUCCESS (0) if OpenText Functional Testing is installed.

Back to top