Generate member mappings for situations where the names of your imported file don't correspond with the member names in the system.
For example, in this sample data import file:
- The accounts may need to be mapped to account members that exist in the system, for example, 10000 may need to be mapped to a member A10000.
- The entity may need to be mapped to Entity codes that are in the system.
In the Sample Import File, for example, USA may need to be mapped to USA100.
| Account | Date | Entity | Currency | Amount |
| 10000 | 202503 | USA | USD | 67000 |
| 11000 | 202503 | USA | USD | 1240000 |
| 13100 | 202503 | USA | USD | 15000 |
| 13200 | 202503 | USA | USD | 10000 |
| 13300 | 202503 | USA | USD | 58222 |
| 13400 | 202503 | USA | USD | 125490 |
To create a map:
- Navigate to Configure and select Maps.
- Select Add in the top-right to add a new Map.
- Enter a name for the new Map when prompted.
- Select Save.
The Map is saved. You now need to specify the member Mappings for the newly created Map in the Mappings editor.
To access the Mappings editor:
- Double-click on a map to open it in the Maps tab.
The Mappings editor displays. - Make an entry in the Map for each member that needs to be mapped in the data import file.
You can either choose to define one Map for members in all dimensions, or you can select to define one Map per dimension that needs to be mapped. - Perform these steps for each member that needs to be mapped:
| Column | Value |
| Add | Select this icon to add a new mapping. |
| Dimension | Select a dimension. |
| Mapping Type | Select the appropriate mapping type from the list:
Read here to know more about information on Mapping Types. |
| Source Value | Enter the source member name used in the data import file. |
| Mapped Value | Enter or select the system member name to which the source member should be mapped. |
- Select Save.
Map Validation
The Mappings editor validates the mapping rows you create or import. When the system detects an invalid configuration, such as an invalid target member, it flags the error immediately. This prevents the mapping from being saved. All saved mappings are valid, which eliminates errors during the file import process. You can use AI-assisted mapping to correct mapping errors.
When you add or import a mapping row, the Status column displays icons:
| Status badge | Description |
![]() | Valid: a newly added mapping is valid. |
![]() | AI- generated: this mapping was AI-generated using the AI-Assisted Mappings. |
![]() | Invalid: a newly added mapping is invalid. For example, the target member doesn't exist, or there's a duplicate mapping present. Mouse over to view the warning message in a tooltip. |
![]() | Incomplete: a newly added mapping is still being edited. For example, the source member is filled in but the target member has not yet been filled in. |
| No badge | Saved: a previously existing mapping in the map is valid. No edits have been made. |
After you configure the Staging Table, Data Import Definition, and required Maps, create a Workflow process that integrates these components. End users can now execute this process as one of their assigned workflow tasks.
Import mappings in the Mappings editor
If you already have mappings in an Excel or csv file format, it's easier to import your mappings instead of keying them in manually. The file must have these columns:
- Dimension: Specifies the system dimension that the mapped member resides in.
- MappingType: Use Exact.
- SourceValue: The source member name used in the data import file.
- MappedValue: The system member name that the source member should be mapped to.
- OrderIndex: Specifies the order the mappings should be applied in cases where a member has more than one mapping applied to it.
| Dimension | MappingType | SourceValue | MappedValue | OrderIndex |
| Account | Exact | 10000 | A10000 | 1 |
| Account | Exact | 11000 | A11000 | 2 |
| Account | Exact | 13100 | A13100 | 3 |
| Entity | Exact | USA | UAS100 | 4 |
To import mappings:
- Select the Import icon in the upper-right corner.
- Select the file containing your mappings when prompted to select a file.
- Select IMPORT.
The mappings are imported into the Mappings editor.
Note: Any existing mappings will be overwritten.
Export mappings from the Mappings editor
Use the Export icon to export your mappings to an Excel or CSV file. It's useful in cases where:
- You want to take a snapshot of the mappings at a point in time.
- You may find it easier to update and maintain the mappings in Excel.
To export mappings:
- Select the Export icon in the upper-right corner.
- Select a file format: Excel or CSV when prompted.
- Select EXPORT.
The mappings are exported and placed in your Downloads folder. The name of the file is the name of the Map followed by the appropriate extension .xlsx or CSV.



