Append XML Element

Appends a custom element, with the name specified in the Name field, to the set of elements selected by the XPath expression. If Before XPath Expression is not specified, the new element 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, the new element is appended after any existing children; otherwise, the new element is inserted before each of the nodes in the node set selected by before that are children of the selected node.

Fields

Name

Specify the tag name of the XML element. This name can contain a namespace prefix if the prefix has been previously defined in this policy.

XPath Expression

Specify an XPath 1.0 expression that returns a node set containing the elements to which the new elements should be appended.

Before XPath Expression

Specify an 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 new elements should be inserted before.

Remarks

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

Example

If you are implementing Novell Credential Provisioning for Identity Manager 4.0.1, 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 Novell Credential Provisioning for Identity Manager 4.0.1. To view the policy in XML, see SampleSubCommandTransform.xml.

The sample file uses the append XML element action to add the Novell SecureLogin or Novell SecretStore credentials to the user object when it is provisioned.

Policy adds the SecureLogin or SecretStore credentials to user objects when they are provisioned
Append XML element