Skip to main content

How to map an enrichment source

This guide explains how to map an enrichment source in Aragorn AI—defining which fields from a supplementary project become new columns on your main project’s final dataset.

T
Written by Tyrone Marhguy

What is enrichment mapping?

After you link a main project to a supplementary enrichment project, mapping determines:

  • Which supplementary fields to import

  • What those columns are called on the main dataset

  • Any calculated transformations applied before data lands in the final dataset

Enrichment mapping works like source mapping: you assign output names and data types for each field you bring in.

Example: Map first_name from the manager’s profile to manager_first_name on the employee record.

Prerequisites

  • Enrichment link configured (linking columns and supplementary project selected)

  • Supplementary project synced with standardized fields

Map an enrichment source

1. Open enrichment mapping

  1. Log in to your Aragorn AI account.

  2. Open Data Projects and select the main project.

  3. Go to the Enrichment step you created.

  4. Open mapping configuration for that enrichment.

Screenshot: Enrichment mapping view—supplementary fields on one side, output column names (for example, manager_first_name) on the other.

2. Map output fields

For each field from the supplementary project:

  1. Select the source field (for example, first_name, last_name, work_email).

  2. Set the output name on the main dataset (for example, manager_first_name).

  3. Confirm the data type is correct.

Click a mapped field to view lineage, similar to source mapping.

3. Optional: calculated fields (FX)

Create a calculated field in enrichment mapping when you need a derived value.

See How to create a calculated field in source mapping.

4. Optional: field order

Use field order to arrange columns in the mapping UI. This is display-only and does not affect stored data.

See How to order enrichment sources.

5. Save and run

  1. Save mapping.

  2. Run Reprocess last sync if you only changed enrichment configuration.

  3. Run Sync new updates on the supplementary project first if HRIS data also changed.

6. Verify the final dataset

Open the final dataset and confirm new columns appear with expected values.

Troubleshooting

Issue

What to check

Blank enriched values

Linking columns do not match—review preview

Wrong related record

Wrong match field on supplementary project

No new columns

Mapping not saved or reprocess not run

Stale values

Sync the supplementary project

Related articles

Related Articles
Did this answer your question?