Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The messages element provides error and information messages about reports that are submitted to the eLandings server. It will be omitted from reports that are successfully exported from eLandings. The messages element may contain any number of message elements.

Data Type

Since Schema Version

Oracle Database Data Definition

Values

text

1.0

N/A

The message text can be of arbitrary length, and can include data values that caused the problem to be reported. Typically the text length will not exceed 265 characters.

The message element has four attributes

  • The msgid attribute provides a unique identifier for the message, which can be used to lookup further information on the eLandings website.

    Data Type

    Since Schema Version

    Oracle Database Data Definition

    Values

    integer

    1.0

    NUMBER(10,0)

    Msg IDs will typically be between 1000 and 99,999. Msg IDs can be looked up on the eLandings website

  • The severity_code attribute identifies the severity of the message

    Data Type

    Since Schema Version

    Oracle Database Data Definition

    Values

    text

    1.0

    N/A

    The severity code values and translations are:
    S - System Error
    E - Error
    W - Warning
    I - Information

  • The severity_desc attribute is the translation of the severity code.
  • The prefix attribute is a message prefix that relates the message to particular lines or items in the XML document.

    Data Type

    Since Schema Version

    Oracle Database Data Definition

    Values

    text

    1.0

    N/A

    The prefix is not applicable to all messages. Where used it has values such as "Line x, Grading/pricing line y".

Schema Version

The schema version data element allows the software to know the version of the schema for which an XML file was generated. If the schema version element is not provided that indicates the version is 1.0, the original groundfish release production schema. The contents of the schema version element corresponds to the version attribute in the <xs:schema> element of the schema, the top level element of the schema definition.

Note that this is NOT the version attribute in the <xml> element that contains the schema definition. That attribute defines the version of XML, as specified by the W3C consortium.

...