natgillin/translations-raw huggingface dataset:
Also the feasibility of a certain measure can be limited by the capabilities of the technical implementation.
Az NtS Web Service-hez a document/literal wrapped kódolási módszert kell alkalmazni, mivel lehetővé teszi az XML sémának megfelelő validálást, és a WSDL előírásban meghatározott műveletneveket közvetlenül XML címkenevekként használják a SOAP üzenetekben.
In the context of NtS all information are public.
Az NtS Web Service-re vonatkozó verzióadatok két szakaszból állnak:
So there is no need to secure the NtS data themselves in terms of data protection.
magának a webszolgáltatásnak a verziója
Therefore every provider has to decide on its own in how far this aspect will be implemented in its service.
a webszolgáltatás által használt NtS séma verziója
The NtS Web Service has to comply with the WS-I Basic Profile 1.1.
Magának a webszolgáltatásnak a verziója két részt foglal magában:
This profile ‘provides interoperability guidance for a core set of non-proprietary web services specifications, such as SOAP, WSDL and UDDI’.
a webszolgáltatás főverziója
The most relevant standards herein are
a webszolgáltatás alverziója
Web Services Description Language (WSDL), and
A főverzió pozitív egész szám, amely a webszolgáltatás főverzióját jelöli.
The response message of the NtS WS is an NtS message which is defined in XML Schema Definition (XSD) in Appendix C of this Commission Regulation.
Az alverzió nemnegatív egész szám, amely a webszolgáltatás főverzión belüli alverzióját jelöli.
SOAP is an application protocol for data transmission among IT-Systems and is standardised by the World Wide Web Consortiums (W3C).
Az NtS séma szakasza az NtS séma NtS szakértőcsoport által meghatározott verzióját tartalmazza.
The specific elements for the NtS Web Service are defined inline in the corresponding WSDL specifications in Appendix D of this Commission Regulation.
Így az NtS Web Service itt meghatározott verziója 2.0.4.0, ahol a 2.0 magának a webszolgáltatásnak a verziója, a 4.0 pedig az alkalmazott NtS séma verziója.
The schema of the NtS standard (XSD) is included with an import statement.
Az NtS Web Service kéréseiben vagy válaszaiban nem szükséges kifejezett verzióinformációt megadni.
UDDI (Universal Description, Discovery and Integration) is noted here as a central, possibly international registry for web services, where the NtS Web Service could be registered.
A szolgáltatásoknak várhatóan csak néhány verziója áll rendelkezésre egyidejűleg online.
In this registry potential consumers of the web service could search and find the service.
A különböző verziókat különböző URL-ekkel látják el.
But since the potential providers of the NtS Web Service are limited by the participating Member States and the WSDL specification is an integral part of the standard, the need for an independent registration of the NtS Web Service is not apparent.
Ezért az NtS Web Service implementációjának minden előfordulása az NtS Web Service egy konkrét verzióját támogatja.
The encoding method Document-literal wrapped is used for the NtS Web Service, because it allows for validation against an XML schema and the operation names defined in the WSDL specification are used directly as XML tag names in the SOAP messages.
Az NtS Web Service-ben a névtartományok a RIS szakértői csoport webdoménjén alapulnak, http://www.ris.eu/.
The version information of the NtS Web Service consists of two sections:
A névtartományok a megfelelő szolgáltatásra és a verzióadatokra utaló elemet tartalmaznak.
version of the web service itself,
Így az itt meghatározott szolgáltatás a következő névtartományt használja:
version of the NtS schema used by the web service.
NtS üzenetszolgáltatás: http://www.ris.eu/nts.ms/2.0.4.0
The section of the web service itself consists of two parts:
Az XML dokumentumok nagyobb átláthatósága érdekében ajánlott a névtartományokat a sémák vagy példánydokumentumok legkülső elemeiben meghatározni, és nem használni helyi névtartomány-meghatározásokat a beágyazott elemekben.
major version of the web service,
Az NtS Web Service-ben a kérések és válaszok az XML elemeket minősített formában használják, azaz kifejezett névtartomány-előtaggal, az XML attribútumokat pedig nem minősített formában, azaz névtartomány-előtag nélkül.
minor version of the web service.
Ajánlott intuitív névtartomány-előtagokat használni, mint az nts, a jobb emberi olvashatóság érdekében.
The major version is given as a positive integer denoting the major version of the web service.
Az ISRS Location Code-okat az alkalmazásfejlesztőknek szóló NtS Encoding Guide 2. fejezete, valamint a RIS Index Encoding Guide fejti ki.
The minor version is given as a non-negative integer denoting the minor version of the web service within the major version.
Az NtS Web Service lekérdezésekor az ügyfél különféle objektumokra hivatkozhat, pl. hajóútszakaszokra, mércékre vagy zsilipekre.
The section of the NtS schema contains the version of the NtS schema as defined by the NtS Expert Group.
Ha a megfelelő paramétereket, „id element”-eket használnak, ezeknek ISRS Location Code-ot kell tartalmazniuk.
Hence, the version of the NtS Web Service specified here is 2.0.4.0, where 2.0 is the version of the web service itself and 4.0 is the version of the NtS schema used.
E paramétereket szokásosan id elementben adják meg, amelyek mindegyike egy vagy két azonosítót tartalmaz.
Explicit version information is not necessary in the requests or responses of the NtS Web Service.
E paraméterek alkalmazásakor a következő általános szokásokat kell követni:
There are only a few versions of the services expected to be online at the same time.
Az ISRS Location Code-okat teljes hosszúságú húszjegyű kódokként kell megadni, azaz a legkisebb helyiértéken található nulla elhagyása nélkül.
Different versions shall be provided with different URLs.
Ha egy id elementen belül két azonosítót használnak, mindkét ISRS Location Code-nak ugyanarra a vízi útra kell vonatkoznia.
Hence, each instance of an NtS Web Service implementation shall support one specific version of the NtS Web Service.
Ez azt jelenti, hogy a kódok tartalmaznak néhány azonos számjegyet is az ISRS Location Code fairway_section részében.
The namespaces in the NtS Web Service are based on the web domain of the RIS Expert Groups, http://www.ris.eu/
A hajóútszakasz kódja a hajóútszakasz hektométerével együtt meghatározza a vízi út szakaszát, amelyet id element párként adnak meg.
The namespaces contain a particle indicating the corresponding service and version information.
A víziút-szakaszok NtS üzenetekben történő megadásához (azonosítóelem-párok a fairway_section geo_objectben), a következőt kell szem előtt tartani az ISRS Location Code-ok tekintetében:
Hence, the service specified here uses the following namespace:
1–2. jegy (Country code):
NtS Message Service: http://www.ris.eu/nts.ms/2.0.4.0
azonosnak kell lennie az azonosítópáron belül, de
For higher transparency of XML documents it is recommended to define namespaces in the outmost suitable element in the schemas as well as the instance documents and not to use local namespace definitions in nested elements.
különböző országkódok határozhatók meg egy azonosítópáron belül, ha szomszédos országok ugyanazt a hajóútszakaszkódot használják az adott vízi útra, és ugyanazt a rendszert a hektométerek meghatározására,
Requests and responses in the NtS Web Service shall use XML elements in qualified form, i.e. with an explicit namespace prefix, and XML attributes in unqualified form, i.e. without a namespace prefix.
3–5. jegy (UN Location code):
It is recommended to use intuitive namespace prefixes like ‘nts’ for better human readability.
nem releváns, különböző tartalmú lehet az azonosítópáron belül,
The ISRS Location Code is explained in chapter 2 of the NtS Encoding Guide for application developers as well as the RIS Index Encoding Guide.
6–10. jegy (Fairway section code):
Querying an NtS Web Service, the client can reference various objects, e.g. fairway sections, gauges or locks.
[kivétel]: ha belga ISRS kódokat használnak az NtS WS-en belül, csak a 6–8. számjegyet szabad használni a hajóútszakasz azonosítására, mivel az NtS üzeneteket egyetlen hajóúton belül különböző szakaszok mentén is közzéteszik,
If the corresponding parameters, the id elements, are used, they must contain ISRS Location Codes.
11–15. számjegy (Object Reference code):
These parameters are typically given in id elements, each containing one or two ids.
16–20. számjegy (Fairway Hectometre):
When using these parameters, the following general conventions have to be observed:
A hektométert meghatározó öt számjegyből áll, így általában különböző tartalommal rendelkezik az azonosítópáron belül.
ISRS Location Codes have to be submitted as full-length 20-character codes, i.e. without truncating trailing zeros,
Példa: „00235” a 23,5 hajóút km tekintetében; „00001” a 0,1 hajóút km tekintetében,
If two ids are used within an id element, both ISRS Location Codes have to refer to the same waterway.
[kivétel]: Hollandia esetében nem mindig van közvetlen kapcsolat a hajóút hektométere és a hajóút tényleges kilométere között, a hajóútszakasz kezdetének a hálózati modellben és a valóságban történő meghatározása miatt, ilyen esetekben a „dismar” típusú objektumok objektumvonatkoztatási kódja Kxxxx-szel kezdődik (xxxx a fizikai kilométer, pl. NLSVG00130K000300191 (km 3)).
This means, that the codes include some identical digits located in the fairway_section part of the ISRS Location Code.
A többi objektum tekintetében ugyanakkor nincs közvetlen kapcsolódás az ISRS kódban szereplő fizikai hajóút km-hez, pl. a Sas van Gent híd ISRS kódja ugyanazon a hajóúton 2,5 km-nél NLSVG001300521600186.
The fairway section code together with the fairway hectometre defines a waterway stretch provided as pair of id elements.
A Kanaal Gent-Terneuzen esetében a fizikai 0,0 km a belga–holland határnál kezdődik, a hajóút 0,0 hektométere a csatorna genti bejáratánál.
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:
Ha az üzenet egynél több víziút- vagy hajóútszakaszt érint, minden hajóútszakaszt a kezdő és végpontja határoz meg különálló „fairway_section” XML elemben.
digits 1 to 2 (Country code):
Egyes országok/régiók tekintetében szűrő funkciót kell kialakítani.
have to be identical within the id pair, but
Ha például az ISRS Location Code 1–2. jegye BE, az ISRS Location Code 6–8. jegyét a hajóút hektométeréhez (ISRS Location Code, 16–20. jegy) való lineáris vonatkoztatás azonosítójaként kell használni.
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,
Példa olyan hajóútszakaszokra (érvényes azonosítóelem-párok a fairway_sectionben), amelyek a fent meghatározott kivételeket tartalmazzák:
digits 3 to 5 (UN Location code):
A két NL ISRS Location Code érvényesen határozza meg a víziút-szakaszt (és mutatja a Hollandiára vonatkozó kivételt a hajóút kilométere vonatkozásában): NLSVG00130K000300191 (3,0 km Sas van Gentnél a Kanaal Gent-Terneuzenen) – NLWDP00130K000400200 (4,0 km Westdorpe-nél a Kanaal Gent-Terneuzenen),
are not relevant, may contain different content within the id pair,
A két BE ISRS Location Code érvényesen határozza meg a víziút-szakaszt (és mutatja a Belgiumra vonatkozó kivételt a hajóútszakasz kódjára vonatkozóan („020” Albertkanaal)): BEGNK02016L010100414 (genki zsilip, az Albert-csatorna 41,4 km-énél) – BEOSH02033L010500772 (hami zsilip az Albert-csatorna 77,2 km-énél).
digits 6 to 10 (Fairway section code):
Az alábbi ábra az ISRS Location Code használatára mutat ellenpéldákat az általános szokások mindegyike tekintetében (az SK víziút-szakaszok tekintetében nincsenek az általános szokások alóli kivételek):
[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,
Érvénytelen ISRS Location Code lekérdezések
digits 11 to 15 (Object Reference Code).
Általános megjegyzés: Az érvényes ISRS Location Code-ra történő lekérdezési szolgáltatást az NtS Web Service nem támogatja.
digits 16 to 20 (Fairway Hectometre):
Az ISRS Location Code-okat az európai referenciaadat-kezelő rendszer (ERDMS) biztosítja.
consist of five numerical digits defining the hectometre thus will usually contain different content within the id pair.
Az ISRS Location Code-ok helyes használata a lekérdezésekben és értelmezésük az alábbi öt esetben szerepel.
Example: ‘00235’ for fairway km 23,5; ‘00001’ for fairway km 0,1,
eset: A kérésben nem szerepel azonosítóelem
[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)).
Az azonosítóelemek a kérés opcionális részei, azaz lehetőség van azonosítóelem nélküli lekérdezésre.
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.
Érvényes lekérdezés azonosítóparaméter nélkül
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.
Ha nincs megadva azonosítóelem, minden üzenetet átküldenek (természetesen más szűrési kritériumok függvényében, mint a validity_period vagy a dates_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.
eset: A kérésben egy azonosítóelem szerepel
For some countries/regions it is required to build filter functionality.
Minden azonosítóelem egy vagy több azonosítóelemet tartalmazhat.
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).
Az egy azonosítóelemre az alábbi ábra szolgáltat példát:
Examples for fairway stretches (valid id element pairs within the fairway_section) that include above defined exceptions:
Érvényes lekérdezés egy azonosítóparaméterrel
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),
Ha ilyen lekérdezés érkezik, a szerver minden ehhez tartozó üzenetet átküld, amelyben a kezdő hektométer ≤ az adott értékhez képest (240,7 a példában) és a záró hektométer ≥ mint ez az érték.
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).
Az alábbi ábra jeleníti meg az üzenetek e választékát: A lekérdezett pozíció az 1., 3. és 4. üzenet esetében a kezdő és a záró hektométerérték között van, ezeket átküldik.
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):
A 2., 5. és 6. üzenetek nincsenek átfedésben a lekérdezett pozícióval, így azokat nem küldik át.
Invalid ISRS Location Code queries
Ha az adott ISRS Location Code egyetlen objektumot, pl. mércét vagy zsilipet jelöl, a webszolgáltatásnak át kell küldenie az ezen objektumot érintő üzeneteket.
General remark: A service to query valid ISRS Location Codes is not supported by the NtS Web Service.
Megfelelő és meg nem felelő üzenetek egy azonosítóparaméter esetén
The ISRS Location Codes are provided within the European Reference Data Management System (ERDMS).
eset: A kérésben két azonosítóelem szerepel
The correct usage of ISRS Location Codes in queries and their interpretation is given in the following five cases.
A két azonosítóelemre az alábbi ábra szolgáltat példát:
Case 1: No ids element in request
Érvényes lekérdezés két azonosítóparaméterrel
The ids element is an optional part of the request, i.e. a query without any ids elements is allowed:
Valamennyi hektométerértéket érvényesként kell kezelni, akkor is, ha a megfelelő hajóútszakasznak más a kezdő- vagy a végpontja.
Valid query without ids parameter
Ha például a hajóútszakasz a 100,0 hektométernél kezdődik és a 300,0 hektométernél ér véget, a 20,0 és a 400,0 közötti hektométereket lekérdező kérések érvényesek.
If no ids element is given, all messages shall be returned (depending, of course, on other filter criteria like validity_period or dates_issue).
A rendszeren belül természetesen csak a hajóútszakasz „valódi” terjedelmére keresnek.
Case 2: One id element in request
Ezzel keresni lehet egy adott hajóútra vonatkozó minden üzenet akkor is, ha a pontos hektométer-tartomány nem ismert (ekkor az ISRS Location Code-ot „00000”, illetve „99999” hektométerre beállítva kell megadni).
Each ids element can contain one or two id elements.
Valamennyi, az adott hektométer-intervallumot keresztező, megfelelő üzenetet át kell küldeni.
The case of one id element is shown in the following figure:
A következő ábra mutatja be ezt a helyzetet:
Valid query with one id parameter
Megfelelő és meg nem felelő üzenetek két azonosítóparaméter esetén
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.
A fenti ábra mutatja, hogy a „keresztező” üzenetet miként határozzák meg.
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.
Noha az 1–4. üzenetek tartománya átfedésben van a lekérdezett hektométer-tartománnyal (részben vagy teljesen), az 5. és 6. üzeneté nincs, így az 1–4. üzenetet át kell küldeni, az 5. és 6. üzenetet pedig nem.
Messages 2, 5 and 6 do not overlap with the query position, so they would not be returned.
Annak gyakorlati feltételei, hogy az üzenet keresztezze [A, B] intervallumot: az üzenet kezdő hektométere ≤ B és záró hektométere ≥ 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áció: A kérésben több azonosítóelem szerepel
Matching and not matching messages for one id parameter
Érvényes lekérdezés több azonosítóelem mellett
Case 3: Two id elements in request
Ha a kérésben több azonosítóelem szerepel, az a megfelelő üzenetek egyesítését eredményezi.
The case of two id elements is shown in the following figure:
Minden azonosítóelemet egyenként kezelnek és az üzenetet átküldik, ha az legalább ezek egyikének megfelel.
Valid query with two id parameters
Így az adott példa tekintetében a következő üzeneteket küldik át:
All hectometre values queried shall be treated as valid, even if the corresponding fairway section has different start or end points.
Valamennyi üzenetet azon objektum tekintetében, amelynek ISRS Location Code-ja SKXXX0000010000*****, a kezdő hektométer =0 és a záró hektométer ≥ 0 (lásd 2. eset)
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.
Valamennyi üzenetet azon objektum tekintetében, amelynek ISRS Location Code-ja SKXXX00005000000*****, és amely a [220,0, 300,0] hektométer-intervallumba esik (lásd 3. eset)
Internally, of course, only the ‘real’ extent of the fairway section is searched.
Ez a fejezet ismerteti az NtS üzenetszolgáltatás megvalósítási előírásait, amelyek az előző fejezetek megfontolásaiból és választásaiból következnek.
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).
Az NtS üzenetszolgáltatás a következő négy üzenettípust kínálja az NtS-ben:
All matching messages intersecting the given hectometre interval shall be returned.
NtS FTM (a hajóútra és a forgalomra vonatkozó üzenet)
The following diagram illustrates this situation:
NtS WRM (vízállásjelentés)
Matching and not matching messages for two id parameters
NtS ICEM (jégjelentés)
The figure above shows, how ‘intersecting’ is defined.
NtS WERM (időjárás-jelentés)
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.
Az NtS üzenetszolgáltatás megvalósítása támogathatja valamennyi üzenettípust, vagy csak azok adott választékát.
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.
Lehetőség van arra, hogy a részt vevő tagállam egynél több szolgáltatást kínáljon egy adott üzenettípus vonatkozásában, amely szolgáltatások kiegészítik egymást.
Valid query with multiple ids elements
Ehelyett a maga a WSDL által biztosított konstrukciókat alkalmazza.
The combination of several ids elements in the request leads to a union of the corresponding messages.
A konkrét műveleteket és paramétereiket teljes egészében a WSDL előíráson belül határozzák meg.
All the ids elements are treated individually and a message will be returned, if it matches at least one of them.
Az NtS üzenetszolgáltatás esetében egyetlen műveletet definiálnak.
Therefore, the following messages would be returned for the given example:
A tárgyspecifikus szűrési kritériumok az NtS szabványból származnak, de kiterjesztve a paraméterek sokaságára:
All messages for the object with the ISRS Location Code SKXXX0000010000***** with start hectometre =0 and end hectometre ≥ 0 (see Case 2)
üzenettípus, (kötelező; az „FTM”, „WRM”, „ICEM”, „WERM” egyike)
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ét víziút-szakaszok vagy azok egy része, vagy konkrét objektumok (opcionális; egyetlen ISRS Location Code-dal és/vagy ISRS Location Code párokkal leírva)
All messages for the object with the ISRS Location Code SKXXX0000500000***** which intersect the hectometre interval [220,0, 300,0] (see Case 3)
érvényességi idő (opcionális, kezdőnap, zárónap)
In this chapter the implementation specification of the NtS message service is given, deduced from the considerations and choices in the preceding chapters.
a hirdetmény közzétételének napja (opcionális; egyedi napok vagy intervallumok)
The NtS message service provides the four types of messages in the NtS:
A szolgáltatás csak az adott kritériumoknak megfelelő üzeneteket küldi át.
NtS FTM (fairway and traffic related message)
Tördelési mechanizmus
NtS WRM (water related message)
Az adatok mennyiségének kontrollálása érdekében támogatott a tördelési mechanizmus.
NtS ICEM (ice message)
A tördelési paramétert az alábbi elemeket tartalmazó összetett típussal határozzák meg:
NtS WERM (weather related message)
offset: az első átküldött üzenet sorozatszáma (integer ≥ 0)
An implementation of the NtS message service can support all message types or just a selection.
limit: az üzenetek maximális száma (integer ≥ 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: jelző, ha az üzenetek teljes számát át kell küldeni (Boolean érték)