Skip to content

Import Engine Mapping

Mapping associates fields in your source file (CSV/Excel) with Arena API attributes.

Mapping Object Structure

A mapping object requires the following fields:

Field Description
resourceName The resource type (e.g., ITEM_BOM). Required.
apiName The Arena workspace attribute (e.g., category.name). Required.
sourceName The column header in your source file. Required.
inResponse If true, includes this attribute in the response CSV.
notes User notes (not processed by the engine).

Formatting Rules

Case Insensitivity: resourceName, apiName, and sourceName are case-insensitive.

Object Attributes: Use dot notation for object properties.

  • Example: category.name, owner.fullName, lifecyclePhase.guid

Custom Attributes: Map these directly by their name.

  • Example: If you have an attribute "Tolerance", set apiName to Tolerance.