Skip to main content

When to Use This

Use an external team management project when:
  • Multiple Polarion projects share the same teams and team members
  • You want a single source of truth for team assignments and capacity
  • Resource allocation needs to be visible across project boundaries
diagram

Step 1: Create the Team Management Project

Create a dedicated Polarion project to hold all team-related work items:
  1. Create a new Polarion project (for example, TeamManagement)
  2. Configure the Team and Team Assignment work item types in this project
  3. Create Team work items representing each team
  4. Create Team Assignment work items under each team, specifying the assignee, allocation percentage, and date range

Step 2: Set the Team Management Project Property

In each Polarion project that needs to reference the external team data, add the following configuration property under Administration > Configuration Properties:
nextedy.gantt.teamManagementProjectId=TeamManagement
Replace TeamManagement with the actual project ID of your team management project.
This property must be set in the project that contains the Gantt widget, not in the team management project itself. Each consuming project needs this property.

Step 3: Configure Team Work Item Types (Optional)

If your team management project uses custom work item type IDs instead of the defaults, set these context properties:
PropertyDefaultDescription
nextedy.gantt.teamWorkItemTypeteamWork item type ID for Team items
nextedy.gantt.teamAssignmentWorkItemTypeteamAssignmentWork item type ID for Team Assignment items
If you are using the default work item type IDs (team and teamAssignment), you do not need to set these properties.

Step 4: Enable Team Assignments in the Gantt Widget

In the Gantt widget parameters of each consuming project:
  1. Set Show Resource View to Yes
  2. Under Working Calendars, enable Use Working Calendar
  3. Enable Load User Calendars
  4. Enable Load Team Assignments
The Gantt now pulls team structure and capacity data from the external project while displaying work items from the current project.
When teams span multiple projects, capacity calculations in the resource view reflect the allocation defined in the team management project. Ensure that team assignments in the central project accurately represent each member’s availability across all projects to avoid misleading overallocation indicators.

Step 5: Verify the Configuration

After setting the properties and widget parameters:
  1. Open the Gantt chart in one of the consuming projects
  2. Switch to the resource view
  3. Verify that team names and member allocations match the data in the team management project

Verification

You should now see:
  • Resource view rows populated with teams and members from the external team management project
  • Allocation percentages reflecting the assignments defined in the central project
  • Work items from the current project distributed under the correct team members

See Also

KB ArticlesSupport TicketsSource Code
  • prod-gantt-src/com.nextedy.polarion.gantt.client/cypress/e2e/view/externalTeamManagementProject.cy.ts
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/impl/TeamEnumProvider.java
  • prod-gantt-src/com.nextedy.polarion.gantt.client/src/js/config.js
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/model/Config.java
  • prod-gantt-src/com.nextedy.polarion.gantt/src/com/nextedy/polarion/gantt/ConfigPropertiesConsts.java