Manage Developers

Learn how to add, update, and manage developer records for your organization in AI DLC Insights.

Developers are the fundamental unit of measurement in AI DLC Insights. Every insight, metric, and analysis ultimately ties back to individual contributors, the people writing code, completing work items, and deploying software.

Managing developer records ensures that each individual is accurately represented, mapped to the right teams, roles, and organization hierarchies. Properly managed developer data is essential for reliable metrics across AIDI dashboards.

AI DLC Insights supports two approaches for maintaining developer data:

• CSV Upload: Recommended for initial setup using an HRIS export that aligns with Harness AIDI’s schema.

• Developer CRUD APIs: Recommended for ongoing programmatic updates or integration with internal systems.

Both approaches support the same data schema and enable full lifecycle management of developer records. Once added, AI DLC Insights automatically correlates each developer’s data across source systems like GitHub, GitLab, Jira, or Azure DevOps.

AUTO IDENTITY DISCOVERY

Each developer is associated with one or more identities, which may include:

• Usernames (e.g., @johndoe)

• Account IDs

• Emails used across connected source systems

AI DLC Insights automatically links contributions to developer identities using Auto Identity Discovery, which matches email addresses and other identifiers to ensure accurate metric attribution. Ensure that the email addresses used in the Developers tab in Team Settings matches the emails your developers use across source systems. Incorrect or mismatched emails may result in missing or fragmented identity mappings in AI DLC Insights.

The Developers page provides a searchable list of all developers in your organization. You can search by Full Name, Email, Manager Email, Role, Site, Team, Sub Role, or Department.

The list contains the following data columns:

Column	Description
Full Name	Developer’s full name
Email	Developer’s email
Manager Email	Developer’s manager email
Role	Developer role
Site	Site or location
Team	Assigned team
Sub Role	Optional sub-role
Department	Department name

Prepare the developer records

Before uploading or syncing developer data, ensure your source records meets the following standards:

Requirement	Description
Managers must also exist as developers	Every email listed as a Manager Email must also appear as a separate developer record. This ensures AI DLC Insights can construct an accurate reporting hierarchy.
No cyclic relationships	Avoid circular manager-reportee chains (e.g., A → B → A). These relationships will break hierarchy creation.
Unique developer emails	Each developer record must have a unique email address. Duplicate emails will cause ingestion errors or incorrect identity attribution.
Required columns	Each record must include the following columns: full_name, email, manager email, role, sub role, team, department, and site. These columns ensure AI DLC Insights can properly map developers to teams and metrics.
No missing values	Ensure all required columns are populated for every record. Missing values will cause failure.
Email correctness	Use the same email IDs that developers use across your source systems (GitHub, Jira, etc.). A mismatch will prevent AI DLC Insights from linking identities correctly.
No blank column names	Every column in your CSV should have a valid header. Blank column headers will cause validation errors.

Upload developer records using a CSV

The CSV upload method is ideal for initial setup or periodic manual updates.

To upload developer records:

1. From the Harness AIDI navigation menu, navigate to Account Management > Developers.

2. Click Upload New CSV to add a developer dataset.

   
3. Click Choose File or drop your CSV file containing developer data.

4. Review the Developer Preview screen and map each column from your CSV to the corresponding AIDI field.

   

   • Display Name: Select the column containing the developer's name.

   • Email: Select the column containing the developer's email.

   • Manager Email: Select the column containing the manager's email.

   • Role: Optionally, select the column containing the developer's role.

5. Click Save.

After upload, review your hierarchy on the Developer Data and Developer Mappings tabs to ensure all records are processed correctly.

Sync developer records programmatically

For automated or large-scale synchronization, you can manage developer records programmatically using the Developer CRUD APIs. These APIs allow you to sync developer data as part of your integration or HRIS sync workflow, ensuring your developer data remains up to date without manual uploads.

For detailed request and response formats, go to Using CRUD APIs to update developer records.

Configure developer settings per team

To ensure metrics reflect actual contributions in Team Settings:

1. From the Harness AIDI navigation menu, click Teams and select a team.

2. Navigate to the Developers tab.

3. Configure the following:

   • Shared Developers: Contributors who work across multiple engineering teams.

   • Developer Identifiers: Map developers to Issue Management, SCM, and CD accounts. Developer identifiers must be correct to ensure metrics are attributed accurately.

   • Developer Filters: Control which developers are included in specific metrics.

These settings allow AI DLC Insights to calculate metrics like Productivity, Lead Time for Changes, and Business Alignment accurately at the team level, even for cross-team contributors.

Managing developer records

Accurate mappings are essential for ensuring developer records are correctly associated with roles, managers, and team assignments. To ensure that the fields from the uploaded CSV file are correctly mapped to Harness AIDI's schema, navigate to the Developer Mappings tab in the Developers page

To review or export existing developer data:

1. Navigate to the Developer Data tab to view all developer records in AI DLC Insights.

2. Click Download Developers CSV to export the data. This provides a snapshot of the current records in CSV format for auditing or offline review.

   Email	Manager Email	Full Name	Role	Site	Team	Sub Role	Department
   [e-mail]	[e-mail]	Frank Castle	SWE	USA	AIDI	SWE
   [e-mail]	[e-mail]	Grace Hopper	SWE	USA	AIDI	SWE
   [e-mail]	[e-mail]	Heidi Klum	Manager	USA	AIDI	Manager
   [e-mail]	[e-mail]	Ivan Petrov	Manager	India	AIDI	Manager
   [e-mail]	[e-mail]	Judy Garland	SWE	India	AIDI	SWE