Device description properties

Object description properties can be used in the object repository description, in programmatic descriptions, in checkpoint and output value steps, and as argument values for the GetTOProperty and GetROProperty methods.

Note: To change descriptions of Mobile test objects created in UFT 12.02 Patch 1 (Mobile Center 1.01) or earlier, first update the test object in the object repository.

The Device test object supports the description properties listed in the table below.

Property Name



The unique device ID that identifies the device.

When learning a Device object, UFT creates a test object without this property to avoid binding the test object to a specific device.

If you plan to test multiple devices in the same test, make sure to add the id property to the list of mandatory properties. This ensures that when UFT learns the objects, it adds the objects under the correct Device test object in the object repository.

By default, during a run session, UFT uses the device ID of the device specified in the Mobile Record and Run settings for the test. If the Device test object contains an ID description property, UFT uses the identified device instead.

You can also add this property to the test object description manually, in which case, UFT uses the device specified in the test object.


Using the GetROProperty and CheckProperty methods, you can retrieve and/or check only the values of the following properties in the application during a run session. You can also use these properties with the WaitProperty, Check, and Output methods.

Property Name


extraApps The applications to use for the test run (when multiple applications are selected in the test's Record and Run settings).
id The device ID.
manufacturer The manufacturer of the device.
model The model name of the device.
ostype The operating system currently running on the device.
osversion The operating system version currently running on the device.

The location of the device.

Possible values:

  • MC: device is stored on Mobile Center
  • AWS: device is stored on an Amazon device farm
  • Any: device stored either in Mobile Center or an Amazon device farm.

See also: