Numbers Data
Number_info
The number_info element is the top level element in files containing importable numbers. The number_info has the following elements.
Messages
The messages element provides error and information messages about requests for numbers that are submitted to the eLandings server. A request for numbers made to eLandings may not cause any messages to be created, but may be present in files received from eLandings. The absence of the messages element indicates that no errors or warnings apply.
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 eLandings software to know what version of the schema the XML was generated for, if it is not the most current version. If the schema version element is not provided it defaults to version 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.
Landing_report_id
The landing_report_id is the unique identifier for both landing and production reports. The actual number must be generated by the eLandings system. Multiple landing_report_id elements can be stored in a number_info XML document. This allows one request for number to return many numbers, which can be stored and used when generating landing or production reports.
Data Type |
Since Schema Version |
Oracle Database Data Definition |
Values |
---|---|---|---|
integer |
1.0 |
NUMBER(10,0) |
Report IDs will be between 1 and 9,999,999,999 |
Fish_ticket_number
the fish_ticket_number is the unique identifier of ADF&G fish tickets. When submitting a landing report to the eLandings system, this number must have been previously received from eLandings as an importable number. Multiple fish_ticket_number elements can be stored in a number_info XML document. This allows one request for number to return many numbers, which can be stored and used when generating landing reports.
Data Type |
Since Schema Version |
Oracle Database Data Definition |
Values |
---|---|---|---|
text |
1.0 |
CHAR(10) |
Fish Ticket Number is the ticket number that associates particular catch lines with particular permits on landing reports. The business rules for the fish ticket number format are documented by the eLandings business rules. |