natgillin/translations-raw huggingface dataset:
If both have the value ALL the whole section shall be omitted if there are no other specific target groups within the message.
Om subject_code är INFSER (Informationstjänst) används giltighetsperioden för att specificera tiden som informationstjänstmeddelandet visas för användarna, inte giltighetsperioden för informationen (t.ex.
If just one of these two is given the other must be filled with the default value ALL because both elements are mandatory.
1 månad).
Further information concerning target groups can be found in the NtS Encoding Guide for editors.
Följande funktioner kan vara tillgängliga för redaktörer av ”meddelanden till befälhavare” beroende på nationella krav:
The validity_period shall be used by applications to select the messages, which are to be displayed to users for a requested time.
Tillämpningar för ”meddelanden till befälhavare” kan ha funktioner för att spara utkast till meddelanden (allt obligatoriskt innehåll måste inte tillhandahållas för att det ska gå att spara utkast till meddelanden).
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).
Redaktörerna kan ha olika användarroller (t.ex. redaktörer som har behörighet att skriva/ändra meddelanden, utgivare som har behörighet att publicera meddelanden (utöver redigering)).
The following functions may be offered to NtS editors depending on national requirements:
XML-strukturen i ”meddelanden till befälhavare” samt innehållet och dataelementens syfte definieras och förklaras ytterligare i tillägg C: XML Schema Definition (XSD) för meddelanden.
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)
Expertgruppen som arbetar med ”meddelanden till befälhavare” identifierade webbtjänsttekniken som ett lämpligt sätt att förmedla ”meddelanden till befälhavare”.
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)
Detta kapitel utgör specifikationen för webbtjänsten för förmedling av ”meddelanden till befälhavare” som förkortas webbtjänst för meddelanden.
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).
Särskild vikt läggs vid användningen av väletablerade internationella standarder.
The NtS Expert Group identified the web service technology as an appropriate means to provide the Notices to Skippers.
Ett av målen med designen av konceptet var att säkra en god balans mellan flexibilitet och pålitlighet för webbtjänsten.
This chapter constitutes the specification of the web service for the provision of the Notices to Skippers, short NtS Web Service.
Filterparametrarna i förfrågningarna är i huvudsak de kriterier som specificeras i standarden för ”meddelanden till befälhavare” (vattenvägsavsnitt med valfri angivelse av flodsträcka i km, giltighetstid, publiceringsdatum för meddelandet).
Particular emphasis was placed on the use of well-established international standards.
Detta verkar tillräckligt specifikt, med tanke på hur webbtjänsten ska användas, och samtidigt begränsar det tillämpningens komplexitet.
One goal of the conceptual design was to ensure a good balance between flexibility and robustness of the resulting web service.
Det viktigaste resultatet är ett avtal för webbtjänsten, i vilket förfrågningar om information och svar specificeras.
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).
Webbtjänstkonsumenterna kan förlita sig på detta avtal och leverantörerna måste följa det.
This seems sufficiently expressive considering the use cases of the web service and at the same time limits the complexity of the implementation.
Avtalet specificeras med den internationella standarden WSDL.
The core result is a contract for the web service, in which the requests and responses are specified.
Alla deltagande medlemsstater ska införa en eller flera webbtjänster för de olika meddelandetyperna (FTM, WRM, ICEM, WERM) och förmedla dem via internet (”Tjänst för meddelanden till befälhavare”).
The consumers of the web service can rely on this contract and the providers have to comply with it.
De tekniska detaljerna för implementeringen av WS för ”meddelanden till befälhavare”, t.ex. valet av lämpliga datapooler, tillämpningar och plattformar, omfattas inte av denna specifikation.
This contract is specified using the international standard WSDL.
Varje enskild deltagande medlemsstat ansvarar för dessa detaljer.
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’),
För att definiera en säker kommunikation måste man beakta olika säkerhetsaspekter och syftet som ligger bakom.
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.
Beroende på omständigheterna måste inte alla dessa aspekter beaktas.
In order to define a secure communication one has to consider various security aspects and protection objectives.
Prioriteringen av de olika säkerhetsaspekterna och i vilken mån alla säkerhetskrav uppfylls kan variera.
Depending on the circumstances not all of these aspects have to be considered.
Genomförbarheten för en viss åtgärd kan begränsas av möjligheterna till det tekniska genomförandet.
The priority of the various security aspects and the degree of their fulfilment can vary.
När det gäller ”meddelanden till befälhavare” är all information offentlig.
Also the feasibility of a certain measure can be limited by the capabilities of the technical implementation.
Så det finns inget behov av dataskydd när det gäller ”meddelanden till befälhavare”.
In the context of NtS all information are public.
Därför måste varje leverantör själv bestämma hur långt denna aspekt ska genomföras i respektive tjänst.
So there is no need to secure the NtS data themselves in terms of data protection.
Webbtjänsten för meddelanden måste följa WS-I Basic Profile 1.1.
Therefore every provider has to decide on its own in how far this aspect will be implemented in its service.
Denna profil ”tillhandahåller vägledning för driftskompatibilitet för en grundläggande uppsättning generiska webbtjänstspecifikationer, såsom SOAP, WSDL och UDDI”.
The NtS Web Service has to comply with the WS-I Basic Profile 1.1.
De mest relevanta standarderna häri är
This profile ‘provides interoperability guidance for a core set of non-proprietary web services specifications, such as SOAP, WSDL and UDDI’.
Web Services Description Language (WSDL) och
The most relevant standards herein are
Svarsmeddelandet för webbtjänsten för meddelanden är ett ”meddelande till befälhavare” som definieras i XML Schema Definition (XSD) i tillägg C i denna förordning från kommissionen.
Web Services Description Language (WSDL), and
SOAP är ett tillämpningsprotokoll för dataöverföring mellan IT-system som standardiseras av World Wide Web Consortiums (W3C).
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.
De specifika elementen för webbtjänsten för meddelanden definieras i motsvarande WSDL-specifikationer i tillägg D till denna förordning från kommissionen.
SOAP is an application protocol for data transmission among IT-Systems and is standardised by the World Wide Web Consortiums (W3C).
Standardschemat för ”meddelanden till befälhavare” (XSD) medföljer med ett importmeddelande.
The specific elements for the NtS Web Service are defined inline in the corresponding WSDL specifications in Appendix D of this Commission Regulation.
UDDI (Universal Description, Discovery and Integration) beskrivs här som ett centralt, möjligtvis internationellt register över webbtjänster där webbtjänsten för meddelanden kan registreras.
The schema of the NtS standard (XSD) is included with an import statement.
I detta register kan potentiella användare av webbtjänsten söka och hitta tjänsten.
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.
Men eftersom de potentiella leverantörerna av webbtjänsten för meddelanden begränsas av de deltagande medlemsstaterna och WSDL-specifikationen är en integrerad del av standarden är behovet av en oberoende registrering av webbtjänsten inte uppenbar.
In this registry potential consumers of the web service could search and find the service.
Kodningsmetoden ”Document-literal wrapped” används för webbtjänsten för meddelanden eftersom den möjliggör validering mot ett XML-schema och namn på operationer som definieras i WSDL-specifikationen används direkt som namn på XML-taggar i SOAP-meddelandena.
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.
Versionsinformationen för webbtjänsten består av två avsnitt:
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.
Versionen av själva webbtjänsten.
The version information of the NtS Web Service consists of two sections:
Versionen av schemat för meddelandena som används av webbtjänsten.
version of the web service itself,
Avsnittet som handlar om webbtjänsten består av två delar:
version of the NtS schema used by the web service.
(Ny) version med större ändringar av webbtjänsten.
The section of the web service itself consists of two parts:
(Ny) version med mindre ändringar av webbtjänsten.
major version of the web service,
En (ny) version med större ändringar anges som ett positivt heltalsvärde.
minor version of the web service.
En (ny) version med mindre ändringar anges som ett icke-negativt heltalsvärde som visar att det är en mindre uppdatering inom den aktuella grundversionen.
The major version is given as a positive integer denoting the major version of the web service.
Avsnittet för meddelandeschemat innehåller versionen av meddelandeschemat såsom detta definieras av expertgruppen för ”meddelanden till befälhavare”.
The minor version is given as a non-negative integer denoting the minor version of the web service within the major version.
Versionen av webbtjänsten för meddelanden som specificeras här är 2.0.4.0, där 2.0 är versionen av själva webbtjänsten och 4.0 är versionen av det schema som används för meddelandena.
The section of the NtS schema contains the version of the NtS schema as defined by the NtS Expert Group.
Utförlig versionsinformation behövs inte i förfrågningar och svar i webbtjänsten för meddelanden.
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.
Det finns bara ett fåtal versioner av tjänsterna som förväntas vara online samtidigt.
Explicit version information is not necessary in the requests or responses of the NtS Web Service.
Olika versioner ska anges med olika URL-adresser.
There are only a few versions of the services expected to be online at the same time.
Därför ska varje instans av en webbtjänst för meddelanden stödja en specifik version av webbtjänsten för meddelanden.
Different versions shall be provided with different URLs.
Namnfälten i webbtjänsten för meddelanden är baserade på RIS-expertgruppernas webbdomän http://www.ris.eu/.
Hence, each instance of an NtS Web Service implementation shall support one specific version of the NtS Web Service.
Namnfälten innehåller en partikel som indikerar motsvarande tjänst och versionsinformation.
The namespaces in the NtS Web Service are based on the web domain of the RIS Expert Groups, http://www.ris.eu/
Tjänsten som specificeras här använder följande namnfält:
The namespaces contain a particle indicating the corresponding service and version information.
Webbtjänst för meddelanden: http://www.ris.eu/nts.ms/2.0.4.0
Hence, the service specified here uses the following namespace:
För högre transparens i XML-dokument rekommenderas det att namnfält definieras i det lämpligaste elementet i schemana såväl som exempeldokumenten och att definitioner för lokala namnfält inte används i nästlade element.
NtS Message Service: http://www.ris.eu/nts.ms/2.0.4.0
Förfrågningar och svar i webbtjänsten för meddelanden ska använda kvalificerade XML-element, dvs. element med ett tydligt namnfältsprefix, och okvalificerade XML-attribut, dvs. utan ett namnfältsprefix.
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.
Det rekommenderas att intuitiva namnfältsprefix som ”nts” används för att öka läsbarheten.
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.
ISRS-identifieringskoden samt kodningsguiden för RIS Index förklaras i kapitel 2 i Kodning av meddelanden till befälhavare – vägledning för tillämpningsutvecklare.
It is recommended to use intuitive namespace prefixes like ‘nts’ for better human readability.
I förfrågningar till en webbtjänst för meddelanden kan användaren hänvisa till ett antal objekt, t.ex. farledsavsnitt, vattenståndsmätare och slussar.
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.
Om motsvarande parametrar (ID-element) används måste de innehålla identifieringskoder.
Querying an NtS Web Service, the client can reference various objects, e.g. fairway sections, gauges or locks.
Dessa parametrar ges vanligtvis i ID-element där varje parameter innehåller ett eller två ID:n.
If the corresponding parameters, the id elements, are used, they must contain ISRS Location Codes.
Vid användning av dessa parametrar måste följande allmänna konventioner iakttas:
These parameters are typically given in id elements, each containing one or two ids.
Identifieringskoder måste anges med hela koden, dvs. 20 tecken, och inga nollor får utelämnas.
When using these parameters, the following general conventions have to be observed:
Om två ID:n används i ett ID-element måste båda identifieringskoderna hänvisa till samma vattenväg.
ISRS Location Codes have to be submitted as full-length 20-character codes, i.e. without truncating trailing zeros,
Det betyder att koderna innehåller vissa identiska siffror i avsnittet fairway_section i identifieringskoden.
If two ids are used within an id element, both ISRS Location Codes have to refer to the same waterway.
Koden för farledsavsnittet i kombination med farledshektometern definierar en sträcka på en vattenväg som tillhandahålls som två ID-element.
This means, that the codes include some identical digits located in the fairway_section part of the ISRS Location Code.
För sträckor på vattenvägar (ID-elementpar i avsnittet fairway_section geo_object) i ”meddelanden till befälhavare” måste följande beaktas med avseende på identifieringskoder:
The fairway section code together with the fairway hectometre defines a waterway stretch provided as pair of id elements.
Siffrorna 1–2 (landskod):
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:
måste vara identiska inom ID-paret, men
digits 1 to 2 (Country code):
olika landskoder kan definieras inom ett ID-par om angränsande länder använder samma kod för farledsavsnittet för en specifik vattenväg och samma system för definition av hektometrar.
have to be identical within the id pair, but
Siffrorna 3–5 (FN:s lokaliseringskod):
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,
är inte relevanta, kan ha innehåll som skiljer sig åt inom ID-paret.
digits 6 to 10 (Fairway section code):
Siffrorna 11 till 15 (referenskod för objekt):
[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,
Siffrorna 16–20 (farledshektometer):
digits 11 to 15 (Object Reference Code).
[undantag]: för Nederländerna finns det inte alltid en direkt koppling mellan farledshektometern och den fysiska kilometern på farleden på grund av definitionen för början av sträckan på farleden i nätverksmodellen och i den fysiska världen.
digits 16 to 20 (Fairway Hectometre):
I sådana fall börjar objektreferenskoden för objekt av typen ”dismar” med Kxxxx (xxxx inkluderar den fysiska kilometern, t.ex.
consist of five numerical digits defining the hectometre thus will usually contain different content within the id pair.
NLSVG00130K000300191 (km 3)).
Example: ‘00235’ for fairway km 23,5; ‘00001’ for fairway km 0,1,
För andra typer av objekt finns ingen direkt relation till den fysiska farledens km i identifieringskoderna, t.ex. har Sas van Gent-bron på samma farled vid km 2,5 identifieringskod NLSVG001300521600186.
[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)).
För Gent-Terneuzenkanalen börjar den fysiska km 0.0 vid gränsen mellan Belgien och Nederländerna och farledshektometern 0.0 börjar vid kanalens början i Gent.
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.
Om ett meddelande berör mer än ett vattenvägs- eller farledsavsnitt måste alla farledsavsnitt definieras med start- och slutpunkt i separata XML-element för ”fairway_section”.
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.
För vissa länder/regioner krävs detta för att filtren ska fungera.
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.
Om t.ex. identifieringskod (1–2) är BE ska identifieringskod (6–8) användas som ID för linjär referens med farledshektometern (identifieringskod 16–20).
For some countries/regions it is required to build filter functionality.
Exempel för sträckor på farleder (giltiga ID-elementpar i avsnittet fairway_section) som inkluderar de undantag som definieras ovan:
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).
De två identifieringskoderna är en giltig definition för en sträcka på en vattenväg (NL-undantag visas med hänsyn till farledskilometern): NLSVG00130K000300191 (km 3,0 vid Sas van Gent på Gent-Terneuzenkanalen) – NLWDP00130K000400200 (km 4,0 vid Westdorpe på Gent-Terneuzenkanalen).
Examples for fairway stretches (valid id element pairs within the fairway_section) that include above defined exceptions:
De två BE-identifieringskoderna är en giltig definition för en sträcka på en vattenväg (BE-undantag visas med hänsyn till koden för farledsavsnittet (”020” Albertkanaal)): BEGNK02016L010100414 (slussen vid Genk är lokaliserad vid km 41,4 på Albertkanaal) – BEOSH02033L010500772 (slussen vid Ham är lokaliserad vid km 77,2 på Albertkanaal).
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),
Följande figur visar motexempel på identifieringskod som används för varje allmän konvention (inga undantag för de allmänna konventioner som gäller för SK-sträckor på vattenvägar):
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).
Ogiltiga förfrågningar om ISRS-identifieringskoder
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):
Allmän anmärkning: En tjänst för förfrågningar om giltiga identifieringskoder stöds inte av webbtjänsten för meddelanden.
Invalid ISRS Location Code queries
Identifieringskoder tillhandahålls inom ERDMS (European Reference Data Management System).
General remark: A service to query valid ISRS Location Codes is not supported by the NtS Web Service.
Den korrekta användningen av identifieringskoder i förfrågningarna och deras tolkning ges i följande fem fall.
The ISRS Location Codes are provided within the European Reference Data Management System (ERDMS).
Fall 1: Inga ID-element i förfrågan
The correct usage of ISRS Location Codes in queries and their interpretation is given in the following five cases.
ID-element är en valfri del av förfrågan, dvs. att en förfrågan utan några ID-element är tillåten:
Case 1: No ids element in request
Giltig förfrågan utan ID-parameter
The ids element is an optional part of the request, i.e. a query without any ids elements is allowed:
Om inga ID-element ges ska alla meddelanden returneras (naturligtvis beroende på andra filterkriterier som validity_period eller dates_issue).
Valid query without ids parameter
Fall 2: Ett ID-element i förfrågan
If no ids element is given, all messages shall be returned (depending, of course, on other filter criteria like validity_period or dates_issue).
Varje ID-element kan innehålla ett eller två ID-element.
Case 2: One id element in request
Ett fall med ett ID-element visas i följande figur:
Each ids element can contain one or two id elements.
Giltig förfrågan med en ID-parameter
The case of one id element is shown in the following figure:
Om en sådan förfrågan tas emot ska servern returnera alla matchande meddelanden med starthektometer ≤ det givna värdet (240,7 i exemplet) och sluthektometer ≥ detta värde.
Valid query with one id parameter
Figuren nedan visar detta urval av meddelanden: Den begärda positionen är placerad mellan start- och sluthektometervärdena för meddelandena 1, 3 och 4 som skulle returneras.
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.
Meddelandena 2, 5 och 6 överlappar inte den begärda positionen, så de skulle inte returneras.
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.
Om den angivna identifieringskoden gäller ett enskilt objekt, t.ex. en vattenståndsmätare eller en sluss, ska webbtjänsten returnera meddelandena som innehåller detta objekt.