Querying values of object properties

Components in the application-under-test, such as dialog boxes, command buttons, and labels, have associated pieces of information called properties. Properties have a name and a value. This topic provides examples of why you may want to modify your script to access an object property.

• You may want to compare previous versions of a value to the current value and to do so would require a calculation (such as factoring in a depreciation rate).

• Sometimes querying a property may return a reference to other objects. In cases like this, you might need to test the value of a property of the returned object. This kind of scenario cannot be handled through the user interface. See Unregistering references to test objects for more information.

• You also might want to branch in your Functional Tester script based on the current value of a property.

You can retrieve the value of a property programmatically by calling the getProperty method, which has the following syntax:

Object getProperty(String propertyName);

The following example uses the getProperty method to test whether a value of a property is being captured and reproduced correctly. The call to getProperty retrieves the value of the text property associated with the yourOrderHasBeenReceivedYourOr object.

import resources.QueryingObjectHelper;

import com.rational.test.ft.*;
import com.rational.test.ft.object.interfaces.*;
import com.rational.test.ft.object.interfaces.SAP.*;
import com.rational.test.ft.object.interfaces.siebel.*;
import com.rational.test.ft.script.*;
import com.rational.test.ft.value.*;
import com.rational.test.ft.vp.*;

/**
 * Description   : Functional Test Script
 * @author Administrator
 */
public class QueryingObject extends QueryingObjectHelper
{
  /**
   * Script Name   : QueryingObject
   * Generated     : Jul 19, 2006 2:31:56 PM
   * Description   : Functional Test Script
   * Original Host : WinNT Version 5.1  Build 2600 (S)
   * 
   * @since  2006/07/19
   * @author Administrator
   */
  public void testMain(Object[] args) 
  {
    startApp("ClassicsJavaA");
    
    // Frame: ClassicsCD
    placeOrder().click();
    
    // Frame: Member Logon
    ok().click();
    
    // Frame: Place an Order
    cardNumberIncludeTheSpacesText().click(atPoint(28,6));
    placeAnOrder().inputChars("1234123412341234");
    expirationDateText().click(atPoint(9,2));
    placeAnOrder().inputChars("12/12");
    placeOrder2().click();
    
    //Waiting for Object 
    yourOrderHasBeenReceivedYourOr().waitForExistence();
    
    //Querying the Object
    String confirmationText = (String)yourOrderHasBeenReceivedYourOr().getProperty("text");
    logTestResult(confirmationText, confirmationText.startsWith("Your order has"));
    
    yourOrderHasBeenReceivedYourOr().click();
    ok2().click();
    
    // Frame: ClassicsCD
    classicsJava(ANY,MAY_EXIT).close();
  }
}

Functional Tester also supports a setProperty method, but do not use it unless you are sure of the result. This method calls internal methods that may violate the integrity of the application-under-test.