[MS-WFIM]:
Workflow Instance Management Protocol
Intellectual Property Rights Notice for Open Specifications Documentation
Technical Documentation. Microsoft publishes Open Specifications documentation for protocols, file formats, languages, standards as well as overviews of the interaction among each of these technologies.
Copyrights. This documentation is covered by Microsoft copyrights. Regardless of any other terms that are contained in the terms of use for the Microsoft website that hosts this documentation, you may make copies of it in order to develop implementations of the technologies described in the Open Specifications and may distribute portions of it in your implementations using these technologies or your documentation as necessary to properly document the implementation. You may also distribute in your implementation, with or without modification, any schema, IDL's, or code samples that are included in the documentation. This permission also applies to any documents that are referenced in the Open Specifications.
No Trade Secrets. Microsoft does not claim any trade secret rights in this documentation.
Patents. Microsoft has patents that may cover your implementations of the technologies described in the Open Specifications. Neither this notice nor Microsoft's delivery of the documentation grants any licenses under those or any other Microsoft patents. However, a given Open Specification may be covered by Microsoft Open Specification Promise or the Community Promise. If you would prefer a written license, or if the technologies described in the Open Specifications are not covered by the Open Specifications Promise or Community Promise, as applicable, patent licenses are available by contacting .
Trademarks. The names of companies and products contained in this documentation may be covered by trademarks or similar intellectual property rights. This notice does not grant any licenses under those rights. For a list of Microsoft trademarks, visit
Fictitious Names. The example companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted in this documentation are fictitious. No association with any real company, organization, product, domain name, email address, logo, person, place, or event is intended or should be inferred.
Reservation of Rights. All other rights are reserved, and this notice does not grant any rights other than specifically described above, whether by implication, estoppel, or otherwise.
Tools. The Open Specifications do not require the use of Microsoft programming tools or programming environments in order for you to develop an implementation. If you have access to Microsoft programming tools and environments you are free to take advantage of them. Certain Open Specifications are intended for use in conjunction with publicly available standard specifications and network programming art, and assumes that the reader either is familiar with the aforementioned material or has immediate access to it.
Revision Summary
Date / Revision History / Revision Class / Comments9/25/2009 / 0.1 / Major / First Release.
11/6/2009 / 0.1.1 / Editorial / Changed language and formatting in the technical content.
12/18/2009 / 0.1.2 / Editorial / Changed language and formatting in the technical content.
1/29/2010 / 0.2 / Minor / Clarified the meaning of the technical content.
3/12/2010 / 0.2.1 / Editorial / Changed language and formatting in the technical content.
4/23/2010 / 0.3 / Minor / Clarified the meaning of the technical content.
6/4/2010 / 0.3.1 / Editorial / Changed language and formatting in the technical content.
7/16/2010 / 1.0 / Major / Updated and revised the technical content.
8/27/2010 / 1.0 / None / No changes to the meaning, language, or formatting of the technical content.
10/8/2010 / 1.0 / None / No changes to the meaning, language, or formatting of the technical content.
11/19/2010 / 1.0 / None / No changes to the meaning, language, or formatting of the technical content.
1/7/2011 / 2.0 / Major / Updated and revised the technical content.
2/11/2011 / 2.0 / None / No changes to the meaning, language, or formatting of the technical content.
3/25/2011 / 2.0 / None / No changes to the meaning, language, or formatting of the technical content.
5/6/2011 / 2.0 / None / No changes to the meaning, language, or formatting of the technical content.
6/17/2011 / 2.1 / Minor / Clarified the meaning of the technical content.
9/23/2011 / 2.1 / None / No changes to the meaning, language, or formatting of the technical content.
12/16/2011 / 3.0 / Major / Updated and revised the technical content.
3/30/2012 / 3.0 / None / No changes to the meaning, language, or formatting of the technical content.
7/12/2012 / 3.0 / None / No changes to the meaning, language, or formatting of the technical content.
10/25/2012 / 3.0 / None / No changes to the meaning, language, or formatting of the technical content.
1/31/2013 / 3.0 / None / No changes to the meaning, language, or formatting of the technical content.
8/8/2013 / 3.0 / None / No changes to the meaning, language, or formatting of the technical content.
11/14/2013 / 3.0 / None / No changes to the meaning, language, or formatting of the technical content.
2/13/2014 / 3.0 / None / No changes to the meaning, language, or formatting of the technical content.
5/15/2014 / 3.0 / None / No changes to the meaning, language, or formatting of the technical content.
6/30/2015 / 4.0 / Major / Significantly changed the technical content.
10/16/2015 / 5.0 / Major / Significantly changed the technical content.
Table of Contents
1Introduction
1.1Glossary
1.2References
1.2.1Normative References
1.2.2Informative References
1.3Overview
1.4Relationship to Other Protocols
1.5Prerequisites/Preconditions
1.6Applicability Statement
1.7Versioning and Capability Negotiation
1.8Vendor-Extensible Fields
1.9Standards Assignments
2Messages
2.1Transport
2.2Common Message Syntax
2.2.1Namespaces
2.2.2Messages
2.2.3Elements
2.2.4Complex Types
2.2.5Simple Types
2.2.6Attributes
2.2.7Groups
2.2.8Attribute Groups
3Protocol Details
3.1IWorkflowInstanceManagement Server Details
3.1.1Abstract Data Model
3.1.1.1Active State
3.1.1.2Suspended State
3.1.1.3Completed State
3.1.2Timers
3.1.3Initialization
3.1.4Message Processing Events and Sequencing Rules
3.1.4.1Run
3.1.4.1.1Messages
3.1.4.1.1.1IWorkflowInstanceManagement_Run_InputMessage
3.1.4.1.1.2IWorkflowInstanceManagement_Run_OutputMessage
3.1.4.1.2Elements
3.1.4.1.2.1Run
3.1.4.1.2.2RunResponse
3.1.4.2TransactedRun
3.1.4.2.1Messages
3.1.4.2.1.1IWorkflowInstanceManagement_TransactedRun_InputMessage
3.1.4.2.1.2IWorkflowInstanceManagement_TransactedRun_OutputMessage
3.1.4.2.2Elements
3.1.4.2.2.1TransactedRun
3.1.4.2.2.2TransactedRunResponse
3.1.4.3Abandon
3.1.4.3.1Messages
3.1.4.3.1.1IWorkflowInstanceManagement_Abandon_InputMessage
3.1.4.3.1.2IWorkflowInstanceManagement_Abandon_OutputMessage
3.1.4.3.2Elements
3.1.4.3.2.1Abandon
3.1.4.3.2.2AbandonResponse
3.1.4.4Cancel
3.1.4.4.1Messages
3.1.4.4.1.1IWorkflowInstanceManagement_Cancel_InputMessage
3.1.4.4.1.2IWorkflowInstanceManagement_Cancel_OutputMessage
3.1.4.4.2Elements
3.1.4.4.2.1Cancel
3.1.4.4.2.2CancelResponse
3.1.4.5TransactedCancel
3.1.4.5.1Messages
3.1.4.5.1.1IWorkflowInstanceManagement_TransactedCancel_InputMessage
3.1.4.5.1.2IWorkflowInstanceManagement_TransactedCancel_OutputMessage
3.1.4.5.2Elements
3.1.4.5.2.1TransactedCancel
3.1.4.5.2.2TransactedCancelResponse
3.1.4.6Terminate
3.1.4.6.1Messages
3.1.4.6.1.1IWorkflowInstanceManagement_Terminate_InputMessage
3.1.4.6.1.2IWorkflowInstanceManagement_Terminate_OutputMessage
3.1.4.6.2Elements
3.1.4.6.2.1Terminate
3.1.4.6.2.2TerminateResponse
3.1.4.7TransactedTerminate
3.1.4.7.1Messages
3.1.4.7.1.1IWorkflowInstanceManagement_TransactedTerminate_InputMessage
3.1.4.7.1.2IWorkflowInstanceManagement_TransactedTerminate_OutputMessage
3.1.4.7.2Elements
3.1.4.7.2.1TransactedTerminate
3.1.4.7.2.2TransactedTerminateResponse
3.1.4.8Suspend
3.1.4.8.1Messages
3.1.4.8.1.1IWorkflowInstanceManagement_Suspend_InputMessage
3.1.4.8.1.2IWorkflowInstanceManagement_Suspend_OutputMessage
3.1.4.8.2Elements
3.1.4.8.2.1Suspend
3.1.4.8.2.2SuspendResponse
3.1.4.9TransactedSuspend
3.1.4.9.1Messages
3.1.4.9.1.1IWorkflowInstanceManagement_TransactedSuspend_InputMessage
3.1.4.9.1.2IWorkflowInstanceManagement_TransactedSuspend_OutputMessage
3.1.4.9.2Elements
3.1.4.9.2.1TransactedSuspend
3.1.4.9.2.2TransactedSuspendResponse
3.1.4.10Unsuspend
3.1.4.10.1Messages
3.1.4.10.1.1IWorkflowInstanceManagement_Unsuspend_InputMessage
3.1.4.10.1.2IWorkflowInstanceManagement_Unsuspend_OutputMessage
3.1.4.10.2Elements
3.1.4.10.2.1Unsuspend
3.1.4.10.2.2UnsuspendResponse
3.1.4.11TransactedUnsuspend
3.1.4.11.1Messages
3.1.4.11.1.1IWorkflowInstanceManagement_TransactedUnsuspend_InputMessage
3.1.4.11.1.2IWorkflowInstanceManagement_TransactedUnsuspend_OutputMessage
3.1.4.11.2Elements
3.1.4.11.2.1TransactedUnsuspend
3.1.4.11.2.2TransactedUnsuspendResponse
3.1.4.12Update
3.1.4.12.1Messages
3.1.4.12.1.1IWorkflowInstanceManagement_Update_InputMessage
3.1.4.12.1.2IWorkflowInstanceManagement_Update_OutputMessage
3.1.4.12.2Elements
3.1.4.12.2.1Update
3.1.4.12.2.2UpdateResponse
3.1.4.13TransactedUpdate
3.1.4.13.1Messages
3.1.4.13.1.1IWorkflowInstanceManagement_TransactedUpdate_InputMessage
3.1.4.13.1.2IWorkflowInstanceManagement_TransactedUpdate_OutputMessage
3.1.4.13.2Elements
3.1.4.13.2.1TransactedUpdate
3.1.4.13.2.2TransactedUpdateResponse
3.1.5Timer Events
3.1.6Other Local Events
3.2IWorkflowInstanceManagement Client Details
4Protocol Examples
5Security
5.1Security Considerations for Implementers
5.2Index of Security Parameters
6Appendix A: Full WSDL
6.1Workflow Instance Management Protocol WSDL
6.2Workflow Instance Management Schema for the WSDL
6.3Workflow Identity Management Schema for the WSDL
7Appendix B: Product Behavior
8Change Tracking
9Index
1Introduction
This document specifies the Workflow Instance Management Protocol, which defines a set of SOAP messages for the management of durable program instances, such as suspending, resuming, or canceling an instance.
Sections 1.8, 2, and 3 of this specification are normative and can contain the terms MAY, SHOULD, MUST, MUST NOT, and SHOULD NOT as defined in [RFC2119]. Sections 1.5 and 1.9 are also normative but do not contain those terms. All other sections and examples in this specification are informative.
1.1Glossary
The following terms are specific to this document:
durable program: A program whose lifetime is not bound to a single operating system process. For more information about these processes, see [PROCESS]. The execution of the durable program starts in one process with a durable state, survives process termination, and can continue to execute in another process at a later point in time.
durable program instance: An identifiable occurrence of the execution of a durable program. The durable program instance captures the complete state of the execution. The execution of a durable program instance is limited to a single process at a time.
globally unique identifier (GUID): A term used interchangeably with universally unique identifier (UUID) in Microsoft protocol technical documents (TDs). Interchanging the usage of these terms does not imply or require a specific algorithm or mechanism to generate the value. Specifically, the use of this term does not imply or require that the algorithms described in [RFC4122] or [C706] must be used for generating the GUID. See also universally unique identifier (UUID).
management operation: An operation on a durable program instance that is not related to the business logic of the durable program.
SOAP: A lightweight protocol for exchanging structured information in a decentralized, distributed environment. SOAP uses XML technologies to define an extensible messaging framework, which provides a message construct that can be exchanged over a variety of underlying protocols. The framework has been designed to be independent of any particular programming model and other implementation-specific semantics. SOAP 1.2 supersedes SOAP 1.1. See [SOAP1.2-1/2003].
SOAP fault: A container for error and status information within a SOAP message. See [SOAP1.2-1/2007] section 5.4 for more information.
SOAP message: An XML document consisting of a mandatory SOAP envelope, an optional SOAP header, and a mandatory SOAP body. See [SOAP1.2-1/2007] section 5 for more information.
Web Services Description Language (WSDL): An XML format for describing network services as a set of endpoints that operate on messages that contain either document-oriented or procedure-oriented information. The operations and messages are described abstractly and are bound to a concrete network protocol and message format in order to define an endpoint. Related concrete endpoints are combined into abstract endpoints, which describe a network service. WSDL is extensible, which allows the description of endpoints and their messages regardless of the message formats or network protocols that are used.
WSDL message: An abstract, typed definition of the data that is communicated during a WSDL operation[WSDL]. Also, an element that describes the data being exchanged between web service providers and clients.
WSDL operation: A single action or function of a web service. The execution of a WSDL operation typically requires the exchange of messages between the service requestor and the service provider.
WSDL port type: A named set of logically-related, abstract Web Services Description Language (WSDL) operations and messages.
XML namespace: A collection of names that is used to identify elements, types, and attributes in XML documents identified in a URI reference [RFC3986]. A combination of XML namespace and local name allows XML documents to use elements, types, and attributes that have the same names but come from different sources. For more information, see [XMLNS-2ED].
XML Schema (XSD): A language that defines the elements, attributes, namespaces, and data types for XML documents as defined by [XMLSCHEMA1/2] and [W3C-XSD] standards. An XML schema uses XML syntax for its language.
XML schema definition (XSD): The World Wide Web Consortium (W3C) standard language that is used in defining XML schemas. Schemas are useful for enforcing structure and constraining the types of data that can be used validly within other XML documents. XML schema definition refers to the fully specified and currently recommended standard for use in authoring XML schemas.
MAY, SHOULD, MUST, SHOULD NOT, MUST NOT: These terms (in all caps) are used as defined in [RFC2119]. All statements of optional behavior use either MAY, SHOULD, or SHOULD NOT.
1.2References
Links to a document in the Microsoft Open Specifications library point to the correct section in the most recently published version of the referenced document. However, because individual documents in the library are not updated at the same time, the section numbers in the documents may not match. You can confirm the correct section numbering by checking the Errata.
1.2.1Normative References
We conduct frequent surveys of the normative references to assure their continued availability. If you have any issue with finding a normative reference, please contact . We will assist you in finding the relevant information.
[MS-DTCO] Microsoft Corporation, "MSDTC Connection Manager: OleTx Transaction Protocol".
[MS-DTYP] Microsoft Corporation, "Windows Data Types".
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate Requirement Levels", BCP 14, RFC 2119, March 1997,
[SOAP1.1] Box, D., Ehnebuske, D., Kakivaya, G., et al., "Simple Object Access Protocol (SOAP) 1.1", May 2000,
[SOAP1.2-1/2007] Gudgin, M., Hadley, M., Mendelsohn, N., et al., "SOAP Version 1.2 Part 1: Messaging Framework (Second Edition)", W3C Recommendation 27, April 2007,
[SOAP1.2-2/2007] Gudgin, M., Hadley, M., Mendelsohn, N., et al., "SOAP Version 1.2 Part 2: Adjuncts (Second Edition)", W3C Recommendation, April 2007,
[WSDL] Christensen, E., Curbera, F., Meredith, G., and Weerawarana, S., "Web Services Description Language (WSDL) 1.1", W3C Note, March 2001,
[XMLNS-2ED] World Wide Web Consortium, "Namespaces in XML 1.0 (Second Edition)", August 2006,
[XMLSCHEMA1] Thompson, H., Beech, D., Maloney, M., and Mendelsohn, N., Eds., "XML Schema Part 1: Structures", W3C Recommendation, May 2001,
[XMLSCHEMA2] Biron, P.V., Ed. and Malhotra, A., Ed., "XML Schema Part 2: Datatypes", W3C Recommendation, May 2001,
1.2.2Informative References
[MS-WSPOL] Microsoft Corporation, "Web Services: Policy Assertions and WSDL Extensions".
[MS-WSRVCAT] Microsoft Corporation, "WS-AtomicTransaction (WS-AT) Version 1.0 Protocol Extensions".
[WSS1] Nadalin, A., Kaler, C., Hallam-Baker, P., et al., "Web Services Security: SOAP Message Security 1.0 (WS-Security 2004)", March 2004,
1.3Overview
The familiar control operations of starting, pausing, and terminating processes are sufficient for managing programs where execution is contained within a single process; however, these operations are insufficient when the program is durable because a durable program spans multiple processes over time. A similar control mechanism that is not scoped to a single process is required for managing durable programs. The Workflow Instance Management Protocol specifies such a control mechanism.
Durable program instances can be hosted on a variety of execution environments or hosts, for example on a desktop computer, a server farm, and so on. The Workflow Instance Management Protocol is provided on durable program hosts that support messaging (that is, messaging hosts) for the external control of various lifetime and execution aspects of the durable program instances running on that host. External control consists of operations for terminating, suspending, and resuming the execution of durable program instances where the client for these operations is typically system administration tooling.
The Workflow Instance Management Protocol defines a set of request and reply SOAP messages that specify these external control operations. This specification also describes the interdependencies of these operations and how they relate to an abstract model of the durable program instance state.
For example, consider an expense approval durable program that is running in a messaging host. The host for the expense approval durable program exposes an expense approval messaging endpoint. The expense approval endpoint and its protocol are part of the definition of the expense approval application. The host can also expose a messaging endpoint that supports the Workflow Instance Management Protocol. This is a generic, infrastructural endpoint provided by the host for the administration of instances of the expense approval durable program. Using this infrastructural endpoint, an administrator of the application can have available tooling that uses the Workflow Instance Management Protocol to control the execution of instances of the expense approval workflows. Using the Abandon, Cancel, Terminate, Suspend, and Unsuspend operations defined in this protocol, the tooling enables the administrator to perform tasks, such as terminating a particular Instance or temporarily suspending its execution.
In some scenarios, operations in the Workflow Instance Management Protocol are used by the system internals itself. For example, the Run operation can be utilized internally by the system for recovery after system failure.
1.4Relationship to Other Protocols
The Workflow Instance Management Protocol can be used with SOAP-formatted messages. The following figure shows a protocol stack:
Figure 1: Protocol stack for the Workflow Instance Management Protocol
1.5Prerequisites/Preconditions
The Workflow Instance Management Protocol requires that:
- The client role can communicate with the server role so that messages can be exchanged between client and server.
- The server role can create and host durable program instances and associate a unique identifier to each durable program instance.
- The client role can determine the unique identifier associated by the server role to the durable program instance on which management operation(s) need to be performed. This unique identifier is used by the client to identify the target instance of the management operation on the server.
1.6Applicability Statement
The Workflow Instance Management Protocol is applicable to scenarios where management of durable program instances is required. The client and server use this protocol to perform management operations on durable program instances.
1.7Versioning and Capability Negotiation
This document covers versioning issues in the following areas:
Supported Transports: This protocol uses multiple transports with SOAP as specified in section 2.1.
Protocol Versions: This protocol has only one WSDL port type version with a single set of operations. The use of these operations is specified in section 3.2.
Capability Negotiation: The Workflow Instance Management Protocol does not support negotiation of the version to use. Instead, an implementation has to be configured to process messages only as described in section 2.1.
1.8Vendor-Extensible Fields
There are no vendor-extensible fields in this protocol.
1.9Standards Assignments
None.
2Messages
2.1Transport
The Workflow Instance Management Protocol can be used over any transport protocol that supports transmitting messages that are specified by the following protocols:
SOAP 1.1 [SOAP1.1]
SOAP 1.2 [SOAP1.2-1/2007]
This specification uses the term SOAP to mean either SOAP 1.1 or SOAP 1.2. An implementation of the Workflow Instance Management Protocol MUST support the processing of messages that are specified by either of these SOAP versions.
2.2Common Message Syntax
This section contains common definitions used by this protocol. The syntax of the definitions uses XML schema (XSD) as defined in [XMLSCHEMA1] and [XMLSCHEMA2], and Web Services Description Language as defined in [WSDL].
2.2.1Namespaces
This specification defines and references various XML namespaces using the mechanisms specified in [XMLNS-2ED]. Although this specification associates a specific XML namespace prefix for each XML namespace that is used, the choice of any particular XML namespace prefix is implementation-specific and is not significant for interoperability.
Prefix / Namespace URI / Referencesoap / / [SOAP1.1]
Soapenc / / [SOAP1.1]
Wsu /
Xsd /
soap12 / / [SOAP1.2-1/2007], [SOAP1.2-2/2007]
Tns /
Wsa /
Wsp /
Wsap /
Wsaw /
Msc / / [MS-WSPOL]
wsa10 /
Wsx /
Wsam /
Wsdl / / [WSDL]
Xs / / [XMLSCHEMA1], [XMLSCHEMA2]
q4 /
2.2.2Messages
This specification does not define any common XSD message definitions.
2.2.3Elements
This specification does not define any common XSD element definitions.
2.2.4Complex Types
This specification does not define any common XSD complex-type definitions.
2.2.5Simple Types
This specification does not define any common XSD simple-type definitions.