More about mapping

Map the data that you want to manage in Oomnitza.

To map a custom extended integration, complete the following steps:

• If the fields you want to map have been added to Oomnitza, click Smart Mapping.
• if not, you can add fields by dragging & dropping the fields into the Oomnitza column. 

Drag and drop

You can map additional fields to Oomnitza.

1. Drag and drop the fields in the Oomnitza column.
2. Rename the field.
3. Make your changes.
4. Save your changes.

Because both list and dictionary type objects contain multiple key-value pairs, they cannot be automatically mapped to Oomnitza. However, you can reference and map items in the object to Oomnitza. To do this, you add custom fields.

Let's say, an addresses list object contains multiple key-value objects such as "addresses":

[{"street_address": "123 Street", "city": "Boston", "country": "USA:}] 

In this case, you add a custom field and enter addresses[0].street_address as the field path to map the street address to Oomnitza.

Or, if it is a dictionary object such as 

{"addresses": {"address": {"street_address":"2 Apple view", "city":"Dallas", "postal_code": "75001", "country": "USA"}}}

you add a custom field and enter addresses.address.street_address as the field path to map the street address to Oomnitza.

See Creating new mapping fields

Adding custom fields

To add custom fields, complete these steps:

1. Click the Add integration field .
2. Enter the name of the field.
3. Enter the field path.
4. Save your changes.

Did you know?
You can click Edit integration  to define rules for the integration. For example, you might want to run the integration only if certain conditions are met.

Tip
Review the information in Mapping fields to find out which fields must be mapped to Oomnitza and the fields that can be selected as sync keys. The integration will not complete successfully unless you map the mandatory fields and choose the correct field for syncing the data. 

Table: Mapping fields 

Object Name	Mandatory mappings	Recommended sync key
Assets	Serial Number	Serial Number
Audits	Audit Name, Stockroom, Approver	Audit Name
Contracts	Contract Name, Contract Type If the Contract Type is Desktop Software, supply the Software Name. If the Contract Type is SaaS, supply the SaaS Name.	Contract Name
Locations	Location Name	Location Name
Desktop Software	Software Name	Software Name
Users	Email, Username, Role	Email or Username