Configuring Object Workflows

Object workflows apply to a single object lifecycle and one or more records of a single object. To set up an object workflow, you’ll need to complete several steps:

Create the new workflow and connect it with a lifecycle.
Plan the path of the workflow using Placeholder steps.
Optional: Create message templates for any notifications or task reminders that your workflow sends.
Optional: Set up any additional lifecycle states you need to support the workflow.
Return to the workflow and set up the workflow steps. Begin with the Start step, since you’ll need to add user controls there for any workflow tasks and notifications.
Optional: Add variables to the workflow from the Workflow Details page. Variables support decision steps and branching workflows.
Optional: Add cancellation actions to the workflow from the Workflow Details page.
Activate the workflow.
Create user actions on lifecycle states where users should be able to start the workflow.

Accessing Workflow Administration

You can create, edit, and view workflows from Admin > Configuration > Workflows.

About Envelope & Envelope Content Object Record Access

Object workflows create the high volume Envelope and Envelope Content objects. While end users do not directly interact with these objects, access to these records should be carefully controlled. Because the objects are high volume Vault objects, users with Workflow: Participate permission and access to Envelope or Envelope Content records through a custom object tab or the Business Admin page are able to view those records regardless of record-level permissions. In addition, if a record is in an active workflow, clicking on the Envelope record link may take the user to the workflow task page, even if the user is not a participant of that specific workflow.

How to Create Object Workflows

You can create an object workflow from scratch or copy an existing workflow using the Copy action.

Creating a New Object Workflow

To create a new workflow and outline its path using placeholder steps:

Click Create from the Workflows page.
Select Object Workflow from the drop-down list.
Click Continue.
Enter a Label. This value appears in various places throughout Vault, so it should be easily understood by users.
Optional: Modify the Name. This value is primarily for referencing the workflow via the API.
Select the Lifecycle related to the workflow. Workflows can only link to a single lifecycle and therefore a single object.
Optional: Enter a Description for the workflow. This description is not visible to end users, but can help Admins understand various workflows and how they are configured.
Optional: If you want to initiate this workflow automatically when an object record enters a specific lifecycle state, select the Allow auto-start from entry action and event action checkbox. Learn more in Configuring Auto-Start Object Workflows.
Optional: Select the Workflow cancellation comment checkbox to require users who cancel the workflow to provide a comment.
Optional: Deselect the Use workflow for single object record (selected by default) checkbox to allow users to send multiple object records of the same object type in the same workflow.
Click Save.

Copying an Existing Object Workflow

You can copy an existing workflow with the Copy action. The new workflow targets the same lifecycle as the source workflow. It also duplicates the description, steps, and variables of the source workflow. The copied workflow is created in configuration mode, and you will need to activate it.

To copy an existing object workflow:

From the Actions menu of the workflow you want to duplicate, click Copy.
Enter a Label. This value appears in various places throughout Vault, so it should be easily understood by users.
Optional: Modify the Name. This value is primarily for referencing the workflow via the API.
Click Copy.

You can now configure the workflow copy.

Deleting a Workflow

You can delete a workflow by selecting Delete from the Actions menu.

Workflow Version History

You can see a list of all activated versions of a workflow by selecting View Workflow Versions from the Actions menu. Click on a version of the workflow to view its details and steps. You cannot make changes to or copies of previous workflow versions.

How to Outline Workflows with Placeholders

To create an outline of your workflow’s path using placeholders:

Open the workflow from the Object Workflows page.
Scroll down to Workflow Steps and make sure that you’re in flowchart view.
Use the plus (+) icon between the Start and End steps and select Create Next Step.
Enter a Label for the step that helps you identify it during workflow configuration.
Clear the Edit step details on save checkbox.
Click Save.
Repeat until you’ve created all the steps.
Click into the details for individual steps and change the Next Steps selections. This is necessary if your workflow should branch via a decision step, should merge two paths via a join step, or should include parallel steps.

At this point, your workflow includes an outline of all steps using the Placeholder step type. Later you’ll need to click into each step, select a type (workflow task, notification, etc.), and define details that are specific to the step type.

How to Define the Start Step

The Start step’s primary purpose is to control the dialog that users see when starting the workflow: workflow start dialog. From here, users can enter participant group assignments, task due dates, and new field values for the object record. Which of these options they see will depend on what “controls” you add to the Start step during workflow configuration.

Open the workflow from the Workflows page.
Click into the Start step.
Click Edit.
Click Add Control.
Select a type of control and define type-specific details. Details for each control type are below.
Add as many controls as needed using these steps.
Rearrange the controls by clicking and dragging the upper left corner of each. The order you set is the order that users will see in the workflow start dialog.
Click Save.

You can create a Start Step Rule to define a scenario in which the workflow owner should not see a particular control in the workflow start dialog.

Note: To make a workflow eligible for auto-start, you cannot use certain controls in the Start step. See Configuring Auto-Start Object Workflows for details.

Instructions Control

The Instructions control type lets you enter an explanation or instructions for the workflow owner. For example, provide guidelines for workflow owners on how they should select participants for the workflow. You can use tokens for field values to dynamically add relevant data to the instructions.

Participants Control

The Participants control allows you to create a participant group. All workflows include a single default participant: Workflow Owner. If your workflow needs to assign tasks to any other users, the Start step must include at least one participant control. Every participant group defined this way also appears as a possible recipient for notifications and task reminders. For example, create a participant control labeled Reviewers and assign a review task in the workflow to that participant group.

There are several ways to assign users to a participant group:

Allow workflow owner to select participants: The workflow owner will select users for each participant group when starting the workflow.; With this setting, you can choose to constrain users based on their object record role assignments at the time when the workflow owner starts the workflow. Use the Roles Allowed to Participate (not available for multi-record workflows) and Roles not Allowed to Participate picklists to select user roles to include and/or exclude from the workflow. The workflow owner cannot select users in the roles you select under Roles not Allowed to Participate.; If you select the Default users from sharing settings checkbox, Vault auto-populates role assignments in the start dialog with users and groups currently in those roles in the record sharing settings.; By default, the maximum number of participants that can be assigned to any workflow participant control is 5,000. To configure a limit between 1 and 5,000, navigate to Admin > Settings and enable Limit workflow participants selected by workflow initiator. Provide a Max number of participants per participant control. The workflow initiator will encounter an error if they attempt to assign more participants than the configured limit.
Use roles as participants: Vault will look at the object roles selected under Roles Allowed to Participate and auto-assign any users already in those roles when the workflow starts. Vault automatically excludes roles selected under Roles not Allowed to Participate from the workflow. Users added to valid roles through manual assignment in Sharing Settings receive current workflow tasks and any future tasks associated with the role.; With this setting, Vault does not display the Participant control in the workflow start dialog or when users add participants to active workflows.; See Use Role as Participants for specific behaviors when using this option.
Use custom action to define participants: With this setting, Vault uses the selected custom action to determine participants. These actions are created by your organization with the Vault Java SDK to meet your specific business needs. Talk to your Vault Administrator to learn more about these actions. With this setting, users cannot add participants to active workflows.; If you’re interested in developing custom actions for your organization with the Vault Java SDK, you can learn more on the Developer Portal. This setting is not available for multi-record workflows.

Selecting the Allow task instructions for these participants checkbox allows the workflow owner to provide instructions for each participant selection in the workflow start dialog. Adding instructions is optional by default, but you can make them mandatory by selecting the Required checkbox.

Use Role as Participants

In workflows with the Use Role as Participants option enabled in a Participants control, the behaviors described below determine the tasks which will appear in users’ My Tasks or Available Tasks views:

When a workflow encounters a task step, Vault assigns tasks to every user in the selected participant group. This participant group consists of all users and groups in that role on the record included in the workflow.
If, after the task has been created and assigned, you add a user to a group that was already part of the participant group, the new user will automatically receive the task assignment.
If, after the task has been created and assigned, a new user or group is added to the role on the record included in the workflow, these new users or groups receive the task if they were added to the role on the object record via manual assignment in Sharing Settings or an Update Sharing Settings workflow step. If the new users or groups were added via matching sharing rules, they do not automatically receive the task, and the new user or group must be added as task participants via the Add Participants action.
If an available task is accepted by a user or group and, subsequently, a new user or group is added via the Add Participants action, the new user or group can only accept the task once it is released by the previous user or group.

Date Control

The Date control lets you set up a date field that appears in the workflow start dialog. You can later use this date as a workflow task due date.

For example, create a date control labeled Review Due Date and place it under a participant control for Reviewer. When setting up the workflow task for reviewing, you can use this date control as the task due date.

Prompt for Fields Control

This control inserts fields from the object record and allows the workflow owner to update field values. You can choose to make individual fields required if needed. Using field controls is particularly helpful when the workflow moves the record into a lifecycle state with entry criteria because you can ensure that the workflow owner fills in that information before the state change.

For example, in a Marketing Campaign workflow, create a field control that pulls the Agency Contact field into the workflow start dialog as a required field. Before users can start the workflow on a campaign, they’ll need to enter the agency contact person.

Variable Control

The Variable control allows the workflow owner to set the value for a workflow variable. The workflow configuration can then use the variable value as the basis for branching.

How to Add Variable Controls

Before adding a variable control, you must add a variable to the workflow. This happens from the Workflow Details page, in the Variables section.

To add a variable control:

From within the Start step configuration, click + Add Control.
Select Variable as the control type.
Select a specific variable from the list.
Optional: Select the Required checkbox if the workflow owner must make a selection.
Optional: If you want to prompt for multiple variables, click the + Add variable link and repeat the steps for a second variable. To remove a variable, click the – (minus) icon.

Start Step Rule

Start step rules provide a way to conditionally modify the controls presented in a workflow start dialog. You can prevent the workflow owner from seeing unnecessary controls in the workflow start dialog, or make controls required under certain conditions. To do so, define a rule using Boolean (true/false) expressions as described below. Using this rule, you can hide or make required Participants, Prompt for Fields, or Variable controls.

Rules should only affect controls that are optional in their individual control configuration. Creating rules to hide required controls can lead to workflow errors. For Participants controls, the control is considered optional if all of the tasks in the workflow that the defined participant would take part in are optional.

To create a start step rule:

From within the Start Step Rule section of Start step configuration, click Edit.
Click Create Start Step Rule.
Enter a Rule Label for the start step rule.
Select a rule type from the Select Rule Type drop-down. This selection determines the effect of the rule when the expression returns True.
From the Select Controls drop-down, select the control you want to affect with the rule.
Enter a Boolean (true/false) expression in the If this expression is True box. You can use the Fields, Functions, and Operators tabs to search a list of options.
Click Check Syntax.
If there are no errors, click Save.

Start step rules expressions use Vault standard expression grammar and return true/false. Vault applies the rule’s effects to controls in the workflow start dialog when the expression returns true. Start step rules support all standard field types supported in Vault expression grammar and use the same syntax as formula fields, validation rules, and other expression-based features.

How to Define an Action Step

Action steps define actions that Vault will automatically complete on the object record. For example, an Action step could move the record into a new lifecycle state.

How to Set Up Action Steps

To define an action step:

From the detail page for the workflow, click into a placeholder step.
Set the Type to Action.
Optional: Select Perform with conditions to add conditions to the action rule.
Choose an action type: Change State, Update field, or Update related record field.
Optional: Create more actions within the same rule by clicking Add action. If the rule is conditional, these actions share the same conditions.
Click Save.

Change State Action

An Action step of the Change State type moves the object record from one lifecycle state to another. For example, when a record first enters a review and approval workflow, it could move to the In Review state. While in this state, workflow participants review and provide verdicts. After the decision step, the record would enter either Approved state or move back to Draft state, depending on the verdicts. This setup would require three (3) change state steps: one following the Start step and two following the Decision step.

To set up a Change State step:

Within an Action step, select the Change State type.
Select the Lifecycle State for the record to move to. If the new state has entry criteria, you should include a Prompt for Fields control on the Start step to populate required fields or use the Prompt for Fields setting on a workflow task that occurs before the state change.
Click Save.

State changes performed within an Action step do not check entry criteria or trigger entry actions when the target state is the same as the existing state.

Update Field Action

An Action step of the Update field type allows you to automatically update fields using a formula. For example, a workflow to approve an object record could include a step to set an expiration date for the approval. You can create multiple update record steps in a single workflow. Formulas can use fields from the current object, an object to which it has an outbound relationship, or both. The formula builder includes a tab for the object referenced by the target field, which you can use to reference specific records in the formula.

To set up an Update field step:

Within an Action step, select the Update field type.
Select a field to update from the Fields drop-down.
Click into the Set to value field. For Text, Long Text, Rich Text, Number, and Date fields, the Edit formula of [Field] dialog opens. For Yes/No and Picklist fields, select the applicable value.
Create the formula.
Click Save.

An Action step of the Update related record field type allows you to automatically update indicated fields on related object records. You can use this option to update Yes/No, Picklist, Number, Date, Text, Long Text, and Rich Text fields. For example, a workflow to add a participant to a study could include a step to automatically update the Status field on the related object Application, to Active. You can create multiple update related record steps in a single workflow. When using formulas to set values, formulas can use fields from the current object, an object to which it has an outbound relationship, or both. The formula builder includes a tab for the object referenced by the target field, which you can use to reference specific records in the formula.

To set up an Update related record field step:

Within an Action step, select the Update related record field type.
Select the object record from the Related Object drop-down.
Choose which field to update from the Fields picklist.
The Set to value field appears as either a picklist or formula field, depending on the field you selected to update. Choose the value or enter the formula that populates the indicated field.
Click Save.

Conditional Actions

Action step effects can be conditional. Using conditional actions, you can configure a workflow that will allow different outcomes based on record attributes and task verdicts.

How to Define Conditions

To define a condition:

Set the rule to Perform with conditions.
Select a Condition Type.
Optional: Create additional conditions for a rule by clicking Add condition. A record must meet all of the conditions for a rule in order for Vault to perform the action.

Vault applies all rules in order and per record. Keep this order in mind when defining conditional rules.

Condition Types

Task references verdicts from a preceding Task step. For this condition type, you select the workflow step, operator, and verdict label.
Field references a field value on the document. For this condition type, you select the document field, operator, and field value.

How to Define a Task Step

A Task workflow step assigns a task to users in a specific participant group. Tasks can be simple (instructions to “Review and confirm”) or complex (verdict to select and fields to populate).

Open the workflow from the Workflows page.
Click into a Placeholder step.
Set the Type to Workflow Task and apply Tags if needed.
Enter a Task Label to identify the task.
In Assign Task To, select Workflow Owner or a participant group. The available participant groups are defined in the workflow Start Step.
Below Assign Task To, select either Assign to all users in participant group or Make available to all users in participant group.
Enter Instructions for the task owner. These appear with the task in the Home tab and object record detail page. You can use tokens to dynamically add relevant data to the instructions.
Select the Task Requirement. If the task is Required, the workflow owner must assign the task to the participant group when starting the workflow. If the task is Optional, the workflow owner may or may not select the participant group when starting the workflow.
Optional: Select Do not allow workflow owner to receive this task. This option makes the task unavailable to the workflow owner even if the workflow owner is part of a group assigned to the task. This option does not appear if you selected Workflow Owner in Assign Task To.
Optional: Select the Complete task without viewing the item checkbox to allow task participants to complete the task directly from the task view on their Home tab.
Optional: Select one or more previous tasks in the workflow in the Display information about previous tasks drop-down to allow task participants to see information such as completion dates and verdicts on the task view on their Home tab.
Optional: Select a Due Date. See due date details.
Optional: Under Update Sharing Settings, define rules to add or remove users in roles to sharing settings based on triggering events in the task. See update sharing settings details below.
Optional: Select Prompt for Comments and enter a label for the comment field. Select Required to indicate that the user cannot continue without adding a comment. This option inserts a text field (500 character limit) in the task completion dialog and allows the task owner to provide a comment.
Optional: Select Prompt for Fields and an object field. This option inserts fields from the object record and allows the task owner to update field values while completing the task. Select Required to indicate that the user cannot continue without filling in the field. Click Add Field if you need additional field prompts.
Optional: Select Prompt for eSignature if users completing this task need to electronically sign.
Optional: Select Prompt for Verdicts. With this setting, the user completing the task must select a verdict. You can also configure verdicts to short circuit workflow tasks.
Optional: Under Notification, select a Notification Template to use when sending an automatic notification to the task owner. You can select Include verdicts and comments from previous tasks and select one or more previous tasks in the Select Tasks field.
Optional: Add Task Reminders. Task reminders allow you to configure notifications to send about open tasks. Learn more below.
Optional: Under Custom Actions, select a custom action to execute on this task step. These actions are created by your organization with the Vault Java SDK to meet your specific business needs. Talk to your Vault Administrator to learn more about these actions. If you are interested in developing a custom action, you can learn more in the Developer Portal.
Optional: Select Complete task asynchronously and then select an Alternate Next Step in the drop-down. See details about this step below.
Click Save.

Short-Circuiting Workflow Tasks

You can short circuit workflow tasks to cut-down on extraneous task completion. When a user selects a verdict you have configured to short circuit, Vault cancels all other workflow tasks with the appropriate tags. For example, if only one user in a group of approvers needs to approve a document, Vault will cancel the approval task for all other users in the group after one of the users approves the document. To set this up:

Apply Tags to the workflow task you want to short circuit under Details.
Select Short-circuit tasks with the configured tags.
Select/create the tags associated with the tasks you want to short circuit.
Click Save.

Task Assignments

Selecting Assign to all users in a participant group will assign the task to every user in the participant group. All users in that group will be required to complete the task. If selecting groups in a participant control, the workflow owner sees an Assigned to every user label.

Selecting Make available to all users in the participant group will offer the task to any user in the participant group. All users in the group will be able to accept the task, but not all users are required to complete the task. If selecting groups in a participant control, the workflow owner sees an Available to any user label.

If the same participant control is used in multiple tasks, and it uses different task assignment options in those tasks, then the workflow owner will not see either the Assigned… or Available… label in the start dialog.
If the workflow owner is part of an assigned participant group but is restricted from receiving the task, the workflow owner will not receive the task.

Task Reminders

Task reminders allow you to configure notifications to send about open tasks. To set up task reminders:

Choose a Notification Template for the reminder. Learn more about notification templates.
Select up to five specific groups as Recipients (including the workflow owner and task owner). If no user has claimed an available task when it is time to send the reminder, all potential task owners receive the reminder.
Choose the Send On date for the reminder. The date to send the reminder is a specified number of days from either the Task Due Date or Task Creation Date. For example, you can remind a user to complete a task one day before the task is due. Task Reminders use the Vault Time Zone.
Optional: Click Add Task Reminder to add another reminder. You can add up to five reminders.
Click Save.

Note: Task reminders run daily based on the Task Reminder Notification. By default, the job owner is System, meaning that no user will receive an email if the job fails. If you would like a user to receive an email if the job fails, update the Job Owner in Admin > Operations > Job Definitions.

Due Dates

Due dates for tasks can be based on:

Date controls on the workflow start step.
Date fields on the object; these can be offset by calculating the task due date. Vault will use the field value at the time it creates the task and will not update the due date if the field value changes. This option is not available for multi-record workflows.
Task Creation Date or Workflow Start Date; these can be offset by calculating the task due date.

Due dates are dates only and do not have time components. Task due status is based on the user’s time zone.

Calculated Task Due Dates

When selecting a workflow task due date, you can configure calculated task due dates. This allows Vault to automatically calculate task due dates without input from the workflow owner. To configure calculated task due dates:

Select Workflow Start Date, Task Creation Date, Due Date (defined on start step), or a Date-type object field from the Due Date drop-down list. If you choose Workflow Start Date or Task Creation Date, the dates are based on the Vault time zone set by the Admin.
Select either + or – as a date offset operator
Select a day value up to 365 days.
Optional: If your Due Date is controlled by a Date-type object field, select the Update active task due date when date field is updated checkbox to update this task’s due date whenever the controlling field is updated. If you select this option, Vault does not allow manual updates to the due date. For example, if your due date is controlled by the Release Date field, selecting this checkbox updates the due date for this task every time the Release Date field updates. When a task due date change occurs this way, Vault audits the change as System and updates the Last Modified field on the task.

You can configure rules in the Update Sharing Settings section of the task step to manage Sharing Settings during a task step. To define sharing settings update rules:

From within the Task step, navigate to the Update Sharing Settings section.
Click Add rule.
In the Select Event drop-down, select the triggering event of the task step. You can choose to trigger the sharing settings change at task assignment, completion, cancellation, or reassignment from another user.
In the Select Operator drop-down, select whether to Add or Remove the role assignment upon the triggering event.
In the Select Roles drop-down, select one or more roles affected by the rule. Each triggering event can only affect a role once, preventing conflicting rule definitions.
Optional: Click Add rule to define additional rules.

The Task Reassignment From event option updates the sharing settings of the user from which the task was reassigned, rather than the current task owner.

How to Set Up Verdicts

Verdicts allow a task owner to indicate a recommendation or decision when completing a task. If you wish to make a workflow that branches based on the results of workflow tasks, you’ll need to set up verdicts that the Decision step will later use.

Click Add Verdict to create each verdict.
Enter a Verdict Label which users will see when selecting a verdict.
Optional: Select Short-circuit tasks with the configured tags if you want the verdict to short circuit other workflow tasks.
Optional: Click Add Comments and enter a label for the comment field. Select Required to indicate that the user cannot continue without adding a comment. This option inserts a text field (500 character limit) in the task completion dialog and allows the task owner to provide a comment.
Optional: Select Add Capacities if users selecting this verdict need to provide a capacity. See details below.
Optional: Select Add eSignature if users selecting this verdict need to electronically sign. See details below.
Optional: Click Add Reasons. Enter a Reason Label. Select the Required checkbox to require users to select a reason when they select the specific verdict. Add Reason Values. The label appears on the picklist field and the values appear within the picklist.
Optional: Click Add Field Prompts and an object field. This option inserts fields from the object record and allows the task owner to update field values when selecting the specific verdict. Select Required to indicate that the user cannot continue without filling in the field. Click Add Field if you need additional field prompts.
When you’ve finished setting up all verdicts, click Save.

How to Set Up Capacities

Verdicts can include a Capacity field, which lets the user provide additional context for their task verdict.

Select Add Capacity.
Enter a Capacity Label for the capacity field.
Optional: Select the Required checkbox to require users to select a capacity.

Add Capacity Values. When users complete a task, the capacity label appears with a drop-down that includes these values.

How to Set Up eSignatures

When you add an eSignature prompt to a workflow task or a verdict, users completing the task or selecting the verdict must provide an electronic signature by entering their login credentials. The Signature Type option allows Admins to use a lifecycle state entry action to preserve eSignatures of certain types and make other types obsolete when related object records move to a new state. To learn about eSignature management, see Managing Object eSignatures.

Select Add eSignature.
Optional: Select a Signature Type from the picklist.
Enter Instructions for users.

About Asynchronous Task Completion

The Complete task asynchronously option allows users to complete individual tasks without affecting other workflow tasks or processes. If the workflow encounters an error, it will take the alternate workflow step that you select.

We recommend using this feature for tasks that your organization regularly assigns to over 100 users. Work with your Vault representative before enabling this option. This option is not available for multi-record workflows.

How to Define a Decision Step

A Decision workflow step lets a workflow diverge into separate paths based on verdicts from a previous Task step, field values on the object record, or variable values set by the workflow owner.

When defining rules for branching, start with the most restrictive rule. Vault evaluates the rules in the configured order. The first rule that evaluates to “true” is the path that the workflow takes.

To set up a decision step:

Open the workflow from the Workflows page.
Click into a Placeholder step. If the decision will be based on verdicts, this step must come after a workflow task that includes verdicts.
Change the Type to Decision.
Click Create Rule. You can create a maximum of 30 rules. Vault automatically includes an “Else” rule, which lets you define what happens if the object record doesn’t meet any of the rule criteria.
For each rule, choose to base it on a Field, Task, or Variable. If the rule is field-based, select an object field, an operator, and a field value. If the rule is verdict-based, select a specific workflow task, an operator, and verdict labels. If the rule is variable-based, select a variable, an operator, and a variable value. After then, choose the next step for the workflow to go to if the object record matches the rule.
Define the Else rule. Vault automatically includes this rule, which lets you specify what happens if the object record doesn’t meet any of the rule criteria.

How to Define a Join Step

The Join workflow step lets you merge two separate paths within a workflow. You’ll use this step in workflows that branch or contain parallel steps. For example, a Review & Approve workflow branches based on workflow task verdicts, so an object record moves into Approved state or back to Draft state. After the state change steps, you’d join the branches so that you can set up a single notification step informing the workflow owner that the process is complete.

To set up a join step:

Open the workflow from the Workflows page.
Click into a Placeholder step.
Change the Type to Join.
Click Save.
If your workflow outline isn’t complete, edit the preceding steps to point to the join as their next step.

The Update Sharing Settings step allows you to add or remove workflow participants to or from specific roles in Sharing Settings. For example, a workflow to approve an object record may require an additional review from a user that isn’t normally assigned to the Reviewer role. You can use this step to add the workflow participant to the Reviewer role for this particular instance. Once the participant completes her task, you can configure another step to remove her from the Reviewer role.

To set up an update sharing settings step:

Open a workflow from the Workflows page.
Create a Placeholder step.
Change the Type to Update Sharing Settings
Select the workflow participant(s) from the Workflow Participants picklist.
In the Action field, use the radio buttons to Add or Remove participants.
Select the applicable role(s) from the Roles picklist.
Click Save.

You can also update sharing settings in a task step.

How to Define a Notification Step

Notification steps allow you to send email and in-Vault messages to workflow participants at various points during the workflow. For example, you could send a notification to workflow owners as the final step, so they know the workflow is complete. You could also send notifications to reviewers after a decision step, letting them know what the final decision was, based on their verdicts.

You don’t need to set up separate notification steps to alert task owners that they have a task. There’s a setting within the workflow task step to include a notification.

To set up a notification step:

Open the workflow from the Workflows page.
Click into a Placeholder step.
Change the Type to Notification.
Select a Message Template. You can set these up beforehand from Admin > Configuration > Object Messages.
Select a Recipient. Your options include the Workflow Owner, any participant group you defined in the start step, or a role in the object record’s sharing settings.
Optional: Select the Include verdicts and comments from previous tasks checkbox and select one or more previous tasks in the Select Tasks field.
Click Save.

How to Define a System Action Step

In the current release, most available application-specific system actions are specific to Clinical Operations Vaults for Milestone Dependencies and Monitoring Events and to RIM application Vaults for Content Plans.

The Check Participant Access to Related Documents system action is also available for all Vaults. See configuration details below.

Custom system actions may also be created using Vault Java SDK record actions. Once the code is uploaded to Vault, select it from the dropdown list. Learn more about Record Actions in the Developer Portal.

System Actions in Clinical Operations Vaults

Apply Updated Dependencies: See Milestone Administration for details.
Verify Required Trip Report Responses and Comments, Seed Monitoring Event Participants, Seed Monitoring Event Activities: See Trip Report Administration for details.
Seed Issues: See Issue Management Administration for details.
Create Related Document from Template: This system action creates a document from the chosen template and automatically relates the document to the object record.
Generate Payable Items, Generate Payment Requests: This system action is visible in all Clinical Operations vaults but only works in vaults with the Vault Payments add-on product. See Configuring Vault Payments for details.
Perform Document Reconciliation: This system action is visible in all Clinical Operations vaults but only works in vaults with Veeva Site Connect enabled. See Configuring Document Reconciliation for details.

System Actions in RIM Vaults

Create Content Plan: See Configuring Submission Content Plans for details.
Content Plan Advanced Copy, Create Binder from Content Plan, Content Plan Hierarchy State Change: See Managing Content Plans with a Lifecycle for details.
Populate the Active Dossier, Update Active Dossier, Set Active Dossier Item Country Status: See Active Dossier Configurations for details.

You can configure workflow steps to verify that all users in a workflow participant group are members of at least one specified Application Role on every document related to an object record. Vault checks for permissions, such as View Content permission, via user membership to document application roles, and captures information in a Participant Access Check Results workflow variable. If configured, Vault can then use the Participant Check Access Results object notification template to send a notification to the workflow owner identifying users who lack access to one or more documents.

Configuring the Check Participant Access Step

Check Participant Access to Related Documents is a type of system action in object workflow within all application and platform Vaults. To configure it:

Add a System Action step to the workflow. We recommend adding this step before any workflow tasks assigned to users who may lack necessary permissions on related documents.
Select Check Participant Access to Related Documents in the System Action drop-down.
Select the Participant Group for which Vault should check access to documents.
Select the Application Role to Check Membership In. Vault will verify that all users in the selected participant group are members of at least one of these application roles for every related document. You can choose multiple application roles if needed.
Select the Document Relationship to evaluate. You can select multiple relationships if needed.

Configuring the Participant Access Decision Step

You can select the Participant Access Check Results workflow variable in a decision step as a way to capture and track whether or not users have access to related documents. To configure this:

Add a Decision step to the workflow. This step should immediately follow the Check Participant Access system action step.
In the Rules section, select the Variable condition type in the first drop-down.
Select the Participant Access Check Results variable in the second drop-down. This variable only supports Is blank and Is not blank operators.

If any user lacks access to one or more documents, Vault populates the workflow variable with the value is not blank. If the workflow variable is blank, all users have necessary access to all related documents. In some cases, is blank could also mean that the workflow configuration is incorrect.

Defining a Notification Template

You can use a Check Participant Access object notification template in your workflow to send notifications informing the workflow owner of which users lack access to which documents during a workflow. The token in this template references the Participant Access Check Results workflow variable.

Notifications include a list of users not assigned to the specified application roles, and the documents to which they lack access, including document number and version. The notification will indicate exact issues for up to thirty results. After that number, additional issues will be reported upon subsequent Participant Access Check workflow actions after the first thirty have been resolved. The notification does not specify the total number of issues encountered.

How to Define an End Workflow Step

By default, all new workflows include an End step, but you can create a new one if you accidentally delete the default step. The End step is a way for Vault to know that no further steps are coming and to close out an in-progress workflow.

Start Next Workflow

Depending on your processes, it may be useful to allow a workflow participant to start another workflow for the same object record upon workflow completion. In the End step configuration, select Display start next workflow dialog when workflow ends to allow the user who completes the final task in the workflow to start another workflow immediately via the Start Next Workflow dialog. To see the dialog, the user must have Start permissions for workflows. This dialog is not available for multi-record workflows.

Variables

When configuring a workflow, you can include variables that you then use when evaluating decision steps in order to create branching workflows. The workflow owner sets values for these variables when starting the workflow. With workflow variables and decision steps, Vault can support small variations in a workflow process without needing to configure multiple workflows. For example, your organization may have a single review workflow, but include additional tasks in some situations.

How to Define Variables

To define a workflow variable:

Navigate to the Workflow Details page and down to the Variables section.
Click Add Variable and select a data type (Yes/No, Picklist, Text).
Enter a Label for the variable. The workflow owner sees this when starting the workflow.
For the picklist data type, enter picklist options.
Click Save.

Example Usage

To define a workflow that asks the workflow owner whether secondary approval is required for the object record, and then branches to that step if so, you’d do the following:

Define the Secondary Approval variable for the workflow using the Yes/No data type.
Add a variable control to the Start step that references the Secondary Approval variable.
Create a Decision step in which rules send the workflow to the Approval 2 task step if Secondary Approval is set to Yes and skip that step if Secondary Approval is set to No.

Limits

Each workflow can include up to 25 variables.

Cancellation Actions

By default, when a user cancels a workflow, Vault deletes all outstanding tasks, notifies all participants, and reverts workflow content to the appropriate state. If you want to add additional cancellation behavior, configure actions in the Cancellation Actions section of the Workflow Details page:

From the Cancellation Actions section of the Workflow Details page, click Edit.
Click Create Rule.
Optional: Select Perform with conditions to add conditions to the action.
From the drop-down, select an action. The Send a notification action sends a notification using a message template. The Update Record field action updates a field according to a formula expression. The Remove eSignature from Records action cancels all eSignatures applied to object records in the workflow. You may also see other actions listed here which were created by your organization with the Vault Java SDK to meet your specific business needs. Talk to your Vault Administrator to learn more about these actions.
If you selected the Send a notification action, select a message configuration from the Message Template drop-down, and select the appropriate participants or roles from the Recipients drop-down.
If you selected the Update Record field action, you can configure the update just as in an action step.
Optional: Click Add Action to add additional cancellation behavior.
Click Save.

How to Validate & Activate Workflows

When you’ve finished defining steps, you’ll need to make the workflow active.

Click into the workflow from the Workflows page.
Click Make configuration active.
Vault validates the workflow and notifies you if it is not valid. If there are validation errors, fix your workflow and try again.

After activating the workflow, you’ll need to create a user action on specific lifecycle states to allow users to start the workflow. In the Start States field on the workflow details page, Vault displays all lifecycle states in which the current workflow can start.

If you have enabled Dynamic Access Control on an object, Vault does not check that the users assigned through a participant control have access to a specific object record. It is possible for a user to start a workflow with task assignments that the task owners cannot complete. When configuring workflows, keep this limitation in mind.

Workflow Versioning

If a workflow is active and there’s a user action making it available to users, editing the workflow doesn’t edit the “live” workflow. When you start editing, Vault automatically updates the workflow status to Editing. While the workflow is in this status, users can still start a workflow instance on an object record. That workflow instance uses the configuration as it was before the workflow entered Editing status. Once you’ve re-validated the workflow and changed its status to Active, the new configuration becomes the “live” version. However, workflow instances that started while you were editing the workflow will still use the previous version.

Sometimes, you may need to check whether a specific workflow instance used the previous workflow configuration or the new configuration. You can find this by checking the workflow instance start time in the object record’s audit trail and compare that to the time that the new workflow configuration was activated in System Audit History.