Important: The role feature Integration > Integration Studio > View IDL must be added to a user role to see the View IDL button in Step 3.
Integration Studio uses a language called Integration Description Language, or IDL, to map and transform data. All configuration is converted into IDL prior to running the integration and when an integration error includes the Mapping.idl tag, the message also includes the line and column number of where the error occurs in the IDL version of the integration.
Before You Begin: All fields with Mapping or Conditional Mapping as the source must be mapped prior to clicking View IDL. If the mapping for these fields is incomplete, the IDL can’t be generated.
To view the IDL version:
- Go to Integrations > Integration Studio.
- Locate the integration you want to work with, click the action icon, and then click Edit.
- Expand Map fields from <Source Vendor> to <Destination Vendor>.
- Click View IDL.
To troubleshoot a specific Mapping.idl error, find the line and column number mentioned in the error message in the IDL Editor window, review the IDL documentation, field configuration, and source data as needed to determine the root cause, and then correct the configuration. See Reference: Integration Description Language.
Some questions to ask yourself when you are troubleshooting:
- What fields are being referenced on the line or column where the error occurred for the integration?
- What operations are being performed on those fields?
- Is there any issue with the source data being referenced?