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.

AccountDateEntityCurrencyAmount
10000202503USAUSD67000
11000202503USAUSD1240000
13100202503USAUSD15000
13200202503USAUSD10000
13300202503USAUSD58222
13400202503USAUSD125490

To create a map:

  1. Navigate to Configure and select Maps.
  2. Select Add in the top-right to add a new Map.
  3. Enter a name for the new Map when prompted.
  4. 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:

  1. Double-click on a map to open it in the Maps tab.
    The Mappings editor displays.
  2. 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.
  3. Perform these steps for each member that needs to be mapped:
ColumnValue
AddSelect this icon to add a new mapping.
DimensionSelect a dimension.
Mapping Type

Select the appropriate mapping type from the list:

  • Exact
  • In
  • Range
  • Wildcard

Read here to know more about information on Mapping Types.

Source ValueEnter the source member name used in the data import file.
Mapped ValueEnter or select the system member name to which the source member should be mapped.
  1. Select Save.

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 badgeDescription
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 badgeSaved: 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.

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.
DimensionMappingTypeSourceValueMappedValueOrderIndex
AccountExact10000A100001
AccountExact11000A110002
AccountExact13100A131003
EntityExactUSAUAS1004

To import mappings:

  1. Select the Import icon in the upper-rightcorner.
  2. Select the file containing your mappings when prompted to select a file.
  3. Select IMPORT.
    The mappings are imported into the Mappings editor.

Note: Any existing mappings will be overwritten.

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:

  1. Select the Export icon in the upper-right corner.
  2. Select a file format: Excel or CSV when prompted.
  3. 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.