Field Mapping
  • 24 Jul 2024
  • 1 Minute to read
  • PDF

Field Mapping

  • PDF

Article summary

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:

Service Automation requires information from Summit (product) which can be obtained by configuring the API base URL. Then configure the list of APIs that fetch the data required from Summit. 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.

    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.

    Figure: Integrations - Field Mapping option


    Field Mapping page is displayed.

    Figure: Field Mapping

  2. Click the desired Module Name hyperlink. The configurations page is displayed.

    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
  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.

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

Import data from JSON by selecting and uploading the required JSON file from your directory. Click Import.

Figure: Import from JSON pop-up

Export the configured data in JSON format.


Was this article helpful?

What's Next
Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.