Ball-in-court workflows

In the portfolio or project settings, you can set up ball-in-court workflow templates to guide records, drawing sets, and specification sets through custom workflows.

The following item types don't support ball-in-court workflow templates:

  • Budget
  • Checklists
  • Drawings
  • Meetings
  • Projects
  • Specifications
  • Transmittals
  • Before you switch to ball-in-court workflows, please consult with your integration administrator because this may affect your existing integrations.
  • If an item type uses ball-in-court workflows, users can't create or copy items if:
    • There are no published workflow templates.
    • They don't have permission to use any workflow templates because the start steps are restricted to a security role that they don't have.
  1. Open the record settings.
  2. Select the item type.
  3. On the settings menu, select Workflow.
  4. If you haven't upgraded to ball-in-court workflows for this item type yet, select Upgrade now.
  1. In the project settings, open the workflow template settings.
  2. On the navigation toolbar, select Locked icon (Locked).
  3. In the confirmation dialog, select OK.

    4. When you unlock the workflow template settings for this project, they become independent from the workflow template settings at the portfolio level.

  1. In the template grid, select Grid icon to show wokflow history (Show workflow history).
  2. Expand the history details.
    • To maximize the History dialog, select Icon to maximize dialog (Maximize).
    • To resize a grid column, select and drag the side border of a column header.
  • In the template grid, select the workflow name.

You can add, edit, and delete the statuses that are used in the ball-in-court workflow templates. You can also select up to five statuses for dashboard widgets.

  • Some item types don't have a dashboard widget.
  • For drawings, only the Current and Not Current statuses are available for the dashboard widget.
  • If you modify a status that's in use, they're updated automatically in all related workflow templates.
  • In the workflow template grid, select Manage statuses.

    • The In use column indicates which statuses are used in a workflow template.

  1. In the workflow template grid, select Manage statuses.
  2. In the dialog:
    • To add a status, select Add, select a status color, and then enter the name.
    • To change the status color, select an option in the Color column.
    • To edit the status name, select the Name column, and then enter the name.
    • To remove a status, select Remove icon(Delete).
  3. Select Save.

You can create workflow templates for different scenarios. When the template is ready, you can publish it.

You can assign a workflow manager in the settings of each template. Workflow managers are responsible for creating, editing, and managing this workflow. This includes assigning, moving steps backward or forward, and overseeing project approvals. They also receive the overdue notification if a step hasn't been completed before the due date.

  1. In the grid, select Add.
  2. On the navigation toolbar, enter a name for the workflow template.
  3. To open the settings, select Settings icon for workflow template (Workflow settings).
    • From the Workflow manager list, select a user.
    • In the Workflow completion time (days) field, enter the total number of days for the workflow.

      • The Step completion time (days) field is calculated automatically based on the number of steps in the template and the number of days in the Workflow completion time (days) field.

      The step calculation doesn't include steps with the Draft status or steps that use the Finish type.

    • To set this workflow template as the default, turn on the Default template toggle.

      • When you create an item, the default workflow template displays a star in the template list.

    • Select Save.
  4. Add workflow steps.
  5. To save the changes, select Save draft.
  1. Open the workflow template.
  2. On the navigation toolbar, select (Copy).
  3. Edit the workflow template.
  4. To save the changes, select Save draft.
  1. Open the published workflow template.
  2. On the navigation toolbar, select New revision icon for workflow template (New revision).

    3. Only one revision can exist at a time in the same level (portfolio or project settings).

  3. Edit the workflow template.
  4. To save the changes, select Save draft.

A workflow template includes the following types of steps:

  • Start (required): The first step of the workflow template.
    • The status for this step is set automatically to Draft for record types that use this status.
    • For other record types, you can select the status for the start step.
  • Input: A step with a single response.
  • Conditional: A step with at least two responses.
  • Finish (required): The final step of the workflow template. A workflow template can include multiple finish steps.

If you restrict a step to an assigned security role, ensure that at least one user in your project has that security role.

  1. At the top of the template, select Add step.

    2. The Step properties panel is displayed on the right side.

  2. In the Name field, enter the step name.
  3. From the Status list, select the status for this step.

    4. To add a status to the list, select Edit and then set up the new status.

  4. From the Type list, select the step type.
  5. Edit the permissions for this step.
  6. Add default assignees to this step.
  7. Add responses to this step.

    8. A response is not needed for finish steps.

  8. To save the changes, select Save draft.
  1. In the Permission section, select Restricted.
  2. From the Roles with access list, select check boxes for the security roles that can edit the record during this step.

    3. If you select Restricted for a start step, only the selected security roles can select this workflow template when they create an item.

  3. Select Done.
  4. For each selected security role, select Editor or Commenter.

    5. The Commenter option isn't available for start steps.

    To remove a security role from the list, select Remove icon (Remove).

  1. In the Assignees section, select an option.

    2. The distribution list, workflow role, and discipline options are displayed if the related lookup lists contain any entries.

  2. Select Add.
  3. In the list, select the check boxes for specific assignees, and then select Done.
    • To remove a default assignee, select Remove icon(Remove) by the name.
    • To remove all the default assignees, select No default assignees in the list.
  1. In the Step properties panel, scroll down to the Response section,
  2. In the If the response is field, enter a name for the response.
  3. From the Then go to step list, select the next step in the workflow.

    4. To add a step, select Add in the Then go to step list, and then set up the new step.

    When the user selects the response in the record, the record proceeds to the selected workflow step.

  4. To add another response to a conditional step, select Add response.

    5. To remove a step, select Remove on the step. Note that input steps must have one response, and conditional steps must have at least two responses.

  • In the grid, select the left side of the step and drag it to a different position.

    • The start step is always at the top of the grid, and the finish steps are always at the bottom of the grid.

  1. In the grid, select the step.
  2. In the Step properties panel, select Remove.

You can edit the steps and details for unpublished workflow templates.

  1. Open the workflow template.
  2. To edit the template settings, select Settings icon for workflow template (Workflow settings).
  3. Add or edit the workflow template steps.
  4. To save the changes, select Save draft.
  1. Open the published workflow template.
  2. On the navigation toolbar, select Settings icon for workflow template (Workflow settings).
  3. Turn on the Default template toggle.

    4. There can only be one default template per record type and per level (portfolio or project settings).

  4. Select Save.

You can publish workflow templates so that they're available for users to apply them to records.

Published workflow templates are read-only, but you can edit the settings (Settings icon for workflow template) for it. If you need to edit the steps or details in a published template, you can create a revision.

If the workflow settings are locked at the project level, the Workflow page in the project settings only displays published workflow templates.

  1. Open the workflow template.
  2. At the bottom of the workflow template, select Publish.

    3. If there are any errors, you can fix them and then select Publish again.

    The status of the workflow template changes to Published.

  1. Open a published workflow template.
  2. At the bottom of the workflow template, select Unpublish.

    3. The status of the workflow template changes to Unpublished, and it's no longer available for creating an item.

You can delete workflow templates that are applied to records. The workflow template is deleted permanently but is still applied to previously created records.

You can't delete the last remaining workflow template. If you don't want to use workflow templates anymore, you can switch back to status workflows.

  1. In the workflow template grid, select Remove icon (Delete).
  2. In the confirmation dialog, select, Delete.