Ativo Programs for Jira 📖 Documentation
  • Getting started
    • Quickstart guide
    • Prerequisites
    • Installation
      • Updates
    • Cheat sheet
  • Configuration
    • Permissions
    • Team
    • Program (release train)
    • Period (program increment)
    • Project and Jira (JQL) filters
  • Preparing a Program Increment (PI)
    • Program cycle
    • Feature backlog
  • Program Increment (PI) planning
    • Plan issues
    • Plan epics (features)
    • Plan dependencies
    • Raise risks and impediments
    • PI Objectives
    • Capacity
    • Team breakout
  • Scrum of scrums / Art Sync
    • Scrum of scrums and art-sync preparation
    • Progress per team
    • Progress per program
  • Cross-pi
    • Cross-PI dependencies
  • Advanced
    • Export issues, PI objectives, milestones and capacity to Excel
    • Ativo Programs custom fields
      • Field sharing
      • Ativo Program fields use PI keys since April 2023
    • Fields added to screens
    • Issue types
    • Limit permissions of suppliers
    • Jira Service Management tickets on the program board
    • Server to cloud migration
  • REST API
    • Authentication
    • Version
    • Cloud REST API Rate Limiting
    • Cloud REST API
    • Data Center REST API
  • Training
    • User training
Powered by GitBook
On this page
  • Create a new period
  • Auto-assign sprints
  • Create missing sprints
  • Can't find my sprint
  • Modify a period configuration
  • Completing a sprint
  • Archive a period
  1. Configuration

Period (program increment)

A Period is a time frame (called PI or Program Increment / Planning Interval in SAFe®) , used to plan and progress iteratively at program level.

PreviousProgram (release train)NextProject and Jira (JQL) filters

Last updated 1 year ago

A period contains a set of sprints (iterations). Some organizations have one period per quarter (e.g. “2020 Quarter 4”).

Create a new period

To create a new period:

  • Navigate to the cycle page.

  • Click on Create a period

  • Choose a period name and key. The key has to be unique, and should be meaningful (e.g. 2024Q4).

  • Choose the number of sprints in the period

  • Click on Create

Complete the period configuration:

  • Define start and end dates for each sprint.

  • Map the sprints at program level to the sprints of each team working Scrum. Use the 'Auto-assign sprints' and 'Create missing sprints' buttons to do this automatically. You can also do it manually by selecting a Jira sprint for each team / program sprint combination. By default, only open sprints are shown. Click 'Show closed sprints ' to also include sprints that are closed.

  • Click on Save or Submit

You don’t need to configure all sprints at the same time. You can map some sprints, save progress and come back later to complete the mapping. If a new sprint is created in the backlog of a team, you can click on the 'refresh sprints'

You can use your keyboard and type in a part of the name of a sprint to find it fast. You can also copy/paste text into the select field.

Auto-assign sprints

Auto-assign sprints based on the Jira sprint start and end date configuration. The start and end dates of the Jira sprint should approximately match with the start and end dates of the sprints in the program.

Click the 'Assign' button to auto-assign sprints .

Create missing sprints

Ativo can create missing sprints directly on the Jira boards.

First click on 'Create missing'. Then defined the sprint start & ending hours. Then click on 'Create sprints'.

Can't find my sprint

Did you create a sprint but can't find it on the drop-down list?

First try to 'Refresh sprints' if you've recently created the sprint. Click 'Show closed sprints' if you also want to see sprints that have been closed.

Jira board teams

For teams configured using a Jira board, the sprint must be created on that board.

Custom teams

For teams configured in a custom way, sprints from Jira Scrum boards that have a JQL filter which includes a reference to the projects used in the team are shown. Due to limitations in the Jira API, we cannot show other sprints.

E.g. If team 'Bear' uses Jira Project 'Bear', then the board of team Bear needs to use a JQL filter that explicitly refers to the 'Bear' Jira project.

To add your sprint to the list:

  • Open the Jira board on which the sprint is created

  • Open the board configuration (context menu on the top right)

  • In the general tab, locate the JQL filter

  • Click “update filter“

  • Add an explicit reference to the Jira project(s) used by the team. E.g. replace category in (…) byproject in (…)

  • Save the filter

Modify a period configuration

To modify the configuration of an existing period:

  • Select the period in the period picker in the left navigation bar

  • Click on Settings > Period

Completing a sprint

Archive a period

To archive a period:

  • Select the period in the period picker at the top of the navigation bar

  • Click on Settings > Period in the left navigation bar.

  • Click on Archive Period at the top right of the page

  • Confirm that you want to archive the period.

The matching only works for .

The sprint creation only works for .

Still can't find it? It then depends if the team is configured using a 'Jira board', or in a 'custom way'. You can between 'Jira board' and 'custom'.

Sprints need to be set to be completed at program level as well. Click for more information on how to complete a sprint at program level.

here
teams that are configured using a Jira board
teams that are configured using a Jira board
switch your team configuration
Period creation form
Auto-assign sprints based on start and end dates
Select Create missing sprints
Confirm sprint creation
Sprint selection options
The Jira board JQL must contain a reference to a Jira project used in the Ativo team configuration