The providers implemented in Microsoft Provisioning Framework (MPF) each require specific data and an action to invoke a particular function. The XML request contains the data and action that are passed to MPF.
Requests must meet the following requirements:
The <executeData> element of a procedure implements all required and optional input for the procedure. You can provide input for the <executeData> element in one of the two following ways:
Making use of the information in the <data> element requires a <before> tag to make the data available to the <executeData> element of a procedure. Input provided in the <data> block is available to all procedures in the request that use the appropriate <before> tag.
Providing information directly in the <executeData> element makes it available only to the <execute> element of the individual procedure in which it is specified, not to any other procedures in the request.
Most of the examples of XML requests provided in this section are structured to implement input by incorporating it in the <executeData> element.
The following examples show the two different ways of providing input for procedures.
<request> <data> <name>Reseller1</name> <policyName>reseller</policyName> <container>LDAP://ou=Hosting,dc=contoso,dc=com</container> <description>The contoso reseller</description> </data> <execute namespace="namespace name" procedure="procedure name"> <before source="data" destination="executeData" mode="merge"/> </execute> </request>
<request> <execute namespace="namespace name" procedure="procedure name"> <executeData> <name>Reseller1</name> <policyName>reseller</policyName> <container>LDAP://ou=Hosting,dc=contoso,dc=com</container> <description>The contoso reseller</description> </executeData> </execute> </request>
You can create XML requests by copying the XML from one of two sources:debug files or XML examples. A description of each follows.
You can turn on the debugging option of Delegated Administration Console, and then perform the actions that correspond to the requests you want to capture. The debugging function captures each of the requests, as well as each of the responses. It then writes each request and response to individual files and places them in the Debug folder. The requests show the XML transformations of the request. This is the recommended method for capturing the XML for requests supported in Delegated Administration Console. Even if you do not plan to use Delegated Administration Console, you can install the program, run it using debugging mode, and then uninstall Delegated Administration Console.
For more information on using debugging options, see "Working with debugging options" and "Configure debugging options" in Delegated Administration Console Help.
You can copy the XML from examples of each request shown in appropriate sections for each of the non-provider namespaces. These show the XML transformations of the request and generally show all available options. This is the recommended method for capturing the XML for requests that are not supported in Delegated Administration Console.
The Microsoft Provisioning Framework Software Development Kit (SDK) contains additional resources to help you understand how XML requests and procedures are implemented in MPF. For more information on the SDK and how to use it, see Microsoft Provisioning Framework SDK and documentation.
After copying the XML requests from the appropriate source, you can modify them to meet your requirements. After creating each XML document, including incorporating any required and optional input in the request contained in the document, save the document as an .xml file, using the Unicode - Codepage 65001 encoding option.