Overview
Integration data mapping enables Mirata to use data from external systems, such as SAP. You define these mappings in the admin tool's forms catalog and link them to form fields to populate forms with external data.
Set Up Integration Data Mapping
Create Integration Data Mapping
Create a new data mapping entry to enable Mirata to understand and use data from external systems. This entry defines how an external field translates into Mirata. Access the "Integration Data Mapping" section in the admin tool's forms catalog and add a new mapping to begin defining your data translation.
Note: Each field that is intended to populate with mapped information requires its own data mapping in Mirata' Admin. For example, if you are mapping fields of "Equipment Number", "Equipment Description", "Work Order Type", "Functional Location", etc. Each of these requires its own unique mapping entry in Mirata's Admin.
Define External Data Source Nomenclature
Specify the exact name or path of the data field in the external system. This nomenclature allows Mirata to identify and extract the correct information. When configuring a new data mapping, set the integration type to "MDK". In the definition field, enter the nomenclature that corresponds to the external system's data field. In this example:
{"integration-data": "{WOHeader/OrderType}", "type": "string"},
The "WOHeader/OrderType" is the path taken in SAP/SSAM, therefore it must be specified here. The user will then reference the data mapping in the form to have the specified field populate with the intended information.
Source Nomenclature
The integration-data value in the Definition field must precisely match the nomenclature from the external system for data to import correctly.
Integrate with Form Fields
Link Mapping to Form Field
Associate a specific form field with your integration data mapping to connect it to external data. In the form designer, select the form field you intend to populate with external data and access its properties to prepare it for integration.
Initialize Field with Integration Data
Configure the selected form field to use the integration data mapping as its initial value. This automatically populates the field with data from the linked external system when the form loads. Within the field's properties, enable an initial calculation. Then, select "integration-data" as the type of calculation and select the specific data mapping you created to link it to this field. Confirm your selection to apply the setting.
The specified field will now populate with the SAP/SSAM value of "WOHeader/OrderType" for this form.
We know this is for a specific order because we have the "work-order-id" header field mapped in the form's details in Designer. This means that for a unique work order, it will pull in the associated work order type.