{"type":"doc","content":[{"type":"paragraph"},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"79cfe4af-bc35-4476-afd6-f263788bbb8c"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[178.0]},"content":[{"type":"mediaSingle","attrs":{"layout":"center","width":250,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1182,"id":"93c9a844-c84c-4bed-bd39-8fc544af82da","collection":"contentId-3632859","type":"file","height":549}}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[582.0]},"content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"RIV Tekniska Anvisningar Domänschema","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Version 2.1.8","type":"text"}]},{"type":"paragraph","content":[{"text":"ARK_0006","type":"text"}]},{"type":"paragraph","content":[{"text":"2024-09-18","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Innehållsförteckning","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"6"},"minLevel":{"value":"1"},"include":{"value":""},"outline":{"value":"false"},"indent":{"value":""},"exclude":{"value":""},"type":{"value":"list"},"printable":{"value":"true"},"class":{"value":""}},"macroMetadata":{"macroId":{"value":"e435e945-9602-4d10-a172-e0d1784ea648"},"schemaVersion":{"value":"1"},"title":"Innehållsförteckning"}},"localId":"acfab92e-5296-4736-836b-79e49bf8a46c"}},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"2202b118-9a39-4cb2-948f-a863150cede7"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":4,"rowspan":1,"colwidth":[99.0,125.0,304.0,232.0]},"content":[{"type":"paragraph","content":[{"text":"Versionshistorik","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"Utgåva","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"Revision Datum","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Beskrivning","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Ändringarna gjorda av","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"A","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2011-10-19","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Fastställd revision","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Marcus Krantz","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"B","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2012-01-03","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Fastställd revision","type":"text"}]},{"type":"paragraph","content":[{"text":"Uppdaterat dokumentet i och med byte av projektplats från Osor till Google code. Enbart ändringar under rubriken Referenser.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Hans Thunberg","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"C","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2013-06-19","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Ny revision efter CeHis nya processer","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Arkitektur och regelverk, Center för eHälsa i samverkan","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"2.1.1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2014-08-20","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Förtydligat regel #6 och flyttat XML-exempel till bilagor.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Mattias Nordvall","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"2.1.1","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2014-09-26","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Lagt över i Inera mall och publiserat.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Lennart Eriksson","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"2.1.2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2015-12-17","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Uppdaterat länkar i referenstabell","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Mattias Nordvall","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"2.1.3","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2018-05-08","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Lagt till att även domänprefix kan ha olika värden, var förut hårt satt till \"riv:\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Förtydligat namnsättningsregler och struktur för domän resp interaktionsnivå","type":"text"}]},{"type":"paragraph","content":[{"text":"Ändrat regel #4 från bör till skall","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Björn Hedman","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"2.1.4","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2019-11-20","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Förtydligat att domänprefix används för att signalera ansvarig domän men att ägandeskapet av en domän kan ändras utan att domänens namnrymd ändras.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Björn Hedman","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"2.1.5","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2019-12-20","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Förtydligat hur hantering av minor uppdateringar ska ske","type":"text"}]},{"type":"paragraph","content":[{"text":"regel 2, namsättning fil","type":"text"}]},{"type":"paragraph","content":[{"text":"ändrat kapitel med exempel till att hänsvisa till bilagor","type":"text"}]},{"type":"paragraph","content":[{"text":"Ändrat felaktig benämning i regel 6 (bytt tjänsteschema till domänschema)","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Björn Hedan","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"2.1.6","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2020-09-24","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Generaliserat ”Notera”-information från ”det kan dock finnas domäner som har en extern ägare som ändå har riv som prefix” till ”det kan dock finnas domäner som har en annan ägare än det som angetts i prefixet” eftersom det även kan finnas fall där externa domäner som inte har riv som prefix ägs av Inera. Förtydligat att ANY-elementet kan bytas ut mot enbart ett element, rättat domän-prefix och små punkterings och skrivfel. Lagt till beskrivning för hur versionsförändring ska ske när komplexa typer, som definierats i domänschemat, ska ändras.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Ranjdar Fallyih","type":"text"}]},{"type":"paragraph","content":[{"text":"Thomas Siltberg","type":"text"}]},{"type":"paragraph","content":[{"text":"Claudia Ehrentraut","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"2.1.7","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2021-09-09","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Obsoleta mailadresser borttagna ur revisionshistoriken. Ersatta med namn","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Anders Malmros","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[99.0]},"content":[{"type":"paragraph","content":[{"text":"2.1.8","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[125.0]},"content":[{"type":"paragraph","content":[{"text":"2024-09-18","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[304.0]},"content":[{"type":"paragraph","content":[{"text":"Förbättrat läsbarhet genom bättre formatering och referenser i löptext","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[232.0]},"content":[{"type":"paragraph","content":[{"text":"Björn Hedman","type":"text"},{"type":"hardBreak"},{"text":"Anders Malmros","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"1. Inledning","type":"text"}]},{"type":"paragraph","content":[{"text":"Detta dokument beskriver regelverket RIV Tekniska Anvisningar Domänschema 2.1.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start","width":536,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1324,"id":"1099984f-76ef-4a9c-9725-60e6901f80eb","collection":"contentId-3632859","type":"file","height":947}},{"type":"caption","content":[{"text":"Anvisningen i sitt sammanhang","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1.1 Målgrupp","type":"text"}]},{"type":"paragraph","content":[{"text":"Denna anvisning riktar sig till dem som ska specificera XML-scheman för tjänstekontrakt i en nationell tjänstedomän. Anvisningen innehåller endast regeluppsättningen. För bakgrund, motiv, krav samt de principer som ligger till grund för framtagning av reglerna hänvisas till ","type":"text"},{"text":"RIV Tekniska Anvisningar - Översikt 2.0","type":"text","marks":[{"type":"link","attrs":{"href":"https://rivta.se/documents/ARK_0001/"}}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1.2 Syfte","type":"text"}]},{"type":"paragraph","content":[{"text":"Syftet med denna anvisning är att beskriva designregler och namngivningsregler för de meddelandetyper som skall användas inom en tjänstedomän.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"1.3 Tillgänglighet","type":"text"}]},{"type":"paragraph","content":[{"text":"Detta dokument är publicerat under licensen Creative Commons CC-BY-SA (","type":"text"},{"type":"inlineCard","attrs":{"url":"http://creativecommons.org/licenses/by-sa/2.5/se/"}},{"text":" ). ","type":"text"}]},{"type":"paragraph","content":[{"text":"Det betyder att du fritt får kopiera, distribuera och skapa bearbetningar av anvisningarna under förutsättning att upphovsmannen Sveriges Kommuner och Regioner anges, men inte på ett sätt som antyder att de godkänt eller rekommenderar din användning av verket.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"2. Meddelanderegler","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Regel #1, designmönster för domänscheman","type":"text"}]},{"type":"paragraph","content":[{"text":"\"Venetian Blind\" ","type":"text"},{"text":"skall","type":"text","marks":[{"type":"em"}]},{"text":" användas som designmönster för domänscheman.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"},{"type":"inlineCard","attrs":{"url":"http://www.xfront.com/GlobalVersusLocal.html"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":" Designmönstret Venetian Blind innebär följande:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Den interna strukturen i ett meddelande byggs upp med hjälp av globalt deklarerade typer. Med ”globalt deklarerade” menas deklarationer som görs direkt under schema-elementet.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Endast rotelementet är deklarerat som ett globalt element. I web-service-fallet innebär det att request- och response-elementen är globalt deklarerade element medan resten är typer.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Anm. I vissa fall kan även andra element än request och response behöva vara globala, t ex används element-referenser till globala element i importerade scheman för att stödja versioneringsstrategin, se nedan.","type":"text","marks":[{"type":"em"}]}]},{"type":"paragraph","content":[{"text":"Motiv:","type":"text","marks":[{"type":"strong"}]},{"text":" Interoperabilitet, WS-I Basic Profile","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Regel #2, namn på xsd-filen","type":"text"}]},{"type":"paragraph","content":[{"text":"Schema-filen för ett domänschema ","type":"text"},{"text":"skall","type":"text","marks":[{"type":"em"}]},{"text":" namnges enligt följande regel: ${tjänstedomän}_${m.n}.xsd","type":"text"}]},{"type":"paragraph","content":[{"text":"Motiv:","type":"text","marks":[{"type":"strong"}]},{"text":" Att ha med versionsnummer i namnet på källkodsfiler är generellt sett något man försöker undvika då det försvårar användning av versionshanteringsverktyg (t ex Subversion, Microsoft Visual Studio). I fallet med domänschema behöver man dock kunna hantera flera olika versioner samtidigt (i byggsystem mm) och för att underlätta den hanteringen ingår versionsnumret i filnamnet på tjänstekontrakt och tjänstescheman. I normalfallet ersätts filen av den nyare versionen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Exempel:","type":"text","marks":[{"type":"strong"}]},{"text":" Första version : itintegration_monitoring_1.0.xsd","type":"text"}]},{"type":"paragraph","content":[{"text":"Efter minoruppdatering : itintegration_monitoring_1.1.xsd","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Regel #3, namn på target namespace","type":"text"}]},{"type":"paragraph","content":[{"text":"Attributet targetNamespace på schema-elementet ","type":"text"},{"text":"skall","type":"text","marks":[{"type":"em"}]},{"text":" ha ett värde som definieras av följande regel: urn:${domänPrefix}:${tjänsteDomän}:${majorVersion}","type":"text"}]},{"type":"paragraph","content":[{"text":"Namngivningsregler för namespace är formulerade enligt följande uppställning:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tjänstedomänens prefix: ","type":"text"},{"text":"${domänPrefix}","type":"text","marks":[{"type":"strong"}]},{"text":", t ex riv eller riv-application","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tjänstedomänens namn: ","type":"text"},{"text":"${tjänsteDomän}","type":"text","marks":[{"type":"strong"}]},{"text":", t ex clinicalprocess:activity:request","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Domänschemats version: ","type":"text"},{"text":"${majorVersion}","type":"text","marks":[{"type":"strong"}]},{"text":", tex 1","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Reglerna för namnsättning av domän finns mer utförligt beskrivna i dokumentet för domännamnsättning","type":"text"}]},{"type":"paragraph","content":[{"text":"Motiv:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Domänprefixet ska signaler vilken organisation som ansvarar för support och utveckling av respektive domän.","type":"text"}]},{"type":"paragraph","content":[{"text":"NOTERA:","type":"text","marks":[{"type":"strong"}]},{"text":" det kan dock finnas domäner som har en annan ägare än det som angetts i prefixet, detta sker i de fall som ägandeskapet ändrats utan att hela domänen ska re-faktureras.","type":"text"}]},{"type":"paragraph","content":[{"text":"Användningen av major-version i namnrymden är en av att följa fastslagen versioneringsstrategi. Att ha en unik namnrymd per tjänstekontrakt (tjänsteinteraktion + roll) är en förutsättning för att följa WS-I Basic Profiles regel om ”operation signature” (","type":"text"},{"type":"inlineCard","attrs":{"url":"http://www.ws-i.org/Profiles/BasicProfile-1.1.html"}},{"text":").Det också generellt goda förutsättningar för att implementera generella bryggor och tjänsteväxlar","type":"text"}]},{"type":"paragraph","content":[{"text":"Exempel:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Nationell domän","type":"text"}]},{"type":"paragraph","content":[{"text":"urn:riv:itintegration:monitoring:1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Applikationsdomän","type":"text"}]},{"type":"paragraph","content":[{"text":"urn:riv-application:sob:apps:resident:1","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Extern domän","type":"text"}]},{"type":"paragraph","content":[{"text":"urn:riv-lv.lv.reporting.pharmacovigilance","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Regel #4, användning av schema-attributet version","type":"text"}]},{"type":"paragraph","content":[{"text":"Schema-attributet version ","type":"text"},{"text":"skall","type":"text","marks":[{"type":"em"}]},{"text":" sättas till \"m.n\"","type":"text"}]},{"type":"paragraph","content":[{"text":"Motiv:","type":"text","marks":[{"type":"strong"}]},{"text":" Då namnrymden inte innehåller minor-version, ger detta en dokumentation som följer intentionen med attributet.","type":"text"}]},{"type":"paragraph","content":[{"text":"Exempel:","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Regel #5, användning av any-element för utökningsbarhet","type":"text"}]},{"type":"paragraph","content":[{"text":"För att uppnå framåtkompatibilitet ","type":"text"},{"text":"skall","type":"text","marks":[{"type":"em"}]},{"text":" ett xsd:any element läggas in sist i alla komplexa typer som ska kunna utökas, exempel:","type":"text"}]},{"type":"paragraph","content":[{"text":"Motiv: ","type":"text","marks":[{"type":"strong"}]},{"text":"För att uppnå framåtkompatibilitet måste man \"förbereda\" sina XML scheman för framtida utökningsbarhet. Detta är en del av den tillämpade strategin för versionering.","type":"text"}]},{"type":"paragraph","content":[{"text":"Exempel:","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Regel #6, nya element i utökningsschema","type":"text"}]},{"type":"paragraph","content":[{"text":"För att lägga till nya element och skapa en ny minor-version av ett domänschema, ","type":"text"},{"text":"skall","type":"text","marks":[{"type":"em"}]},{"text":" följande regler följas:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Det nya elementet läggs till i befintligt schema och ersätter any-elementet i den komplexa typ som ska utökas. Detta nya element har ingen typ, utan refererar (xsd:ref=”…”) element som är rotelement i en ny schema-fil (","type":"text"},{"text":"utöknings-schema","type":"text","marks":[{"type":"em"}]},{"text":")","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Exempel ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"För att ändringen ska vara bakåtkompatibel så måste det nya elementet ha attributet minoccurs=”0”. Detta för att uppfylla kravet på Unique Particle Attribution i Xml Schema 1.0. Följden blir att denna komplexa typ inte kan förändras fler gånger på ett bakåtkompatibelt sätt.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Det nya elementet definieras i en ny schema-fil (utökningsschema) med ett namn som följer följande regel: ${tjänstedomän}_${m.n}_","type":"text"},{"text":"ext","type":"text","marks":[{"type":"strong"}]},{"text":".xsd","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Utökningsschemat ska ha en targetNamespace enligt följande regel: urn:${domänPrefix} :${tjänsteDomän}:${m.n}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Domänschemat importerar (xsd:import) utöknings-schemat som ges namnrymdsalias enligt följande regel: m${n}","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Exempel:","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"xmlns:m1='urn:riv:infrastructure:directory:organization:GetUnitResponder:2.2'","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Domänschemats versionsattribut ändras till den nya minor-versionen.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"I nästa major-version av tjänsteschemat flyttas element-deklarationerna in från alla utökningsscheman (det finns ett för varje minor-version som tilkommit sedan förra major-versionen skapades). Dessutom läggs eventuellt borttagna any-element tillbaka, enligt regel #5.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"När komplexa typer som definierats i domänschema ska ändras så sker versionsförändringen enligt följande:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Nya (minor) versionen av domänschemat ersätter tidigare fil.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Endast interaktioner som får strukturell påverkan av ändringar i domänschema behöver ändra version.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Med strukturell påverkan menas att interaktionen använder element som förändrats i domänschemat.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Övriga interaktioners schemafiler importerar förvisso nya schemat så det sker en förändring av importen i filen men inte interaktionens struktur och därför ökas inte version i interaktionen eller filnamn.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Tidigare versioner av domänschemat försvinner.","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Motiv: ","type":"text","marks":[{"type":"strong"}]},{"text":"Detta förfarande är en konsekvens av vald strategi för versionering ","type":"text"},{"text":"W3C Extending and Versioning Languages: XML Languages","type":"text","marks":[{"type":"link","attrs":{"href":"http://www.w3.org/2001/tag/doc/versioning-xml"}}]},{"text":" . Se ","type":"text"},{"type":"inlineCard","attrs":{"url":"http://rivta.se/documents/ARK_0001/"}},{"text":" för ytterligare bakgrund.","type":"text"}]},{"type":"paragraph","content":[{"text":"Se även Bilaga 1 och 2 för exempel","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Bilaga 1: Exempel på utökning av domänsschema","type":"text","marks":[{"type":"link","attrs":{"href":"https://inera.atlassian.net/wiki/spaces/RTA/pages/582288197"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Bilaga 2: Exempel på utökning via både domänschema och interaktionsschema","type":"text","marks":[{"type":"link","attrs":{"href":"https://inera.atlassian.net/wiki/spaces/RTA/pages/582026207"}}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Regel #7 Nationella tecken","type":"text"}]},{"type":"paragraph","content":[{"text":"Domänscheman ","type":"text"},{"text":"ska","type":"text","marks":[{"type":"em"}]},{"text":" inte använda nationella tecken i såväl elementnamn, attributnamn som vid listning av värdemämngder för uppräkningstyper. Följande exempel bör därför undvikas:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n …\n \n \n \n \n \n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Motiv:","type":"text","marks":[{"type":"strong"}]},{"text":" För att undvika interoperabilitetsproblem bör man ej använda sig av nationella tecken när man definierar typer som kommer att användas i ett tjänstekontrakt. Ofta uppstår annars fel vid kodgenerering från schemat.","type":"text"}]}],"version":1}

Webbläsaren stöds inte