Provisioning Schema::after

---

Element that encapsulates an XSL transformation (insert, merge, replace, or move) that a provisioning engine performs after an execution step in a provisioning procedure. This element is part of the provisioning schema of Microsoft. Provisioning Framework (MPF).

Note  Source and destination elements can belong to different namespaces. However, after the transformation, the source element will still belong to the source namespace. If the destination element specifies a namespace but the source element does not, the transformed source element will have an empty xmlns attribute (xmlns="").

Parents

execute, queue, transform

Attributes

allowNullTransform

Optional. Boolean that specifies what happens if the XSL transformation returns an XML string that does not contain a valid XML element. If set to 0 (default), the provisioning engine returns an error. If set to 1, the engine returns a null value. In this case, the destination node is not updated, and execution proceeds.

destination

Required. Destination node for the transformed data, expressed as one of the following values:

• "data" (the request's data node)
• "context" (the request's context node)
• "procedureData" (the called procedure's procedureData node)
• "executeData" (the called procedure's executeData node)
• Name of a forEach node in the associated execute node

destinationPath

Optional. XPath for the destination node where the transformed node is to be inserted, merged, or replaced.

ifNull

Optional. Enumeration that specifies what happens if the source node specified by attributes source and sourcePath is not present. 

• "fail" (default): Returns a failure.
• "ignore": Treats the source node as optional.

mode

Optional. Enumeration that specifies the action to perform on transformed XML: 

• "insert" (default): Inserts a new node under the target node.
• "merge": Merges the contents of the new node with the contents of the target node. 
• "replace": Replaces the target node with the new node.
• "move": Passes content into the transformation by reference rather than by value. This setting offers the best performance and automatically removes the source XML node (identified by the source and sourcePath attributes) from the source tree. Be careful not to use this setting in situations where the source node is needed for other operations. 

source

Required. Destination node for the transformed data, expressed as one of the following values: 

• "data" (the request's data node)
• "context" (the request's context node)
• "procedureData" (the called procedure's procedureData node)
• "executeData" (the called procedure's executeData node)
• Name of a forEach node in the associated execute node

sourcePath

Optional. XPath for the source node to transform relative to the value of the source attribute.

Example

<request xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
  <data>
	<organizations>
	<organization name="OrgA" type="primary"/>
	<organization name="OrgB" type="secondary"/>
	<organization name="OrgC" type="secondary"/>
	</organizations>
  </data>
  <procedure>
	<execute namespace="New Namespace" procedure="New Request">
	<before source="data" destination="executeData" mode="merge"/>
	<after source="executeData" destination="data" mode="merge"/>
	</execute>
  </procedure>
</request>

See also

Customization, Procedure Examples, XML Schema for Procedures

---

 Top of Page
) 1999-2002 Microsoft Corporation. All rights reserved.

---