TitlePage validates all ONIX data received to ensure that the information is well formed and matches ONIX specifications and TitlePage requirements. TitlePage validates records using the EDItEUR XSD.
Who this is for
This article is for users responsible for the upload and maintenance of publisher and distributor feeds to TitlePage who want to:
- Understand how TitlePage validates files.
- Check on the status of any occurring errors.
XSD validation
TitlePage makes use of XSD (XML Schema Definition) validation against all records uploaded to TitlePage. This validator checks if:
- An ONIX file is a correctly structured XML document.
- All required elements are present.
- The data within each element follows the permitted formats, codes, and business rules defined by the ONIX standard.
This validation helps ensure the file can be processed successfully. Your file is validated against the EDItEUR schema for the ONIX version it declares. The schemas are available from the EDItEUR website. For the versions TitlePage accepts, see ONIX Versions, requirements, codelists.
Understanding the TitlePage XSD readout
When TitlePage finishes loading an ONIX file, a JSON load report is generated. A copy of this report is placed in the same SFTP location where the file was uploaded, and a copy is also emailed to all users who have opted in to receive load report emails. See System Emails and Reports for further information.
The JSON load report gives a readout of all that occurred during the processing of the ONIX file, including:
- How long it ran for.
- How many titles were affected.
- The number and severity of issues.
Issues are broken into two levels:
- Warn: a problem has been detected in the uploaded ONIX file that should be corrected, but the product will still be loaded onto TitlePage. The warning message will describe the detected issue.
- Error: a critical problem has been detected in the ONIX record, preventing the record from being loaded onto TitlePage. The error message will describe the detected issue.
Example of a Warn issue message
Example of an Error issue message
If you need help understanding an issue message in a load report, or believe it has been falsely generated, please contact TitlePage support.
Related articles
- System Emails and Reports, load report emails and who receives them
- ONIX Versions, requirements, codelists, the versions and codelists TitlePage supports
- TitlePage File Naming Conventions, naming your files so they load
Further information
For further information please contact TitlePage support.