Denne frase betyder, at det definerede er fuldstændig forbudt.

Transkript

1 OIOXML Navngivnings- og Designregler () 3.2 Publikationen OIO Navngivnings- og Design Regler (engelsk: OIO Naming and Design Rules), også kort betegnet OIO- eller bare, definerer de regler, som et XML-skema skal overholde for at kunne blive godkendt som et OIOXML-skema til anvendelse indenfor OIOXML-regi. Godkendte OIOXMLskemaer er baseret på W3C XML Schema anbefalingen. Dette dokument indeholder alle de regelændringer, der er blevet foretaget for at løfte den gældende OIO- til OIO Rationalet for disse regelændringer er: platformskift fra InfoStrukturBasen (ISB) til Digitalisér.dk ny fortolkning af nøgleordene BØR og BØR IKKE anvendt i reglerne ny opbygning af et OIO-namespace med versioneringsangivelse via namespacet samt ændring fra URL- til URN-format Platformskift fra ISB til Digitalisér.dk ISB'en blev lukket d. 31. oktober 2008 og er nu overtaget af det nye Digitalisér.dk. Da termen "InfoStrukturBasen" indgår som tekst i en del -regler, er det nødvendigt at opdatere disse regler, så de reflekterer skiftet til Digitalisér.dk. Ændret fortolkning af nøgleordene BØR og BØR IKKE -reglernes vægtning er gradueret med nøgleordene "SKAL", "MÅ IKKE", "BØR", "BØR IKKE" og "MÅ" og er i 3.2 bragt i overensstemmelse med anbefalingerne i Internet Engineering Task Force RFC 2119 Key words for use in RFCs to Indicate Requirement Levels [ I 3.2 er specielt fortolkningen af BØR og BØR IKKE ændret i forhold til tidligere praksis. Ændringerne er markeret i nedenstående tabel med gråt og kursiv. Nøgleord 3.2 SKAL Dette ord betyder, at det definerede er et absolut krav. Dette ord betyder, at det definerede er et absolut krav. MÅ IKKE Denne frase betyder, at det definerede er fuldstændig forbudt. Denne frase betyder, at det definerede er fuldstændig forbudt. BØR Dette ord betyder, at der kan findes vægtige grunde til at se bort fra det define- Dette ord betyder, at det definerede er et krav. Kun hvis der findes vægtige grunde (der skal

2 BØR IKKE MÅ, KAN rede, men de fulde konsekvenser skal være forstået og nøje overvejet, før man vælger den vej. Denne frase betyder, at der kan findes vægtige grunde, hvor det, som defineres som frarådeligt, er acceptabelt eller sågar nyttigt, men de fulde konsekvenser skal være forstået og nøje overvejet, før man vælger den vej. Disse ord betyder, at det definerede er valgfrit. accepteres som gyldige), hvor de fulde konsekvenser skal være forstået og nøje overvejet, kan man se bort fra det definerede. Denne frase betyder, at det definerede forbydes. Kun hvis der findes vægtige grunde (der skal accepteres som gyldige), hvor de fulde konsekvenser skal være forstået og nøje overvejet og hvor det som defineres som frarådeligt, er acceptabelt eller sågar nyttigt, kan man anvende det definerede. Disse ord betyder, at det definerede er valgfrit. Denne ændring betyder i praksis, at nøgleordene BØR eller BØR IKKE ikke længere fortolkes som deciderede krav eller forbud, dvs. som SKAL og MÅ IKKE med mulighed for dispensation. Konsekvensen er også, at kun SKAL-regler fremover vil blive sagsbehandlet og krævet overholdt; BØR-regler vil ikke blive krævet overholdt. F.eks. vil konsekvensen være, at det kun er påkrævet at genbruge OIOXMLskemaer (tilhørende enten -klassen eller Adoptionsklassen), hvis de samtidigt er klassificerede som Kerne- eller Domæneskemaer (se OIO-1). Hvis et OIOXML-skema ikke er klassificeret som et Kerne- eller Domæneskema, er der ikke længere krav om, at det skal genbruges, kun at det bør genbruges (se OIO- 2). Udover ændret fortolkning, er visse -regler ændrede i 3.2 pga. denne nye fortolkning af BØR og BØR IKKE. Bl.a. er: nogle dublet-regler slået sammen pga. ny fortolkning af BØR, f.eks. OIO-6 og OIO-7 slås sammen til kun én regel OIO-6. Det samme sker for GTD-2 og GTD-3 samt ELD-1 og ELD-2. GNR-2 ændres fra BØR til SKAL. Namespaceopbygning og versionering Et OIO-namespace har indtil nu været opbygget som en URL, som angav en fysisk placering af et XML-skema på InfoStrukturBasen. Dette giver ikke længere mening, da XML-skemaer på Digitalisér.dk ikke placeres i en folderstruktur. Af den grund ændres namespacet fra at være opbygget som en URL til at være opbygget som en URN (Uniform Resource Name - se ). Dette er tillige en harmonisering med international opbygning af namespaces (bl.a. i UN/CEFACTregi). 2

3 Versionering i den nuværende udføres vha. skemafilnavnet. Da netop håndtering af skemafilnavne er helt ændrede på Digitalisér.dk er det ikke længere muligt at opretholde versionering på denne måde. Der er også andre praktiske grunde til at ændre versioneringshåndteringen. Versionering vil fremover i 3.2 (og senere versioner af OIO-) blive håndteret udelukkende via skemaets namespace. Konsekvensen af at flytte versionering fra filnavn til namespace, påvirker en del regler (bl.a. FNR-1, VER-1, VER-2, VER-3). Regelændringer i OIOXML 3.2 regelsættet I det følgende gennemgås alle regelændringer i 3.2 i forhold til den nuværende. Følgende ordliste er en normativ definition af centrale termer anvendt i regelsættet. Adoptionsklasse Domæneklasse Kerneklasse Metadatafil -klasse OIOXML-klasse Adoptionsklassen er den grundlæggende OIOXMLklasse indeholdende internationalt udviklede XMLskemaer, der er optaget under OIOXML; disse betegnes Adoptionsskemaer. Et Adoptionsskema kan, hvis ønsket, samtidigt tilhøre enten Kerne- eller Domæneklassen (se disse). Domæneklassen indeholder skemaer, som, når det er muligt, specielt skal genbruges inden for et bestemt anvendelsesområde. Domæneklassen skal understøtte OIOXML-paradigmets genbrugstanke i så stor udstrækning, som det er muligt. Kerneklassen indeholder helt generelt genanvendelige skemaer, som, når det er muligt, skal genbruges af alle OIOXML-skemaer uafhængigt af deres klasse og uafhængigt om disse er specifikke for et bestemt anvendelsesområde eller ej. Kerneklassen skal understøtte OIOXML-paradigmets genbrugstanke i så stor udstrækning, som det er muligt. Betegner den XML-fil, som følger ethvert OIOXMLskema, og som indeholder OIOXML-skemaets metadata. -klassen er den grundlæggende OIOXML-klasse indeholdende nationalt udviklede OIOXML-skemaer, betegnet -skemaer. Et -skema kan, hvis ønsket, samtidigt tilhøre enten Kerne- eller Domæneklassen (se disse). Fællesbetegnelse for -klassen, Adoptionsklassen, Kerneklassen og Domæneklassen. 3

4 OIO-komitéen OIO-namespace OIO-udvalg Et udvalg godkendt af OIO-komitéen til at godkende områdespecifikke OIOXML-skemaer angivet i Domæneklassen. OIOXMLaflevering OIOXML-skema Støttetype Target namespace Betegner det fællesoffentlige organ, som samlet udarbejder OIO-retningslinier og -metoder, samt godkender åbne OIO-standarder, såsom datastandarder og tekniske standarder. Er tæt koblet til OIO-udvalg, som er OIO-komitéens "forlængede arm" i de forskellige fagområder. Betegner et namespace som det anvendes inden for OIO-regi, dvs. hvis opbygning overholder de regler som er angivet i OIO-. Et sæt af XML-skemaer, som hver kandiderer til at blive OIO-godkendt i en af OIO-klasserne. Et OIO-godkendt XML-skema, der overholder alle -regler, er klassificeret via OIO-klasserne samt placeret på Digitaliser.dk En støttetype angiver en speciel type i OIOsammenhæng, som anvendes hvis det i et OIOXMLskema er nødvendigt at definere mere end én type. Den anvendes primært til at definere typer for lokalt erklærede attributter. Betegner det namespace som tildeles alle globalt erklærede og definerede komponenter, elementer, attributter og typer, i et XML-skema. I tabellen nedenfor er der i første kolonne angivet et 3.2 ; i anden kolonne det tilsvarende (kun hvis nummeret har ændret sig i 3.2); i tredje kolonne den nye 3.2 regelformulering; og i fjerde kolonne regelformuleringen (hvis formuleringen har ændret sig). 3.2 OIOXML regler OIO-1 OIO-2 Et OIOXML-skema SKAL genbruge eksisterende elementer eller typer fra Kerneklassen og Domæneklassen. Et OIOXML-skema BØR genbruge eksisterende elementer eller typer fra -klassen. formulering 4

5 3.2 OIO-3 OIO-4 OIO-5 OIO-6 Et OIOXML-skema SKAL genbruge de indbyggede simple typer i XML Schema anbefalingen frem for at definere egne typer til at repræsentere den samme type. Et OIOXML-skema BØR genbruge et element frem for dets type, hvis elementets navn og anvendelse er entydig i den konkrete sammenhæng. Et OIOXML-skema SKAL genbruge nyeste version af et andet eksisterende OIOXML-skema, hvis dette andet skema forekommer i flere versioner. Et OIOXML-skema SKAL indeholde én elementerklæring og, hvis elementerklæringen ikke genbruger en eksisterende type fra et andet skema, én typedefinition for elementet samt eventuelt en eller flere definitioner af støttetyper nødvendige for etablering af elementets typedefinition. Skemaet må dog ikke indeholde en elementerklæring, hvis den tilstedeværende typedefinition specificerer en abstrakt type. formulering Et OIOXML-skema SKAL genbruge de indbyggede simple typer i XML Schema anbefalingen frem for at definere egne typer til at repræsentere den samme information. Et OIOXML-skema tilhørende Kerneklassen eller Domæneklassen SKAL indeholde én elementerklæring og, hvis elementerklæringen ikke genbruger en eksisterende type fra et andet skema, én typedefinition for elementet samt eventuelt en eller flere definitioner af støttetyper nødvendige for etablering af elementets typedefinition. Skemaet må dog ikke indeholde en elementerklæring, hvis den tilstedeværende typedefinition specificerer en abstrakt type. Udgår OIO-7 Et OIOXML-skema tilhørende -klassen BØR indeholde én elementerklæring og, hvis elementerklæringen ikke genbruger en eksisterende type fra et andet skema, én typedefinition for elementet samt eventuelt en eller flere definitioner af støttetyper nødvendige for etablering af elementets typedefinition. Skemaet må dog ikke indeholde en elementerklæring, hvis den tilstedeværende typedefinition specificerer en abstrakt type. 5

6 3.2 OIO-7 OIO-8 En OIOXML-skemaaflevering SKAL i dets enkelte skemaer altid referere enten til godkendte OIOXML-skemaer på Digitalisér.dk eller til skemaer indeholdt i selve skemaafleveringen. OIO-8 OIO-9 Et OIOXML-skema SKAL placeres på Digitalisér.dk. OIO-9 OIO-10 i dets udformning være influeret af begrænsninger i et bagvedliggende fagsystem. formulering En OIOXML-skemaaflevering SKAL i dets enkelte skemaer altid referere enten til godkendte OIOXML-skemaer i InfoStruktur- Basen eller til skemaer indeholdt i selve skemaafleveringen. Et OIOXML-skema SKAL placeres i InfoStrukturBasen. Et OIOXML-skema tilhørende Kerneklassen eller Domæneklassen MÅ IKKE i dets udformning være influeret af begrænsninger i et bagvedliggende fagsystem. Udgår OIO-11 Et OIOXML-skema tilhørende -klassen BØR IKKE i dets udformning være influeret af begrænsninger i et bagvedliggende fagsystem. OIO-10 OIO-12 Et OIOXML-skema SKAL designes så enkelt og entydigt som overhovedet muligt uden unødvendig kompleksitet og overflødige konstruktioner. Generelle XML skema regler GXS-1 GXS-2 GXS-3 GXS-4 GXS-5 Et OIOXML-skema SKAL defineres i overensstemmelse med W3C XML Schema anbefalingen (version 1.0) af 2. maj 2001: XML Schema Part 1: Structures og XML Schema Part 2: Datatypes. Et OIOXML-skema SKAL anvende version 1.0 af W3C XML anbefalingen af 4. februar 2004 Extensible Markup Language (XML) 1.0 (Third Edition). Et OIOXML-skema SKAL anvende UTF-8 som encoding scheme. Et OIOXML-skema SKAL have specificeret et target namespace. benytte import-konstruktionen til at referere til et andet OIOXML skema, der anvender samme namespace, som skemaet der refereres fra. Et OIOXML-skema SKAL tilknyttes et namespace. 6

7 3.2 GXS-6 GXS-7 GXS-8 GXS-9 Generelle navngivningsregler GNR-1 GNR-2 GNR-2a GNR-2b GNR-2c benytte redefine-konstruktionen. benytte notation-konstruktionen. Et OIOXML-skema SKAL angive alle dets schemalocationattributter med en gyldig reference til OIOXML-skemaer på Digitalisér.dk. benytte konstruktionerne key, keyref og unique. Et OIOXML-skema SKAL navngive alle dets globalt erklærede komponenter (elementer, og typer) unikt indenfor skemaets namespace og BØR navngive unikt på tværs af alle namespaces for godkendte OIOXML-skemaer. Et OIOXML-skema SKAL navngive alle dets globalt og lokalt erklærede komponenter (elementer, attributter samt typer) efter ObjektEgenskabRepræsentation navngivningsmodellen, som specificeret i følgende underregler. Et navn SKAL i dets Objekt term beskrive det dataobjekt, som et element og dets type repræsenterer i en bestemt sammenhæng. Et navn KAN udelade dets Objekt term i det tilfælde, hvor et element og dets type optræder i en kontekst af et objekt eller objektet er ukendt. Et navn SKAL i dets Egenskab term ved hjælp af en eller flere kvalificerende ord beskrive en fremtrædende egenskab ved et elements og dets types Objekt term. formulering Et OIOXML-skema SKAL angive alle dets schemalocationattributter med en absolut og gyldig URL til det refererede OIOXMLskemas placering i InfoStrukturBasen. Et OIOXML-skema BØR navngive alle dets globalt og lokalt erklærede komponenter (elementer, attributter samt typer) efter ObjektEgenskabRepræsentation navngivningsmodellen, som specificeret i følgende underregler. 7

8 3.2 GNR-2d (listen over repr.termer er placeret sidst i dette notat) GNR-2e GNR-2f GNR-2g GNR-2h GNR-2i Engelsk/dansk sprogvalg i navngivning LNR-1 Et navn SKAL i dets Repræsentation term beskrive et elements og dets types repræsentative kategori og SKAL antage en af værdierne i OIOXML's liste over repræsentationstermer. Et navn SKAL, hvis det har en frase i termen Egenskab, som er synonymt med en frase i termen Repræsentation, fjerne frasen fra Egenskab og bibeholde den i Repræsentation. Et navn SKAL angives på entalsform, med mindre navneordet er en flertalsform. Et navn MÅ IKKE benytte en forkortelse eller et akronym, hvis ikke forkortelsen eller akronymet er alment kendt. Et navn SKAL opbygges af udsagnsord, navneord og tillægsord. Et navn MÅ IKKE i dets opbygning benytte underscore (_), punktum (.) og bindestreg (-). Undtaget er dog navne for støttetyper, der altid starter med underscore (_). Et OIOXML-skema SKAL navngive alle dets globalt og lokalt erklærede komponenter (elementer, attributter samt typer) i ét og samme sprog på enten dansk eller engelsk. Et OIOXML-skema med komponenter navngivet på engelsk betegnes et engelsk OIOXML-skema, og et OIOXML skema med komponenter navngivet på dansk betegnes et dansk OIOXML-skema. formulering Et navn BØR IKKE benytte forkortelser og akronymer. 8

9 3.2 LNR-2 LNR-3 LNR-4 LNR-5 Navngivning af typer TPN-1 TPN-2 TPN-3 Et OIOXML-skema har frit sprogvalg mellem dansk og engelsk med mindre et OIO-udvalg har taget konkret ejerskab af skemaet. I det tilfælde beslutter OIOudvalget, hvorvidt OIOXMLskemaet skal være dansk eller engelsk. Et dansk OIOXML-skema SKAL tildele attributten xml:lang i rodelementet schema værdien DA. Et engelsk OIOXML skema KAN tildele attributten xml:lang i rodelementet schema værdien EN. Attributten xml:lang MÅ IKKE antage andre værdier end DA og EN og hvis attributten ikke er specificeret, antages værdien at være EN, dvs. skemaet antages at være et engelsk OIOXML skema. Navngivning på engelsk BØR ske i overensstemmelse med Oxford English Dictionary eller relevante fagbøger. Navngivning på dansk BØR ske i overensstemmelse med Dansk Retskrivningsordbog eller relevante fagbøger. anvende de danske specialtegn æ, ø og å samt Æ, Ø, Å på grund af manglende værktøjsunderstøttelse. Som alternativ anvendes i stedet ae for æ, oe for ø og aa for å og tilsvarende Ae for Æ, Oe for Ø og Aa for Å. Et OIOXML-skema SKAL afslutte navnet på en simpel eller kompleks type med suffiks Type. Et OIOXML-skema SKAL anvende termen Repræsentation i typenavnet for en simpel type. anvende termen Repræsentation i typenavnet for en kompleks type. formulering 9

10 3.2 TPN-4 TPN-5 TPN-6 Navngivning af elementer ELN-1 ELN-2 Navngivning af attributter ATN-1 Navngivning af skema- og metadatafiler Et OIOXML-skema SKAL i dets Egenskab term i typenavnet for en kompleks type have værdien Collection i et engelsk OIOXML-skema og Samling i et dansk OIOXML-skema, hvis indholdsmodellen for skemaets komplekse type indeholder mindst 2 forekomster af præcist ét element (dvs. attributten maxoccurs i elementreferencen er større end eller lig med 2, eller lig med unbounded ). I alle andre tilfælde SKAL termen Egenskab i typenavnet være Structure i et engelsk OIOXML-skema og Struktur i et dansk OIOXML-skema eller helt undlades uanset sprog. Et OIOXML-skema SKAL navngive dets simple og komplekse typer med UpperCamelCase. Et OIOXML-skema SKAL anvende ét underscore (_) som præfiks til en type s navn, hvis typen er en støttetype. Et OIOXML-skema SKAL navngive dets element identisk med elementets type (uden typens Type suffiks), hvis elementerklæring og typedefinition forekommer sammen i skemaet. Et OIOXML-skema SKAL navngive dets element med UpperCamelCase. Et OIOXML-skema SKAL navngive dets attributter med lower- CamelCase. formulering 10

11 3.2 FNR-1 Et OIOXML-skema SKAL specificere dets filnavn <skemafilnavn> efter navngivningsmodellen: <elementnavn> +.xsd, hvor <elementnavn> angiver navnet på det i skemaet erklærede element, eller, hvis skemaet indeholder en abstrakt typedefinition, navnet på den definerede type uden dets suffiks Type. formulering Et OIOXML-skema SKAL specificere dets filnavn <skemafilnavn> efter navngivningsmodellen: <elementnavn>+ _ +<version>+.xsd. Udgår FNR-1a Et OIOXML-skemas filnavn SKAL i dets <elementnavn>-term angive navnet på det i skemaet erklærede element, eller, hvis skemaet indeholder en abstrakt typedefinition, navnet på den definerede type uden dets suffiks Type. Udgår FNR-1b Et OIOXML-skemas filnavn SKAL i dets <version>-term benytte en gyldig datoangivelse i formattet ÅÅÅÅMMDD, hvor ÅÅÅÅ angiver et 4-cifret årstal, MM en 2-cifret månedsangivelse (01-12) og DD en 2-cifret dagsangivelse (01-31). FNR-2 Generelle regler for typedefinitioner GTD-1 GTD-2 Et OIOXML-skema SKAL navngive dets metadatafil efter modellen: <skemafilnavn>+.meta.xml. Et OIOXML-skema SKAL definere alle dets simple og komplekse typer stærkest muligt. Et OIOXML-skema SKAL definere alle dets simple og komplekse typer globalt. Et OIOXML-skema tilhørende Kerneklassen eller Domæneklassen SKAL definere alle dets simple og komplekse typer globalt. Udgår GTD-3 Et OIOXML-skema tilhørende -klassen BØR definere alle dets simple eller komplekse typer globalt. GTD-3 GTD-4 definere en ny simpel eller kompleks type identisk med en simpel eller kompleks type fra et andet eksisterende OIOXML-skema. 11

12 3.2 GTD-4 GTD-5 genbruge de indbyggede ur-typer anytype og anysimpletype. GTD-5 GTD-6 genbruge følgende indbyggede simple typer long, int, short, byte, unsignedlong, unsignedint, unsignedshort, unsignedbyte (afledt af den simple indbyggede type decimal) samt normalizedstring, token, language, name, NCName, ID, IDREF, IDREFS, ENTITY, ENTITIES, NMTOKEN, NMTO- KENS (afledt af den simple indbyggede type string). GTD-6 GTD-7 Et OIOXML-skema BØR benytte de indbyggede simple typer anyu- RI eller base64binary til at håndtere binært indhold. GTD-7 GTD-8 Et OIOXML-skema KAN benytte attributten abstract i simple og komplekse typedefinitioner til at definere abstrakte typer. GTD-8 GTD-9 Et OIOXML-skema BØR IKKE begrænse typeafledninger, dvs. attributterne finaldefault og block- Default i rodelementet schema, attributten final i simple typedefinitioner samt attributterne block og final i komplekse typedefinitioner BØR IKKE benyttes. GTD-9 GTD-10 Et OIOXML-skema SKAL anvende dets støttetyper udelukkende som en hjælp til at etablere skemaets ene typedefinition, hvis en sådan defineres i skemaet og ikke kan udtrykkes i en enkelt definition. GTD-10 GTD-11 Et OIOXML-skema SKAL definere dets støttetyper som simple typer. Regler for simple typedefinitioner STD-1 STD-2 benytte konstruktionen list. benytte konstruktionen union. formulering 12

13 3.2 STD-3 STD-4 STD-5 Et OIOXML-skema BØR IKKE begrænse længden af den simple indbyggede type string. Et OIOXML-skema BØR udtrykke kodelister via enumeration konstruktionen. Et OIOXML-skema SKAL udelukkende udtrykke værdier i enumeration konstruktioner med tal, små og store bogstaver, ".", "/" og mellemrum. Udgår STD-6 Et OIOXML-skema KAN udtrykke værdier i enumeration konstruktioner enten på dansk eller engelsk. STD-6 STD-7 benytte whitespace-facetten. Regler for komplekse typedefinitioner CTD-1 CTD-2 CTD-3 CTD-4 CTD-5 CTD-6 CTD-7 Et OIOXML-skema SKAL definere en kompleks type ved anvendelse af konstruktionerne sequence og choice. definere en kompleks type ved anvendelse af konstruktionen all. Et OIOXML-skema KAN definere en kompleks type via extension konstruktionen. definere en kompleks type via restriction konstruktionen. Et OIOXML-skema KAN benytte den blandede indholdsmodel (mixed content) til strukturer, hvor tekst og elementer frit kan blandes. Et OIOXML-skema KAN benytte den tomme indholdsmodel (empty content) til strukturer, hvor tekst og elementer frit kan blandes. Et OIOXML-skema KAN benytte any konstruktionen til at binde to relaterede, og eventuelt uafhængige, OIOXML-dialekter sammen. formulering Et OIOXML-skema SKAL udelukkende udtrykke værdier i enumeration konstruktioner med tal, små og store bogstaver og mellemrum. 13

14 3.2 CTD-8 CTD-9 CTD-10 CTD-11 Regler for elementerklæringer ELD-1 benytte any konstruktionen til at skabe en bevidst svag indholdsmodel indenfor samme OIOXMLdialekt eller til generelt at skabe en uforpligtende overgang til et eller flere elementer, som enten er statisk kendt på forhånd eller som ikke reelt repræsenterer en selvstændig OIOXML-dialekt. Et OIOXML-skema SKAL i en any konstruktion sætte værdien af processcontents attributten til strict. benytte anyattribute konstruktionen i indholdsmodellen for en kompleks type. Et OIOXML-skema tilhørende Kerneklassen MÅ IKKE genbruge eksisterende elementer i indholdsmodellen for dets komplekse typedefinition, med mindre disse elementer ligeledes tilhører Kerneklassen. Et OIOXML-skema SKAL erklære dets element globalt. formulering Et OIOXML-skema tilhørende Kerneklassen eller Domæneklassen SKAL erklære dets element globalt. Udgår ELD-2 Et OIOXML-skema tilhørende -klassen BØR erklære dets element globalt. ELD-2 ELD-3 Et OIOXML-skema SKAL tildele et namespace til dets element, dvs. attributten elementformdefault i rodelementet schema SKAL tildeles værdien qualified og attributten form i elementeterklæringer MÅ IKKE benyttes. ELD-3 ELD-4 benytte substitution groups i dets elementerklæring. 14

15 3.2 ELD-4 ELD-5 specificere nillable-attributten i en elementerklæring. ELD-5 ELD-6 benytte attributten default i dets elementerklæring. ELD-6 ELD-7 benytte attributten fixed i dets elementerklæring. Regler for attributerklæringer ATD-1 Et OIOXML-skema SKAL benytte dets elements attributter til metadata for elementets værdi. ATD-2 Et OIOXML-skema SKAL erklære alle dets attributter lokalt. ATD-3 tildele et namespace til dets attributter, dvs. attributten attribute- FormDefault i rodelementet schema SKAL tildeles værdien unqualified, eller slet ikke specificeres (unqualified er defaultværdien), og attributten form i attributerklæringer MÅ IKKE benyttes. ATD-4 benytte attributten default i dets ATD-5 Versioneringsregler VER-1 VER-2 attributerklæringer. benytte attributten fixed i dets attributerklæringer. Et OIOXML-skema SKAL angive dets version ved hjælp af <version>-termen i dets target namespace. Et OIOXML-skema SKAL i en ny version af samme OIOXMLskema specificere en <version>term i dets target namespace med et højere versionsnummer end anvendt i en eventuelt tidligere version af skemaet. formulering specificere nillable attributten i en elementerklæring, således at defaultværdien false altid er gældende. Et OIOXML-skema SKAL angive dets version ved hjælp af <version>-termen i OIOXMLskemafilnavnet. Et OIOXML-skema SKAL i en ny version af samme OIOXML-skema specificere en datoangivelse i <version>-termen i OIOXMLskemafilnavnet, der er senere end datoen anvendt i en eventuelt tidligere version af skemaet. 15

16 3.2 VER-3 VER-4 VER-5 Namespaceregler NMS-1 (Ny) oprettes i en ny version, dvs. med en ny <version>-term i dets target namespace, hvis skemaets indhold er uændret. slettes eller ændres på Digitalisér.dk. Et OIOXML-skema KAN frit benytte attributten version i rodelementet schema. Et OIO-namespace SKAL defineres i overensstemmelse med W3C XML Namespace anbefalingen af 16. august 2006: Namespaces in XML 1.0 (Second Edition). NMS-2 NMS-1 Et OIO-namespace SKAL anvende følgende opbygning: "urn:oio:" <organisation> ( ":" <forretningsområde> )? ":" <version>. Kun små bogstaver (a-z), ':' og tal kan anvendes i værdien for <organisation> og <forretningsområde>. formulering oprettes i en ny version, dvs. med en ny <version>-term i skemafilnavnet, hvis skemaets indhold er uændret. Et OIOXML-skema, som er godkendt og optaget i en af OIOXML klasserne, MÅ IKKE slettes eller ændres i InfoStrukturBasen. Et OIO-namespace SKAL repræsentere en gyldig URL i Infostrukturbasen med følgende opbygning: <isb-indgang> "/" ( <isborganisation> "/")? <isbforretningsområde> "/" ( <isbteknik> "/" )? Udgår NMS-1a Et OIO-namespace SKAL i dets namespace-term <isb-indgang> altid anvende værdien " 16

17 3.2 NMS-2a NMS-1b Et OIO-namespace SKAL i dets namespace-term <organisation> anvende opbygningen <toporganisation> ( ":" <suborganisation> )*. Værdien for <toporganisation> SKAL være entydig og svare til en reel eksisterende organisation (myndighed, virksomhed, eller lignende) med samme navn eller forkortelse. Hvis to eller flere organisationer er involveret, kan et organisatorisk fællesnavn anvendes, f.eks. et overordnet navn på en løsning eller et konsortium (f.eks. virk, borger, oib). En organisation MÅ IKKE anvende flere alternative værdier for <toporganisation> eller anvende en værdi, der svarer til en anden organisation. NMS-2b NMS-1c Et OIO-namespace SKAL i dets namespace-term <forretningsområde> anvende opbygningen: <topforretningsområde> ( ":" <subforretningsområde> )*. NMS-2c NMS-1d Et OIO-namespace SKAL i dets namespace-term <version> anvende opbygningen <majorversion> ("." <minor-version> ("." <revision> )? )?. Kun tal kan anvendes i værdien for <majorversion>, <minor-version> og <revision>. formulering Et OIO-namespace SKAL i dets namespace-term <isborganisation> anvende opbygningen <toporganisation> ( "." <suborganisation> )*. Værdien for <toporganisation> SKAL være entydig og svare til en reel eksisterende organisation (myndighed, virksomhed, eller lignende) med samme navn eller forkortelse. En organisation MÅ IKKE anvende flere alternative værdier for <toporganisation> eller anvende en værdi, der svarer til en anden organisation. Kun små bogstaver (a-z) og tal kan anvendes i værdien for <toporganisation> og <suborganisation>. Et OIO-namespace SKAL i dets namespace-term <isbforretningsområde> anvende opbygningen: <forretningsområde> ( "." <subforretningsområde> )*. Kun små bogstaver (a-z) og tal kan anvendes i værdien for <forretningsområde> og <subforretningsområde>. Et OIO-namespace SKAL i dets namespace-term <isb-teknik> anvende opbygningen <teknik> ( "." <subteknik> )*. Kun små bogstaver (a-z) og tal kan anvendes i værdien for <teknik> og <subteknik>. Udgår NMS-2 Et OIOXML-skema SKAL altid i dets OIO-namespace angive namespace-termen <isb-teknik> og værdien af <isb-teknik> SKAL altid være "xml.schema". Dokumentation af OIOXML skemaer DOC-1 Et OIOXML-skema SKAL placere al dets dokumentation i skemaets metadatafil. 17

18 3.2 DOC-2 DOC-3 DOC-4 DOC-5 DOC-6 DOC-7 DOC-8 DOC-9 DOC-10 DOC-11 Et OIOXML-skema SKAL udfylde metadata-elementet Title med en overordnet titel for skemaet. Hvis metadata-elementet DescriptionEnglish udfyldes, SKAL metadata-elementet indeholde en udførlig beskrivelse af skemaets funktion på engelsk. Hvis metadata-elementet DescriptionDanish udfyldes, SKAL metadata-elementet indeholde en udførlig beskrivelse af skemaets funktion på dansk. Et OIOXML-skema tilhørende Kerneklassen SKAL udfylde metadata-elementerne DescriptionEnglish og DescriptionDanish. Et OIOXML-skema tilhørende Domæneklassen eller klassen SKAL udfylde enten metadata-elementet DescriptionEnglish eller metadata-elementet DescriptionDanish, og KAN udfylde begge metadata-elementer, hvilket anbefales. Et OIOXML-skema KAN udfylde metadata-elementerne LabelEnglish og/eller LabelDanish til at angive en brugervenlig term, som egner sig til præsentation i en brugergrænseflade. Hvis metadata-elementet LabelEnglish udfyldes, SKAL termen være på engelsk. Hvis metadata-elementet Label- Danish udfyldes, SKAL termen være på dansk. benytte appinfo konstruktionen. Et OIOXML-skema SKAL dokumentere alle værdierne i en kodeliste enten i metadata eller med en reference til et andet fyldestgørende dokument. formulering Et OIOXML-skema SKAL dokumentere alle værdierne i en kodeliste enten lokalt eller med en reference til et andet fyldestgørende dokument i Infostrukturbasen. 18

19 3.2 DOC-12 Metadata for OIOXML skemaer MTA-1 En OIOXML-aflevering SKAL indeholde afleveringsdokumentation, der overordnet beskriver afleveringens skemaer. Et OIOXML-skema SKAL have tilknyttet en metadatafil. formulering Repræsentationstermer anvendt i GNR2-d Repræsentationsterm Engelsk Dansk Beskrivelse Amount Beloeb Et antal af monitære enheder specificeret i en møntfod, hvor møntfoden enten er eksplicit eller implicit. Code Kode En karakterstreng der kan bruges til at repræsentere eller erstatte en definitiv værdi eller tekst, f.eks. som forkortelse og/eller for at opnå sproguafhængighed. Koder er normalt vedligeholdt i en kodeliste per type, f.eks. farve. Data Data Binær data repræsenteret i base64binary og hexbinary tekstformat, komplementær til termen Tekst. Date Dato En dato indenfor et bestemt kalenderår, baseret på ISO DateTime (*) DatoTid Et bestemt tidspunkt. Identifier Identifikator En karakterstreng der, indenfor en identifikationsramme, bruges til at identificere og unikt udpege én instans af et objekt blandt alle objekter indenfor samme ramme. Reference Reference En karakterstreng som bruges til at referere til en bestemt objektinstans identificeret med en Identifier (dette er en tilføjelse til de repræsentationstermer, ebxml definerer). Indicator Indikator En liste af to og kun to værdier, som indikerer en tilstand som f.eks. "on/off" eller "true/false". Synonymt med "boolean". Measure Maal En numerisk værdi bestemt ved at måle et objekt. Dette mål kan angives med en måleenhed; de mulige måleenheder tages fra UN/ECE Rec. 20. Name Navn Et ord eller en frase som indeholder den præcise betegnelse for en person, et sted, ting eller koncept. Percent Procent En rate udtrykt som en hundrede-del mellem to værdier med samme måleenhed. 19

20 Quantity Kvantitet Et antal af ikke monitære enheder. Den er associeret med indikationen af objekter. Mængder kan angives med en eksplicit mængdeenhed. Rate Rate En mængde eller et antal målt i forhold til en anden mængde eller antal, eller en fast eller passende ladning, omkostning eller værdi, f.eks. "kroner i timen", "danske kroner per EURO" eller "kilometer per liter". Text Tekst En karakterstreng udtrykt generelt som ord i et sprog. Time Tid Tidspunktet indenfor en ikke specificeret dag. Baseret på ISO 8601: