Capture program increments (PIs)

A program increment (PI) is a timebox during which an agile release train (ART) delivers incremental value in the form of working, tested software and systems. Features are delivered in the context of a program increment.

In the navigation panel, go to Agile Architecture > Agile Release Trains and click the root node of the Agile Release Trains explorer. Go to Overview > Program Increments.​ Per default, the data workbench displays only a set of basic attributes. You can add more columns to capture other attributes directly in the data workbench or you can navigate to a program increment's content area and define it in more detail there. Click to learn about how to use data workbenches.

Try to capture as much information as possible about the program increment because complete data considerably improves the results of business questions and other analytics.

Once a program increment is in the repository, you can define more details about it in the Program Increments data workbench . Or specify and analyze the program increment in detail in its content area . In the data workbench, click the Navigate button for a program increment to open its content area > Overview page. All mandatory fields must be defined to create the program increment and save it.

Per default, the data workbench displays a limited set of basic attributes. You can add more columns via the Structure column to capture other attributes directly in the data workbench.

Define the program increment's basic data. All mandatory fields must be defined to create the program increment and save it.

A role represents a functional responsibility that a user or organization has for the program increment. Assigning users and organizations to roles is critical to understanding responsibility for assets in the IT and is required to answer the business question Who is responsible for our assets?

Responsibilities are based on preconfigured role types. Your company may also configure custom role types via the Portfolio Admin user profile. Depending on the role type, a specified user and/or a specified organization may fulfill the responsibility for the program increment. A user assigned responsibility via a role has read-only permissions to the program increment. To change data about the program increment, they must also be specified as an authorized user or member of an authorized user group.

Roles can be assigned to a program increment in the Program Increments data workbench or the program increment content area via Overview > Responsibilities. A person can have one of the following roles or a custom role added by your company:

To specify responsibilities for the program increment:

  1. Click in the relevant role field to open the selector.
  2. Expand the ORGANIZATION or USER sections in the selector and select the person or organization fulfilling the role.
  3. Click OK to save the role definition and close the selector.

An iteration is a standard, fixed-duration timebox during which agile teams and ARTs individually and collectively deliver incremental customer value while working towards the objective of the program increment. Stories are delivered in the context of an iteration.In the navigation panel, go to Agile Architecture > Agile Release Trains and click the root node of the Agile Release Trains explorer. Go to Overview > Iterations.​ Or go to the program increment content area via Overview > Iterations.

Click the New plus sign button > Create Iteration. Specify the iteration's basic attributes. All mandatory fields must be defined to create the iteration and save it. In the Program Increments view, click the Navigate  Navigate button next to a program increment to open its content area and specify the iteration's attributes.

Go to the program increment's content area > Execution > Features. Click the  New plus sign button > Add Feature and select the feature that shall be delivered by the program increment.

The assets that are impacted by a program increment make up its solution scope. You can specify any application, business capability, business process, component, information flow, or organization as an asset that is impacted by program increment.

  1. Go to the program increment's content area > Solution Scope > Affected Architecture.
  2. Click New > and select the relevant option to add the architecture impacted by the program increment.

    Information flows specified for applications that have been added to the program increment's architecture scope will not be automatically added to the program increment. You must explicitly add the relevant information flows to the program increment in the Affected Architecture view.

  3. Select the relevant assets and click OK.
  4. To document the planned changes to one or more architecture elements assigned to the program increment's scope, click the ThreeDots_Black 3-dots button >  EditSingle  Edit. Provide a comment about the change and set the Change Category to describe the how the asset will be changed by the program increment:
    • New: The asset will be introduced in the scope of the program increment.
    • Updating: The asset will be significantly updated in the scope of the program increment.
    • Changing: The asset will be changed to some degree in the scope of the program increment.
    • Retiring: The asset will be retired in the scope of the program increment.

Go to the program increment's content area > Execution > Story Kanban. The columns display the iterations defined for the program increment. The cards in the lane display the user stories and enabler stories assigned to the program increment's iterations.

Move a story to a different iteration. Drag-and drop a story to a different iteration.

Add a user story to a program increment. Click the lane for the iteration in the Kanban >  Add_Reference add story button. Select the user story or enabler story to add in the selector and click OK.