Skip to main content

XTM Cloud 26.4

Editing the workflow for selected jobs in the Edit Workflow screen

You can edit the workflow for selected jobs in the Edit Workflow screen at any time. There are many ways in which you can open the Edit Workflow screen, depending on the set of jobs for which you want to edit the workflow. You can:

In the Edit Workflow screen, you can perform these actions:

  • Manage additional workflow options for the selected workflow step.

  • Edit transition type between steps.

  • Add workflow steps.

  • Change the workflow step to a different one.

  • Delete workflow steps.

Important

These features only enables you to edit the selected workflow definition for the selected jobs and a particular project. They do not affect the global workflow definitions created by your XTM Cloud Administrator (for details, see Creating workflow definitions).

Important

If you are a user with the Limited Project Manager (LPM) role, your access rights to the New Workflow Editor and its functions can vary. For details, see Project Editor – Beta Workflow Editor.

Procedure. To edit the workflow for selected jobs in the Edit Workflow screen:
  1. For the relevant project, open the Project Editor – kanban_gray_solid_brand_refreshed.svg Workflow tab screen.

  2. Ensure that you are working in the Beta Workflow Editor. If you are not, enable it. For details, see Enabling the Beta Workflow Editor.

  3. Display the relevant jobs in the Manage jobs view. For details, see Viewing jobs in the Manage jobs view.

    Result: You are redirected to the Manage jobs view.

  4. If necessary, filter the displayed results. For details, see Filtering jobs in the Manage jobs view.

    You can also use the search box to display only relevant jobs. For details, see Searching for jobs in the Manage jobs view.

  5. Use checkboxes in the table, in the Manage jobs view, to select the jobs whose workflow you want to edit. You can:

    • edit the workflow for all jobs displayed in the current table page, in the Manage jobs view. To do so, select the checkbox in the table header.

    • edit the workflow for all jobs in the project, displayed on all pages, in the Manage jobs view. To do so, select the checkbox in the table header. Then, select the Select all [number] jobs on all pages button that is displayed above the table when you select the checkbox in the table header. Now you can bulk-edit the workflow for all jobs listed in the Manage jobs view, on all pages.

    • select one or more checkboxes on the same table page to only edit the workflow for the selected jobs.

    • edit the workflow for one or more jobs that are displayed on different table pages. To do so, first, display the relevant jobs on the same page. You can either adjust the number of entries that are to be displayed on one page or filter jobs to ensure you see all relevant jobs on the same page, in the table, in the Manage jobs view. Next, select the checkboxes for all required jobs.

  6. After you have selected all required jobs, select the Edit workflow button at the top of the table.

    Result:

    • If all selected jobs have the same workflow definition, the Edit Workflow screen is displayed. In the top left-hand corner of that screen, you see the number of jobs for which you are currently editing the workflow. For example, 3/3 indicates that you are editing the workflow for all three jobs you have selected in the Manage jobs view. So, all changes that you now make will apply to all the selected jobs. All settings you can make in the Edit Workflow screen are listed in the next step.

    • If selected jobs have different workflow definitions, you see a Choose workflow definition popup. In it, the You have selected jobs with different workflow definitions warning prompts you to select only one workflow definition. When you select:

      • the Exit button at the bottom of the screen, you return to the Manage jobs view. In it, you can select jobs with the same workflow definitions and select the Edit workflow button again.

      • one specific workflow definition, it is displayed in the Edit Workflow screen. In the top left-hand corner of that screen, you see the number of jobs for which you are currently editing the workflow versus the total number of jobs that you have initially selected in the Manage jobs view. For example, 2/5 indicates that you are only editing the workflow for two out of five initially selected jobs. So, all changes that you now make will only apply to these two jobs. All settings you can make in the Edit Workflow screen are listed in the next step.

        If, in the Edit Workflow screen, your changes to the selected workflow definition make it identical to another workflow definition that has been displayed in the Choose workflow definition popup, and you select the Save button, the number of jobs that you see in the top left-hand corner will increase. That is because more jobs now share this workflow definition, and you can edit all of them at once.

        Example 41. Why the number of edited jobs increases

        You initially selected five jobs. Two of them had the Translate two_straight_lines.svg Correct workflow definition, and the remaining three had the Translate dashed_vertical_line.svg Correct workflow definition. In the Choose workflow definition popup, you selected Translate two_straight_lines.svg Correct. So, in the top left-hand corner of the Edit Workflow screen, you previously saw 2/5. You then changed the transition type between workflow steps from two_straight_lines.svg to dashed_vertical_line.svg. As a result, all five jobs now share the same workflow definition. So, in the top left-hand corner of the Edit Workflow screen, you now see 5/5, and all changes that you now make will apply to all five initially-selected jobs.


  7. In the Edit Workflow screen, you can perform these actions, if required:

    1. Select additional options for a step. For details, see Selecting additional options for workflow steps in the Edit Workflow screen.

    2. Change the transition type between workflow steps. For details, see Changing the transition type between workflow steps in the Edit Workflow screen.

    3. Add steps to selected workflow definitions. For details, see Adding steps to a selected workflow definition in the Edit Workflow screen.

    4. Change the workflow step to a different one. For details, see Changing a step type in a selected workflow definition in the Edit Workflow screen.

    5. Delete a workflow step. For details, see Deleting workflow steps in the Edit Workflow screen.

    6. Edit a different workflow definition than the one that is currently displayed. If you initially select jobs with various workflow definitions, you can later select a different workflow definition to edit. There are multiple ways to do so:

      • You can select Change workflow definition in the top right-hand corner of the screen. Then, in the Change workflow definition screen, select the workflow definition that you want to edit. However, if you do so, all changes that you have already made to the currently displayed workflow definition will be canceled. If you do not want to discard your changes, at the bottom of the Change workflow definition screen, select Close, or click anywhere else outside of the Change workflow definition screen. You will then return to the Edit Workflow screen, where you can save your changes before switching to editing another workflow definition.

      • If you want to keep the changes that you have made to this workflow definition, select Save in the bottom right-hand corner of the Edit Workflow screen. After your changes have been saved, the Choose workflow definition popup is displayed again. In it, select the workflow definition that you want to edit next.

  8. At the bottom of the Edit Workflow screen, select:

    • Exit to discard changes made to the selected workflow definition and return to the Manage jobs screen. If you have made any changes in the Edit Workflow screen, you will need to confirm your action in the Discard changes popup. Alternatively, you can select the close icon close_X-mark_from-UX-team.svg in the top right-hand corner of the Edit Workflow screen

    • Save and exit to save your changes to the selected workflow definition and exit the Edit Workflow screen.

    • Save to save your changes to the selected workflow definition and stay in the Edit Workflow screen, for example, to make additional edits.

      Important

      If, initially, you select jobs that have different workflow definitions and change a selected workflow definition in such a way that it becomes identical to another workflow definition, and you select the Save button, the number of jobs that you see in the top left-hand corner will increase. This is because more jobs now share this workflow definition, and you can edit all of them at once. (For details, see example above).