[1] Error is a container element for information about an error that has occurred in a receiving application and is being reported back to the sending application by the receiving application in which the error occurred. Error includes one required child element, Error:Message. Error includes nine optional child elements (a) Error:Code, (b) Error:Line, (c) Error:LinePosition, (d) Error:FilePosition, (e) Error:SourceText, (f) Error:ParserCode, (g) Error:ParserReason, and (f) Error:ParserName. [2] Error:Message and Error:Code may be related to any error experience by the receiving application. The error may, but must not, be related to XML parsing or validation. [3] Error:Line, Error:LinePosition, Error:FilePosition, Error:SourceText, Error:ParserCode, and Error:ParserReason contain error information related to XML parsing and validation. Error information for these elements is expected to be the actual error message reported from the validating parser, if the parser is capable of generating such error information. Different parsers return different types of error messages. Applications should send back as much parser error message as possible, but are not required to send back information that the parser does not or cannot generate. [4] Error:Message is a human readable error message. Error:Message may be related to any error experience by the receiving application. The Error:Message value should be understandable to, and appropriate for, a non-technical user. The application sending the Error:Message value should anticipate that the receiving application will, or may, display the Error:Message value to a non-technical user. The receiving application is not, however, required to display the value of the Error:Message to its users. [5] Error:Code is a code value that corresponds to the Error:Message. Error:Code may be related to any error experience by the receiving application. For the code value to be useful, implementations must standardize Error:Code values and meanings and use the standard codes accordingly. 2GEFS currently does not include standard Error:Code values. Implementations should define and publish standard Error:Code values. Implementations are encouraged to harmonize code values with code values of other implementations. [6] If applications do not trust that the Error:Message will be appropriate for its users, then it should rely on standard Error:Code values and then match Error:Code values to a library of its own error messages. [7] Error:Line is the line number of the text file in which the error occurred. The Error:Line value should be generated by the validating parser. [8] Error:LinePosition is a number corresponding to the position of the character on the line reported in Error:Line. The Error:LinePosition value should be generated by the validating parser. [9] Error:FilePosition is a number corresponding to the position of the character in the text file in which the error occurred. The Error:FilePosition value should be generated by the validating parser. [10] Error:SourcText is the source text or node in which the parsing or validation error occurred. [11] Error:ParserCode is the parser code value generated by the validating parser for the error. [12] Error:ParserReason is the human-readable reason generated by the validating parser for the error. Attribute(s) | type | use | fixed/default | ParserVersion | xsd:string | required | None |
[13] Error:ParserName is the commonly used name of the parser, such as MSXML or Xerces, without the version of the parser. Error:ParserName includes a required attribute ParserVersion. ParserVersion must include the version of the named parser. |