natgillin/translations-raw huggingface dataset:
The position of objects is encoded via position code and added to the object by the NtS application out of the RIS Index.
Sen sijaan, että luotaisiin eri rajoitusjaksot jokaista aikavyöhykkeen vaihtumista varten, käytetään vain yhtä rajoitusjaksoa ilman aikavyöhyketietoja, jotta vähennetään viestien käsittelyyn ja lähettämiseen liittyvää ylimääräistä työtä.
Editors may change prefilled type and position codes.
Yleissäännön mukaan sekunnit on ilmoitettava (päivä)/aika-kentissä, mutta niitä ei näytetä NtS-käyttäjille.
An object position code shall not be provided for geo_objects in the fairway_section.
Minuutit riittävät NtS-ilmoitusten tarkkuuden takaamiseen.
A full object name is composed of its position code, type code and name.
Tuhaterotinta ei käytetä.
To ease the work of NtS editors the following mapping may be implemented in NtS editor tools supporting editors in finding / selecting the proper objects based on the RIS Index function_code or the NtS type_code:
Arvoista käytettävien desimaalien määrää on rajoitettava siten, että varmistetaan viestien näyttäminen käyttäjäystävällisellä tavalla.
Table 1
NtS-viesteissä yksikköinä voidaan käyttää vain seuraavia: cm, m3/s, h, km/h ja kW, m/s (tuuli), mm/h (sade) ja celsiusaste.
Matching ‘RIS Index function_code’ — ‘NtS type_code’
Sovelluksissa yksiköt voidaan muuntaa käyttäjäystävälliseen muotoon.
/ G.4.4 Lock Area [C_AGGR()]
Jos syötettävät yksiköt eroavat vakiomuotoisista yksiköistä, syötetyt arvot on muunnettava sovelluksessa vastaavasti.
To avoid application logic / necessity of proper reference data at the receiving system (software displaying the notice to the user) the optional element ‘fairway_name’ shall always be included in the ‘geo_object’ and automatically filled by the NtS application with the ‘Waterway name’ from the RIS Index.
”name”-elementti esitäytetään automaattisesti ”national object name”-elementtiä koskevilla RIS Indexin viitetiedoilla (NtS-käsittelijät voivat muuttaa esitäytettyä nimeä, jos sitä vaaditaan kansallisissa säännöksissä).
NtS editors shall not alter the content of the element fairway_name.
Kohteiden nimiä koskevat nimeämiskäytännöt sisältyvät RIS Index Encoding Guide -ohjeen versioon 2.0 tai sitä uudempiin versioihin.
The following definition shall be used for reference_code values provided in the NtS Reference Tables:
Esimerkkejä asianmukaisista kohteiden nimistä annetaan myös käsittelijöille tarkoitetussa NtS Encoding Guide -ohjeessa.
NAP: In the Netherlands the abbreviation NAP is used and understood, NAP is not translated
Tyyppikoodi lisätään NtS-sovelluksessa kohteen nimen edelle.
KP: ‘channel level’ shall be translated thus provided in national language
Kohteiden sijainti koodataan käyttämällä sijaintikoodia, ja se lisätään kohteeseen NtS-sovelluksessa RIS Indexistä.
FZP: only the abbreviation ‘FZP’ shall be used (nowadays hardly used anymore)
Käsittelijät voivat muuttaa esitäytettyjä tyyppi- ja sijaintikoodeja.
ADR: ‘Adriatic Sea’ shall be translated thus provided in national language
Kohteen sijaintikoodia ei merkitä fairway_section-osioon sisältyvistä geo_objects-kohteista.
TAW/DNG: ‘Tweede algemene waterpassing’ (Dutch) — ‘Deuzième Nivellement Général’ (French) is the reference height used in Belgium to express height measurements.
Kohteen täydellinen nimi koostuu seuraavista: position code, type code ja name.
0 is the average sea water level at low water in Oostende
NtS-käsittelijöiden työn helpottamiseksi NtS-muokkausvälineissä voidaan käyttää seuraavaa kartoitusta, joka auttaa käsittelijöitä heidän etsiessään/valitessaan asianmukaisia kohteita RIS Index function_code -koodin tai NtS type_code -koodin avulla:
Dutch: TAW
Taulukko1
French: DNG
”RIS Index function_code” – ”NtS type_code” -koodien vastaavuus
All other Languages: TAW/DNG
/ G.4.4 Lock Area [C_AGGR()]
LDC: ‘low navigable water level Danube Commission’ shall be translated thus provided in national language
Jotta vältetään sovelluslogiikka / tarve asianmukaisille viitetiedoille vastaanottavassa järjestelmässä (ohjelmisto näyttää ilmoituksen käyttäjälle), valinnainen ”fairway_name”-elementti on aina sisällytettävä ”geo_object”-kohteeseen.
HDC: ‘high navigable water level Danube Commission’ shall be translated thus provided in national language
NtS-sovelluksessa tähän elementtiin täytetään automaattisesti RIS Indexistä saatava ”Waterway name” (vesiväylän nimi).
ETRS: ‘European Terrestrial Reference System 1989’ the abbreviation ‘ETRS89’ is used in all languages.
NtS-käsittelijät eivät saa muuttaa ”fairway_name”-elementin sisältöä.
Although the element coordinate within the geo object section is conditional, the geo coordinates shall be given in WGS84 in format [d]d mm.mmm[m] N (latitude) and [d][d]d mm.mmm[m] E (longitude).
NtS Reference Table -taulukoissa esitettävistä reference_code-arvoista on käytettävä seuraavia määritelmiä:
This is to refer the NtS messages geographically.
NAP: NAP-lyhennettä käytetään ja se ymmärretään Alankomaissa, NAP-lyhennettä ei käännetä
The target group section consists of target group code and direction code.
KP: ”channel level” käännetään maan omalla kielellä käytettävään muotoon
If both have the value ALL the whole section shall be omitted if there are no other specific target groups within the message.
FZP: käytetään vain lyhennettä ”FZP” (sitä käytetään nykyään enää hyvin harvoin)
If just one of these two is given the other must be filled with the default value ALL because both elements are mandatory.
ADR: ”Adriatic Sea” käännetään maan omalla kielellä käytettävään muotoon
Further information concerning target groups can be found in the NtS Encoding Guide for editors.
TAW/DNG: ”Tweede algemene waterpassing” (hollanniksi) – ”Deuzième Nivellement Général” (ranskaksi) on viitekorkeus, jota käytetään Belgiassa ilmaisemaan korkeusmittoja.
The validity_period shall be used by applications to select the messages, which are to be displayed to users for a requested time.
0 on merenpinnan keskikorkeus matalan veden aikaan Oostendessä
If subject_code is INFSER (Info service) the validity period is used to specify the time the Info service Message is displayed to the users, not for the period of validity of the provided information (e.g. 1 month).
hollanniksi: TAW
The following functions may be offered to NtS editors depending on national requirements:
ranskaksi: DNG
NtS applications may offer NtS editors to save draft NtS messages (not all mandatory content has to be provided in order to save draft messages)
kaikilla muilla kielillä: TAW/DNG
Different user roles may apply to different editors (e.g. editors that are allowed to enter/alter notices, publishers that are allowed to publish notices (in addition to editing)
LDC: ”low navigable water level Danube Commission” käännetään maan omalla kielellä käytettävään muotoon
The NtS XML Message Structure and the content and purpose of data elements are defined and further explained in Appendix C: NtS XML Schema Definition (XSD).
HDC: ”high navigable water level Danube Commission” käännetään maan omalla kielellä käytettävään muotoon
The NtS Expert Group identified the web service technology as an appropriate means to provide the Notices to Skippers.
ETRS: käsitteestä ”European Terrestrial Reference System 1989” käytetään kaikilla kielillä lyhennettä ”ETRS89”
This chapter constitutes the specification of the web service for the provision of the Notices to Skippers, short NtS Web Service.
Vaikka vesiväylän tai kohteen maantieteellisiin tietoihin (geo_object) sisältyvä ”coordinate”-elementti on valinnainen, maantieteelliset koordinaatit esitetään WGS84-muodossa [d]d mm.mmm[m] N (latitude) and [d][d]d mm.mmm[m] E (longitude).
Particular emphasis was placed on the use of well-established international standards.
Koordinaattien avulla NtS-viestit kohdennetaan maantieteellisesti.
One goal of the conceptual design was to ensure a good balance between flexibility and robustness of the resulting web service.
Kohderyhmä-osio koostuu kohderyhmäkoodista ja liikenteen suunnan koodista.
The filter parameters provided in the requests are essentially the criteria specified in the NtS standard (waterway section with optional river km, time of validity, date of publication of the notice).
Jos molempien arvona on ALL, koko osio on jätettävä pois, ellei viestillä ole muita kohderyhmiä.
This seems sufficiently expressive considering the use cases of the web service and at the same time limits the complexity of the implementation.
Jos vain toinen näistä kahdesta ilmoitetaan, toiseen on täytettävä oletusarvoksi ALL, koska molemmat elementit ovat pakollisia.
The core result is a contract for the web service, in which the requests and responses are specified.
Lisätietoa kohderyhmistä on käsittelijöille tarkoitetussa NtS Encoding Guide -ohjeeessa.
The consumers of the web service can rely on this contract and the providers have to comply with it.
Sovelluksissa on käytettävä validity_period-elementtiä valittaessa viestejä, jotka näytetään käyttäjille pyydetyn keston ajan.
This contract is specified using the international standard WSDL.
Jos subject_code on INFSER (Tietopalvelu), voimassaoloajan avulla määritetään ajanjakso, jona Tietopalvelu-viesti näytetään käyttäjille, eikä annettujen tietojen voimassaoloaikaa (esim. 1 kuukausi).
Every participating Member State shall implement one or more web services for the different message types of the NtS (FTM, WRM, ICEM, WERM) and provide them via the internet (‘NtS Message Service’),
NtS-käsittelijöille voidaan tarjota seuraavia toimintoja sen mukaan, mitä kansallisissa vaatimuksissa määrätään:
The technical details of the implementation of the NtS WS, e.g. choice of appropriate data pools, applications and platforms, are not in the scope of this specification and are in the responsibility of each individual participating Member State.
NtS-sovelluksissa voidaan tarjota NtS-käsittelijöille mahdollisuus tallentaa NtS-viestien luonnoksia (kaikkea pakollista sisältöä ei tarvitse antaa viestiluonnosten tallentamiseksi).
In order to define a secure communication one has to consider various security aspects and protection objectives.
Eri käsittelijöihin voidaan soveltaa eri käyttäjärooleja (esim. käsittelijät, jotka voivat syöttää/muuttaa ilmoituksia, ja julkaisijat, jotka voivat julkaista ilmoituksia (käsittelyn lisäksi).
Depending on the circumstances not all of these aspects have to be considered.
NtS XML -viestin rakenne sekä tietoelementtien sisältö ja tarkoitus määritellään ja niitä selvennetään lisäyksessä C: NtS XML -kaavio (NtS XML Schema Definition, XSD).
The priority of the various security aspects and the degree of their fulfilment can vary.
NtS-asiantuntijaryhmä määritti web service -teknologian tarkoituksenmukaiseksi tavaksi laatia laivureille tarkoitetut ilmoitukset.
Also the feasibility of a certain measure can be limited by the capabilities of the technical implementation.
Tässä luvussa määritetään laivureille tarkoitettujen ilmoitusten laatimiseen käytettävä web service -palvelu, jäljempänä ”NtS Web Service”.
In the context of NtS all information are public.
Erityistä huomiota on kiinnitetty vakiintuneiden kansainvälisten standardien käyttämiseen.
So there is no need to secure the NtS data themselves in terms of data protection.
Yksi konseptoinnin tavoite oli varmistaa verkkopalvelun joustavuuden ja häiriönsietokyvyn välinen hyvä tasapaino.
Therefore every provider has to decide on its own in how far this aspect will be implemented in its service.
Pyynnöissä käytettävät suodatinparametrit ovat lähinnä NtS-standardissa määritettyjä kriteerejä (väyläosio ja valinnainen jokikilometrimäärä, voimassaoloaika, ilmoituksen julkaisupäivä).
The most relevant standards herein are
Verkkopalvelun käyttäjät voivat vedota tähän sopimukseen, ja palveluntarjoajien on noudatettava sitä.
Web Services Description Language (WSDL), and
Sopimuksen määrittelyssä käytetään kansainvälistä WSDL-standardia.
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.
Jokainen osallistuva jäsenvaltio ottaa käyttöön yhden tai useamman web service -palvelun erilaisia NtS-viestityyppejä varten (FTM, WRM, ICEM, WERM) ja tarjoaa niitä internetissä (jäljempänä ”NtS-viestipalvelu”).
SOAP is an application protocol for data transmission among IT-Systems and is standardised by the World Wide Web Consortiums (W3C).
NtS WS -palvelun käyttöönoton tekniset yksityiskohdat, esimerkiksi asianmukaisten tietovarantojen, sovellusten ja alustojen valinta, eivät kuulu tämän eritelmän piiriin, ja ne ovat jokaisen yksittäisen osallistuvan jäsenvaltion vastuulla.
The specific elements for the NtS Web Service are defined inline in the corresponding WSDL specifications in Appendix D of this Commission Regulation.
Turvallisen viestinnän määrittelemiseksi on otettava huomioon useita eri turvallisuusnäkökohtia ja suojelutavoitteita.
The schema of the NtS standard (XSD) is included with an import statement.
Kaikkia näitä näkökohtia ei ole tarpeen tarkastella tilanteesta riippuen.
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.
Eri turvallisuusnäkökohtien tärkeys ja se, missä määrin ne toteutuvat, voivat vaihdella.
In this registry potential consumers of the web service could search and find the service.
Tekniset käyttöönottovalmiudet voivat myös rajoittaa tietyn toimenpiteen käyttökelpoisuutta.
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.
NtS-ilmoitusten yhteydessä kaikki tiedot ovat julkisia.
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.
NtS-dataa itsessään ei siten ole tarpeen turvata tietosuojan kannalta.
The version information of the NtS Web Service consists of two sections:
Jokaisen palveluntarjoajan on siten päätettävä itse, miten laajasti tämä näkökohta toteutuu sen palvelussa.
version of the web service itself,
NtS Web Service -palvelun on oltava WS-I Basic Profile 1.1 -suosituksen mukainen.
version of the NtS schema used by the web service.
Tämä suositus ”sisältää yhteentoimivuuteen liittyviä ohjeita keskeisiä avoimen teknologian web service -spesifikaatioita, kuten SOAP, WSDL ja UDDI, varten”.
The section of the web service itself consists of two parts:
Tärkeimmät standardit tässä yhteydessä ovat
major version of the web service,
Web Services Description Language (WSDL) ja
minor version of the web service.
NtS WS -palvelun vastausviesti on NtS-viesti, joka määritellään tämän komission asetuksen lisäyksessä C olevassa XML-kaaviossa (XSD).
The major version is given as a positive integer denoting the major version of the web service.
SOAP on sovellusprotokolla, jota käytetään tiedon siirtämiseen IT-järjestelmissä ja jonka World Wide Web Consortium on standardoinut (W3C).
The minor version is given as a non-negative integer denoting the minor version of the web service within the major version.
UDDI (Universal Description, Discovery and Integration) tarkoittaa tässä keskeistä, mahdollisesti kansainvälistä web service -palvelujen rekisteriä, jos NtS Web Service -palvelun rekisteröinti on mahdollista.
The section of the NtS schema contains the version of the NtS schema as defined by the NtS Expert Group.
Tässä rekisterissä web service -palvelun mahdolliset asiakkaat voivat hakea palvelua ja löytää sen.
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.
Osallistuvat jäsenvaltiot rajoittavat kuitenkin NtS Web Service -palvelun mahdollisten tarjoajien määrää, ja WSDL-spesifikaatio on olennainen osa standardia, joten NtS Web Service -palvelun itsenäiselle rekisteröimiselle ei ole ilmeistä tarvetta.
Explicit version information is not necessary in the requests or responses of the NtS Web Service.
NtS Web Service -palvelussa käytetään Document-literal wrapped -koodaustapaa, koska se mahdollistaa validoinnin XML-kaaviota vastaan, ja WSDL-spesifikaatiossa määriteltyjä toimintonimiä käytetään suoraan XML-tagien niminä SOAP-viesteissä.
There are only a few versions of the services expected to be online at the same time.
NtS Web Service -palvelun versiotiedot koostuvat kahdesta osiosta:
Different versions shall be provided with different URLs.
itse web service -palvelun versiosta
Hence, each instance of an NtS Web Service implementation shall support one specific version of the NtS Web Service.
web service -palvelussa käytettävän NtS-skeeman versiosta.
The namespaces in the NtS Web Service are based on the web domain of the RIS Expert Groups, http://www.ris.eu/
Web service -osio koostuu kahdesta osasta:
The namespaces contain a particle indicating the corresponding service and version information.
web service -palvelun pääversiosta
Hence, the service specified here uses the following namespace:
web service -palvelun aliversiosta.
NtS Message Service: http://www.ris.eu/nts.ms/2.0.4.0
Pääversio ilmoitetaan web service -palvelun pääversiota ilmaisevana positiivisena kokonaislukuna.
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.
Aliversio ilmoitetaan web service -palvelun pääversion aliversiota ilmaisevana ei-negatiivisena kokonaislukuna.
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.
NtS-skeemaosio sisältää NtS-skeeman version, sellaisena kuin NtS-asiantuntijaryhmä on sen määritellyt.
It is recommended to use intuitive namespace prefixes like ‘nts’ for better human readability.
Tässä määritetty NtS Web Service -verkkopalvelun versio on siten 2.0.4.0, jossa 2.0 on itse web service -palvelun versio ja 4.0 on käytetyn NtS-skeeman versio.
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.
Tarkat versiotiedot eivät ole välttämättömiä NtS Web Service -palvelun pyynnöissä tai vastauksissa.
Querying an NtS Web Service, the client can reference various objects, e.g. fairway sections, gauges or locks.
Vain muutamien palvelujen versioiden oletetaan olevan verkossa samanaikaisesti.
If the corresponding parameters, the id elements, are used, they must contain ISRS Location Codes.
Eri versioille on määritettävä eri URL-osoitteet.
These parameters are typically given in id elements, each containing one or two ids.
NtS Web Service -palvelun jokainen käyttökerta tukee yhtä tiettyä NtS Web Service -palvelun versiota.
When using these parameters, the following general conventions have to be observed:
NtS Web Service -palvelussa nimialueet pohjautuvat RIS-asiantuntijaryhmien verkkotunnukseen http://www.ris.eu/.
ISRS Location Codes have to be submitted as full-length 20-character codes, i.e. without truncating trailing zeros,
Nimialueet sisältävät vastaavaa palvelua osoittavan osan ja versiotiedot.
If two ids are used within an id element, both ISRS Location Codes have to refer to the same waterway.
Tässä määritettävässä palvelussa käytetään siten seuraavaa nimialuetta:
This means, that the codes include some identical digits located in the fairway_section part of the ISRS Location Code.
NtS-viestipalvelu: http://www.ris.eu/nts.ms/2.0.4.0
The fairway section code together with the fairway hectometre defines a waterway stretch provided as pair of id elements.
XML-dokumenttien läpinäkyvyyden lisäämiseksi on suositeltavaa määritellä nimiavaruudet tähän tarkoitukseen parhaiten soveltuvassa elementissä skeemoissa ja ilmentymädokumenteissa.
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:
Sen sijaan ei ole suositeltavaa käyttää paikallisia nimiavaruusmääritelmiä sisäkkäisissä elementeissä.
digits 1 to 2 (Country code):
NtS Web Service -palvelun pyynnöissä ja vastauksissa on käytettävä XML-elementtejä lavennetussa (qualified) muodossa, ts. käyttämällä nimialueen etuliitettä, ja XML-attribuutteja laventamattomassa (unqualified) muodossa, ts. ilman nimialueen etuliitettä.
have to be identical within the id pair, but
On suositeltavaa käyttää intuitiivisia nimiavaruuden etuliitteitä, kuten ”nts”, luettavuuden parantamiseksi.
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,
ISRS Location Code -koodi selitetään sovelluskehittäjille tarkoitetun NtS Encoding Guide -ohjeen luvussa 2 ja RIS Index Encoding Guide -ohjeessa.
digits 3 to 5 (UN Location code):
Tehdessään hakua NtS Web Service -palvelussa asiakas voi hakea erilaisia kohteita, esim. väyläosioita, vedenkorkeusmittareita tai sulkuja.
are not relevant, may contain different content within the id pair,
Jos käytetään vastaavia parametrejä, joista käytetään nimitystä ”id elements”, niihin on sisällyttävä ISRS Location Code -koodit.
digits 6 to 10 (Fairway section code):
Nämä parametrit ilmoitetaan tyypillisesti id elements -elementeissä, joista kukin sisältää yhden tai kaksi id:tä.
[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,
Näitä parametrejä käytettäessä on noudatettava seuraavia yleisiä käytäntöjä:
digits 11 to 15 (Object Reference Code).
ISRS Location Code -koodit on syötettävä täysimittaisina 20-merkkisinä koodeina, ts. ilman katkaisevia loppunollia.
digits 16 to 20 (Fairway Hectometre):
Jos yhdessä id-elementissä käytetään kahta id:tä, molempien ISRS Location Code -koodien on viitattava samaan vesiväylään.
consist of five numerical digits defining the hectometre thus will usually contain different content within the id pair.
Tämä tarkoittaa, että koodeihin sisältyy joitain identtisiä numeroita ISRS Location Code -koodin väyläosio-osassa.
Example: ‘00235’ for fairway km 23,5; ‘00001’ for fairway km 0,1,
Väyläosio-koodilla yhdessä väylähehtometrin kanssa määritellään vesiväylän osuus, joka ilmaistaan id elements -parina.
[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)).
Kun NtS-viesteissä ilmoitetaan vesiväylän osuuksia (id-elementtiparit fairway_section-osioon sisältyvässä geo_objects-kohteessa), ISRS Location Code -koodien osalta on otettava huomioon seuraavaa:
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.
merkit 1 ja 2 (Country code):
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.
näiden on oltava samat id-parissa, mutta
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.
yhdessä id-parissa voidaan määritellä eri maakoodeja, jos naapurivaltiot käyttävät samaa väyläosio-koodia tietystä vesiväylästä ja samaa järjestelmää hehtometrien määrittelyyn,
For some countries/regions it is required to build filter functionality.
merkit 3–5 (UN Location code):