A Baseline in TeamForge represents an approved snapshot of selected configuration items from a given TeamForge project at a given point in time. Create a baseline when you release or deliver a product or when you accomplish specific milestones in your project. Such a baseline includes key data that describes or helps identify the configuration items in the same state as it existed at the time of creation of the baseline.

What is a Baseline?

A Baseline in TeamForge represents an approved snapshot of selected configuration items from a given TeamForge project at a given point in time. For example, you can create a Baseline when you release or deliver a product or when you accomplish specific milestones in your project. Such a Baseline includes key data that describes or helps identify the configuration item in the same state as it existed at the time of creation of the Baseline. In other words, Baselines, once created, cannot be modified.

What is a Baseline Definition?

A Baseline Definition is a template that consists of a set of predefined filter criteria to accelerate baseline creation. Baseline definitions can also be modified from time to time to suit your changing requirements.

What is a Configuration Item?

A Configuration item is a project artifact that can be uniquely identified.

Typically, a Baseline in TeamForge can include the following configuration items:

  • Tracker Artifacts
  • Documents
  • Source Code Repositories (from Git/Subversion repositories, identified by Tags)
  • File Releases
  • Binaries (Nexus)

What is a Project Baseline?

A Project Baseline can be defined as a set of item level baselines created from the requirements phase to the release/delivery phase of a project. You can create a project baseline using the project baseline definition. When a project baseline is created, a snapshot of all items, comprising the project baseline definition and the constituent item level baseline definitions will be stored. You can create as many project baselines as required.

What is a Project Baseline Definition?

A Project Baseline Definition is a union of various other item level baseline definitions that include all approved configuration items in a specific project. Only one project baseline definition can be created for a project baseline. However, a project baseline definition can be edited whenever required.

Is there a separate license for the Baseline tool in TeamForge?

Yes, Baseline has its own license in TeamForge. You must have both ALM and Baseline licenses to create and work with the Baseline tool in TeamForge. For more information, see TeamForge License.

What are the permissions associated with the Baseline tool?

Here’s a list of Baseline-specific permissions. You can set up site-wide, project-level or global roles in TeamForge with the following permissions.

Baseline Permissions User Actions
BASELINE ADMIN

Users with this permission can:

  • Manage custom attributes
  • Manage custom statuses
  • Manage workflow status transition
  • Manage field inclusions
CREATE/VIEW BASELINE

Users with this permission can:

  • Create a new baseline definition
  • Create a new baseline
  • View baseline definitions and baselines
  • Search for baseline definitions and baselines
  • Compare baselines
VIEW ONLY

Users with this permission can:

  • View baseline definitions and baselines
  • Search for baseline definitions and baselines
  • Compare baselines
CREATE PROJECT BASELINE Users with this permission can create a project baseline.
PROJECT BASELINE DEFINITION

Users with this permission can:

  • Create a new project baseline definition
  • Update an existing project baseline definition
BASELINE REVIEW

Users with this permission can:

  • Review a baseline
  • Approve a baseline
  • Reject a baseline

How would you create a Baseline in TeamForge?

Baseline creation in TeamForge involves the following steps:

1. Create baseline definitions

You can create a baseline definition by defining the filter criteria for Tracker Artifacts, Documents, Source Code Repositories, File Releases, and Binaries. Baseline definitions can be used while creating the baseline. You can also edit a baseline definition at any point in time. For more information, see Create Baseline Definitions.

2. Create baselines

You can create a new baseline using an existing baseline definition or without a definition. Baselines become immutable after their creation. For more information, see Create Baselines.

3. Review baselines

You can review the baseline once it is created. During the review cycle, the baselines can either be approved or rejected. For more information, see Review Baselines.

4. Compare baselines

You can compare two baselines created in distinct timelines to view the difference between them. For more information, see Compare Baselines.

How would I install Baseline?

Baseline services can be installed when you install TeamForge. For more information on Baseline hardware requirements, see Baseline Hardware Requirements.

It’s highly recommended that you install the TeamForge Baseline services on a separate server as the baseline process can consume considerable CPU and database resources. For more information, see Install TeamForge in a Distributed Setup.

How to enable Baseline for projects?

The Baseline tool is enabled by default for any new project created after you install Baseline on your site. However, you must enable Baseline for old projects that were created before Baseline installation.

To add the Baseline tool to an existing TeamForge project:

  1. Log on to TeamForge and select a project from the My Workspace menu.
  2. Select Project Admin > Tools from the Project Home menu.
  3. Select the Baselines check box and click Save.

    Enable Baselines for projects created before Baseline installation

    A new tool, Baselines, is added to the Project Home menu.

    Baselines tool added to the Project Home menu

To use the Baseline feature, a TeamForge user must have the Baseline license and the required baseline permissions to perform various functions.

For example, a user with the VIEW ONLY permission can view baselines and baseline definitions, search for baselines and baseline definitions, and compare baselines. For more information about baseline permissions, see What are the permissions associated with the Baseline tool?

Tags for this page: baseline ctf_18.2 ctf_18.3