Request Change is an option reviewers and approvers have when completing Request Feedback and Request Approval tasks, and is not a separate widget. This option allows a reviewer or approver to create a new task for another user or group that must be completed before the original review or approval task.

NOTE: The Request Change option is available if the Allow Request Change property for the Request Feedback or Request Approval widget is set to Yes, as shown below. If this property is set to Yes, a Request Change button is displayed at the bottom of the feedback or approval task form.

To create a Request Change task for another user or group, edit a Request Feedback or Request Approval task assigned to you:

Step	Action	Result
1.	Click the Request Change button at the bottom of the review or approval task form.
2.	Enter a single user or group in the Assign Task To box, enter a due date in the Due Date* box (if the task needs one), and enter a Description for the task.	* The earliest Due Date is always used. For example, if the reviewer or approver assigns a Due Date that is earlier than the Due Date in the original task, the workflow uses the new Due Date. However, if the reviewer or approver assigns a Due Date that is later than the Due Date in the original task, then the workflow uses the Due Date in the original task.
3.	Click Submit to assign the Request Change task.	After you click Submit in the Request Change form, several things happen: A new task is created for the user or group you entered in the Assign Task To box. If the Send Email property in the Request Feedback or Request Approval widget is set to Yes, the new user or group is sent a notification e-mail. You can customize the content of this e-mail in the Request Feedback or Request Approval widget Request Change Subject/Body properties. Default text is specified in the Request Approval or Request Feedback Task Change Request sections of the Workflow Conductor Control Panel E-mail Settings. The original task status is updated to Completed. The Outcome field for the original task and the Description field for the new task show the Request Change details. When the user or group assigned to the Request Change task completes the task, you are assigned a copy of your original review or approval task to complete.

Top

The Request Feedback widget assigns one or more users or groups a task to review an item in a list or library. Assigned feedback tasks are completed using a Workflow Conductor task form.

Below, the various sections of the widget properties are separated so that you can quickly jump to the area that is of particular interest to you.

• General Settings
• Task Details
• Notifications
• Fault Handling

This widget has the following features:

• Individual users, groups, or both can be assigned tasks, either explicitly or using lookups.
• Specify how many reviewers must respond for the task to be complete.
• Reviewers can be notified of their tasks by e-mail.
• Notification e-mails sent by the widget can be fully customized or can use global e-mail templates.
• If you are using SharePoint 2010 and the server has InfoPath Forms Services, feedback tasks automatically use customizable InfoPath forms (Workflow Conductor 2.5 for SharePoint 2010 and higher).
• Assigned feedback tasks are visible in associated Microsoft Office 2007 and 2010 applications*.
• Task Due Dates can be assigned using explicit values or lookups.
• Reviewers can delegate tasks or create new tasks for other users from the task form.

• Reviewers can enter comments in the task form, which can be saved to a workflow variable for use later in the workflow.

  * Workflow task integration with Microsoft Outlook (the “Edit this Task” or “Open this Task” button) is only available in SharePoint Server 2010 or Microsoft Office SharePoint Server 2007. Task integration with Microsoft Office applications does not currently work with InfoPath task forms.
  

  Widget Limitation: If the Approver property is a lookup to another SharePoint column, the following SharePoint column type and data format limitations apply for the lookup value:

  • For Person or Group columns, person or group data can be displayed using any user information field, as long as that field has data. For example: Users displayed as Name, Account, Work e-mail, User name, etc., can all be used as approvers. Multiple entries are supported for Person or Group columns.
  • For Single line of text columns, the value must be an account name (DOMAINUsername) or SharePoint group name (e-mail addresses are not supported). Multiple entries are supported for Single line of text columns, separated by semicolons (;).
  • Calculated columns are supported with the same format limitations as Single line of text columns.
  • A lookup to a Choice column with the option Checkboxes (allow multiple selections) selected will only work if a single entry is checked.
  • Lookups to SharePoint Lookup columns are not supported.

General Settings

The image at the top of this page contains numeric reference points for the content of the widget properties. Each number is referenced in the table below.

Top

No.	Column	Description
1.	Display Name	This property will default to the generic widget name, but you can change it to something specific on your workflow to better describe what that widget is configured to do. When you update a widget Display Name property, the widget in the Studio diagram is updated after you click Save.
2.	Description	This is an optional setting that allows you to add a short description for the widget to explain the purpose of it in the workflow. It is only displayed in Conductor Studio, and is not used anywhere in the workflow.
3.	Select Item* This is a required column indicated by the red asterisk.	Select the item on which you want the reviewers to provide feedback. This can be the item that triggered the workflow (the current item), or it can be an item in another list. The default selection is the Current Item. If you need to choose a different item, click the ellipsis icon ( ) to open the Select Item dialog and choose External List Lookup from the Select choices. Identify the item by choosing the Site Collection, Site, List and appropriate filter criteria. When finished with your selections, click Add to save your selections and close the Select Item dialog. Otherwise, click Close to close the dialog without saving any changes.
4.	Feedback Type	Specify the number of reviewers who must respond for the feedback task to be complete. All Feedback Required – Select this if you require feedback from all identified Reviewers. NOTE: The widget is finished when all reviewers respond. Some Feedback Required – Select this option if you do not require feedback from all reviewers. When the specified number of responses is received, the widget is finished. Any incomplete tasks will be marked Completed as soon as the required number of reviewers has completed their feedback tasks. * Number of Responses Required – If you choose Some Feedback Required, this property appears so that you may enter the number of responses required for feedback. You can enter a number directly, or choose to lookup it up which allows you to specify how many users or groups must complete their feedback tasks. NOTE: When the specified number of responses is received, the widget is finished. Any incomplete tasks will be marked Completed as soon as the required number of reviewers has been reached.
5.	Reviewers(Required)	Enter one or more users or groups who need to review the item. Each reviewer is assigned a task when the widget runs, and all tasks must be completed for the widget to finish. Reviewer names can be entered using any of the following methods: Type a SharePoint or Active Directory display name or account name for a user or group and click the Check User icon . Separate multiple users with a semicolon (;). Click the Lookup User icon to search for a SharePoint or Active Directory user or group in the User Lookup form. Enter a lookup to user or group data using the Add Lookup button in the User Lookup form.
6.	Expand Groups	If a SharePoint group is entered in the Reviewers property, the Expand Groups setting determines whether a single task is assigned to the entire group or if a separate task is assigned to each member of the group. Select Yes to assign each user in the group a task, as if each name was entered individually in the Reviewers property. Select No to assign one task to the entire group. NOTE: The owner of the group is considered a member of the group and is also assigned a task. The only exception is when the owner is the default system account, which will not be assigned a task.
7.	Save Comments To	Each reviewer has the opportunity to enter comments when completing a feedback task as shown here. You can view task comments in the completed task.

Task Details

Top

Continuing to look at more of the widget’s properties, the screenshot here shows the Task Details of the widget properties:

Notifications

Top

The next section of the widget properties covers the Notifications section:

No.	Column	Description
12.	Attach Item to Emails	It is possible to attach an electronic file to the email notifications (this option was added in WFC R3.5). When this option is set to Yes, the Item to Attach property appears. By default, the file attached/associated with the current item is used. To attach a different file, click to open the Select List dialog to select an item in another list. This is the same dialog used to specify an item to review earlier in the widget configuration.
13.	Send Task Notification	Select an option, Yes or No, to determine if the widget will send notification e-mails to reviewers when tasks are assigned. Select Yes to send an e-mail to reviewers when a task is assigned. Select No to assign the task without sending task assignment e-mail.
14.	Notification Subject	Customize the subject and body for the notification e-mail sent for the original Request Feedback task. Default text can be specified in the Request Feedback Task Notification sections of the Workflow Conductor Control Panel E-mail Settings.
15.	Notification Body	The default notification body contains a few tokens that may be of interest to you. Every item shown in blue is a lookup that looks up the actual data in the list. Refer to Easy Reference Lookups for more details.
16.	Send Reminder	Select an option, Yes or No, to determine if the widget will send a reminder email to the task assignee some number of days before a task’s due date is reached. The default is No.
17.	Send Status Update Emails	Select an option, Yes or No, to determine if the widget will send status update e-mails to the workflow initiator. The default is Yes. The status update emails CANNOT be specifically configured so no other parameters appear when set to Yes.
18.	Allow Reassignment	Select an option, Yes or No, to allow assigned users to delegate their task to another user. If reassignment is allowed, a Reassign Task button is displayed at the bottom of the task form next to Save and Cancel. The default is No. When a task assignee clicks Reassign Task, a new task form appears (See below). The original task assignee enters a person to delegate the task to (Delegate To), a Due Date for the delegated task, a Description, and then clicks Submit. Another task is created for the workflow instance and the status of the original task is set to Completed.
19.	Allow Request Change	Select Yes to allow approvers to create a new task for the item that must be completed before the approver task is completed. If change requests are allowed, a Request Change button is displayed at the bottom of the task form. Select No if you do not want approvers to be able to create new tasks using the task form. When a task assignee clicks the Request Change button on the task form, a form for a new task appears. The user must then assign the new task to someone, specify a due date, and add a specific description which will overwrite the description from the original task.
20.	Escalate Overdue	Select an option, Yes or No, to determine if the widget will automatically reassign a task to a specified person if the Due Date for a task passes without the task being completed. The default is No.

Fault Handling

Top

Workflow designers have the option to override the logging level configured for widgets and specify a new logging level for all widgets for that workflow instance as described below:

Sample Request Feedback Workflow and Tasks

Return to User Interaction Widgets List

See Also:

• How to Use Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

Removing (deleting) a workflow means it can no longer be associated to a list. The steps for removing a workflow differ depending on how the workflow was deployed* .

Deleting a workflow is different than deleting a workflow template. Please see Overview of Workflow Conductor Templates for more information about templates or Deleting workflow templates for specific information about deleting a template.

Workflows Published to a List Simple Publishing Workflows are published using the Publish to List option in Conductor Studio and are managed in the Associated Workflows page in that list.
Step	Action
1.	In the list or library where the workflow was published, click Associated Workflows in the Workflow Conductor section of the Tools ribbon.
2.	Locate the List Workflow and click the Delete Workflow icon (). IMPORTANT: Deleting a workflow associated with a list will stop all instances of that workflow that are in process and removes the workflow history. Be sure there are no in process instances before deleting a workflow.

Workflows Published to a Site This type of workflow is published using the Publish to Site option in Conductor Studio and is managed in Site Administration.
Step	Action
1.	In the site where the workflow was published, go to Site Actions > Site Settings.
2.	In the Site Administration section, click Manage Site Reusable Workflows.
3.	Locate the Site Workflow and click the Delete Workflow icon (). IMPORTANT: Deleting a workflow that was published to a site will also delete associations of that workflow that were made to specific lists. When a workflow association with a list is deleted, all instances of that workflow that are in process are stopped and the workflow history is removed. Be sure there are no in process instances before deleting a workflow.

Workflows Published to a Site Collection This type of workflow is published using the Publish to Site Collection option in Conductor Studio and is managed in Site Collection Administration.
Step	Action
1.	In the top-level site in the site collection where the workflow was published, go to Site Actions > Site Settings.
2.	In the Site Collection Administration section, click Manage Site Collection Reusable Workflows.
3.	Locate the Site Collection Workflow and click the Delete Workflow icon ().

Workflows Published as Site Workflows This type of workflow is published using the Publish as Site Workflow option in Conductor Studio and is managed in Site Administration.
Step	Action
1.	In the site where the workflow was published, go to Site Actions > Site Settings.
2.	In the Site Administration section, click Manage Site Workflows.
3.	Locate the Site Workflow and click the Delete Workflow icon ().

* For workflows deployed using the Solution Deployment method:

Workflow solutions are deployed using the Deploy option in Conductor Studio and are listed in the Workflow Solution Management page in the Workflow Conductor Control Panel.

• To remove a workflow solution from the current site collection, deactivate the site collection feature.
• To remove a workflow solution from all site collections in the Web application, retract and remove the workflow solution in Central Administration.

For more information and instructions for performing the tasks above, read Remove a Workflow Solution From a Site Collection or Web Application.

See Also:

• Workflow Association
• Removing a Workflow Association
• Disabling a Workflow
• Retract and remove the workflow solution from the Web application (for Site Administrators only!)
• Deactivate the workflow feature in the site collection (for Site Administrators only!)
• Changing Workflow Options

If you no longer want the workflow solution associated to a particular list or library but you want the workflow to remain available for users with Design or Full Control permission to associate to other lists or libraries in the site collection, simply delete its association from any list where it is no longer wanted.

IMPORTANT: When you remove a workflow association, any instances of the workflow that are in progress will be terminated and you will lose access to all workflow history data. To prevent users from starting new instances of the workflow, see Disabling a Workflow. Rather than removing a workflow association while there are instances running, first restrict new instances and then remove the workflow when all in progress workflows complete.

You must have Design or Full Control permission on the list or library to perform these procedures.

NOTES:

• Removing a workflow association terminates all running instances of the workflow and removes it from the list of available workflows that can be started on items in the list or library.

• Removing an association for a workflow deployed using the Solution Deployment method in one list does not affect the workflow in other lists, and you can re-associate the workflow to the list or library later (see the Workflow Association topic). If you want to delete the workflow so it cannot be associated to lists again, see Removing a Workflow Association.

• If the workflow was published to the list (not to the site or site collection) using the Simple Publishing method, removing the association in the Associated Workflows list deletes the workflow. To associate it with the list again, you must republish it from Conductor Studio.

To remove a workflow association,

Step	Action
1.	Go to Settings > Associated Workflows in the list or library, and then click the Delete link next to the workflow. The Associated Workflows page shows all Conductor workflows associated to the current list, no matter which deployment method was used. To remove a workflow association, click the Delete Workflow icon ().
2.	Alternatively, to see if any workflows are in progress before removing one, go to Settings > Workflow Settings in the list or library. A list of the currently associated workflows is shown, with information about how many are in progress. Click Remove a workflow to restrict new instances of a workflow and/or to remove a workflow association. To restrict new instances, select the radio button in the No New Instances column (see below). To remove a workflow association, select the radio button in the Remove column. When ready, click OK. IMPORTANT: When you remove a workflow association, any instances of the workflow that are in progress will be terminated and you will lose access to all workflow history data. It is best to restrict new instances first and then wait until all in progress workflows are deleted before removing.

See Also:

• How to Delete a Workflow deployed using Simple Publishing

• Workflow Association
• Removing a Workflow
• Disabling a Workflow
• Retract and remove the workflow solution from the Web application (for Site Administrators only!)
• Deactivate the workflow feature in the site collection (for Site Administrators only!)
• Changing Workflow Options

: Video example of this widget

The Repeat For Each Item widget executes a series of other widgets for each item in a list. The widget can run for all items in a list, or can be limited to a specific start and end item.

NOTE: For widgets dropped inside the Repeat For Each Item widget, Current Item refers to the item the workflow was started on. It does NOT refer to the item the Repeat For Each Item widget is currently on in the loop. To execute a widget against the current item in the loop, use a Field Lookup to the Repeat For Each Item widget Lookup Item ID variable.

Widget Limitations

• When specifying Start Item or End Item conditions based on criteria in a SharePoint Person or Group column configured to allow multiple values, the SharePoint column values must be listed in the exact order specified in the widget. For example: If the widget is waiting for the Person or Group column to change to User1; User2, SharePoint column values entered as User2; User1 will not match.

• When specifying specific Start Item or End Item conditions based on criteria in a SharePoint Choice column configured to allow multiple values, you cannot select the values in the widget like you can for single Choice columns. You must enter them as text or a lookup to text in the format Value1, Value2 (the space after the comma is required). The values must be entered in the same order they appear in the SharePoint column.

• The widget processes one item per loop, with a minimum one-minute delay between items. This can result in a long-running workflow if Repeat for Each Item is processing a list containing many items. Use Start Item and End Item conditions to limit the number of items processed.

Widget Properties:

Column	Description
Repeat Settings	Click the button to select items for loop widgets to execute on. If you do not make any selections, the loop will start with the first item in the list and continue in order by SharePoint ID to the last item in the list.
Site Collection/Site/List	To execute loop widgets on list items in the current site, select a list in the List box. To execute loop widgets on list items in another site or site collection, make the desired selections in the Site Collection and Site boxes, and then select a List and a View.
Start Item	Select the first item in the list to start executing loop widgets on. NOTE: This condition is only used to identify a start item; it does not filter items in the list. To start executing loop widgets on the first item in the list (by SharePoint ID), select First Item of List. To start with a specific item in the list, select Conditional Item and specify the condition that must be met. The loop will start with the first item in the list (by SharePoint ID) that meets the condition and continue in order by SharePoint ID to the End Item.
End Item	Select the last item in the list to execute loop widgets on. NOTE: This condition is only used to identify an end item; it does not filter items in the list. To stop with the last item in the list (by SharePoint ID), select Last Item of List. To stop with a specific item in the list, select Conditional Item and specify the condition that must be met. The loop will execute for items in the list until the End Item condition is matched, and then exit. Widgets are not executed on the End Item.
Store Loop Item ID (Required)	Select a workflow variable with a Number data type. The Loop Item ID variable stores the ID of the current item in the loop. You can use this ID with a Field Lookup to execute widgets on the current item in the loop not the Current Item (which refers to the item the workflow was started on). Create variables in the Workflow Settings tab in the settings pane, or click the Create new variable link next to the variable list.
Loop Delay (minutes)	Enter the delay between items processed by the widget, in minutes. Each loop processes a single item in the list. The minimum delay is one minute. NOTE: Workflow processing is dependent on the Workflow timer job, which evaluates workflow status every 5 minutes. Repeat for Each Item conditions will be evaluated at the next timer job interval after the specified Loop Delay has elapsed. This means that the minimum effective Loop Delay settings is 5 minutes, even though you can specify a Loop Delay of as little as 1 minute.
Click Apply to save the widget settings.

Return to Workflow Logic Widgets List

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

The Repeat While widget executes a series of other widgets while up to two defined conditions are True. The condition is checked at the start of each loop. When the condition is no longer True, the workflow exits the Repeat While widget and continues with the next widget in the workflow. If more than two conditions are required, Repeat While widgets can be nested.

NOTE: Dropping widgets inside the Repeat While widget is optional. The widget can also be used to simply pause a workflow until a condition is met.

Widget Limitations:When entering a condition to match values in SharePoint Person or Group or Choice columns configured to allow multiple values, enter the matching value in the format listed below:

• Person or Group columns: User1;User2

NOTE: There is no space after the semicolon for the match condition, even though SharePoint displays one in the actual column value.

• Choice columns: Value1, Value2

  NOTE: The space after the comma is required.

  The values must be listed in the same order as they appear in the SharePoint column. For example: If the condition is listed as User1;User2 or Value1, Value2, SharePoint column values entered as User2; User1 or Value2, Value1 will not match.

Widget Properties:

Example of Repeat While Widget

Return to Workflow Logic Widgets List

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

The Remove AD Group widget removes a group from a specified Active Directory location. The widget has the following features and options:

• Remove a group from a pre-configured LDAP path or enter a custom LDAP path (if allowed).
• Choose a group to remove by querying the selected LDAP path or specify a group name with a lookup or workflow variable.
• This widget runs with the permissions of the user configured with the LDAP path.

Return to User & Group Management Widgets

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

The Remove SharePoint Group widget removes an existing group from SharePoint.

The widget has the following features and options:

• Choose a group from the site collection group list or or specify a group name with a lookup or workflow variable.
• Remove groups from any site collection.
• Run this widget with alternate credentials.

Return to User & Group Management Widgets

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

The Remove User From SharePoint Group widget removes one or more SharePoint or Active Directory users from a SharePoint group in the current site collection.

NOTE: To update membership to a SharePoint group, a user must be a site collection administrator or the owner of the group. If the option to allow group members to edit group membership is selected in the group properties, any group member may also update the group.

If it is possible that the workflow initiator will not have this permission, use the Run As property to run the widget as another user with the required permission.

Widget Properties:

Return to User & Group Management Widgets

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

Reassign Task is an option reviewers and approvers have when completing Request Feedback and Request Approval tasks, and is not a separate widget. This option allows a reviewer or approver to delegate the original review, approval, or data collection task to another user. The Reassign Task option is available if the Allow Reassignment property for the Request Feedback or Request Approval Widget is set to Yes, as shown here. If this property is set to Yes, a Reassign Task button is displayed at the bottom of the feedback, approval, or data collection task form.

To reassign a review or approval task to another user, edit a task assigned to you:

Step	Action	Result
1.	Click the Reassign Task button at the bottom of the review or approval task form.
2.	Enter a single user or group in the Delegate To box, enter a due date in the Due Date* box (if the task needs one), and enter a Description for the task.	NOTE: The earliest Due Date is always used. Forexample, if the reviewer or approver assigns a Due Date that is earlier than the Due Date in the original task, the workflow uses the new Due Date. However, if the reviewer or approver assigns a Due Date that is later than the Due Date in the original task, then the workflow uses the Due Date in the original task.
3.	Click Submit to reassign the task.

After you click Submit in the Reassign Task form, several things happen:

• A new task is created for the user or group you entered in the Delegate To box.
• If the Send Email property in the Request Feedback or Request Approval widget is set to Yes, the new user or group is sent a notification e-mail. You can customize the content of this e-mail in the Request Feedback or Request Approval widget Reassignment Subject/Body properties. Default text is specified in the Request Approval or Request Feedback Task Reassignment sections of the Workflow Conductor Control Panel E-mail Settings.
• The original task status is updated to Completed.
• The Outcome field for the original task and the Description field for the new task show the task reassignment details.

The Query Database widget executes a single SELECT, INSERT, UPDATE, or DELETE SQL statement against a database. The results of SELECT statements can be stored in a workflow variable. The widget supports SQL Server, Oracle, ODBC, and OLEDB connections.

NOTE: In the case of SELECT statements, the Query Database widget returns either a single value (field) or a single record (row). SQL statements should be constructed with this in mind.

If the query returns multiple fields or rows, the widget will only store the first row or the first field from the first row of results, depending on the variable type selected for the results. See the Save To Variable property description below for more information.

Widget Properties:

Column	Description
Connection Type (Required)	Select the type of database connection to use. Available choices are SQL Server, ODBC, OLEDB, and Oracle.
Connection String (Required)	For ODBC, OLEDB, and Oracle connection types, manually enter the connection string. For SQL Server connections, click the button to define the following additional properties: Server name: Enter the Server name for your SQL Server database. Authentication: Select Windows Authentication or SQL Server Authentication. Windows Authentication will use the login credentials of the workflow initiator. SQL Server Authentication will use the Username and Password defined in the widget. Username/Password: To connect using SQL Server Authentication, enter a Username and Password. Database: Click the Get Database button to retrieve a list of databases on the specified server, and select the database you want to query. Query: Enter a valid SQL statement. Any SQL statement you enter here will propagate to the Query String property in the main Widget Properties form. Results: To test your database connection, enter a SQL statement in the Query box and click the Test button. For INSERT, UPDATE, or DELETE statements, only the database connection string is tested. For SELECT statements, the query string is also tested, and a result indicating success or failure is shown in the Results field. Statements containing lookups cannot be tested, since lookup values are not determined until the workflow runs. NOTE: You can also test ODBC, OLEDB, and Oracle connection types from this property form.
Query String	Enter a single SQL statement to execute against the database. SELECT statements should be constructed to return a single field from a single row or a single record (row) of results. Click the button to include lookups in your statement.
Save to Variable	Select a workflow variable with a Text or Record data type to store the query results (applicable only for the results of a SELECT statement). Create variables in the Workflow Settings tab in the settings pane, or click the Create new variable link next to the variable list.
Run As	This widget can run with the permissions of the workflow initiator, the workflow designer, or another user. Select the option in the Run As property that best matches your requirement. For more information, see the Common Widget Properties topic.
Click Apply to save the widget settings.

Example Using Query Database Widget

Return to External Data Widgets

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

To open a workflow template from the template gallery, click the Open icon in the Conductor Studio ribbon.

A list of your available templates will be displayed in the My Templates tab of the Template Gallery. Select one or click the Shared Templates or Featured Templates tab to select a template from one of those tabs and then click Open. The workflow template will load into Conductor Studio.

NOTES:

1. Opening a workflow template in Conductor Studio does not open the workflow deployed or published to the current list. You are opening the template that is saved to the template gallery.
2. By default, a saved workflow template can only be opened and edited by the designer who saved it, or by a template manager. For information about sharing templates so other users can view and save a copy of them, see Sharing Workflow Templates.

More Information About the Template Gallery

The Template Gallery is organized into the tabs described in the table below. By default, the templates in each tab are sorted in the order the template was last saved so the one created most recently is at the top of the list. To sort or filter the list, see Filter or Sort the List of Templates in the Template Gallery.

To open a template, select it and then click Open.

The My Workflows Web Part displays all the workflows initiated by the current user in the site, the Web application, or the entire farm. My Workflows displays the status, workflow name, a link to the item the workflow was started on, and additional information that might be relevant depending on the type of workflow.

From this Web Part, the workflow initiator can:

• Cancel a workflow that is running, by clicking the Cancel link associated with the specific workflow.
• Restart a workflow that errored, by clicking the Restart link associated with the specific workflow.
• Resume a paused workflow, by clicking the Resume link associated with the specific workflow.

Sort the list of workflows displayed by clicking on a column heading. Click the same heading a second time to reverse the sort order.

For information about configuring this web part, see How to configure the My Workflows Web Part.

The Move Item widget moves a list or library item from one list or library to another. Fields that exist in both the source and target lists are copied. The item is first copied to the target list, and then deleted from the source list.

Widget Limitation: The source and target list types and column types must match or the Move Item widget will fail.

Widget Properties:

Example Using Move Item Widget

Return to Lists and Items Widgets

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

Return to

• Calculate Widget
• Workflow Logic Widgets List

If you need to collect information from a user in an initialization form when a workflow is started, add a Workflow Initialization Form to your workflow in Conductor Studio. The Workflow Form is made up of one or more fields. Each field is stored in a workflow parameter, which can be used by the widgets in the workflow. Workflow parameters, like workflow variables, appear in the lookup list for Workflow Variables.

NOTE: Workflows with an initialization form must be configured with a manual Start Option to allow users the opportunity to complete the required form fields. When workflows start automatically, users don’t see the initialization form.

If you have already created an initialization form for your workflow, clicking Init Form from the menu or Workflow Settings tab will edit your existing form. If no form has been created yet, clicking Init Form will allow you to create a new form (see Workflow Forms for more information).

To modify an initialization form, follow these steps:

Step	Action	Result
1.	In the Workflow Conductor Studio, click the Add Field button in the Workflow Settings tab. Alternatively, click the Init Form option in the Variables section of the Workflow Conductor ribbon.	The Form Builder is displayed. Fields added previously are listed in the Input Field list. The Form Builder allows you to add more fields to the initialization form or edit, delete, or rearrange fields.
2.	To modify the fields on an initialization form, select the field that needs updating and click Modify. For more details about Information Types, see Information Types used on Workflow Initialization Forms.	The Forms Settings dialog will appear. See below for an example of a Date and Time field ready to be modified.
3.	Modify the parameters as needed. When ready, click Finish to save changes made to the field. Otherwise, click Cancel to close the Form Settings dialog without saving any changes.	The Form Settings dialog will close. IMPORTANT: If you change the field name and have already referenced the parameter in a widget of your workflow, you will need to re-reference the parameter. It will not be updated with the new name automatically.
4.	If you want to delete a field, select it in the Form Builder and click Remove.	The selected field will be deleted. NOTE: There is no warning asking if you are sure you want to remove the field. Clicking Remove, removes the field and you won’t be able to get it back unless you close the Workflow Conductor Studio without saving changes to your template.
5.	If you want to change the order that the fields are displayed to the end user, select a field and choose Move Up or Move Down as appropriate.	The selected field will move up or down the list one position. NOTE: The Move Up and Move Down buttons are disabled unless there is more than one field on the form.
6.	Repeat steps 2-5 to modify, remove, or move more fields, as needed.
7.	When your form is complete, click Close to close the Form Builder.	Your form will be saved.

Workflow Conductor provides a central page to view and manage Workflow Conductor workflow solutions deployed using the Solution Deployment method. This page is accessed from Central Administration by clicking Workflow Conductor > Workflow Solution Management.

NOTE: If you are looking for information about managing workflows deployed using the Simple Publishing method, see Workflow Association for more information.

The following tasks can be performed in the Workflow Solution Management page of the Workflow Conductor Control Panel in Central Admin:

• View workflow solutions across the farm
• Retract and remove workflow solutions
• Manually deploy workflow solutions scheduled for deployment

Top

View workflow solutions across the farm

To view the list of workflow solutions from the Workflow Solution Management page, follow these steps:

Top

Retract and remove workflow solutions

Retracting a workflow solution removes it as a site collection feature. The workflow will no longer be available to associate to lists and libraries. Any workflow instances that are running will be terminated. Removing the workflow solution removes it from the list of solutions in the SharePoint farm.

IMPORTANT: As with any SharePoint solution, before retracting, make sure you have removed any associations to the solution. For a workflow solution, this means that you need to remove the association with any lists and libraries in the appropriate site collection(s). If you do not remove the association before retracting, the workflow will still be associated to the list or library, users will still see it as an available workflow for list items although it will not run, and new workflows deployed with the same name may need to be manually associated before they can run.

For more information about viewing, disabling, and removing workflow associations, see Workflow Association.

To retract and remove a workflow solution from the Workflow Conductor Solution Management page, follow these steps:

Step	Action
1.	Click the solution name in Deployed Solutions section of the Workflow Solution Management list.
2.	In the Solution Properties page, click Retract Solution.
3.	Enter a date and time to schedule the retraction and click OK. You can also schedule the retraction for Now, however note the warning below. While the app pool is recycled, the SharePoint farm is unavailable to users. IMPORTANT: The application pool is recycled during a retraction.
4.	After the solution is retracted, its Status in the Workflow Solution Management list will change to Not Deployed (you may need to refresh the page to see the change). The solution is no longer available to associate to any list in the Web application. If you want to be able to deploy the workflow solution again later, you can leave it in the list. NOTE: Any instances of a workflow that were running when the solution is retracted are terminated.
5.	To completely remove the workflow solution from the farm, click its name again and click Remove Solution. NOTE: If a workflow solution remains deployed (whether it is retracted or not), you will not be able to deploy any other workflows with the same name to the same Web application.

Top

Manually deploy workflow solutions scheduled for deployment

If Workflow Conductor is configured for scheduled solution deployment, solutions that are waiting to be deployed will be listed separately. To deploy a solution immediately instead of waiting for the scheduled time, follow these steps:

The Log to History widget writes a custom message to the workflow history. Workflow history messages are shown on the workflow status page. Read Viewing Workflow Status for more information.

Widget Properties:

Column	Description
Message	Enter text for the workflow history Description column by typing text in the property field or by clicking the button to open the text editor. Add lookups to the Description text using the Add Lookup button () in the text editor.
Outcome	Enter text for the workflow history Outcome column by typing text in the property field or by clicking the button to open the text editor. Add lookups to the Outcome text using the Add Lookup button in the text editor.
Click Apply to save the widget settings.

Example Using Log to History Widget

Return to Lists and Items Widgets

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

This is a high level overview of the types of List and Items Widgets available. Click on the name of the widget to get details and examples.

• Add Attachment: The Add Attachment widget attaches a file to a SharePoint List item.
• Add Column: Add an existing site column to a list or library.
• Check In: Check in an item.
• Check Out: Check out an item.
• Complete Task: Set a task Status field to Completed.
• Copy Item: Copy an item to a list or library.
• Create Column: Create a new column in a list or library.
• Create Item: Create a new item in a list or library.
• Create List: Create a new list.
• Create Task: Create a Task list item.
• Delete Item: Delete an item from a list or library.
• Delete List: Delete a list.
• Discard Check Out: Remove the Checked Out status from an item.
• Get Previous Version: Query and return the value of a field for the previous version of an item.
• Log to History: Write an entry to the Workflow History list.
• Move Item: Move an item to a list or library.
• Set Approval Status: Set the Approval Status on an item.
• Set Field Value: Set the value of a field for an item in a list or library.
• Set Item Permissions: Set unique item permissions for an item in a list or library.
• Update Item: Update one or more fields for an item in a list or library.

See Also:

• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

Use the information in the table below to learn about the Information Types available for Workflow Conductor Initialization Forms.

Type	Description
Single line of text	Top Enter a default value, if desired, and check Requires value if you need this field to have a value before the workflow continues.
Multiple lines of text	TopEnter a default value, if desired, and check Requires value if you need this field to have a value before the workflow continues. Need more info about HTML format allowed.
Number	TopSpecify the following for the Number field: Enter a default value, if desired Check Requires value if you need this field to have a value before the workflow continues. If you want to force the value entered to be greater than a minimum, check the Minimum value allowed box and enter the minimum value. If you want to force the value entered to be less than a maximum, check the Maximum value allowed and enter the maximum value.
Date	TopSpecify the following for the Date field: Enter a default value, if desired. You can select the current date as the default or enter a specific date. Check Requires value if you need this field to have a value before the workflow continues. Choose the format for the date displayed. It can include time or not include time. Check the box if you want the date entered to be greater than the date the workflow runs.
Choice	TopSpecify the following for the Choice field: Enter the choices for the end user. If you would like to display different text than that saved to the parameter, include a vertical separator. For example, to store “1 – High” but display “High”, enter the choice value as 1 – High | High. Enter a default value, if desired. Check Requires value if you need this field to have a value before the workflow continues. Choose to display the choices in a drop-down menu or as radio buttons.
Yes/No	TopEnter a default value, if desired. NOTE: This field will always have a value, so there is no option to make it a required field.

Workflow Conductor widgets are the modular building blocks used to create workflows in Workflow Conductor Studio. Some widgets define the flow, or path, of a workflow, and others perform specific actions, such as sending an e-mail, updating the properties of an item, or creating a task.

Widgets are grouped by function in the widget list in the left pane of Conductor Studio. The categories in this list can be customized by an administrator in Central Administration. See Configuring WF Conductor Categories for more information. The default categories represent the major widget functions (listed below). A Frequently Used category contains widgets that administrators expect to be used most often by workflow designers.

• Workflow Logic Widgets: Workflow Logic widgets handle the “flow” of the workflow. This category includes widgets that allow workflow branching or parallel processing. Some of the widgets in this category are container widgets that allow other widgets to be dropped inside of them. For example, drop other widgets inside the two branches of a Run Parallel widget to allow two sets of actions to be executed simultaneously.
• User Interaction Widgets: User Interaction widgets request input from users or communicate to users during a workflow. Widgets that send e-mail or assign certain types of tasks can be found in this category.
• User & Group Management Widgets: User & Group Management widgets query, create, update, and delete accounts and groups. Widgets that manage Active Directory and SharePoint user accounts and groups are found in this category.
• Lists and Items Widgets: Widgets in the List and Items category read or manipulate SharePoint items, lists, and libraries. Actions such as creating, copying, or updating list items are found here.
• Site Management Widgets: Site Management widgets provide options to create and manage SharePoint sites.
• External Data Widgets: External Data widgets access data outside of the current SharePoint environment. Access to Web services, databases, and even external SharePoint environments is provided by these widgets.

See also an Alphabetical List of Workflow Conductor Widgets.

Workflow Conductor widgets can access data in the current site, other sites in the current site collection, and (in Workflow Conductor 1.5 and higher) most widgets can also access data in other site collections. If a widget can access data in other site collections, you will see the Site Collection box, which allows you to select the site collection and site to access. In addition, any widget property that supports lookups can access data in other site collections with the Field Lookup option.

To add a widget to a workflow, simply drag it from the widget list pane on the left and drop it where you want it in the Conductor Studio diagram. Most widgets require configuration, which is done in the Widget Properties tab of the settings pane. No coding is required to set the properties of a widget.

General information about features common to all widgets can be found in the following sections:

• Common Widget Properties
• Using Lookups in Workflow Studio
• Working with widgets…

The Workflow Variables lookup list contains Variables and Parameters related to the workflow. Parameters are fields that you add to a workflow initialization form.

If you haven’t created an Initialization form or any variables for your workflow yet, you won’t see anything listed here.

Just like the other lookup types, Conductor retrieves Workflow Variable lookups when the workflow reaches the widget.

The Workflow Reports Web Part allows you to create reports about workflows in the current site or site collection. The report is displayed graphically, with a summary text-based list below the chart.

It is possible to specify the range of information you wish to display in the chart. Choose:

• Start Date – the start of the reporting interval
• End Date – the end of the reporting interval
• Period – Summarize the data by period. Choose Day, Week, Month, or Quarter.
• Workflow Status – choose All, Running, Completed, Errored, Canceled, or Paused.

When ready, click View Report. If desired, choose to print the report by click Print. The print includes the graph, but not the list display beneath the chart.

For information about the configuration parameters for this web part, see How to Configure the Workflow Reports Web Part

The My Workflow Tasks Web Part displays tasks created by workflows. These tasks typically reside in lists called Workflow Tasks. My Workflow Tasks can display tasks for the current user or for all users, and can display tasks for the site, the Web application, or the entire farm.

Use the links displayed with each task to see the item that triggered the workflow (in the Item column), the workflow history (in the Workflow Name column).

For information about how to configure the My Wrokflow Tasks Web Part, see How to configure the My Workflow Tasks Web Part.

APPLIES TO
The following widgets in Workflow Conductor 1.1 and higher:

• Conditional Branch
• Compare
• Repeat While
• Wait For Field Change
• Repeat For Each Item (Workflow Conductor 1.5 and higher)
• Field Lookups
• External List Lookups

Some Widgets in Workflow Conductor allow you to specify a condition that must be met in order for the Widget to run. If the condition is comparing a value with a SharePoint Single line of text, SharePoint Multiple lines of text column, or Bamboo Rich Text column, here are some important tips:

• When matching text strings, use less specific match conditions. For example, use Contains instead of Equal To.

• Comparisons are case-sensitive. “Text” and “text” are different strings and will not match.

• If you change the settings for a SharePoint Multiple lines of text column from Plain text formatting to Rich text or Enhanced rich text formatting, an Equal To condition that worked before may stop working. This is because a rich text field contains non-printing characters, even if the text does not appear formatted.

• Field Lookup conditions that require an Equals match will not match Bamboo Rich Text columns or SharePoint Multiple lines of text columns formatted as Rich text or Enhanced rich text. Perform the lookup using a different column in the list.

The Field Lookup conditions shown here will not match any items, even if the text appears to match the column text:

For Bamboo Rich Text and SharePoint Multiple lines of text columns configured for rich text or enhanced rich text formatting, be aware that any text formatting adds non-printing characters that can make the condition false.

The conditions shown below will not match if the word “text” is in bold in the list column:

The Add User to AD Group widget shown here is configured to add a new employee to a group “Conductor”.

In this example, the workflow designer has permission to enter custom LDAP paths in Active Directory widgets.

This setting is configured in the Active Directory Settings section of the Workflow Conductor Control Panel > General Settings page in SharePoint Central Administration.

Return to

Add User To AD Group

User & Group Management Widgets

See Also:

• How to Use Add User to SharePoint Group Widget
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

When a workflow is started manually, Workflow designers have the option to run the workflow in Simulation Mode. Simulation Mode allows designers to test workflow functionality without affecting other users. It skips all delays, and sends e-mail and assigns tasks only to the workflow initiator.

Specifically, Simulation Mode affects workflows in the following ways:

• All Delay For and Delay Until widgets are skipped.
• The Delay Time property in any Repeat While widgets is changed to “0”.
• Approvers and Reviewers configured in Request Approval and Request Feedback widgets are changed to the workflow initiator.
• Send Email widgets will send e-mail only to the workflow initiator.
• The Assigned To property of any Create Task widgets is changed to the workflow initiator.
• Echo Test widgets will send e-mail only to the workflow initiator.

To start a workflow in Simulation Mode, check the appropriate checkbox in the workflow initiation page before clicking the Start Workflow button.

Workflow designers also have the option to override the logging level configured for widgets and specify a new logging level for all widgets for that workflow instance. To override the widget logging level, select the desired logging level in the workflow initiation page.

Workflow Conductor provides a central page to view and manage workflow solutions deployed with Workflow Conductor using the Solution Deployment method. To view the list of workflow solutions, go to Central Administration > Workflow Conductor, and then click Workflow Solution Management.

This list is similar to the Central Administration > System Settings > Manage farm solutions list in SharePoint Central Administration, but limits the list of solutions to those deployed by Workflow Conductor.

The following tasks can be performed in the Workflow Solution Management page.

View workflow solutions

Workflow solutions deployed to the SharePoint farm are listed in the Deployed Solutions section.

For more information about the solution, view the Status and Deployed To columns or click the solution name.

Retract and remove workflow solutions

Retracting a workflow solution removes it as a site collection feature. The workflow will no longer be available to associate to lists and libraries. Any workflow instances that are running will be terminated. Removing the workflow solution removes it from the list of solutions in the SharePoint farm.

IMPORTANT: Before you retract a solution, make sure you have removed its associations with lists and libraries in the site collection. If you do not, the workflow will still be associated to the list or library and users will still see it as an available workflow for list items, but it will not run, and new workflows deployed with the same name may have to be manually associated before they can run. This is a problem with SharePoint, not Workflow Conductor. To see a count of workflow associations for a workflow, go to the Workflows page in Site Settings.

For more information about removing workflow associations, see Removing a Workflow Association.

To retract and remove a workflow solution, follow these steps:

Step	Action	Result
1.	Click the solution name in the Workflow Solution Management list.
2.	In the Solution Properties page, click Retract Solution.
3.	Enter a time to schedule the retraction (which will recycle the application pool) and click OK. For more information about retracting workflow solutions, see Retract and remove the workflow solution from the Web application.
4.	After the solution is retracted, its Status in the Workflow Solution Management list will change to Not Deployed (you may need to refresh the page).	The solution is no longer available to associate to any list in the Web application. If you want to be able to deploy the workflow solution again later, you can leave it in the list. However, you will not be able to deploy any other workflows with the same name to the same Web application.
5.	To completely remove the workflow solution from the farm, click its name again and click Remove Solution.
Viewing Workflow Association Counts
1.	To view the number of associations for a workflow before retracting it, go to Site Actions > Site Settings in the top-level site as a site collection administrator. In the Site Administration section, click Workflows.
Manually Deploy Workflow Solutions Scheduled for Deployment
1.	If Workflow Conductor is configured for scheduled solution deployment, solutions that are waiting to be deployed will be listed separately. To deploy a solution immediately instead of waiting for the scheduled time, click the Deploy link for the solution.	IMPORTANT: The application pool will be recycled when the solution is deployed. Sites in the Web application may be temporarily unavailable.

See Also:

• Workflow Association
• Removing a Workflow Association
• Disabling a Workflow
• Removing a Workflow
• Retract and remove the workflow solution from the Web application (for Site Administrators only!)
• Changing Workflow Options

Workflow Conductor provides a number of tools and web parts to help you run, manage, and view the status of workflows in your environment. You can find each of these topics separately in our documentation and we include them here grouped by permission level.

For SharePoint contributors:

• Running Conductor Workflows on List Items
• Running Site Workflows (for workflows published as site workflows)
• My Workflows Web Part
• My Workflow Tasks Web Part
• Workflow Reports Web Part
• Resolving Workflow Errors

For workflow designers:

• Viewing Workflow Status
• Managing Workflow Associations
• Running Workflows in Simulation Mode
• Log Viewer Web Part

For SharePoint administrators:

• Workflow Solution Management

APPLIES TO

• Workflow Conductor 1.0 and higher

While workflows can be associated with specific Content Types in a list or library, sometimes your workflow only has one or two steps that differ depending on the item’s Content Type. In that scenario, you may not want to maintain multiple workflows for each Content Type. Instead, consider branching your workflow using the Conditional Branch widget with a condition that checks for the item’s Content Type.

Branching a Workflow

Step	Action	Result
1.	Add a Calculated column to your list or library with a value of =Content Type, as shown below. Make sure to associate this column with all Content Types.	The column will auto-populate with the name of the Content Type used to create the item. The column does not have to be included in any views.
2.	In your workflow, insert a Conditional Branch widget wherever your workflow needs to branch depending on Content Type. Configure at least one of the conditions for the widget to include checking the value of the Content Type column, similar to the example shown here:
3.	If you have more than two Content Types and your workflow takes a different action for each one, you can nest Conditional Branch widgets:

To learn how to associate separate workflows to each Content Type, see How to Associate a Workflow Conductor workflow to a Content Type.

How do I configure a workflow to run when items are added or changed?

When you design a workflow in Conductor Studio, you can configure the workflow Start Options in the Workflow Settings tab. Workflow Conductor supports the same start options as SharePoint, including starting a workflow when an item is created or changed. To change workflow start options after the workflow has been deployed, follow the instructions in Changing Workflow Options.

The Get Previous Version Data widget allows a workflow to query and return the value of a field for the previous version of an item if Item Versioning is enabled in the targeted SharePoint list.

IMPORTANT: This widget requires versioning to be enabled in the targeted list.

NOTE: This widget is available in Workflow Conductor version 3.5 or later.

Widget Properties:

Return to Lists and Items Widgets

See Also:

• How to Use Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

The Get User Info widget retrieves a single SharePoint user profile property for a user and stores it in a workflow variable.

Notes for MOSS Users: This widget uses the MOSS User Profile Account property in the Workflow Conductor Control Panel > Account Settings page. This setting specifies a user account that has the Manage User Profiles Shared Services right in Shared Services Administration > Personalization services permissions. This account is used to access the SharePoint User Profile Properties list. Access to specific user profile data is security trimmed at runtime based on the permission of the user account configured for the widget in the Run As property.

Notes for WSS Users: The widget will retrieve profile data from the User Information List in the current site collection. Access to SharePoint user profile data is security trimmed at runtime based on the permission of the user account configured for the widget in the Run As property.

Widget Properties:

Example Using Get User Info Widget

Return to User & Group Management Widgets

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

Workflow Conductor allows Designers and Administrators to easily create custom workflows using a simple drag-and-drop interface. We call that interface Workflow Conductor Studio, or Conductor Studio for short. It is a browser-based design interface that runs within SharePoint and can be accessed directly from a list or library. For more information about using Conductor Studio, visit the following sections:

To start Conductor Studio, first make sure that the account you are using has the Design or Full Control permission level for the list or library. Then, navigate to a list or library and click the Create or Edit Workflows button in the List or Library tab of the Tools ribbon.

NOTE: Administrators can further restrict who can design workflows in Conductor Studio using the Workflow Designers settings in Central Administration >Workflow Conductor. If you are a SharePoint Designer but do not have the Create or Edit Workflows option in the Settings menu, contact your SharePoint administrator.

You can learn more about the four sections of the Workflow Conductor Studio interface by clicking an item below:

• Workflow Conductor widget pane
• Workflow Conductor workflow diagram pane
• Workflow Conductor settings pane
• Workflow Conductor Studio menus

When working with Workflow Conductor, your list of templates may grow quickly and span multiple pages. When this happens, use the Sort and Filter features of the Template Gallery to quickly and easily find the template you need.

NOTES:

1. The sort and filter features of the Template Manager changed a bit in Workflow Conductor Release 3.5. This page describes how they work in the latest release. If you are using an older release, please see Filter or Sort the List of Templates in the Template Gallery in Release 3.2 and Earlier.
2. The screen shot shows the Manage Templates tab because the logged in user is a template manager. If you are not a template manager, you will not see that tab.

To filter or sort the list of templates shown, follow these steps:

Step	Action
1.	In the Template Gallery, hover over the heading of the column that shows the information you want to sort or filter on. A menu arrow () will appear. Click it to see the menu. NOTE: The menu option won’t appear until you hover over the column heading.
2.	To filter the list, hover over Filters to see the text entry box. Enter filter text in the box. The list will be filtered to only those templates that have the text anywhere in the column. For example, the screen shot shows how to filter the list to show only the templates with the word “test” anywhere in the Template Name. As you enter the filter string, the list is filtered dynamically. To remove the filter, uncheck the Filters box.
3.	To sort the list, simply click the header text. Clicking the same header a second time, will reverse the sort order. Alternatively, you can choose Sort Ascending or Sort Descending from the menu displayed in Step 2.
4.	The font of the header will change to indicate a filter is applied to the list using that column. A small arrow () will appear to indicate the list is sorted by that column. The arrow will point up or down, depending on the sort order selected.

Export a template for

• safe keeping,
• to be able to import it to another SharePoint environment, or
• to send a copy to Bamboo’s Support Team if you are having an issue.

Export a template

Import a template

Step	Action
1.	To import a workflow template, select Import from the Workflow area of the menu in the Workflow Conductor Studio.
2.	In the dialog box that appears, browse for the *.xoml file to import and then click Import. NOTE: If the template imported refers to hard-coded server URLs and other things that don’t exist in your SharePoint environment, you may need to make a few adjustments to the workflow before publishing it to your list, site, or site collection.

This is a high level overview of the types of External Data Widgets available. Click on the name of the widget to get details and examples.

• Access SP via REST: Read and update items in an external SharePoint list.
• Call Web Service: Call a SOAP Web service.
• Query Database: Query a database.
• Run PowerShell Script: Run a PowerShell script on the SharePoint server.

Return to About Workflow Conductor Widgets

See also an Alphabetical List of Workflow Conductor Widgets.

Any designer can share a workflow template. However, you may want to highlight specific templates as those that are commonly used, approved for use by all designers, or maybe just good examples for other designers. The template gallery includes a Featured Templates area for this purpose.

IMPORTANT: Designating a template as a Featured Template can be done only from the Workflow Conductor Control Panel in SharePoint Central Administration.

To add a template to the Featured Templates tab, follow these steps:

Step	Action
1.	Go to Central Administration and click the Workflow Conductor section.
2.	In the Workflow Conductor Control Panel, click Template Management.
3.	In the Template Management page, use the table to locate the template you want to feature. You can browse for templates in either the User Templates or Shared Templates tabs. Click the column header to sort the display by that column. Click the same column a second time to reverse the sort order. There is no filter capability for the lists on these tabs.	When you locate the template you want to feature, click the Add to Featured link () for the specific template. NOTE: Previous to Release 3.5, the Add to Featured link was displayed as the word Add.
4.	To remove a template from the Featured Templates list, click on the Featured Templates tab in the table and click the Delete icon ().	Template managers can also delete featured templates from the Manage Templates tab in the Conductor Studio template gallery.

The End Workflow widget stops the workflow with an optional message to the workflow history log. No further widgets will be executed.

The primary purpose of this widget is to end a workflow inside one branch of a branched widget, such as Conditional Branch Widget, Request Approval Widget, or Request Feedback Widget.

NOTE: This widget does not need to be added to the bottom of a workflow, since workflows will always end after the last widget runs.

Widget Properties:

Example of End Workflow

Return to Workflow Logic Widgets List

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

The Disable AD Account widget disables an Active Directory user account.

This widget uses the Active Directory Settings property in the Workflow Conductor Control Panel > General Settings page. These settings provide a list of pre-configured LDAP paths that can be used in the widget and determines if Conductor Studio designers can enter their own LDAP paths. See the General Settings page for more information.

NOTE: This widget accesses Active Directory with the permission of the user account configured with the LDAP path selected in the widget.

Widget Properties:

Example of Using the Disable AD Account Widget

Return to User & Group Management Widgets

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

Disable a workflow when you want to prevent users from starting new instances of the workflow but you want to let running instances finish. This is typically done before the workflow association is permanently removed from the list. Disabling a workflow also lets you keep workflow history data available for future reference. If needed, the workflow can be enabled again if it is not removed.

IMPORTANT: Removing a workflow association terminates any instances of the workflow that might be running and removes the workflow history.

You must have Design or Full Control permission on the list or library to perform these procedures.

Step	Action
1.	From the List Ribbon, click Workflow Settings.
2.	In the Workflow Settings page for the list, click Remove, Block, or Restore a workflow.
3.	In the Remove Workflows page, choose the No New Instances radio button for the workflow you want to disable. This will allow current workflow instances to finish, but the workflow will no longer be listed in the available workflows list. Once no instances are running, it is safe to Remove the workflow by choosing the Remove radio button for a particular workflow association. It is also possible to remove the workflow from the Associated Workflows page accessed from the List Ribbon. NOTE: Previous Versions of workflows are shown only on the Remove Workflows page shown above and therefore can only be removed from there. Active workflows are shown on the Associated Workflows page and can be removed from either place.

See Also:

• Workflow Association
• Removing a Workflow Association
• Removing a Workflow
• Retract and remove the workflow solution from the Web application (for Site Administrators only!)
• Deactivate the workflow feature in the site collection (for Site Administrators only!)
• Changing Workflow Options

The Discard Check Out widget removes the “Checked Out” status from an item that is currently checked out and restores the previous version number.

NOTE: To discard check out for items checked out to other users, the user configured in the Run As property must have the Override Check Out permission.

Widget Properties:

Example Using Discard Check Out

Return to Lists and Items Widgets

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

To delete a workflow template from Workflow Conductor Studio, open the template gallery and locate the copy of the template you want to delete.

IMPORTANT: Deleting a workflow is different than deleting a workflow template. See Removing a Workflow for more information about deleting or removing workflows.

To delete your personal copy of the template, locate it in the My Templates tab and click the Delete link (). Click OK to the warning displayed to delete the template.

IMPORTANT: Once you delete your copy of a template, you cannot get it back. There is no recycle bin. Deleting a template does not affect the published or deployed copy of the workflow in the farm.

To delete the shared copy of a template so it is no longer available to other workflow designers, locate it in the Shared Templates tab and click the Remove from Shared link (). You can only delete templates you originally shared, unless you are a template manager.

NOTE: Since the template listed in the Shared Templates tab is a copy of the original, deleting it will NOT delete the original. The owner of the original template can choose to share it again at a later time.

Featured templates can only be deleted by template managers from either the Workflow Conductor Studio Managed Templates tab or the Workflow Conductor Control Panel in SharePoint Central Administration. See Featured workflow templates for more information.

The Delete List widget deletes an entire list or library from the current site.

Widget Properties:

Example Using Delete List

Return to Lists and Items Widgets

See Also:

• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

The Delete Site widget permanently deletes a SharePoint site from the site collection. The widget includes the following options and features:

• Choose to delete a site in the existing site list or specify a site URL with a lookup or workflow variable.
• Delete sites in other site collections.
• Run this widget with alternate credentials.

IMPORTANT: If you delete the current site, the workflow (and any workflows in progress in that site) will not complete. Deleting the site deletes any workflow associations.

Return to Site Management Widgets

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets

The Delay For widget pauses a workflow until a specified amount of time has elapsed.

NOTE: Workflow processing is dependent on the SharePoint Timer Service, which evaluates workflow status every 5 minutes. The workflow will resume at the next timer interval after the specified amount of time has elapsed.

Widget Properties:

Column	Description
Days	Enter a number of days to pause the workflow. You can type a number or enter a lookup to a number using the Add Lookup icon ().
Hours	Enter a number of hours to pause the workflow. You can type a number or enter a lookup to a number using the Add Lookup icon.
Minutes	Enter a number of hours to pause the workflow. You can type a number or enter a lookup to a number using the Add Lookup icon. NOTE: The Days/Hours/Minutes properties can be used in combination. For example: to pause a workflow for 1 hour and 15 minutes, enter 1 in the Hours property and 15 in the Minutes property. If none of the Days/Hours/Minutes properties are filled in, the workflow will pause until the next Workflow timer job interval (up to 5 minutes).
Click Apply to save the widget settings.

Example of Delay For Widget

Return to Workflow Logic Widgets

See Also:

• Overview of Lookup Selector
• Using Lookups in Workflow Studio
• About Workflow Conductor Widgets
• Alphabetical List of Workflow Conductor Widgets