Welcome to Zuora Product Documentation

Explore our rich library of product information

Field Mapping Page Layout

The Field Mapping page provides navigation and management of mappings, highlighting actions, search, child objects, and partitioned objects.

The Field Mapping page contains several components that allow users to navigate and manage mappings.

The page highlights the following main concepts:

  • Actions

  • Search

  • Child Objects

  • Partitioned Objects

    Concept layout

Actions

The Actions section is located at the top of the page. These actions allow users to adjust and test field mappings.

Additional details about the available actions are described in the Field Mapping Actions topic.

Search

The Search bar is located above the list of fields and applies to all objects and fields.

It allows users to quickly locate specific fields and mappings across objects.

Child Objects

Child objects represent objects that are related to a parent object through inheritance.

A child object originates from the parent object and has access to the data available at the parent level.

For example, Invoice Items are child objects of Invoices. Because of this relationship, Invoice Items can access Invoice data in their field mappings.

Partitioned Objects

Partitioned objects occur when different parent objects map to the same target object but require different mappings.

For example, Zuora Invoice, Credit Memo, and Debit Memo all map to SAP Billing Documents.

This relationship can be found in the corresponding SAP capability configuration.

Partitioned Objects Example

Field Mapping Actions

The Editing action unlocks the field mapping interface so that users can modify mappings.

After making changes, click Save to apply the updates.

The Dry Run action executes a test job using the current field mappings. This job retrieves data from the source system and simulates a synchronization process. The job runs similarly to a normal synchronization job and its results appear in the Jobs tab.

However, no data is sent to the target system. Instead, the job output displays a sample payload so that users can validate their mapping configuration. Ensure that you save all mapping changes before executing a dry run.

Edit Field Mapping

Correctly mapping data between systems is essential for connector operations.

The Field Mapping page provides tools that allow users to locate source fields, configure mappings, and transform data during synchronization.

To begin modifying mappings, click Edit Mapping in the top-right corner of the page.