Helix Swarm Guide (2018.3)

Workflows - Technology preview feature

Warning

Workflow is a technology preview feature and is disabled by default.

A workflow can be applied to a projectIn Helix Swarm, a group of Helix Server users who are working together on a specific codebase, defined by one or more branches of code, along with options for a job filter, automated test integration, and automated deployment. or project branch to ensure that changelists and code reviews in the project/branch follow the rules specified in that workflow.

  • Swarm workflows can be created by any Swarm user.
  • Shared Swarm workflows can be viewed by any Swarm user.
  • Shared Swarm workflows can be applied to a project or project branch by any Swarm user that is authorized to edit the project.
Important

The Swarm administrator can enforce a minimum workflow rule setting (by setting the rule to policy mode) for the entire Helix Core Server. If a project or project branch has an associated workflow, the global rule is merged with the workflow rule and the most restrictive setting is used.

This section provides an introduction to listing, searching, and viewing workflows.

Listing workflows

To view a list of workflows, click the Workflows link in the main toolbar.

Image of the Workflows Page

Logged-in users can choose which workflows to display by clicking on the My Workflows tab or the All Workflows tab. Anonymous users only see the shared workflows, the My Workflows tab is not available to anonymous users:

  • The My Workflows: tab lists all of the workflows that you are an owner of.
  • The All Workflows: tab lists all of the shared workflows, and workflows that you are an owner of.
Tip

The Workflow Owner icon Owner Icon image is displayed for workflows you own.

Search workflow names and workflow descriptions

You can search for Swarm workflow names and for the content of the workflow description from the workflows page:

  1. Enter text in the search box.
  2. Click Search.
  3. Any workflow names, and descriptions that match the search text are displayed in the workflows tab:

    Image of a Workflow Name and Description Search

Tip

Switch to the other workflow tab to display search results for that tab.

Viewing a workflow that you own

To view workflow details:

  1. Click the Workflows link in the main toolbar.
  2. Click on the name of the workflow you want to view.
  3. For information about editing the workflow, see Add a workflow.

    Note

    You can edit a workflow if you are the owner of the workflow, or if you have super user rights.

    Workflow Settings image

Tip
  • The project count does not include project branches.
  • If the workflow is associated with a Private project, the private project name is only displayed if you are authorized to view it. Private projects are included in the project count.

Viewing a shared workflow that you do not own

Shared workflows can be viewed and used by all Swarm users.

To view workflow details:

  1. Click the Workflows link in the main toolbar.
  2. Click on the name of the workflow you want to view.
  3. Read Only Workflow image

Tip
  • The project count does not include project branches.
  • If the workflow is associated with a Private project, the private project name is only displayed if you are authorized to view it. Private projects are included in the project count.