Append XML Text

Appends the specified text to the set of elements selected by the XPath expression. If Before XPath Expression is not specified, the text is appended after any existing children of the selected elements. If Before XPath Expression is specified, it is evaluated relative to each of the elements selected by the expression to determine which of the children to insert before. If Before XPath Expression evaluates to an empty node set or a node set that does not contain any children of the selected element, then the text is appended after any existing children; otherwise, the text is inserted before each of the nodes in the previously selected node set that are children of the selected node.

Fields

XPath Expression

Specify the XPath 1.0 expression that returns a node set containing the elements to which the new elements should be appended. Supports variable expansion. For more information on variable expansion and XPath, see XPath Expressions.

String

Specify the text to be appended.

Insert

Select whether to insert the XPath expression before the source XPath expression or append the XPath expression to the end of the current node in the destination XPath expression.

Before XPath Expression

Specify the XPath 1.0 expression that evaluates relative to each of the nodes selected by the expression that returns a node set containing the child nodes that the text should be inserted before. Supports variable expansion. For more information on variable expansion and XPath, see XPath Expressions.

Remarks

For more information on using XPath expressions with policies, see XPath 1.0 Expressions in the NetIQ Identity Manager Understanding Policies Guide.

Example

If you are implementing NetIQ Credential Provisioning policies, there is a sample Subscriber Command Transformation policy that uses the XPath Expression condition. The sample file is called SampleSubCommandTransform.xml. It is found in the \dirxml\utilities folder on the Identity Manager media. For more information, see Example Credential Provisioning Policies in the NetIQ Identity Manager Credential Provisioning Guide. To view the policy in XML, see SampleSubCommandTransform.xml.

The example is using the append XML text action to find the NetIQ SecureLogin or NetIQ SecretStore application username. By obtaining the application name, the credentials can be set for the user object when it is provisioned.

The policy finds the SecureLogin or SecretStore application username
Append XML text