natgillin/translations-raw huggingface dataset:
For the provision of waterway stretches (id element pairs within the fairway_section geo_object) in NtS messages, the following has to be considered with respect to the ISRS Location Codes:
V prípade, že sa správa týka viacerých úsekov vodnej cesty alebo plavebnej dráhy, všetky úseky plavebnej dráhy musia byť určené bodom ich začiatku a konca v osobitných elementoch XML „fairway_section“.
digits 1 to 2 (Country code):
Pri niektorých krajinách/regiónoch sa požaduje, aby sa vypracovala funkcia filter.
have to be identical within the id pair, but
Napríklad, keď kód umiestnenia ISRS Location Code (1 a 2) je BE, použije sa ISRS Location Code (6 až 8) ako ID pre lineárne referencovanie s hektometrom plavebnej dráhy (ISRS Location Code 16 až 20).
different country codes may be defined within one id pair in case neighbouring countries are using the same fairway section code for a specific waterway and the same system for defining the hectometres,
Príklady pre úseky plavebnej dráhy (platné páry id elementov v časti fairway_section), ktoré zahŕňajú uvedené výnimky:
digits 3 to 5 (UN Location code):
Dva kódy ISRS Location Code NL sú platným určením úseku plavebnej dráhy (a ukazujú holandskú výnimku, pokiaľ ide o kilometre plavebnej dráhy): NLSVG00130K000300191 (km 3,0 v Sas van Gent na kanáli Kanaal Gent-Terneuzen) – NLWDP00130K000400200 (km 4,0 vo Westdorpe na kanáli Kanaal Gent-Terneuzen),
are not relevant, may contain different content within the id pair,
Dva kódy ISRS Location Code BE sú platným vymedzením úseku plavebnej dráhy (a ukazujú belgickú výnimku, pokiaľ ide o kód úseku plavebnej dráhy („020“ Albertkanaal)): BEGNK02016L010100414 (plavebná komora Genk umiestnená na kilometri 41,4 na Albertovom kanáli) – BEOSH02033L010500772 (plavebná komora Ham umiestnená na kilometri 77,2 na Albertovom kanáli).
digits 6 to 10 (Fairway section code):
Na ďalšom obrázku sú uvedené opačné prípady použitia ISRS Location Code za každú všeobecnú konvenciu (na úsekoch plavebnej dráhy na Slovensku sa neuplatňujú žiadne výnimky zo všeobecných konvencií):
[exception]: in case of using the Belgian ISRS codes within NtS WS, one should use only digits 6 to 8 to identify the fairway section, because NtS messages will be published across different sections within one fairway,
Neplatné vyhľadávania kódu umiestnenia ISRS Location Code
digits 11 to 15 (Object Reference Code).
Všeobecná poznámka: Systém NtS Web Service nepodporuje službu vyhľadávania platných kódov ISRS Location Code.
digits 16 to 20 (Fairway Hectometre):
Kódy ISRS Location Code sa uvádzajú v rámci európskeho systému správy referenčných údajov (ERDMS).
consist of five numerical digits defining the hectometre thus will usually contain different content within the id pair.
Správne používanie kódov ISRS Location Code pri vyhľadávaniach a ich výklade je opísané v týchto piatich prípadoch:
Example: ‘00235’ for fairway km 23,5; ‘00001’ for fairway km 0,1,
Prípad 1: Žiadny ids element v žiadosti
[exception]: in case of the Netherlands there is not always a direct connection between the Fairway hectometre and the physical kilometre of the fairway due to the definition of the start of the fairway stretch in the network model and in the real world, in such cases the Object Reference Code for objects of the type ‘dismar’ starts with Kxxxx (xxxx includes the physical kilometre, e.g. NLSVG00130K000300191 (km 3)).
Ids element je voliteľnou časťou žiadosti, t. j. vyhľadávanie bez akýchkoľvek ids elementov je povolené:
But for other types of objects there is no direct relation to the physical fairway km in the ISRS codes, e.g. the bridge of Sas van Gent on the same fairway at km 2,5 has the ISRS code NLSVG001300521600186.
Platné vyhľadávanie bez ids parametra
For the Kanaal Gent-Terneuzen the physical km 0,0 starts at the border of Belgium and the Netherlands and the Fairway Hectometre 0,0 starts at the beginning of the canal in Gent.
Ak nie je uvedený žiadny ids element, všetky správy sa odošlú (samozrejme v závislosti od ďalších kritérií filtra, ako je validity_period alebo date_issue).
In case a message touches more than one waterway or fairway sections all fairway sections have to be defined by their begin- and end-point in separate ‘fairway_section’ XML elements.
Prípad 2: Jeden id element v žiadosti
For some countries/regions it is required to build filter functionality.
Každý ids element môže obsahovať jeden alebo dva id elementy.
For example if ISRS Location Code (1-2) is BE use ISRS Location Code (6-8) as the ID for linear referencing with the fairway hectometre (ISRS Location Code 16-20).
Na tomto obrázku je znázornený prípad jedného id elementu:
Examples for fairway stretches (valid id element pairs within the fairway_section) that include above defined exceptions:
Platné vyhľadávanie s jedným id parametrom
The two NL ISRS Location Codes are a valid definition of a waterway stretch (showing NL exception with respect to the kilometre of the fairway): NLSVG00130K000300191 (km 3,0 at Sas van Gent on the Kanaal Gent-Terneuzen) — NLWDP00130K000400200 (km 4,0 at Westdorpe on the Kanaal Gent-Terneuzen),
Po prijatí takéhoto dopytu server odošle všetky vyhovujúce správy s hektometrom počiatočného bodu ≤ v porovnaní s danou hodnotou (240,7 v príklade) a hektometrom koncového bodu ≥ v porovnaní s touto hodnotou.
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).
Na obrázku nižšie je znázornený tento výber správ: Vyhľadávaná poloha leží medzi hodnotami hektometra počiatočného bodu a koncového bodu v prípade správ 1, 3 a 4 a tieto správy budú odoslané.
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):
V správach 2, 5 a 6 nedochádza k prekrývaniu s vyhľadávanou polohou, preto nebudú odoslané.
Invalid ISRS Location Code queries
Ak daný ISRS Location Code označuje jednotlivý objekt, napríklad stanicu na meranie hladiny alebo plavebnú komoru, webová služba by mala odoslať správy týkajúce sa tohto objektu.
General remark: A service to query valid ISRS Location Codes is not supported by the NtS Web Service.
Vyhovujúce a nevyhovujúce správy pre jeden id parameter
The ISRS Location Codes are provided within the European Reference Data Management System (ERDMS).
Prípad 3: Dva id elementy v žiadosti
The correct usage of ISRS Location Codes in queries and their interpretation is given in the following five cases.
Na nasledujúcom obrázku je znázornený prípad dvoch id elementov:
Case 1: No ids element in request
Platné vyhľadávanie s dvomi id parametrami
The ids element is an optional part of the request, i.e. a query without any ids elements is allowed:
Všetky vyhľadávané hodnoty hektometra sa považujú za platné aj v prípade, že zodpovedajúci úsek plavebnej dráhy má rozličné počiatočné alebo koncové body.
Valid query without ids parameter
Napríklad, ak sa úsek plavebnej dráhy začína na hektometri 100,0 a končí na hektometri 300.0, žiadosť o vyhľadávanie medzi hektometrami 20,0 až 400,0 bude platná.
If no ids element is given, all messages shall be returned (depending, of course, on other filter criteria like validity_period or dates_issue).
Samozrejme, interne sa vyhľadáva iba „reálny“ rozsah úseku plavebnej dráhy.
Case 2: One id element in request
Takýto postup tiež umožňuje vyhľadávanie všetkých správ týkajúcich sa plavebnej dráhy bez znalosti jej presného rozsahu v hektometroch (je potrebné poslať ISRS Location Code s hektometrami nastavenými na hodnoty „00000“ resp. „99999“).
Each ids element can contain one or two id elements.
Odoslané budú všetky vyhovujúce správy, ktoré zasahujú do daného intervalu hektometrov.
The case of one id element is shown in the following figure:
Takúto situáciu znázorňuje tento diagram:
Valid query with one id parameter
Vyhovujúce a nevyhovujúce správy pre dva id parametre
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.
Na uvedenom obrázku je znázornené, ako sa vymedzuje pojem „zasahovania“.
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.
Zatiaľ čo rozsah správ 1 až 4 sa prekrýva s vyhľadávaným rozsahom hektometrov (čiastočne alebo úplne), rozsah správ 5 a 6 sa neprekrýva, preto správy 1 až 4 budú odoslané a správy 5 a 6 nebudú odoslané.
Messages 2, 5 and 6 do not overlap with the query position, so they would not be returned.
Technickou podmienkou, aby správa zasahovala do intervalu [A, B], je: počiatočný hektometer správy je ≤ B a jej koncový hektometer je ≥ A.
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.
Kombinácia: Viaceré ids elementy v žiadosti
Matching and not matching messages for one id parameter
Platné vyhľadávanie s viacerými ids elementmi
Case 3: Two id elements in request
Kombinácia viacerých ids elementov v žiadosti vedie k spojeniu zodpovedajúcich správ.
The case of two id elements is shown in the following figure:
Každý ids element sa posudzuje osobitne a správa bude odoslaná, ak vyhovuje najmenej jednému z nich.
Valid query with two id parameters
Preto v uvedenom príklade by sa odoslali tieto správy:
All hectometre values queried shall be treated as valid, even if the corresponding fairway section has different start or end points.
všetky správy pre objekt s ISRS Location Code SKXXX0000010000***** s počiatočným hektometrom = 0 a koncovým hektometrom ≥ 0 (pozri prípad 2)
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.
všetky správy pre objekt s ISRS Location Code SKXXX0000500000*****, ktoré zasahujú do intervalu hektometrov [220,0, 300,0] (pozri prípad 3)
Internally, of course, only the ‘real’ extent of the fairway section is searched.
V tejto kapitole sa uvádza špecifikácia vykonávania služby NtS message service, pričom sa vychádza z predpokladov a možností voľby v predchádzajúcich kapitolách.
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 Message Service poskytuje štyri typy správ v rámci správy NtS:
All matching messages intersecting the given hectometre interval shall be returned.
NtS FTM (správa o plavebnej dráhe a doprave)
The following diagram illustrates this situation:
NtS WRM (správa o vodnom stave)
Matching and not matching messages for two id parameters
NtS ICEM (správa o ľadochode)
The figure above shows, how ‘intersecting’ is defined.
NtS WERM (správa o počasí)
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.
Vykonávanie služby NtS message service môže podporovať všetky typy správ alebo iba ich výber.
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.
Zúčastnený členský štát môže poskytovať viaceré služby pre konkrétny typ správ, ktoré sa navzájom dopĺňajú.
Valid query with multiple ids elements
Namiesto toho sa uplatňujú konštrukty, ktoré poskytuje samotná špecifikácia WSDL.
The combination of several ids elements in the request leads to a union of the corresponding messages.
Konkrétne operácie spolu s ich parametrami sa uvádzajú iba v rámci špecifikácie WSDL.
All the ids elements are treated individually and a message will be returned, if it matches at least one of them.
V prípade služby NtS Message Service je vymedzená jednotná operácia.
Therefore, the following messages would be returned for the given example:
Kritériá filtra špecifické pre daný predmet sú prevzaté zo štandardu NtS, ale sú rozšírené, pokiaľ ide o množstvo parametrov:
All messages for the object with the ISRS Location Code SKXXX0000010000***** with start hectometre =0 and end hectometre ≥ 0 (see Case 2)
typ správy (povinné, jeden z týchto typov: „FTM“, „WRM“, „ICEM“, „WERM“)
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)
konkrétne úseky vodnej cesty alebo ich časti, alebo konkrétne objekty (voliteľné, opísané jedným ISRS Location Code a/alebo pármi týchto kódov)
All messages for the object with the ISRS Location Code SKXXX0000500000***** which intersect the hectometre interval [220,0, 300,0] (see Case 3)
čas platnosti (voliteľné, dátum začiatku a dátum ukončenia)
In this chapter the implementation specification of the NtS message service is given, deduced from the considerations and choices in the preceding chapters.
dátum vydania správy (voliteľné, jednotlivé dátumy a/alebo intervaly dátumov)
The NtS message service provides the four types of messages in the NtS:
Iba správy spĺňajúce dané kritériá sa odosielajú touto službou.
NtS FTM (fairway and traffic related message)
Mechanizmus stránkovania
NtS WRM (water related message)
Mechanizmus stránkovania je podporovaný s cieľom kontrolovať množstvo údajov.
NtS ICEM (ice message)
Stránkovací parameter je určený komplexným typom obsahujúcim tieto elementy:
NtS WERM (weather related message)
offset: číslo verzie prvej odoslanej správy (celé číslo ≥ 0)
An implementation of the NtS message service can support all message types or just a selection.
limit: maximálny počet správ (číslo ≥ 0)
It is allowed that a participating Member State provides more than one service for a specific message type, that complement each other.
total count: príznak, ak sa odosiela úplný počet správ (booleovská hodnota)
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.
Komplexný stránkovací parameter je voliteľný, ale ak je aktivovaný, musia sa uviesť všetky elementy v jeho rámci.
Instead the constructs provided by WSDL itself are applied.
Stránkovací mechanizmus potom funguje takto:
The specific operations together with their parameters are specified entirely within the WSDL specification.
Celkový počet správ nepresiahne hodnotu parametra limit, s výnimkou prípadu, keď hodnota 0 znamená „žiadny limit“.
In the case of the NtS Message Service a single operation is defined.
Odpoveď preskočí toľko správ, koľko je stanovených v parametri offset.
The subject-specific filter criteria are taken from the NtS standard, but extended concerning multiplicity of the parameters:
Aby bolo možné poskytovať tento mechanizmus, služba musí sledovať dočasne stabilnú (ale inak ľubovoľnú) postupnosť správ, napríklad medzi dvomi aktualizáciami údajov v správe vo vzťahu k súboru základných údajov webovej služby.
type of message (compulsory; one of ‘FTM’, ‘WRM’, ‘ICEM’, ‘WERM’),
To znamená, že dve po sebe idúce identické žiadosti musia viesť k odoslaniu rovnakých správ v rovnakom poradí.
specific waterway sections or parts thereof, or specific objects (optional; described by single ISRS Location Codes and/or pairs of ISRS Location Codes),
Parameter total count určuje, či odpoveď poskytne celkový počet správ spĺňajúcich kritériá špecifické pre daný predmet.
time of validity (optional; start date and end date),
Spravidla by malo postačovať požiadať o túto informáciu pri prvej odpovedi a vynechať to pri všetkých nasledujúcich odpovediach.
date of publication of the notice (optional; single dates and/or intervals of dates).
Malo by to viesť k lepšiemu fungovaniu webovej služby.
Only the messages matching the given criteria are returned by the service.
Stránkovací mechanizmus poskytuje prostriedky na opakované požadovanie správ po „stránkach“.
Paging mechanism
Aby stránkovací mechanizmus riadne fungoval, v každej výzve sa musia uvádzať rovnaké parametre špecifické pre daný predmet.
In order to control the amount of data a paging mechanism is supported.
V prípade úspešnej žiadosti obsahuje odpoveď služby NtS Web Service správy NtS, ktoré spĺňajú parametre žiadosti.
The paging parameter is defined with a complex type containing the following elements:
Správy NtS musia byť v súlade so schémou NtS a môžu sa overovať podľa tejto schémy.
offset: serial number of the first returned message (integer ≥ 0),
Keďže typ správy je povinným parametrom žiadosti, každá odpoveď môže obsahovať len správy NtS toho istého typu, FTM, WRM, ICEM resp. WERM.
limit: max. number of messages (integer ≥ 0),
Ak služba zistí chyby pri spracovávaní žiadosti, môže odoslať ľubovoľný počet chybových správ s použitím kódov chýb uvedených v nasledujúcej podkapitole.
total count: flag, if total number of messages shall be returned (Boolean value).
Jedna odpoveď služby NtS Web Service môže obsahovať zároveň správy NtS aj chybové správy.
The complex paging parameter is optional, but if it is present, all elements within have to be given.
Ak žiadosť obsahovala stránkovacie parametre, môžu sa odoslať voliteľné informácie o stránkovaní.
Then, the paging mechanism works in the following way:
V tomto prípade sú offset a počet obsiahnutých správ povinné, celkový počet sa musí uviesť, iba ak sa o to požiada.
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’.
Upozornenie: Predpokladá sa, že komunikácia medzi webovou službou a používateľom je technicky zabezpečená, t. j. služba dostane žiadosť a používateľ dostane zodpovedajúcu odpoveď.
The response skips as many messages as defined in the parameter offset.
Technické chyby, napríklad prerušenie internetového spojenia alebo neprístupnosť webovej služby v dôsledku údržby alebo poruchy, sa tu neuvažujú.
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.
Uvažujú sa len chybové situácie, ktoré nastanú „za“ vrstvou webovej služby z hľadiska používateľa.
This means that two consecutive identical calls must return the same messages in the same order.
Chybové správy
The parameter total count determines whether the response shall provide the total number of messages matching the subject-specific criteria.
V nasledujúcej tabuľke sú uvedené chybové kódy pre očakávané chybové situácie, spolu s ich vysvetlením.
Usually it should be sufficient to request this information with the first response, but omit it in all consecutive responses.
V odpovedi je uvedený iba chybový kód, čo je zvyčajný postup v schéme XML správy NtS.
This should result in a better performance of the web service.
Chybové kódy služby NtS Message Service
The paging mechanism provides a means to request the messages iteratively in ‘pages’.
Ak sa bude dôsledne dodržiavať prístup „najskôr dohoda“, t. j. ak jedna alebo viaceré dohody s úplným opisom rozhraní budú vznikať vo forme dokumentov WSDL, vykonávanie služby(-ieb), ako aj zabezpečovanie zodpovedajúcich klientov môže prebiehať automaticky s použitím príslušných softvérových nástrojov.
In order for the paging mechanism to work properly, the same subject-specific parameters have to be provided in each call.
V ideálnej situácii sa nemusia robiť žiadne ručné zmeny vygenerovaného zdrojového kódu.
In case of a successful request the NtS Web Service response contains the NtS messages that match the request parameters.
Vo väčšine prípadov sú však potrebné viaceré opakovania, kým špecifikácie dokumentu WSDL splnia presné požiadavky takého nástroja.
The NtS messages have to comply with the NtS schema and can be validated against that schema.
Tento nástroj spravidla vytvára jednotlivé požiadavky na používanie štandardu WSDL s cieľom zabezpečiť hladkú prevádzku systému.
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.
V dôsledku toho môžu byť potrebné zmeny špecifikácie dokumentu WSDL, aj keď špecifikácia WSDL bola v prvom rade platnou špecifikáciou podľa štandardu WSDL.
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.
Ak sa špecifikácia WSDL webovej služby zmení po vygenerovaní služby alebo klienta, môže byť potrebný nový postup vytvárania, v závislosti od vykonaných zmien.
One response of an NtS Web Service can contain NtS messages and error messages at the same time.
Pojem
Optional paging information is returned if the request contained paging parameters.
Vysvetlenie
In this case the offset and number of contained messages are mandatory, the total count needs only be present if it has been requested.
Identifikácia
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.
Jednoduchý protokol na prístup k objektom; sieťový protokol spravidla používaný na webové služby
Technical errors, e.g. breakdown of the internet connection or inaccessibility of the web service due to maintenance or crash, are not considered here.
Univerzálny opis, zistenie a integrácia; norma pre služby registrácie v kontexte webových služieb
Only error situations that happen ‘behind’ the web service layer from the users point of view are considered here.
Organizácia Spojených národov
Error messages
Jednotný lokátor zdroja; lokalizácia sieťového zdroja typicky používaná na internetové adresy
The error codes for the expected error situations are given below, together with an explanation.
Svetový geodetický systém 1984
Only the error code is contained in the response, which is the usual procedure in the XML schema of the NtS.
Webová služba; služba, ktorá poskytuje svoje rozhrania na internete a používa sa na internetovú komunikáciu
Error codes for the NtS message service
Jazyk na opis webových služieb; norma pre špecifikáciu webových služieb
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.
Organizácia pre interoperabilitu webových služieb; priemyselné konzorcium s cieľom podporovať interoperabilitu webových služieb
In an ideal situation no manual changes have to be made in the generated source code.
Rozšíriteľný značkový jazyk; metajazyk pre štruktúrované a od platformy nezávislé zobrazovanie údajov
However, in most cases several iterations are necessary until the WSDL specification meets the precise requirements of such a tool.
schéma XML; norma pre špecifikáciu štruktúry dokumentov XML
Typically the tool makes individual demands on the use of the WSDL standard in order to work smoothly.
Opis citovaný z webového sídla WS-I: http://www.ws-i.org.
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.
Aby mohli členské štáty zakódovať plavebné správy pre veliteľov lodí konzistentným a interoperabilným spôsobom, mali by sa aktualizovať referenčné tabuľky uvedené v dodatku E. Na tento účel by sa mali vymedziť nové kódy v novej referenčnej tabuľke, ktorá bude obsahovať harmonizované značky vo vyhľadávacom rozhraní pre grafické používateľské rozhranie.