natgillin/translations-raw huggingface dataset:
The two BE ISRS Location Codes are a valid definition of a waterway stretch (showing BE exception with respect to the fairway section code (‘020’ Albertkanaal)): BEGNK02016L010100414 (lock of Genk located at km 41,4 on the Albert Canal) — BEOSH02033L010500772 (lock of Ham located at km 77,2 on the Albert Canal).
Če navedena lokacijska koda ISRS (ISRS Location Code) označuje posamezen objekt, npr. merilnik ali zapornico, bi morala spletna storitev (web service) vrniti sporočila, ki vključujejo ta objekt.
The following figure shows counter-examples of ISRS Location Code usage for each of the general conventions (no exceptions to the general conventions apply to SK waterway stretches):
Ujemanje in neujemanje sporočil za en identifikacijski parameter
Invalid ISRS Location Code queries
Primer 3: V zahtevi sta dva identifikacijska elementa
General remark: A service to query valid ISRS Location Codes is not supported by the NtS Web Service.
Primer dveh identifikacijskih elementov je prikazan na naslednji sliki:
The ISRS Location Codes are provided within the European Reference Data Management System (ERDMS).
Veljavna poizvedba z dvema identifikacijskima elementoma
The correct usage of ISRS Location Codes in queries and their interpretation is given in the following five cases.
Vse vrednosti v hektometrih, za katere se opravi poizvedba, se obravnavajo kot veljavne, tudi če ima ustrezni odsek plovne poti drugačno začetno ali končno točko.
Case 1: No ids element in request
Če se odsek plovne poti na primer začne pri 100,0 hektometra in konča pri 300,0 hektometra, bi bila veljavna zahteva s poizvedbo po hektometrih med 20,0 in 400,0.
The ids element is an optional part of the request, i.e. a query without any ids elements is allowed:
Interno se seveda išče le „dejanski“ obseg odseka plovne poti.
Valid query without ids parameter
Tako je mogoče tudi iskanje vseh sporočil na plovni poti brez poznavanja dejanskega obsega v hektometrih (poslala bi se lokacijska koda ISRS (ISRS Location Code) s hektometri, nastavljenimi na „00000“ oziroma „99999“)
If no ids element is given, all messages shall be returned (depending, of course, on other filter criteria like validity_period or dates_issue).
Vrnjena bodo vsa ujemajoča se sporočila, ki sekajo navedeni interval hektometra.
Case 2: One id element in request
To je prikazano na naslednjem diagramu:
Each ids element can contain one or two id elements.
Ujemanje in neujemanje sporočil za dva identifikacijska parametra
The case of one id element is shown in the following figure:
Iz zgornje slike je razvidno, kako je opredeljeno „sekanje“.
Valid query with one id parameter
Obsegi sporočil od 1 do 4 se prekrivajo z obsegom razpona v hektometrih, za katerega je bila opravljena poizvedba (delno ali v celoti), obsega sporočil 5 in 6 pa se ne, zato bodo sporočila od 1 do 4 vrnjena, sporočili 5 in 6 pa ne.
If such a query is received, the server shall return all matching messages with a start hectometre ≤ the given value (240,7 in the example) and an end hectometre ≥ this value.
Tehnični pogoj za to, da sporočilo seka interval [A, B], je: začetni hektometer v sporočilu je manjši ali enak B, končni hektometer pa večji ali enak A.
The figure below depicts this selection of messages: The position queried lies between the start and end hectometre values of messages 1, 3 and 4, which would be returned.
Kombinacija V zahtevi je več identifikacijskih elementov
Messages 2, 5 and 6 do not overlap with the query position, so they would not be returned.
Veljavna poizvedba z več identifikacijskimi elementi
If the given ISRS Location Code denotes a singular object, e.g. a gauge or a lock, the web service should return the messages involving this object.
Kombinacija več identifikacijskih elementov v zahtevi vodi do združitve ustreznih sporočil.
Matching and not matching messages for one id parameter
Vsi identifikacijski elementi se obravnavajo posamično in sporočilo se vrne, če se ujema z vsaj enim od njih.
Case 3: Two id elements in request
Zato bi se v navedenem primeru vrnila naslednja sporočila:
The case of two id elements is shown in the following figure:
vsa sporočila za objekt z lokacijsko kodo ISRS (ISRS Location Code) SKXXX0000010000*****, pri čemer je začetni hektometer = 0, končni hektometer pa ≥ 0 (glej primer 2);
Valid query with two id parameters
vsa sporočila za objekt z lokacijsko kodo ISRS (ISRS Location Code) SKXXX0000500000*****, ki sekajo interval hektometra [220,0; 300,0] (glej primer 3).
All hectometre values queried shall be treated as valid, even if the corresponding fairway section has different start or end points.
V tem poglavju je podana izvedbena specifikacija storitve sporočil NtS, ki izhaja iz premislekov in odločitev iz prejšnjih poglavij.
For instance, if the fairway section starts at hectometre 100,0 and ends at hectometre 300,0, a request querying hectometres 20,0 up to 400,0 would be valid.
Storitev sporočil NtS zagotavlja štiri vrste sporočil v obvestilih NtS:
Internally, of course, only the ‘real’ extent of the fairway section is searched.
NtS FTM (sporočilo v zvezi s plovno potjo in prometom)
Doing so also enables the search for all messages on a fairway without knowing its exact hectometre range (one would send its ISRS Location Code with hectometres set to ‘00000’ or ‘99999’ respectively).
NtS WRM (sporočilo v zvezi z vodo)
All matching messages intersecting the given hectometre interval shall be returned.
NtS ICEM (sporočilo o ledu)
The following diagram illustrates this situation:
NtS WERM (sporočilo v zvezi z vremenom)
Matching and not matching messages for two id parameters
Izvajanje storitve sporočil NtS lahko podpira vse vrste sporočil ali samo izbor.
The figure above shows, how ‘intersecting’ is defined.
Sodelujoča država članica lahko zagotovi več kot eno storitev za določeno vrsto sporočila, ki se dopolnjujejo med seboj.
While the extents of the messages 1 to 4 overlap with the extent of the queried hectometre range (partially or completely), the extents of messages 5 and 6 do not, therefore messages 1 to 4 will be returned, 5 and 6 will not be returned.
Da bi se dosegla čim večja zanesljivost zadevne storitve in bi bila zapletenost čim manjša, se za spletno storitev NtS (NtS Web Service) ne uporablja noben dodatni jezik za poizvedbe.
The technical condition for a message to intersect with an interval [A, B] is: The start hectometre of the message is ≤ B and its end hectometre is ≥ A.
Namesto tega se uporabljajo konstrukti, ki jih zagotavlja sama specifikacija WSDL.
Valid query with multiple ids elements
V primeru storitve sporočil NtS je opredeljena ena sama operacija.
The combination of several ids elements in the request leads to a union of the corresponding messages.
Merila filtrov za posamezno področje so vzeta iz standarda NtS, vendar so razširjena glede na množico parametrov:
All the ids elements are treated individually and a message will be returned, if it matches at least one of them.
vrsta sporočila (obvezno; eno od „FTM“, „WRM“, „ICEM“, „WERM“),
Therefore, the following messages would be returned for the given example:
specifični odseki vodne poti ali njihovi deli ali specifični objekti (neobvezno; opisani z enojnim naborom lokacijskih kod ISRS (ISRS Location Codes) in/ali parom teh kod),
All messages for the object with the ISRS Location Code SKXXX0000010000***** with start hectometre =0 and end hectometre ≥ 0 (see Case 2)
čas veljavnosti (neobvezno; začetni in končni datum),
All messages for the object with the ISRS Location Code SKXXX0000500000***** which intersect the hectometre interval [11,0, 15,0] (see Case 3) — All messages for the object with the ISRS Location Code SKXXX0000200000***** with start hectometre ≤ 110,5 and end hectometre ≥ 110,5 (see Case 2)
datum objave obvestila (neobvezno; enojni datumi in/ali intervali datumov).
All messages for the object with the ISRS Location Code SKXXX0000500000***** which intersect the hectometre interval [220,0, 300,0] (see Case 3)
Storitev vrne le sporočila, ki se ujemajo z določenimi merili.
In this chapter the implementation specification of the NtS message service is given, deduced from the considerations and choices in the preceding chapters.
Mehanizem ostranjevanja
The NtS message service provides the four types of messages in the NtS:
Zaradi nadzorovanja količine podatkov je podprt mehanizem ostranjevanja.
NtS FTM (fairway and traffic related message)
Parameter ostranjevanja je opredeljen z zapleteno vrsto, ki vsebuje naslednje elemente:
NtS WRM (water related message)
odmik (offset): zaporedna številka prvega vrnjenega sporočila (celo število (integer) > 0),
NtS ICEM (ice message)
omejitev (limit): največje število sporočil (celo število (integer) > 0),
NtS WERM (weather related message)
skupno število (total count): opozorilo, če se vrne skupno število sporočil (Boolova vrednost (Boolean value))
An implementation of the NtS message service can support all message types or just a selection.
Zapleten parameter ostranjevanja je neobvezen, če pa je prisoten, je treba v njem navesti vse elemente.
It is allowed that a participating Member State provides more than one service for a specific message type, that complement each other.
Mehanizem ostranjevanja nato deluje, kot sledi:
In order to achieve a maximum robustness of the service while keeping the complexity on a low level no additional query language is used for the NtS Web Service.
Skupno število sporočil ne bo preseglo vrednosti parametra omejitev (limit), razen da vrednost 0 pomeni „brez omejitve“.
Instead the constructs provided by WSDL itself are applied.
Odziv preskoči toliko sporočil, kot je določeno v parametru odmik (offset).
The specific operations together with their parameters are specified entirely within the WSDL specification.
Da bi se ta mehanizem lahko zagotovil, mora storitev upoštevati začasno stalno (vendar sicer poljubno) zaporedje sporočil, npr. med dvema posodobitvama podatkov v sporočilu v okviru osnovnega niza podatkov spletne storitve (web service).
In the case of the NtS Message Service a single operation is defined.
To pomeni, da se morajo pri dveh zaporednih enakih pozivih vrniti ista sporočila v istem zaporedju.
The subject-specific filter criteria are taken from the NtS standard, but extended concerning multiplicity of the parameters:
Parameter skupno število (total count) določa, ali bo odziv zagotovil skupno število sporočil, ki se ujemajo z merili za posamezno področje.
type of message (compulsory; one of ‘FTM’, ‘WRM’, ‘ICEM’, ‘WERM’),
Običajno bi moralo zadostovati, da se te informacije zahtevajo pri prvem odzivu, v vseh zaporednih odzivih pa izpustijo.
specific waterway sections or parts thereof, or specific objects (optional; described by single ISRS Location Codes and/or pairs of ISRS Location Codes),
S tem bi se morala zagotoviti večja učinkovitost spletne storitve (web service).
time of validity (optional; start date and end date),
Mehanizem ostranjevanja je način za zahtevanje sporočil dobesedno v „straneh“.
date of publication of the notice (optional; single dates and/or intervals of dates).
Da bi mehanizem ostranjevanja deloval ustrezno, je treba v vsakem pozivu navesti iste parametre za posamezno področje.
Only the messages matching the given criteria are returned by the service.
V primeru uspešne zahteve odziv spletne storitve NtS (NtS Web Service) vsebuje sporočila NtS, ki ustrezajo parametrom zahteve.
Paging mechanism
Sporočila NtS morajo biti v skladu s shemo NtS in se lahko potrdijo glede na navedeno shemo.
In order to control the amount of data a paging mechanism is supported.
Ker je vrsta sporočila obvezen parameter zahteve, lahko vsak odziv vsebuje le sporočila NtS iste vrste, tj. FTM, WRM, ICEM oziroma WERM.
The paging parameter is defined with a complex type containing the following elements:
Če storitev med obdelavo zahteve zazna napake, lahko vrne naključno število sporočil o napaki z uporabo kod napak iz naslednjega podpoglavja.
offset: serial number of the first returned message (integer ≥ 0),
En odziv spletne storitve NtS (NtS Web Service) lahko hkrati vsebuje sporočila Nts in sporočila o napakah.
limit: max. number of messages (integer ≥ 0),
Vrnejo se neobvezne informacije o ostranjevanju, če je zahteva vsebovala parametre ostranjevanja.
total count: flag, if total number of messages shall be returned (Boolean value).
V tem primeru sta odmik (offset) in število vsebovanih sporočil obvezna, skupno število mora biti prisotno le, če je bilo zahtevano.
The complex paging parameter is optional, but if it is present, all elements within have to be given.
Opozorilo: predpostavlja se, da je komunikacija med spletno storitvijo (web service) in uporabnikom tehnično vzpostavljena, tj. da storitev prejme zahtevo in da uporabnik prejme ustrezen odziv.
Then, the paging mechanism works in the following way:
Tehnične napake, na primer prekinitev internetne povezave ali nedostopnost spletne storitve (web service) zaradi vzdrževanja ali sesutja, tukaj niso obravnavane.
The total number of messages will not exceed the value of the parameter limit, with the exception that a value of 0 means ‘no limit’.
Obravnavani so le primeri napak, do katerih pride „v ozadju“ spletne storitve (web service) z vidika uporabnika.
The response skips as many messages as defined in the parameter offset.
Sporočila o napakah
In order to provide this mechanism, the service has to observe a temporarily stable (but otherwise arbitrary) sequence of the messages, e.g. between two updates of message data on the underlying data set of the web service.
Kode napak za pričakovane primere napak so skupaj s pojasnilom navedene v nadaljevanju.
This means that two consecutive identical calls must return the same messages in the same order.
V odzivu je navedena le koda napake, kar je običajen postopek v shemi XML obvestil NtS.
The parameter total count determines whether the response shall provide the total number of messages matching the subject-specific criteria.
Kode napak za storitev sporočil NtS
Usually it should be sufficient to request this information with the first response, but omit it in all consecutive responses.
Če se nato upošteva pristop contract-first, tj. če se v obliki dokumentov WSDL predloži en ali več standardiziranih zapisov (dogovorov, pogodb – contracts) s popolnimi opisi vmesnikov, se lahko izvajanje storitev in izvajanje ustreznega odjemalca samodejno ustvari z uporabo ustreznih programskih orodij.
This should result in a better performance of the web service.
V najboljšem primeru ustvarjene izvorne kode ni treba spreminjati.
The paging mechanism provides a means to request the messages iteratively in ‘pages’.
Vendar je v večini primerov potrebnih več ponovitev, dokler specifikacija WSDL ne izpolnjuje natančnih zahtev takega orodja.
In order for the paging mechanism to work properly, the same subject-specific parameters have to be provided in each call.
Da bi orodje delovalo nemoteno, običajno postavlja posamične zahteve glede uporabe standarda WSDL.
In case of a successful request the NtS Web Service response contains the NtS messages that match the request parameters.
Posledično so morda potrebne spremembe specifikacije WSDL, čeprav je bila specifikacija WSDL prvotno veljavna specifikacija v skladu s standardom WSDL.
The NtS messages have to comply with the NtS schema and can be validated against that schema.
Če se specifikacija WSDL spletne storitve (web service) spremeni po tem, ko sta bila storitev ali odjemalec ustvarjena, je morda potreben nov postopek ustvarjanja, odvisno od izvedenih sprememb.
Since the message type is a compulsory request parameter, each response can contain only NtS messages of the same message type, FTM, WRM, ICEM or WERM respectively.
Pojem
If the service detects errors while processing the request it can return an arbitrary number of error messages, using the error codes listed in the following subchapter.
Pojasnilo
One response of an NtS Web Service can contain NtS messages and error messages at the same time.
Identifikacija
Optional paging information is returned if the request contained paging parameters.
Simple Object Access Protocol; omrežni protokol, ki se običajno uporablja za spletne storitve
In this case the offset and number of contained messages are mandatory, the total count needs only be present if it has been requested.
Universal Description, Discovery and Integration; standard za storitve registra v okviru spletnih storitev
Please note: It is assumed that the communication between the web service and the user is technically established, i.e. the service receives the request and the user receives the corresponding response.
Združeni narodi
Technical errors, e.g. breakdown of the internet connection or inaccessibility of the web service due to maintenance or crash, are not considered here.
enotni naslov vira (Uniform Resource Locator); lokacija omrežnega vira, ki se navadno uporablja za internetne naslove
Only error situations that happen ‘behind’ the web service layer from the users point of view are considered here.
svetovni geodetski sistem iz leta 1984 (World Geodetic System 1984)
Error messages
Spletna storitev (Web Service); storitev, ki zagotavlja vmesnike na internetu in jo uporablja internetna komunikacija
The error codes for the expected error situations are given below, together with an explanation.
Opisni jezik spletnih storitev (Web Services Description Language); standard za specifikacijo spletnih storitev
Only the error code is contained in the response, which is the usual procedure in the XML schema of the NtS.
Web Services Interoperability Organisation; industrijski konzorcij, katerega cilj je podpora interoperabilnosti spletnih storitev
Error codes for the NtS message service
Razširljiv označevalni jezik (Extensible Markup Language); metajezik za strukturirano predstavitev podatkov, ki je neodvisna od uporabljene platforme
If the contract-first approach is consequently observed, i.e. one or more contracts with complete descriptions of the interfaces are given in the form of WSDL documents, an implementation of the service(s) as well as an implementation of a corresponding client can be automatically generated using appropriate software tools.
Definicijska shema protokola XML (XML Schema Definition); standard za določitev strukture dokumentov XML
In an ideal situation no manual changes have to be made in the generated source code.
Opis s spletnega mesta WS-I: http://www.ws-i.org.
However, in most cases several iterations are necessary until the WSDL specification meets the precise requirements of such a tool.
Zaradi zagotavljanja, da lahko države članice dosledno in interoperabilno kodirajo obvestila kapitanom, bi bilo treba izboljšati referenčne tabele iz Dodatka E. V ta namen bi bilo treba nove kode določiti v novi referenčni tabeli, ki vsebuje usklajene oznake iskalnega vmesnika za grafični uporabniški vmesnik.
Typically the tool makes individual demands on the use of the WSDL standard in order to work smoothly.
določenega odseka vodne poti;
As a consequence changes to the WSDL specification may be necessary, although the WSDL specification was a valid specification according to the WSDL standard in the first place.
Koda razloga (Reason_code):
If the WSDL specification of the web service is changed after the service or the client have been generated, a new generation process may be necessary, depending on the changes made.
Koda poročanja (Reporting_code):
Term
Koda komunikacije (Communication_code)
Explanation
Koda stanja ledu (Ice_condition_code)
Identification
Koda dostopnosti v primeru ledu (Ice_accessibility_code)
Simple Object Access Protocol; network protocol typically used for web services
Koda klasifikacije ledu (Ice_classification_code)
Universal Description, Discovery and Integration; Standard for registry services in the context of web services
Imena se vnesejo v lokalnem jeziku, zato se lahko uporabijo tudi diakritični znaki ali cirilica (npr. Baarlerbrücke, Volkeraksluis ali Mannswörth).
United Nations
Interval zaupanja za predvidevanje vodostaja: najverjetnejša vrednost (v črni barvi), zgornja meja intervala zaupanja (v vijolični barvi), spodnja meja intervala zaupanja (v rdeči barvi), izmerjeni vodostaj (v modri barvi)
Uniform Resource Locator; location of a network resource typically used for internet addresses
(Na abscisni osi je prikazan čas; na ordinatni osi je prikazan vodostaj v cm.)
World Geodetic System 1984
a. se preveri, ali je navedena vsa obvezna vsebina v skladu s shemo NtS XSD (če ni, se je treba vrniti na korak (2)),
Web Service; service that provides its interfaces in the internet and is used by internet communication
i. polje „organizacija“ (organisation) ostane nespremenjeno,
Web Services Description Language; standard for the specification of web services
polje „leto“ (year) ostane nespremenjeno,
XML Schema Definition; standard to specify the structure of XML documents
Traffic Sistat – Lock
Description cited from the WS-I Website: http://www.ws-i.org
Traffic Sistat – Oncoming Traffic Indicator
In order to ensure that Member States are able to encode Notices to Skippers messages in a consistent and interoperable manner, the Reference tables included in Appendix E should be improved.
Traffic Sitat – Port Entry and Departure
For this purpose, new codes should be defined in a new Reference table containing harmonised search interface labels for the graphical user interface.
matching example, other TypeCodes possible (1:n relation)
a specific waterway section;
vsa sporočila za objekt z lokacijsko kodo ISRS (ISRS Location Code) SKXXX0000500000*****, ki sekajo interval hektometra [11,0; 15,0] (glej primer 3);
a specific part of a waterway, defined by the river-km of the starting and the end point; (e) time of validity of the notice (start date and end date of validity period);
vsa sporočila za objekt z lokacijsko kodo ISRS (ISRS Location Code) SKXXX0000200000*****, pri čemer je začetni hektometer ≤ 110,5, končni hektometer pa ≥ 110,5 (glej primer 2);
Yes:
parameters for paging mechanism do not fit the available messages, e.g.
Reason_code
Offset >= Total Count
Reporting_code
Dodatek C
Communication_code
Dodatek D]
Ice_condition_code
koda položaja (position_code): vse (AL),
Ice_accessibility_code
določenega dela vodne poti, opredeljenega z rečnim km začetne in končne točke;
Ice_classification_code
datuma objave obvestila (datum in čas objave).
Names shall be entered in local language, thus also e.g. diacritics or Cyrillic letters may be used. (e.g. Baarlerbrücke, Volkeraksluis or Mannswörth).
Sporočila NtS, ki so v skladu s standardi iz te priloge, se lahko med drugim zagotovijo z naslednjimi orodji:
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)
Celinski ECDIS (Inland ECDIS)
(The x-axis shows the time; the y-axis shows the water level in cm)
Decimalke v številčnih poljih so označene s „.“ (piko).
it is checked if all mandatory content is provided in line with the NtS XSD (if not, go back to (2));
Predmetna koda (Subject_code):
the ‘organisation’ stays unchanged;
Koda omejitve (Limitation_code):
the ‘year’ stays unchanged;
Koda označitve (Indication_code):
the ‘number’ stays unchanged;
Koda vrste (Type_code):
Traffic Sistat — Bridge Passage
Spletna storitev NtS (NtS Web Service)
Traffic Sistat — Oncoming Traffic Indicator
definicijska shema protokola XML (XML Schema Definition, XSD),
Traffic Sitat — Port Entry and Departure
Lokacijska koda ISRS (ISRS Location Code)
establishing a discard plan for certain demersal fisheries in South-Western waters for the period 2019-2021
o načrtu za zavržke pri nekaterih vrstah pridnenega ribolova v jugozahodnih vodah za obdobje 2019–2021