Share via


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).

Arguments

Input Argument Description

Provisioning Schema::catch

(minOccurs="0" maxOccurs="*")

Provisioning Schema::execute

(minOccurs="0" maxOccurs="*")

Provisioning Schema::procedureData

(minOccurs="0" maxOccurs="1")

Provisioning Schema::queue

(minOccurs="0" maxOccurs="*")

Provisioning Schema::Schema

(minOccurs="1" maxOccurs="*")

Provisioning Schema::select

(minOccurs="0" maxOccurs="*")

Provisioning Schema::transform

(minOccurs="0" maxOccurs="*")

Provisioning Schema::try

(minOccurs="0" maxOccurs="*")

Dd252275.note(en-us,TechNet.10).gifNote
The following attributes apply only to procedure nodes used in namespace XML files. They are not used in requests.

access

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.

Dd252275.note(en-us,TechNet.10).gifNote
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.

auditEnabled

Optional. Boolean that activates auditing of all calls to this procedure. If set to 1, the Audit Log records calls.

description

Optional. Description of the procedure.

name

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.

perfEnabled

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.

saveDataForRollback

Optional. Boolean specifying whether MPF saves rollback data in the Provisioning Schema::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."

type

Optional. Enumeration that specifies the procedure type: "read," "write", or "twophase." Rollback transaction logging varies by procedure type.

Remarks

No remarks.

Sample Code

No sample code.

Applies To

Provisioning Schema; Provisioning Schema::namespace; Provisioning Schema::request

See also

Tasks

Provisioning Schema::namespace
Provisioning Schema::request
Provisioning Schema::catch
Provisioning Schema::execute
Provisioning Schema::procedureData
Provisioning Schema::queue
Provisioning Schema::Schema
Provisioning Schema::select
Provisioning Schema::transform
Provisioning Schema::try