Help Center>Foundation Help

Applies to:

  • Winshuttle Foundation

Export Process State plugin properties

The Export Process State plugin allows you to export the current status of a workflow. You can export the status of a single node, multiple nodes, or an entire workflow. The status values are placed in the column of a SharePoint list.

On this page


Download a sample XML file (.ZIP)Download sample XML file (.zip)

This XML file (contained in a .ZIP file) contains sample XML from the Export Process State plugin.

Export Process State plugin tips and best practices

Back to top
  • The Export Process State plugin should not be used in conjunction with SharePoint columns that are promoted from form fields because the SharePoint column could be modified by the end user when routing the form.

Export Process Plugin Properties table

Back to top

Value Pair

Description

Autocheckout

Allowed values = "true" or "false".

If this argument is not specified, default value of "false" will be used.

If set to "true" and a list item requires checkout before updating and it is not already checked out, then the list item will automatically be checked out/in when the list value is updated.

column

The name of the SharePoint list column to which you want to export the value(s).

multinodebehavior

What the system should do if multiple nodes are selected by the XPath.

Options are comma separated and first. Defaults to comma separated if it is a string field, otherwise it defaults to First.

NOTE: Comma separated is not valid with non-string field types.

xpath

XPath to navigate to the node in the process state data.

Export Process State example—finding who is assigned to a swimlane

Back to top

In this example we want to find out who is assigned to the JEApprover swimlane because we used a SharePoint Query Participant Resolver to assign someone so we can see who the approver was in the SharePoint lists. (In this case, we used this method in an Excel-based workflow, but we could also use it for a form-based workflow as well.)

The resolver is used to find the Full Name of the person assigned to that swimlane:

xpath = /ProcessState/Process/SwimLaneInstances/SwimLaneInstance[Name='JEApprover']/WorkflowParticipant/FullName

Note:

  • You could change FullNametoLoginName at the end of the string.
  • You could also replace [Name='JEApprover] with [Name='yourswimlanename']. ( In our example, we are populating a SharePoint column called JEApprover.)
  • The Multinode Behavior setting is set to comma separated in case more than one result is returned.

Export Process State example—Extract due date

Back to top

Following is an example of an XML description (download this sample file as an example ) of a current process that is running.

The process extracts the Process Due Date of 9/12/2008 1:55:54 PM from the process state XML and inserts it into the SharePoint column Process Due Date. Download the sample XML file (at right) for reference.

Export Process State example 2 property settings

  • xpath - /ProcessState/Process/DueDate
  • column - Process Due Date

The xpath referenced in the plugin is used to navigate to different parts of data in the description.