Error Handling

As soon as something goes wrong when processing a request, an error is generated and put into the response document. The status of the response will be set to "Error" or "Warning" depending on the severity of the error. In case of an error, processing will abort immediately, while in case of a warning processing continues.

An error has the following format:

<Error Id=”12345”>
  <Severity>Error/Warning</Severity>
  <Description>Short description</Description>
  <ExternalDescription>An external error text if available</ExternalDescription>
</Error>

Example response when trying to retieve a non-existent document:

<ProLinga>
  <Repository Version="1.0">
    <Command Name="Get" Mode="Response" Status="Warning">
      <Object Application="MyOrder" Type="Constant" Name="Standard">
        <Error Id="10006">
          <Severity>Warning</Severity>
          <Description>Document not found</Description>
          <ExternalDescription/>
        </Error>
      </Object>
    </Command>
  </Repository>
</ProLinga>

The "External" element will contain any error text passed on from the O/S or 3rd party products.

The following initial errors are defined:

Table 1. Errors

Error Id	Severity	Description
10000	Ok	No Error
10001	Error	Error parsing document
10002	Error	Empty Document
10003	Error	Invalid root element
10004	Error	Invalid repository XML file
10005	Warning	No document match
10006	Warning	Document not found
10007	Warning	Document already deleted
10008	Error	Can not parse return string