Skip to main content

Manage Contributors

Contributors are developers and other team members that complete actions and activities that contribute to your SEI metrics and insights. Contributors are represented by contributor records in SEI. SEI contributor records serve two primary functions: Account association and Collection association.

Account associations connect related user accounts across your SDLC tools. For example, you can associate a contributor's Jira, GitHub, and Harness accounts so the data from those accounts are correlated to the same record in SEI, rather than three "instances" of a user. This makes it easier to track individual contributor activity across tools.

You can use any attributes as dynamic filters for contributor-based Collections. Some attributes are included by default, such as Name, Email, and Integration. You can add custom attributes to further refine contributor records and create dynamic filters unique to your organization or teams.

info

SEI contributor records don't control access to SEI or the Harness Platform; these records are for data management only.

Configure attributes​

To view and modify contributors:

  1. In your Harness project, go to the SEI module.
  2. Select Account.
  3. Select Contributors under Data Settings.

Select the Settings (wrench) icon to edit contributor attributes. By default, contributors only include a Name and Email. You can use attributes as dynamic filters for contributor-based Collections. Therefore, you might find it useful to add custom attributes, such as roles, team names, departments, supervisors, or other designations.

To add custom attributes:

  1. Select the Settings (wrench) icon.
  2. Select Add Custom Attribute.
  3. Enter a Title for the custom attribute category.
  4. Select the Type.
  5. In the Description column, define where the attribute's values come from.

The Integration attribute​

For the Integration attribute, SEI uses the Email as the primary attribute to collate contributor identities across integrations.

For example, assume a user's email is a.developer@myorg.com, and you have integrations with Jira, GitHub, and Slack. If SEI finds the same email address in Jira, GitHub, and Slack, then the data from those integrations are all correlated to the same contributor in SEI.

However, if the user is registered under a.developer@myorg.com in Jira and Slack, but they use a different email for GitHub, then the GitHub data is associated with a separate contributor record. This is because SEI does not know that the other email address also belongs to a.developer@myorg.com unless you modify the contributor to include the user's GitHub email address.

Modify contributors (export and import)​

SEI automatically detects user identities in your integrations and creates contributors from those identities. However, there are several reasons you might need to modify contributors, such as:

  • Users don't have the same email address for all accounts.
  • A user's identity wasn't detected through the integration.
  • You need to populate data for custom attributes that isn't otherwise populated.

To modify contributors, you must export a CSV file, edit it, and then import the edited file.

  1. In your Harness project, go to the SEI module, and select Account.
  2. Select Contributors under Data Settings.
  3. Select Import and Export Contributors.
  4. Select Export Existing Contributors or, if you don't yet have any contributors, select Export Sample CSV.
  5. Open the CSV file and edit the data accordingly.
  1. Go back to the Contributors page in SEI, and select Import and Export Contributors.
  2. Select Import Contributors, and upload your modified CSV file.

Manually add contributors​

SEI automatically detects user identities in your integrations. If you need to manually add a contributor, follow the steps to Modify contributors, and add a row for each new contributor. At minimum, you must provide a name and email for the contributor to be valid.