Setting Up Stingray Object Support

Before you begin working, you need to configure the Stingray Add-in to work with your application. UFT support for Stingray objects is based on an agent entity that exists in the Stingray application. This agent interacts with UFT to enable record and run operations. There are two different modes for establishing the agent entity:

Run-time Agent Mode

When you choose the run-time agent mode, UFT injects an agent DLL into the application's process during run-time. This recommended mode is non-intrusive and does not require any modifications to the source code of the application being tested.

You can use the run-time agent mode only with Stingray applications that are created with dynamically-linked MFC libraries. You can verify if your MFC libraries are linked dynamically or statically by launching the Stingray Support Configuration Wizard. If the wizard identifies that your Stingray application uses statically-linked MFC libraries, it issues a warning.

The run-time agent mode supports the most commonly used major Stingray versions, as well as some—but not all—minor versions. For a list of supported version combinations, see the Unified Functional Testing Product Availability Matrix. You can also verify if your Stingray application version is supported by launching the Stingray Support Configuration Wizard. If the wizard identifies that your Stingray application version is not supported, it issues a warning.

The Stingray Add-in is designed to support only applications that are compiled in Release mode.

If you cannot use the run-time agent mode for any reason, you can still work with your Stingray application using the precompiled agent mode, instead.

Precompiled Agent Mode.

If your application is statically linked with the MFC libraries, you can use the precompiled agent mode to enable Stingray object support. The precompiled agent mode requires you to make slight modifications to your Visual C++ project to enable UFT to support your Stingray application. If you select the precompiled agent mode in the Stingray Support Configuration Wizard, you can compile your project using the Stingray Add-in agent files.

If your Stingray application project was compiled with an earlier version of the Stingray Add-in agent, your project already contains the required support code. To take advantage of the latest functionality provided with this add-in, we recommend removing the existing Stingray Add-in agent files from your project and recompile using the latest agent files.

Setting up Stingray support using the precompiled agent mode requires adding one support header file to your application's Visual C++ project and copying one library file to your Visual C++ project directory. After you complete these steps, you can compile your application, as usual.

Note: Use the precompiled agent mode only if the run-time agent mode is unsuitable or cannot be used.

You choose your preferred mode and configure support for the Stingray Add-in using the Stingray Support Configuration Wizard. For details, see Stingray Support Configuration Wizard.

After you configure support for the Stingray Add-in, you can fine-tune the configuration options, if needed. For details, see Stingray Pane (Options Dialog Box > GUI Testing Tab).