---
title: "Field Mapping"
slug: "field-mapping"
updated: 2024-07-24T15:01:34Z
published: 2024-07-24T15:01:34Z
canonical: "help.symphonysummitai.com/field-mapping"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.symphonysummitai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Field Mapping

**Field Mapping** Configurations refer to the process of mapping fields between various applications or systems in order to ensure consistency and data accuracy. This configuration ensures accurate data transfer between the systems despite differences in field names, formats, or structures.

The following gif highlights the benefits of Field Mapping Configurations:

![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/SA configuration pages (2)(1).gif)

Service Automation requires information from (product) which can be obtained by configuring the API base URL. Then configure the list of APIs that fetch the data required from . Since Service Automation support is available for Incident management, service request and work order modules, we will map the APIs to the corresponding fields. This page is a guide to configure fields of a module to a particular data source and align it to the API.

## Navigation

To view the main Service Automation application page, perform the following steps:

1. Navigate to **Admin > Advanced > Automation > Orchestration**.

OR

Navigate to **Orchestration > User >Orchestration**.
2. Click the left hamburger icon to access all the options from the **MENU**.

![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/main navig screen.png)

Figure: Service Automation - Landing page with menu options

### View and configure Field Mapping

To configure field mapping, perform the following steps:

1. From the left MENU, select **Integrations > Field Mapping**.

![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-KHOOXHM8.png)

Figure: Integrations - Field Mapping option

Field Mapping page is displayed.

![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-W6YQMO1A.png)

Figure: Field Mapping
2. Click the desired **Module Name** hyperlink. The configurations page is displayed.

![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-QRIJ34S2.png)

Figure: Field Mapping configurations page
3. Select the **Module** from the drop-down to load module field mapping configurations.
4. Map the API response to valid text and value using **Response Mapping** option. See the below gif to know more.

![Response%20Mapping%20gif](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/Response%20Mapping%20gif.gif)
5. Specify the required details. Click **Save**. The data settings for the selected module are saved.

**Field Description**

This table contains the list of fields and their descriptions available on Field Mapping page:

| Field | Description |
| --- | --- |
| Field Name | Default names are displayed based on the Module selection. |
| Field Alias | Specify the required name to be displayed. |
| Control Type | Specify the type of control. Following are the types of controls: - **Textbox** - **Dropdown** - **Autosearch** - **Treeview** |
| Data Source Name | Select the Data Source name from the drop-down list. |
| Mapping | Using Response Mapping, map the API response to valid text and value. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-XHW62CZV.png) Figure: Response Mapping Tenant pop-up |
| Active | Use the toggle switch to toggle configured data settings as active or inactive. Only active fields are displayed in the Workflow Designer. |

#### Actions

Let’s understand each action icon present on the Field Mapping page in detail.

| Icon | Action |
| --- | --- |
| ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-QQXLYZHO.png) | Import data from JSON by selecting and uploading the required JSON file from your directory. Click **Import**. ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-7XZZ31KV.png) Figure: Import from JSON pop-up |
| ![](https://cdn.document360.io/62351b42-cfbd-43ad-8ce1-82b8f455337f/Images/Documentation/image-9IGLIP3P.png) | Export the configured data in JSON format. |