Appendix B Workflow Properties

The following table lists alphabetically the properties you can set for a workflow. Properties are set using the Properties pane in Winshuttle Designer. See Winshuttle Solution Model for information about using the Properties pane. Following the table is a section about how to automatically export process data.


Property	Description
AssignmentByEmail	Whether or not to deliver a notification when assignments are done.
AssignmentMessage	The message to send when a new assignment happens. This message can include HTML markup, and it can include references to SharePoint columns.
AssignmentStyle	Whether to allow the user to select from a control when the default Participant Resolver is used or to use Labeled Assignments.
Author	The name of the workflow's author.
AutoAttachedDocumentList	Automatically attaches a document to a form from the specified document library. This occurs when a document is first placed in the library.
AutoAttachedDocumentSite	The site that contains the document library whose documents will be automatically attached to forms.
AutoLaunchOnCheckIn	Automatically launches the process when an item is checked in. It is the responsibility of the Process Designer to ensure that swimlanes are assigned before visiting nodes in the swimlanes.
AutoLaunchOnCreate	Automatically launches the process when an item is created. It is the responsibility of the Process Designer to ensure that swimlanes are assigned before visiting nodes in the swimlanes.
AutoLaunchOnEdit	Automatically launches the process when an item is edited. It is the responsibility of the Process Designer to ensure that swimlanes are assigned before visiting nodes in the swimlanes.
AutoLaunchOnEditColumn		Works only when AutoLaunchOnEdit is set to "true". The columns specified in AutoLaunchOnEditColumn must be updated to trigger the workflow.
CancellationMessage		The message to send when an existing assignment is canceled. This message can include HTML markup, and it can include references to SharePoint columns.
ChallengeOnApproval		Whether or not to require users to retype their username and password before completing an assignment.
Desc		The description of the workflow.
Duration		The expected duration of the entire workflow.
DurationUnit		The unit of the duration. Can be either Day or Hour.
ExceptionMessage		The message to use when the system encounters some problem, such as a blocked workflow.
ExtendedAttributes		A collection of SharePoint columns that can be edited during the assignment completions.
LabeledAssignmentColumn		The name of the column whose contents will be used to select the collection of participants for an assignment.
Name		The name of the workflow.
OverrideDuration		The name of a SharePoint column whose numeric content will be used to override the expected duration.
PastDueMessage		The message to send when an assignment is overdue.
ReminderMessage		The message to send when an assignment is almost due.
SharePointList		The name of the list against which this workflow can be run. This is a drop-down list of the SharePoint lists that exist on the SharePoint site you have specified. The lists must include all variables that are referenced in the workflow.
SharePointSite		The URL of the site that the workflow is associated with. After this site is entered, Winshuttle Designer queries the SharePoint server to retrieve further information about the site that is used to populate other controls in Designer.
SharePointSiteExtensions		Multiple SharePoint site URLs can be defined for publishing processes (but not for publishing forms). The defined site or sites must contain the list that is selected in the SharePointList property. If multiple URLs are specified, they must be comma separated.
SharePointTaskList		The name of a SharePoint Task List in the specified site that should be updated when assignment statuses are updated.
SharePointTaskListSite		The name of the SharePoint site that contains a task list that should be updated when assignment statuses are updated.
DesignerAssignmentStatusList		The name of the assignment status list that should be updated when assignment statuses are updated.
DesignerProcessStatusList		The name of the process status list that should be updated when assignment statuses are updated.
DesignerStatusListSite		The name of the site that contains the assignment status list, the process status list, or both that should be updated when assignment statuses are updated.
SiteCollectionGUID		The read-only SharePoint Globally Unique Identifier(GUID) for the site collection that contains the site to which Designer is connected.
SPListFields		The read-only list of SharePoint columns in the list that is selected.
Status		Whether this workflow is still a work in progress or completed. No longer used.
StrictEvaluation		Whether or not the workflow engine should use a strict evaluation method. False allows Process Designers to avoid using And nodes when multiple transitions enter a single node.
SwimLanes		The collection of swimlanes in the workflow.
Version		The read-only version of this workflow.

Automatic Process Data Update

After successfully installing Winshuttle Designer, the installer creates two custom lists preconfigured with relevant field names and data types:

The Winshuttle Process Status List is preconfigured to hold data on individual workflows that have been started. You can add additional fields to instances of this list to contain process data that might be relevant for a process summary list.
The Winshuttle Assignment Status List is preconfigured to hold data on individual assignments that have been created as part of a running workflow. You can add your own relevant fields to instances of this list.

The fields in these lists are designed to contain Winshuttle Designer workflow data. All field names are prefixed with SV to prevent name conflicts with data that you might already have in your forms and document libraries.

For example, one of the fields in the Winshuttle Process Status List is named SVCreationDate, and that field will contain the creation date of a particular workflow in a populated list. By adding your own fields to forms status list instances, you can also have the system automatically synchronize your own data from your forms or document libraries to the status lists. Using this functionality, you can configure your workflows so there is a single SharePoint list that contains process and assignment data from all SharePoint sites in your organization. This type of list that aggregates data from numerous sources is also known as a rollup.

To configure your workflows to automatically update process and assignment data into instances of these forms lists, you must tell the workflow where to find them. In Winshuttle Designer, set the URL to the site that contains these lists in the WinshuttleStatusListSite field. This should be the full URL that references the site.

For example, http://spserver/statusrollup would reference a site named statusrollup on your server. After entering this URL, Designer will retrieve the list data, and it will present the lists with the proper types as a drop-down in the WinshuttleAssignmentStatusList and the WinshuttleProcessStatusList fields. You can then select the list to which to write process data. Once you have configured your workflow, the system will automatically write appropriate data to these lists as your processes progress.

To add your own data from your form or document library fields, add the fields with the exact name to the instance of the Winshuttle Designer Process Status List or the Winshuttle Assignment Status List. The system will synchronize these items each time it writes Winshuttle Designer data to the lists.