Provisioning Schema::procedure

Element that encapsulates the set of steps in a provisioning request. This element is part of the provisioning schema of Microsoft. Provisioning Framework (MPF).


namespace, request


catch (minOccurs="0" maxOccurs="*")
execute (minOccurs="0" maxOccurs="*")
procedureData (minOccurs="0" maxOccurs="1")
queue (minOccurs="0" maxOccurs="*")
Schema (minOccurs="1" maxOccurs="*")
select (minOccurs="0" maxOccurs="*")
transform (minOccurs="0" maxOccurs="*")
try (minOccurs="0" maxOccurs="*")


Note  The following attributes apply only to procedure nodes used in namespace XML files. They are not used in requests.

Optional. Enumeration that specifies the visibility of the procedure. MPF has two types of procedures: public and private. A public procedure can be invoked from outside of MPF (for example, when a user submits requests from a Web application). A private procedure can only be executed by MPF procedures and not directly by the request.
  • "private" (default): The procedure is private.
  • "public": The procedure is public.

Note  When deploying a procedure, change the access type to "private" so it cannot accidentally be invoked by a request. By default, the generated namespace file sets the access type to "public" so it will be easier to test. However, in a live production environment, this is not especially secure.

Optional. Boolean that activates auditing of all calls to this procedure. If set to 1, the Audit Log records calls.
Optional. Description of the procedure.
Required. Name of the provisioning procedure as it is registered in the Configuration Database. Must be unique within a namespace. The namespace name can include letters, numbers, underscores, and spaces.
Optional. Boolean that determines whether MPF collects performance data when executing a procedure. The MPF performance counters are Latency, Rate, Count, Failed, InDoubt, Succeeded, and Executing. The default value is "0". For more information on performance counters, see Help in Provisioning Manager.
Optional. Boolean specifying whether MPF saves rollback data in the executeData block to disk before it processes requests. If there is a failure, MPF passes this data to the procedure's rollback handler. The default value is "0."
Optional. Enumeration that specifies the procedure type: "read," "write", or "twophase." Rollback transaction logging varies by procedure type. For more information, see Transactions.

See also

Customization, Procedure Examples, XML Schema for Procedures

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