Widget Properties

Widget Properties

Overview of the Workflow Conductor Studio

sa08WidgetCommonProperties.jpgAfter a widget is dropped into the workflow, it must be configured before the workflow can use it. To set the properties of a widget, drag your widget to the studio and right-click on it to display the Widget Properties ** for that widget.

Widget Properties vary by widget, but there are a few properties that most widgets have in common. They are described on this page. For a list of the properties unique to a particular widget, see the documentation for that widget.

Icon-WarningIMPORTANT: After making changes to any property in the Widget Properties, be sure to click Apply to save your changes.

The common widgets are described in the table below.

# Common Property Description
1. Display Name This property will default to the widget name, but you can change it to something specific to your workflow to better describe what that widget is configured to do. For example, you might change the Display Name from “Send Email” to “Notify Initiator via Email” to provide more detail about what that particular Send Email widget is doing. When you update a widget Display Name property, it also updates the widget in the Studio diagram.
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. Logging Level

You can select different levels of logging for each widget in your workflow. Workflow logs of workflow run time events can be viewed using the Workflow Conductor Log Viewer Web Part by selecting Run Time mode. Available Logging Level settings are:

  • Errors Only (the default, and least verbose)
  • Errors and Warnings
  • Errors, Warnings, and Info (most verbose)

Workflow Designers can override individual widget Logging Level settings when a workflow is started manually.

4. If Widget Errors:

By default, Conductor will stop a workflow if it encounters an error on any widget. You can customize this behavior for each widget by selecting one of the following options:

  • Stop Workflow (default): The workflow will stop running with a status of Errored (or Canceled in SharePoint 2007). An email containing an error message will be sent to the Workflow Initiator, or other person as configured. See Workflow Error Reporting for more information.
  • Skip This Step: The workflow will skip the step (widget) that errors and continue with the next step.
  • Pause Workflow: The workflow pauses on the step that errors, and sends a notification to the people listed in the Workflow Error Reporting section of the Workflow Conductor Control Panel General Settings page (by default, the Workflow Initiator). The notification includes a link to a form where you can cancel the workflow, skip the step with the error, or repeat the step if the error is now resolved. For more information, see Resolving Workflow Errors.

NOTE: Per-widget error handling options are available in Workflow Conductor 2.5 and higher. Previous versions of Workflow Conductor provide global error handling options in the Workflow Conductor Control Panel General Settings page. Errors in workflows deployed with previous versions of Workflow Conductor will cancel the workflow, no matter what the previous error handling settings were.

By default, widgets are executed with the permission level of the Workflow Initiator. You can override this for many widgets using the Run As property. The Run As property has the following options:

  • Workflow Initiator (default): The widget will run with the permissions of the person who initiates (starts) the workflow.
  • Workflow Designer: The widget will run with the permissions of the user who deployed the workflow from Conductor Studio.
  • Other: The widget will run with the permissions of another user. Click the Lookup User icon sa08userlookupbutton.jpg and enter the Username and Password of another user account. Click Save.