Represents a FIM approval.

Schema

  Copy Code 
<?xml version="1.0"?><xs:schema xmlns:rm="http://schemas.microsoft.com/2006/11/ResourceManagement" targetNamespace="http://schemas.microsoft.com/2006/11/ResourceManagement" version="1.0" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexType name="Approval">
	<xs:sequence>
	<xs:element minOccurs="0" name="ObjectID" type="rm:ReferenceType" />
	<xs:element minOccurs="1" name="ObjectType">
		<xs:simpleType>
		<xs:restriction base="xs:string">
			<xs:pattern value=".{0,448}" />
		</xs:restriction>
		</xs:simpleType>
	</xs:element>
	<xs:element minOccurs="1" name="CreatedTime" type="xs:dateTime" />
	<xs:element minOccurs="0" name="Creator" type="rm:ReferenceType" />
	<xs:element minOccurs="0" name="MVObjectID">
		<xs:simpleType>
		<xs:restriction base="xs:string">
			<xs:pattern value=".{0,448}" />
		</xs:restriction>
		</xs:simpleType>
	</xs:element>
	<xs:element minOccurs="0" name="DeletedTime" type="xs:dateTime" />
	<xs:element minOccurs="0" name="Description">
		<xs:simpleType>
		<xs:restriction base="xs:string">
			<xs:pattern value=".{0,448}" />
		</xs:restriction>
		</xs:simpleType>
	</xs:element>
	<xs:element minOccurs="0" name="DetectedRulesList" type="rm:ReferenceCollectionType" />
	<xs:element minOccurs="0" name="DisplayName">
		<xs:simpleType>
		<xs:restriction base="xs:string">
			<xs:pattern value=".{0,448}" />
		</xs:restriction>
		</xs:simpleType>
	</xs:element>
	<xs:element minOccurs="0" name="ExpectedRulesList" type="rm:ReferenceCollectionType" />
	<xs:element minOccurs="0" name="ExpirationTime" type="xs:dateTime" />
	<xs:element minOccurs="0" name="Locale">
		<xs:simpleType>
		<xs:restriction base="xs:string">
			<xs:pattern value=".{0,448}" />
		</xs:restriction>
		</xs:simpleType>
	</xs:element>
	<xs:element minOccurs="0" name="ResourceTime" type="xs:dateTime" />
	<xs:element minOccurs="1" name="ApprovalDuration" type="xs:dateTime" />
	<xs:element minOccurs="1" name="ApprovalStatus">
		<xs:simpleType>
		<xs:restriction base="xs:string">
			<xs:pattern value="^(Pending|Approved|Rejected|Expired)$" />
		</xs:restriction>
		</xs:simpleType>
	</xs:element>
	<xs:element minOccurs="0" name="ApprovalResponse" type="rm:ReferenceCollectionType" />
	<xs:element minOccurs="1" name="ApprovalThreshold" type="xs:integer" />
	<xs:element minOccurs="0" name="Approver" type="rm:ReferenceCollectionType" />
	<xs:element minOccurs="0" name="ComputedActor" type="rm:ReferenceCollectionType" />
	<xs:element minOccurs="0" name="EndpointAddress" type="rm:StringCollectionType" />
	<xs:element minOccurs="0" name="Request" type="rm:ReferenceType" />
	<xs:element minOccurs="0" name="Requestor" type="rm:ReferenceType" />
	<xs:element minOccurs="0" name="WorkflowInstance" type="rm:ReferenceType" />
	</xs:sequence>
  </xs:complexType>
</xs:schema>

Properties

The following table lists the properties of the Approval object:

Property Description

ApprovalDuration

Optional DateTime property. Indicates the duration of the workflow. When the time in duration is reached after being submitted, the approval is escalated. The second time the duration is reached the approval will timeout and be set to denied. If there is no escalation defined in the approval, the approval will timeout after duration is reached the first time.

ApprovalResponse

Optional multi-valued Reference property that represents a list of references to each ApprovalResponse resource that is associated with this approval.

ApprovalStatus

Optional property. String that represents status of the approval. See ApprovalStatus Property table for a list of valid values. The maximum length of the string is 448 characters.

ApprovalThreshold

Optional Integer property. Indicates how many approvals are required before the approval object is complete.

Approver

Optional multi-valued Reference property that defines valid approvers. The reference will be resolved by the approval activity to only reference Person resources.

ComputedActor

Optional multi-valued reference property that is populated by the FIM Service. This property is used to set up permissions.

EndpointAddress

Optional multi-valued string property. Each instance of this element indicates an endpoint addresses that the workflow instance is listening to.

Request

Optional property. Reference to the Request associated with the given Approval.

Requestor

Optional property. Reference to the creator of the Request associated with the Approval.

WorkflowInstance

Optional property. Reference to a WorkflowInstance that started the approval workflow that created this approval object.

ApprovalStatus Property

Value Description

Pending

Indicates the approval is still pending because some approvers have not yet responded.

Approved

Indicates that the Approval is complete. If the “Threshold” property is set to an integer value X, this means that at least X approvals have been received.

Rejected

Indicates that one or more approvers rejected the approval.

Expired

Indicates that the necessary approvals were not received by the time specified by the “ApprovalDuration” value.

Parent Elements

None

Remarks

All of the resource types in FIM have the same attribute bindings as the Resource type by default. For more information, see Forefront Identity Manager Schema.

See Also