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

Parents

namespace, request

Children

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="*")

Attributes

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

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.

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