Resolving Common Errors in Configuration Studio

Causes and resolutions for the most common errors in Configuration Studio

Working with Errors

In Configuration Studio, errors are identified at two levels: at the document level, where you check if the documents have passed or failed, and at the field level, where an error icon highlights the specific source of the issue for those that failed. Most errors are highlighted directly within the document, with affected fields marked in red. By hovering over these highlighted areas, you can access additional guidance that will assist you in resolving the issue.

Spotting Errors at the Document Level

ErrorDocConfigStudio2

Spotting Errors at the Field Level

ErrorFieldConfig Studio

Spotting Errors in the Document

Common Error Messages and Resolutions

For a standard source on information, resolutions for the most common errors are also described in the following table with descriptions for why they happened.

Error	Error Description	What to do
Relative Text Not Found	The expected relative text is missing, preventing the system from referencing the necessary field.	Click the error icon to open the issue in the panel on the right. Compare the header labels between the documents that are passing, and those that are failing and then find text that is consistent in both examples. Select the new relative text on the document. Click Commit Change.
No Text Found In the Expected Location Error	A mandatory field could not be found.	Click the error icon to open the issue in the panel on the right. Select one of the two: If it is a mandatory field, select the new field on the document. If it is not a mandatory field, check the box for "Optional Field" in the panel on the right. Click Commit Change.
Split Error	The split is broken, often due to the split separator not being present in the mapped field.	Click the error icon to open the issue in the panel on the right. Edit the split directly from the broken field. Click Commit Change.
Invalid Format Error	The date or number format does not match the expected format for the field.	Click the error icon to open the issue in the panel on the right. Select the correct format. Click Commit Change.