AutoGetChildObjectAction

The AutoGetChildObjectAction action locates the specified child business object and saves it for other actions to use.This action does not invoke the load services of the parent business object to load the object. Use the AutoLoadChildrenAction action to ensure that the child business objects load.
Declare the AutoGetChildObjectAction action as a child of a root <testcase> element by using the <action> element. Set the value for the name attribute of the <action> element to identify the name and package of the action.

<testcase>
<action name="cmc/automation/AutoGetChildObjectAction">
...
</action>
</testcase>

Parameters

This action accepts the following parameters:
objectPath
Required: The object path that is used to locate the child business object.
propertyName
The name of the property that is used to choose between multiple child business objects that match the specified object path. If this parameter is specified, you must also specify one of the following parameters: propertyValue or propertyValueKey.
propertyValue
The property value that is used to find a specific child business object. This parameter must be specified when the propertyName parameter is specified.
propertyValueKey
The name of a value set by the AutoSetValueAction action that is used as the property value to find a specific child business object. This parameter must be specified when the propertyName parameter is specified.
parentObject
The name of the parent business object. This name must match the objectKey parameter of a previous action that created or located the parent business object. If the parent business object is not specified, the object path resolves relative to the Top object.
objectKey
Required: The name that is used to keep a reference to the business object so it can be used by other actions.

Example

The following code snippet shows an example of these parameters when used in the AutoGetChildObjectAction action:

<!-- Get the attachment description object -->
<action name="cmc/automation/AutoGetChildObjectAction">
  <param name="parentObject" value="attachment"/>
  <param name="objectPath" value="AttachmentDescription"/>
  <param name="objectKey" value="attachmentDescription"/>
</action>