Errors and warnings
The handling of errors and warnings is much more flexible in the Conversion Service and easier to understand. The user or operator has the full control over each aspect of it.
| Conversion Service | 3-Heights® Document Converter | |
|---|---|---|
| Errors | ||
| Possible error code values | Fixed documented set of possible error codes | Positive integer value, can also be a system error code. Common values are documented |
| Identify the affected input document within a multi-document job | If applicable, the ID of the corresponding document is provided at the interface. (dataId)For more information, see the dataId schema in the Get job result endpoint | Manually (e.g. with log files) |
| Identify the affected part within a nested input document (e.g. attachment) | If applicable, a string identifying the affected part is provided at the interface. (dataPart)For more information, see the dataPart schema in the Get job result endpoint | Manually (e.g. with log files) |
| Identify errors in the static service configuration | Error code Configuration | Manually (e.g. with log files) |
| Identify errors in the runtime options (job options, document options) | Error code Option | Manually (e.g. with log files) |
| Identify internal service errors | Error code Internal. More details are provided in the service log file. | Manually (e.g. with log files) |
| Warnings | ||
| Possible warning code values | Workflow-specific set of possible values | Negative integer error code value |
| Multiple warnings | All warnings are reported in the list of conversion events. For more information, see the events schema in the Get job result endpoint. | Only a single warning is reported. |
| Identify the affected input document within a multi-document job | If applicable, the ID of the corresponding document is provided at the interface. (dataId)(For more information, see the dataId schema in the Get job result endpoint) | Manually (e.g. with log files) |
| Identify the affected part within a nested input document (e.g. attachment) | If applicable, a string identifying the affected part is provided at the interface. (dataPart)For more information, see the dataPart schema in the Get job result endpoint | Manually (e.g. with log files) |
| Ignore certain warning types | Can be configured for all possible warning types in the profile configuration. | Can only be configured for some types of warnings (e.g. options WARNSIGNATURES PDFA.XMPWARNINGS, PDFA.WARNVISDIFF, etc.) |
| Treat certain warning types as errors | Can be configured for all possible warning types in the profile configuration. | Can only be configured with job options for some types of warnings (e.g. option PDFA.CONVERSIONERRORMASK). |
info
For more information on how to set up the service logs to track errors and warnings, see Service logs.
tip
For more information on the events, dataId, and dataPart schemas, see the Get job result endpoint.