wcfAutoGetChildObjectAction
The wcfAutoGetChildObjectAction 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 wcfAutoLoadChildrenAction
action to ensure that the child business objects are loaded.
Parameters
This action accepts the following parameters:- objectPath
- Required: The object path used to locate the child business object.
- propertyName
- The name of the property that is used to choose between multiple child business objects which 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 wcfAutoSetValueAction 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 used in the wcfAutoGetChildObjectAction action:<!-- Get the child directory object. -->
<action name="wcfAutoGetChildObjectAction">
<param name="parentObject" value="rootDirectory"/>
<param name="objectPath" value="ChildManagedDirectory/ManagedDirectory"/>
<param name="objectKey" value="directory"/>
<param name="propertyName" value="displayName"/>
<param name="propertyValueKey" value="bvt_directory_name"/>
</action>