Appendix B. NOTICES TO SKIPPERS ENCODING GUIDE FOR APPLICATION DEVELOPERSF1
United Kingdom Repealed
1.
Background & Structure
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.1.
Purpose of NtS Encoding Guide
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.1.1.
NtS Encoding Guide for editors
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
1.1.2.
NtS Encoding Guide for application developers (this document)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.
NtS messages and sections
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 2
Visualisation of the NtS message structure: mandatory element (1), mandatory element that may occur one or two times (1…2), mandatory element that has to occur two times (2), mandatory elements that may occur as often as necessary (1-n), optional element that may occur as often as necessary (0…n)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.
WRM basic considerations
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.1.
Filling of nts_number section in the WRM
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2.
Filling of WRM including predictions
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Figure 3
Visualisation of water level prediction confidence interval: most probable value (black), confidence interval upper boarder (violet), confidence interval lower boarder (red), measured water level (blue)
(The x-axis shows the time; the y-axis shows the water level in cm)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.
ICEM processes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.1.
New ICEM
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
4.2.
Update of an existing ICEM
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.
WERM basic considerations
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.1.
Filling of nts_number section in the WERM
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.2.
Filling of WERM ‘ weather_category_code ’
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.
FTM processes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.1.
New FTM
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.2.
Update/withdrawal of an existing FTM
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.3.
Waterway and/or object related FTM
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.4.
Automatic ordering of limitation codes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
6.5.
Handling of limitation period
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.
General implementation rules
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.1.
Filling of the ‘ number_section ’
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.2.
Filling of elements ‘ from ’ , ‘ originator ’ , ‘ organisation ’ and ‘ source ’
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.3.
Omission of elements
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.4.
Automatic filling of date_issue
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.5.
Handling of time zone information in NtS messages
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.6.
Handling of Seconds in NtS messages
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.7.
Format of decimals in NtS messages
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.8.
Units to be used in NtS messages
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.9.
Rules for the elements ‘ name ’ , ‘ position_code ’ and ‘ type_code ’
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Table 1
Matching ‘ RIS Index function_code ’ — ‘ NtS type_code ’
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.10.
Rules for the element ‘ fairway_name ’
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.11.
Clarifications for translations in the spreadsheet ‘ reference_code ’
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.12.
Recommendation for the element ‘ coordinate ’
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.13.
Handling of target groups
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.14.
Display of valid messages at a given time
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.15.
Optional functions to increase user friendliness of NtS editor tools
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8.
NtS XML Message Structure
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.
NtS Web Service
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.1.
Objective
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.2.
Basic Principles and constraints
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.2.1.
Web standards
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.2.2.
Interaction model and encoding method for NtS WS
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.3.
General specifications and recommendations
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.3.1.
Specification: Version information
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.3.2.
Specification: Structure of namespaces
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.3.3.
Recommendation: Use of namespaces
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.3.4.
Recommendation: Use of namespace prefixes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.3.5.
Specification: Use of ISRS Location Codes
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Invalid ISRS Location Code queries
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Case 1: No ids element in request
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Valid query without ids parameter
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Case 2: One id element in request
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Valid query with one id parameter
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Matching and not matching messages for one id parameter
Case 3: Two id elements in request
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Valid query with two id parameters
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Matching and not matching messages for two id parameters
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Combination: Multiple ids elements in request
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Valid query with multiple ids elements
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.4.
NtS Message Service (implementation specification)
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.4.1.
Request
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.4.2.
Response
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.5.
Generation of services and clients
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Glossary
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Annotations
Textual amendments
- F1
Regulation revoked (31.12.2020) by The Merchant Shipping (Miscellaneous Provisions) (Amendments etc.) (EU Exit) Regulations 2018 (S.I. 2018/1221), regs. 2(b), 5(g); 2020 c. 1, Sch. 5 para. 1(1)