IdentificationProperty Element

Description

An identification property for the test object class.

Important Information

  • This element replaces the Property element that was used in earlier versions of the Test Object Schema. The Property element is supported for backward compatibility purposes only.

  • You must define all of the identification properties for a specific test object class in a single XML file. Definitions of identification properties for the same test object class in multiple XML files are not merged into the test object class definition.

  • The following attributes specify information that can be modified using the Object Identification dialog box in OpenText Functional Testing: AssistivePropertyValue, ForAssistive, ForBaseSmartID, ForDescription, ForOptionalSmartID, and OptionalSmartIDPropertyValue. These attributes determine the lists of identification properties used for the test object classes.

    Therefore, by default, the values of these attributes are read from the XML only once, to prevent overwriting any changes a user makes using the Object Identification dialog box. In this way, persistence is provided for the user defined property lists.

    If the user clicks Reset Test Object in the Object Identification dialog box, the attributes' values are reloaded from the XML.

    If the XML changed since the last time it was loaded (based on the file's modification date in the system), the attributes are read from the XML. Identification properties are added to the relevant lists (and their order is adjusted if necessary) according to the values of these attributes, but does not remove any existing identification properties from the lists.

    To indicate that the identification property lists should be completely refreshed according to the attributes defined in the XML each time OpenText Functional Testing is opened, set the DevelopmentMode attribute of the TypeInformation element to true.

Note for .NET Add-in users: Do not use this element for the .NET Add-in.

Attributes

NameTypeUseDefaultDescription
AssistivePropertyValuelongoptional0

The number that represents the position of the identification property in the assistive property list. The first position in the list is 1. (A value of 0 means that the identification property is not included in the assistive property list.)

Relevant only if the ForAssistive attribute is set to true.

Note: Persistence is provided for this attribute. For more information, see Important Information, above.

ForAssistivebooleanoptionalfalse

Indicates whether the identification property is included in the list of assistive properties for test objects of this class.

If you set this attribute to true, you must also set the AssistivePropertyValue attribute to a non-zero value.

Possible values:

True - Include this identification property in the assistive property list.

False - Do not include this identification property in the assistive property list.

Note: Persistence is provided for this attribute. For more information, see Important Information, above.

ForBaseSmartIDbooleanoptionalfalse

Indicates whether the identification property is included in the Smart Identification Base Filter Properties list for test objects of this class.

Possible values:

True - Include this identification property in the Base Filter Properties list.

False - Do not include this identification property in the Base Filter Properties list.

Notes:

  • This setting is only relevant if Smart Identification is enabled for this test object class. To enable Smart Identification, use the Object Identification dialog box in OpenText Functional Testing.

  • Persistence is provided for this attribute. For more information, see Important Information, above.

ForDefaultVerificationbooleanoptionalfalseIndicates whether the identification property is selected by default for checkpoints on test objects of this class.

Possible values:

True - Check this identification property by default.

False - Check this identification property only if the user selects it for verification.

ForDescriptionbooleanoptionalfalseIndicates whether the identification property should be used in the unique test object description for test objects of this class.

Possible values:

True - Include this identification property in the test object description.

False - Do not include this identification property in the test object description.

Note: Persistence is provided for this attribute. For more information, see Important Information, above.

ForOptionalSmartIDbooleanoptionalfalse

Indicates whether the identification property is included in the Smart Identification Optional Filter Properties list for test objects of this class.

If you set this attribute to true, you must also set the OptionalSmartIDPropertyValue attribute to a non-zero value.

Possible values:

True - Include this identification property in the Optional Filter Properties list.

False - Do not include this identification property in the Optional Filter Properties list.

Notes:

  • This setting is only relevant if Smart Identification is enabled for this test object class. To enable Smart Identification, use the Object Identification dialog box in OpenText Functional Testing.

  • Persistence is provided for this attribute. For more information, see Important Information, above.

ForSpybooleanoptionaltrueIndicates whether the identification property is displayed in the Object Spy for test objects of this class.

Possible values:

True - Display this identification property in the Object Spy.

False - Do not display this identification property in the Object Spy.

ForVerificationbooleanoptionalfalseIndicates whether the identification property can be used in checkpoints and output values for test objects of this class.

Possible values:

True - Enable this identification property to be verified.

False - Do not enable this identification property to be verified.

NameIdentificationPropertyRestrictedStringrequired The property name.

For naming rules, see the RestrictedString simple type.

Note: OpenText Functional Testing uses only lowercase letters in identification property names. If you use uppercase letters in this attribute, they are converted to lowercase.

OptionalSmartIDPropertyValuelongoptional0The number that represents the position of the identification property in the Smart Identification Optional Filter Properties list. The first position in the list is 1. (A value of 0 means that the identification property is not included in the Smart Identification Optional Filter Properties list.)

Relevant only if the ForOptionalSmartID attribute is set to true.

Note: Persistence is provided for this attribute. For more information, see Important Information, above.

Used By

Source

<xs:element xmlns:xs="http://www.w3.org/2001/XMLSchema" name="IdentificationProperty">
    <xs:annotation>
        <xs:documentation>An identification property for the test object class.</xs:documentation>
    </xs:annotation>
    <xs:complexType>
        <xs:attribute name="Name" type="IdentificationPropertyRestrictedString" use="required" />
        <xs:attribute name="ForVerification" type="xs:boolean" use="optional" default="false" />
        <xs:attribute name="ForDefaultVerification" type="xs:boolean" use="optional" default="false" />
        <xs:attribute name="ForDescription" type="xs:boolean" use="optional" default="false" />
        <xs:attribute name="ForAssistive" type="xs:boolean" use="optional" default="false" />
        <xs:attribute name="ForBaseSmartID" type="xs:boolean" use="optional" default="false" />
        <xs:attribute name="ForOptionalSmartID" type="xs:boolean" use="optional" default="false" />
        <xs:attribute name="ForSpy" type="xs:boolean" use="optional" default="true" />
        <xs:attribute name="AssistivePropertyValue" type="xs:long" use="optional" default="0" />
        <xs:attribute name="OptionalSmartIDPropertyValue" type="xs:long" use="optional" default="0" />
    </xs:complexType>
</xs:element>