Apply template customization

This topic describes how to apply customizations of a template project to projects that are linked with the template.

Overview

As the needs of your organization change over time, you may want to update the settings of your template project and apply the settings to multiple linked projects.

If you update a template project in ALM Desktop Client, you apply template customizations to linked projects in ALM Desktop Client.

If you update a template project in Web Runner, you first apply template customizations in ALM Desktop Client in case there is any template customization done in ALM Desktop Client, and then apply template customizations in Web Runner.

Back to top

Prerequisites

Before applying template settings in Web Runner, make sure the following requirements are met:

  • You have the Set Up Cross Project Customization permission.

    Users of the TDAdmin user group are by default granted this permission.

  • You already applied the template settings to linked projects from ALM Desktop Client. For details, see Cross project customization.

Back to top

Apply template customization in Web Runner

Apply changes to a template projects that are done in Web Runner to linked projects.

To apply template customization in Web Runner:

  1. Log on to Web Runner. Make sure to select a template project.

    For more log on details, see Start Web Runner.

  2. Customize the template project in Web Runner by customizing project workflows. For details, see Customize workflow scripts.

  3. In Web Runner, apply template customization to linked projects.

    1. In the top right corner of Web Runner, click Settings > Apply Template.

      The Apply Template Settings window opens, listing all projects that have Web Runner enabled.

    2. In the Apply Template Settings window, select the linked projects that you want to apply template settings to.

      Show active only. Click this button to exclude inactive projects.

      Select by Importing. Enables you to select the target linked projects by importing a .txt file. To understand the supported format, select a linked project, click Export Selected, and see how the exported file is formatted.

      Export Selected. Enables you to export the selected linked project list to a .txt file.

    3. Click Apply.

      The progress bar appears, displaying the number of failed and successful projects.

    4. If you want to re-apply customization to failed projects, do the following:

      1. Click the red part of the progress bar to see the failure details.
      2. Click the download icon to export the failed projects.
      3. Fix the failures.
      4. Re-apply template customization to these projects by using the Select by Importing button.

Back to top