Manage Collections
Last updated
Last updated
Collections are groupings representing subdivisions of a Collection category. By default, each Collection category has one root, or All, Collection. For example, the Teams category automatically has an All Teams Collection. Under the root Collection, you can create any number of Collections and Collection levels.
For example, in the Teams category, you can have a Collection for your Engineering Teams, and then you can create a child Collection for the Front End team under the Engineering Teams Collection. The resulting hierarchy might look like this:
Harness project
Teams (Collection category)
All Teams (Root Collection)
Engineering teams (Parent Collection)
Front End team (Child Collection)
Other Engineering teams...
Other teams...
Inheritance flows down the Collection levels. For example, Collection categories and Collections inherit integrations from the associated project, and child Collections inherit Insights associations from their ancestor Collections. For more information about the relationship between projects, Collection categories, and Collections, go to Collection hierarchies.
Depending upon how Insights should be driven across teams for your organization Collections can be configured in two distinct approaches:
Asset-Based Collections
People-Based Collections
Asset-based Collections are defined based on digital assets, primarily utilizing Jira projects (or any other Issue Management Platform) and GitHub (or any other SCM) repositories, and other integrations as their foundational elements.
These teams are organized based on digital assets and code repositories, with the flexibility to apply additional filters as per the requirements.
Asset-based Collections are centered around specific Jira (Issue Management) projects and GitHub (SCM) repositories, which serve as their primary assets.
All Insights and Metrics in this type of Collection are aligned with the assets defined for each team. For example, if a team defines its focus on a particular Project, all metrics and dashboards will correspond to that particular project.
It is recommended to create the DORA Insight and Sprints Insight exclusively with People-Based Collections.
The Collection Definition section allows you to configure the Collection as either a people-based or asset-based Collection. Asset-based collections are defined based on a specific asset.
To define a collection based on a specific asset, you will have to add the respective integration and associated integration filters in the Collection definition settings. This enables you to define the criteria that determine how contributors will be associated with the collection.
People-based Collections are created based on individual members who belong to a definition that can be considered as a logical unit. These people-based Collections take into account the members' associations with tools such as Jira, Bitbucket, and others.
People-based Collections are defined based on the individuals within the team and their interactions with tools like Jira and Bitbucket. SEI establishes this connection through the individual’s identifiers as provided and generates the team's insights and metrics.
It is recommended to use Trellis exclusively with People-Based Teams. Example: If a team member contributes to three different projects, the metrics and insights from all three projects are considered when evaluating that team member’s performance and contributions.
This user-centric approach allows for a comprehensive assessment of an individual’s impact across multiple projects.
People-Based Collections are defined based on the Contributor data. To define a people-based Collection you can add the respective contributor-level filters on the custom attributes in the Collection Definition settings or add contributor data manually or import the data using a CSV.
Collection categories are shown as tabs on the Collection Settings page.
Select a Category tab to view the Collections under that category. This page shows only Collection categories and Collections relevant to the current project. Switch projects to view Collection categories and Collections for other projects.
The Flat List view shows a summary of the Collections in the Collection category. The Path is the Collection's hierarchical position in the Collection category.
Select a Collection's Name to view or edit it.
Select Tree View to switch to a hierarchical outline view. Use the arrow icons to expand and collapse Collections levels.
Options for editing Collections are only available on the Flat List view.
The Path column shows the hierarchical position of a Collection
The Root Collection is readily accessible for viewing/editing by choosing the Root Collection link at the top of the Collection
Select the tab for the Collection category where you want to add or edit a Collection. This page shows only Collection categories and Collections relevant to the current project. Make sure you are in the correct project before creating or editing Collections.
To edit an existing Collection, select the Collection in the Name column. To add a Collection, select + [Collection Category]. For example, in the Teams category, select + Teams.
In the Basic Info settings, you can:
Enter a Name, Description, and Tags. Collection names must be unique within each project.
Specify users who can manage this Collection.
Change the associated Collection Category.
Change the Collection's position in the hierarchy by changing the Parent Collection.
Use the Insights settings to manage Insights associations. By default, child Collections automatically inherit Insights associations from their ancestor Collections.
Use the Definition settings to define integrations associated with the Collection. By default, if you don't specify any integrations, the Collection automatically inherits integrations from the associated project.
Follow the steps to define an Asset Based Collection. To learn more, go to Asset Based Collections
In the Collection Definition settings, add the relevant Integration to define the digital asset.
Add the Integration Filters to determine the criteria to associate Contributors with the Collection.
Follow the steps to define a People-Based Collection. To learn more, go to People Based Collections.
In the Collection Definition settings, Select the Configure Attribute option under the Collections section.
Add Filters using the custom attributes to define the criteria to associate contributors with the Collection.
Once you’ve configured the Collection definition, click on Save to save the collection.
Collection in a Project must have a unique name.
To move an existing Collection under a different Collection category, use the Collection Category dropdown to select a category.
To move an existing Collection under a specific Collection, use the Parent Collection dropdown to select a Collection.
All Insights (previously Dashboards) must be associated with at least one Collection. You can configure these associations through Collection settings or when creating or editing Insights. For information about creating and editing Insights, go to Insights.
INHERITANCE
By default, a child Collection automatically inherits Insights associations from its ancestor Collections. Inherited associations can't be removed from child Collections.
Adding an Insight association to a Collection also adds that association to any descendant Collections.
Adding an Insight association to a Collection category applies the association to all Collections under that category.
To view or edit a Collection's Insights associations:
Follow the steps to add and edit Collections, and go to the Collection's Insights settings.
Select Insights on the Available Insights list and use the left and right arrows to move them to the Associated Insights list.
Use the up and down arrows on the Associated Insights list to change the order in which the Insights are presented when viewing Insights on the Insights list or the All Insights dropdown menu on the Insights header.
Select Save.
