Field Mapping

Field mapping controls how data from an incoming document is written into Business Central records. DEXPRO Core offers three mapping surfaces, each for a different kind of field, so you can cover standard fields, arbitrary JSON fields, and custom app fields.

Open the mapping lists from Core Setup (Field Mapping action) or by searching for the individual pages.

Standard Field Mapping

The Field Mappings page maps source document fields to Business Central target tables and fields. Mappings are defined per Document Class and can apply to the document header or the document lines.

Use this when you need to map the well-known fields of a document class to their standard Business Central destinations.

Field Mappings list with source and target fields

Generic Additional Fields

The Generic Additional Fields page maps arbitrary JSON field names from the source data to a target table and field. This is useful when the source contains extra fields that are not part of the standard mapping.

Use this for ad hoc or additional source fields that you want to route into Business Central without a code change.

{add screenshot of Generic Additional Fields here}

Custom Field Mapping

The Custom Field Mapping page maps custom app fields in the range 50000-99999 to target fields. This is intended for fields added by other extensions (the customer/partner field range) that need to be populated from the source data.

Use this when your environment has custom fields that must be filled during document creation.

Custom Field Mapping page

Which mapping to use

Use caseMapping surface
Standard, well-known fields of a document class (header or line)Standard Field Mapping
Extra JSON fields present in the source dataGeneric Additional Fields
Custom fields (50000-99999) added by another extensionCustom Field Mapping

Use the Validate flag on Generic Additional Fields when the target field has validation logic that must run (for example to trigger dependent field updates). Leave it off to set the value directly.

Copying mappings to other companies

The Generic Additional Fields and Custom Field Mapping pages each have a Replace mapping in companies action that copies the mapping to other companies:

On the Custom Field Mapping page, only the mappings of the document class selected at the top of the page are replaced. To copy the Core Setup and both kinds of mappings in one step, use Copy Configuration to Companies on the Core Setup card.


Revision #4
Created 2026-07-22 07:21:12 UTC by Bernd Feddersen
Updated 2026-11-19 11:11:34 UTC by Bernd Feddersen