QCUtil Object

Description

The object used to access the ALM Open Test Architecture (OTA) interface. You can use the properties associated with the QCUtil object to return ALM OTA objects. You can use the returned object to perform any OTA property or method supported for that object.

For details on the objects, properties, and methods supported for the returned objects exposed by the QCUtil object, see the ALM Open Test Architecture API Reference.

Note: This object replaces the TDUtil object used in earlier versions of QuickTest. The TDUtil object is supported for backwards compatibility only. We recommend updating your tests to use the QCUtil object.

Properties

Method RunReturns the ALM OTA Run object, which represents the current run.
Method CurrentTestReturns the ALM OTA Test object, which represents a planning test.
CurrentTestSetReturns the ALM OTA TestSet object, which represents a group of tests.
CurrentTestSetTestReturns the ALM OTA TSTest object, which represents an execution instance.
IsConnectedIndicates whether UFT One is currently connected to an ALM project.
QCConnectionReturns the ALM OTA QCConnection object, which represents the current ALM session and provides access to the ALM object model.

Back to top

Run Property

Description

Returns the ALM OTA Run object, which represents the current run. For more details, see the ALM Open Test Architecture API Reference.

Note: This property is supported only when UFT One is connected to Quality Center, version 7.5 or later or ALM, and the run results location is a Quality Center or ALM location.

Syntax

QCUtil.CurrentRun

Return Value

An ALM OTA Run object.

Back to top

CurrentTest Property

Description

Returns the ALM OTA Test object, which represents a planning test. For more details, see the ALM Open Test Architecture API Reference.

Note: This property is supported only when UFT One is connected to ALM and the test is saved in an ALM project

Syntax

QCUtil.CurrentTest

Return Value

An ALM OTA Test object.

Back to top

CurrentTestSet Property

Description

Returns the ALM OTA TestSet object, which represents a group of tests. For more details, see the ALM Open Test Architecture API Reference.

Note: This property is supported only when UFT One is connected to ALM and the run results location is an ALM location.

Syntax

QCUtil.CurrentTestSet

Return Value

An ALM OTA TestSet object.

Back to top

CurrentTestSetTest Property

Description

Returns the ALM OTA TSTest object, which represents an execution instance. For more details, see the ALM Open Test Architecture API Reference.

Note: This property is supported only when UFT One is connected to ALM.

Syntax

QCUtil.CurrentTestSetTest

Return Value

An ALM OTA TSTest object.

Back to top

IsConnected Property

Description

Indicates whether UFT One is currently connected to an ALM project.

Note: Returns False if UFT One is connected to an ALM server, but not connected to any project.

Tip: We recommend inserting a IsConnected step before other ALM operations.

Syntax

QCUtil.IsConnected

Return Value

Boolean

Back to top

QCConnection Property

Description

Returns the ALM OTA QCConnection object, which represents the current ALM session and provides access to the ALM object model.

For more details, see the ALM Open Test Architecture API Reference.

Note: This property is supported only when UFT One is connected to ALM.

Syntax

QCUtil.QCConnection

Return Value

An ALM OTA QCConnection object.

Back to top

See also: