Gå till slutet av bannern
Gå till början av bannern

Formatspecifikation XML

Hoppa till slutet på meta-data
Gå till början av metadata

Du visar en gammal version av den här sidan. Visa nuvarande version.

Jämför med nuvarande Visa sidhistorik

« Föregående Version 2 Nästa »



Version 2.0 exportformatet (XML).

export 1..1  (ExportType)

Datatypen beskriver vilka urval som gjordes i användargränssnittet i SoB exportgränssnitt och som gäller för efterföljande data om moment i denna fil

AttributKardinalitetBeskrivning
exportDate1..1

Tidsstämpel för när exporten skedde. Skrivs som yyyy-MM-dd'T'hh:mm:ss+<tidszon>

systemName1..1Namnet på systemet "Stöd och behandling"
processName1..1Namnet på momentetmallen som valdes vid exportfiltreringen
specifiedSelection1..1

Val av export. Ett av följande fyra konstanter är valbara. Valen följer de fyra alternativ som finns i användargränssnittet för export:

ALL (alla invånare)

FILTER_ON_CATEGORIES (Begränsat urval baserat på en eller flera kategorier)

ONLY_ONE_RESIDENT (Begränsat urval på en invånare inklusive länkade moment)

SELECT_RESIDENTS (Begränsat urval på en eller flera invånare). 

selectedCategories0..*Lista med kategorier som valdes att exporteras, om FILTER_ON_CATEGORIES valdes ovan.
status1..*Visar filtreringen som gjordes på status för moment. Om filtrering gjorts på avslutade moment kommer status vara DONE. Om filtrering gjorts på pågående moment kommer två statusar visas: INPROGRESS och MAINTAIN då både moment som pågår och moment som är i vidmakthållande räknas som pågående moment.
residentAnonymization1..1

Visar om vald export inkluderar personuppgifter för invånare eller inte, visas som följande:

Ingen invånarinformation: ANONYMIZED

Invånarinformation med hashat personnummer: PSEUDONONYMIZED

Invånarinformation i klartext (personnummer och namn): NONE.

Ålder vid momentstart samt kön kommer alltid med i exporten.

modulesExported1..1Visar om modulinformation valdes att exporteras. true/false.
messageTransactionsExported1..1Visar om meddelandehistorik valdes för export. true/false.
activityPlansExported1..1Visar om formulär som ingår i aktivitetsplaner med eventuellt tillhörande resultat valdes för export. true/false
measurementBatteriesExported1..1

Visar om formulär som ingår i mätbatterier med eventuellt tillhörande resultat valdes för export. true/false.

formsExported1..1

Visar om formulär som inte ingår i mätbatterier med eventuellt tillhörande resultat valdes att exporteras. true/false.

startFromPeriod0..1Användaren tillåts i exportgränssnittet att välja ett datumintervall för vilka moment som ska exporteras. StartFromPeriod visar periodens från och med-datum för momentens startdatum. Om fältet är tomt och startToPeriod har ett värde kommer startFromPeriod tolkas som tidigast möjliga datum ett moment kan ha startats.
startToPeriod0..1Användaren tillåts i exportgränssnittet att välja ett datumintervall för vilka moment som ska exporteras. StartToPeriod visar periodens till och med-datum för momentens startdatum. Om fältet är tomt och startFromPeriod har ett värde kommer startToPeriod tolkas som dagens datum.
endFromPeriod0..1Användaren tillåts i exportgränssnittet att välja ett datumintervall för vilka moment som ska exporteras. EndFromPeriod visar periodens från och med-datum för momentens avslutsdatum. Om fältet är tomt och endToPeriod har ett värde kommer endFromPeriod tolkas som tidigast möjliga datum ett moment kan ha avslutats.
endToPeriod0..1Användaren tillåts i exportgränssnittet att välja ett datumintervall för vilka moment som ska EndToPeriod visar periodens till och med-datum för momentens avslutsdatum. Om fältet är tomt och endFromPeriod har ett värde kommer endToPeriod tolkas som dagens datum.
processes0..*Lista med alla moment som exporterats.

processes  0..*  (ProcessType)

Lista med exporterade moment. Varje processes XML-nod håller information om ett specifikt moment som en invånare går.

AttributKardinalitetBeskrivning
id1..1Unikt Id för momentet.
name1..1

Momentets namn.

T.ex. Rehabilitering efter knäskada

status1..1

Den status som momentet hade vid exporttillfället. Status kan vara följande:

INPROGRESS - Pågående

DONE - Avslutad

MAINTAIN - I vidmakthållande

majorVersion1..1

Momentets huvudversion. Version på momentet består av de två attributen majorVersion och minorVersion.

T.ex. 1.2 ger majorVersion = 1 minorVersion = 2

minorVersion1..1

Momentets delversion. Version på momentet består av de två attributen majorVersion och minorVersion.

T.ex. 1.2 ger majorVersion = 1 minorVersion = 2

startDate1..1

Momentets start enligt formatet yyyy-MM-dd'T'hh:mm:ss+<tidszon>.

T.ex. 2015-01-13T10:00:00.000+01:00

lastActivityDate0..1

Senaste invånaraktivitet enligt formatet yyyy-mm-dd+<tidszon>. Kan vara tomt om invånaren aldrig varit aktiv enligt momentets definition på aktivitet.

T.ex. 2015-01-13+01:00 

endDate0..1

Momentets avslutsdatum enligt formatet yyyy-mm-dd+<tidszon>.

T.ex. 2016-12-20+01:00

maintainDate

0..1

Datumet då momentet sattes i vidmakthållande av behandlaren enligt formatet yyyy-mm-dd+<tidszon>

T.ex. 2017-02-26+01:00

terminationReason0..1Avslutningsorsak om momentet är avslutat. (se TerminationReason nedan)
categories0..*Lista med namn på de kategorier detta moment är märkt med.
resident1..1Invånare som momentet gäller. invånare exporteras enligt den komplexa typen ResidentType (se ResidentType nedan)
handlers1..*

Lista med ansvariga behandlare för momentet. Se komplexa typen HandlerType nedan.

Varje handler-nod motsvarar en period då en behandlare har haft ansvar för momentet. Om en behandlare har haft ansvar för momentet under två olika tidsperioder kommer detta att representeras av två handler-fält.

modules0..*Lista med moduler som ingår i momentet. Varje modul exporteras genom den komplexa typen ModuleType. Denna lista kommer att alltid innehålla alla moduler som finns tillgängliga för momentet, även om moduler ännu inte påbörjats.
measurementBatteries0..*Lista med mätbatterier för momentet. Varje mätbatteri exporteras genom den komplexa datatypen MeasurementBatteryType (Se nedan)
activityPlans0..*Lista med aktivitetsplaner för momentet. Varje aktivitetsplan exporteras genom den komplexa datatypen ActivityPlanType (Se nedan)
connectedProcesses0..*

Lista med information om moment som är länkade med detta moment. Länkade moment som exporteras här exporteras genom den komplexa typen ConnectedProcessType. Denna lista innehåller endast de unika IDn, namnen samt versionen på de länkade momenten.

I fallet då användaren valt att exportera alla moment inklusive länkade moment för en viss invånare (ONLY_ONE_RESIDENT) kommer denna lista inte att exporteras. Istället exporteras en instans av ProcessType för varje moment som innehåller en komplett bild av momentet.

conversations0..*Lista med konversationer som har förts mellan behandlare och invånare under momentet. Konversationer består vidare av meddelanden eller kommentarer och exporteras som den komplexa typen ConversationType (se nedan).

connectedProcesses 0..* (ConnectedProcessType)

Lista med information om länkade moment/behandlingar.

AttributKardinalitetBeskrivning
id1..1Id för det kopplade momentet.
name1..1

Namnet på det kopplade momentet

majorVersion

1..1Huvudversion på det kopplade momentet
minorVersion1..1Delversion på det kopplade momentet

terminationReason 0..1 (TerminationReasonType)

AttributKardinalitetBeskrivning
code1..1Komplex typ (CVType). Se vidare nedan underattributen för denna typ
code.code0..1

Kod till avslutningsorsak i Snomed. Tom om avslutningsorsak är satt till "Övrigt" eller om momentet avslutades innan release 1.12. Koder följer struktur enligt tabellen nedan (se Koder i Snomed).

Koden beskrivs via den komplexa typen CVType (Coded value).

code.codeSystem

0..1N/A
code.codeSystemName0..1N/A
code.displayName0..1Titel på avslutningsorsak enligt Snomed. Tom om avslutningsorsak är satt till "Övrigt" (ingen kod/orsak definierad) eller om momentet avslutades innan release 1.12
code.originalText0..1N/A
nameInSoB1..1Beskrivning/namn på avslutningsorsak enligt konfiguration i Stöd- och behandling. Denna beskrivning ska överrensstämma med beskrivning/konceptnamn i Snomed för förmedlad kod.

Koder i Snomed

Term i snomedNamn i Stöd och behandlingKod i snomed
behandling slutfördMoment slutfört182992009
åtgärd stoppadBehandlare avbryter moment394908001
patienten avböjer behandlingInvånare avbryter moment105480006
ändrad behandlingÄndrad behandling445528004
-Övrigt-

handlers 1..* (HandlerType)

Lista med behandlare som avsvarat för momentet. Om en behandlare har haft ansvaret vid flera olika tidsperioder kommer det att skapas en post per sådan period. En behandlare kan således förekomma flera gånger i denna lista.

AttributKardinalitetBeskrivning
hsaId1..1HSAId för behandlaren
name1..1För- och efternamn för behandlaren
startDate1..1Startdatum då behandlaren blev ansvarig för momentet. Visas som yyyy-MM-dd'T'hh:mm:ss+<tidszon>
endDate0..1Slutdatum för behandlarens ansvar för momentet. Tom om behandlaren fortfarande innehar ansvaret för momentet. Visas som yyyy-MM-dd'T'hh:mm:ss+<tidszon>
careGiver1..1Vårdgivare som behandlaren arbetar under, för momentet. Representeras av den komplexa typen OrgUnitType (Se nedan)
careUnit1..1Vårdenhet som behandlaren arbetar under, för momentet. Representeras av den komplexa typen OrgUnitType (Se nedan)
unit0..1Kopplad enhet som behandlaren arbetar under, för momentet. Representeras av den komplexa typen OrgUnitType (Se nedan)

careGiver 1..1, careUnit 1..1, unit 0..1 (OrgUnitType)

Vårdgivare/vårdenhet eller kopplad enhet som behandlaren arbetar under.

AttributKardinalitetBeskrivning
hsaId1..1

Enhetens hsa-id. Motsvarar HSA-identitet på den enhet aktuellt uppdrag tillhör.

name1..1Enhetens namn.

modules 0..* (ModuleType)

Lista som innehåller alla moduler som finns tillgängliga för momentet. Listan innehåller även moduler som ännu inte är påbörjade för det specifika momentet. Antalet moduler i listan är m a o konstant för en specifik version av momentet.

AttributKardianlitetBeskrivning
name1..1

Namn på modulen

index1..1

Index (löpsiffra/numrering) för modulen, som visar i vilken ordning modulen legat i momentet. Behandlaren kan per moment välja att starta moduler i olika ordning så index kommer inte att motsvara den ordning invånaren har fått se modulerna, utan endast den ordning designern valt att lägga modulerna.

statusChanges

0..*

Lista med alla statusändringar för modulen. Moduler som aldrig startats och varit tillgängliga för invånaren kommer inte att ha några statusändringar. Varje statusändring representeras av den komplexa datatypen ModeuleStatusType (se nedan)

statusChanges 0..* (ModuleStatusType)

AtributKardinalitetBeskrivning
date1..1Datum och tid då statusändringen skedde. Visas som yyyy-MM-dd'T'hh:mm:ss+<tidszon>
status1.1

Nytt status för modulen. En av (START|STOP|PENDING)

START visar när modulen satts som tillgänglig för invånaren. Detta kan vara när behandlaren manuellt startat modulen, alternativt när modulen gjordes synlig i samband med vidmakthållande.

STOP visar när behandlaren manuellt har satt en modul som avklarat. Moduler loggas inte som STOP i samband med vidmakthållande eller avslut av moment.

PENDING visar när en behandlare manuellt satt en modul till kommande, efter att den startats.

resident 1..1 (ResidentType)

Håller information gällande den invånare som behandlas.

AttributKardinalitetBeskrivning
firstName0..1

Invånarens förnamn.

Ersätts med "Skyddad" om personuppgiften är skyddad.

Om invånaren inte har ett förnamn anges "NOT DEFINED"

lastName0..1

Invånarens efternamn.

Ersätts med "Identitet" om personuppgiften är skyddad.

Om invånaren inte har ett efternamn anges "NOT DEFINED"

personId0..1

Personnummer enligt den komplexa datatypen PersonIdType

personId.id1..1

Personnummer eller liknande unik identifierare för invånare. I dagsläget stödjer systemet endast personnummer.

Formatet för personnummer yyyymmdd-nnnn.

T.ex. 19121212-1212

Om dataadmin valt att exportera prsonnummer hashat (krypterat) skrivs detta ut istället för personummer.

personId.type1..1

OID eller liknande som visar vad för typ av identifierare för person som avses. Kan sättas till:

"1.2.752.129.2.1.3.1" = Id genererat från Skatteverket och motsvarar person-id för någon som är folkbokförd i Sverige enligt SKV704.

"HASHED_PERSON_ID" = Personnumret är krypterat.

gender1..1

Invånarens kön. Kan vara en av tre värden: MALE, FEMALE, OTHER. Om en person har skyddad identitet anges kön som OTHER.

ageAtStart1..1Invånarens ålder vid start av momentet.


conversations 0..* (ConversationType)

Lista med konversationer som antingen är av typen kommentar eller meddelande (Observera att datatypen ConversationType också innehåller en lista - messages. Se nästa avsnitt). Listan innehåller instanser av datatypen ConversationType som grupperar de enskilda kommentarerna/meddelandena. Samtliga konversationer ligger direkt under ProcessType, oavsett om det är kommentarer eller meddelanden.

AttributKardinalitetBeskrivning
messageType1..1

Vilken typ av meddelanden som finns i konversationen.

MESSAGE - om konversationen innehåller fristående meddelanden.

COMMENT - om konversationen innehåller kommentarer på steg eller formulär.

messages0..*Lista med de meddelanden som skickats i konversationen. Meddelanden som inte skickats (utkast) kommer inte med i exporten.


messages 0..* (MessageType)

Lista med meddelanden/kommentarer. Varje instans i denna lista motsvarar det enskilda meddelandet/kommentaren som skickats inom en konversation. Konversationer är i sin tur antingen "meddelanden" eller "kommentarer"

AttributKardinalitetBeskrivning
sentDate1..1Datum och tid för när meddelandet skickades. Visas som yyyy-MM-dd'T'hh:mm:ss+<tidszon>

sender

1..1

Visar vem som skickat meddelandet.

HANDLER = meddelandet skickat av behandlaren till invånaren

RESIDENT = meddelandet skickat av invånaren till behandlaren

handlerHsaId0..1HSAId för behandlaren som skickade meddelandet. Saknas om det var invånaren som skickade meddelandet.
handlerName0..1Namn (för och efternamn) på behandlaren. Saknas om det var invånaren som skickade meddelandet.

activityPlans 0..* (ActivityPlanType)

Lista med aktivitetsplaner för momentet. Varje aktivitetsplan exporteras genom den komplexa datatypen ActivityPlanType

AttributKardinalitetBeskrivning
name1..1Namn på aktivitetsplanen
activities0..*Lista med aktiviteter. Varje instans i denna lista är av typen ActivityType (se ActivityType nedan)

activities 0..* (ActivityType)

activities innehåller en eller flera instanser av ActivityType. Varje ActivityType motsvarar en aktivitet, i form av ett formulär (en instans av ett formulär) som ska fyllas i.

AttributKardinalitetBeskrivning
status1..1

Status då aktiviteten fått sin statusförändring;

MISSED: Invånaren har missad aktiviteten

SKIPPED: invånaren har satt aktiviteten som skippad

SAVED: Invånaren har sparat

CANCELLED: Behandlaren har inaktiverat aktivitetsplanen

Obesvarade/pågående aktiviteter visas inte i XML-filen.

statusDate1..1Datum för statusändringen. Visas som yyyy-MM-dd'T'hh:mm:ss+<tidszon>.
activity0..1Attribut som pekar på den specifika formulärinstansen som ingått i aktiviteten. (se FormType nedan)

forms 0..*, activity 0..1 (FormType)

Lista med formulär då formulären är del av ett mätbatteri eller övriga formulär, kopplade till momentet.

Om formuläret däremot är den del av en aktivitetsplan innefattas datatypen FormType i instansen activity (ActivityType). I det fallet råder ett-till-ett förhållande mellan aktiviteten (ActivityType) och formuläret (FormType).

Formulär som är delsparade kommer inte med i exporten.

AttributKardinalitetBeskrivning
templateId1..1

Id för formulärmallen. Dessa id:n är unika för varje exporterat moment. Id:n är, för gemensamma formulär, unikt per momentmall och om formuläret uppdaterats får det istället en ny version. Om formulär är gemensamma kommer detta id att vara detsamma för alla versioner av det formuläret. Om formuläret inte är gemesamt kommer ett nytt id att genereras vid ny majorversion av momentet.

Om formuläret finns i en aktivitetsplan som skapats av behandlaren kommer id vara olika per startat moment.

(varning) De moment som exporterats av designern innan release 1.12 (24/10-17) har unika id per version av moment, oavsett om formuläret är oförändrat eller inte.

templateVersion1..1

Versionsnummer för formulärmallen i Stöd och behandling.

De enda formulär som idag har versionshantering är gemensamma formulär. Momentspecifika formulär kommer därför ha versionsnummer 1.

(varning) Endast de moment som publicerats/exporterats efter release 1.12 (24/10-17) kommer att ha rätt versionsnummet, övriga kommer att ha version 1.

templateAlternativeName0..1Altenativt namn som angetts för formuläret. Kommer endast med om designer angett denna information.
name1..1

Formulärets namn.

T.ex. Hälsodeklaration

id

1..1Unikt id för formulärinstansen. Detta unika id består även mellan exportuttag. Olika uttag som pekar på samma formulärmalls-instans kommer således att få samma unika id.
lastSavedDate0..1

Datum och tid för när formuläret senast sparades av invånare. Visas som yyyy-MM-dd'T'hh:mm:ss+<tidszon>.

referralDate0..1

Hänvisningsdatum (det datum formuläret avser) för formulär som ingår i kalenderformulär eller aktivitetsplaner. 

Om formulär är av typen kalender skrivs endast datum för kalenderdagen ut.

2015-10-09T00:00:00+0200

status1..1

Status på formuläret. Kan vara en av följande (SUCCESS|ERASED)

SUCCESS = Formuläret finns.

ERASED = Formuläret finns ej.

questions0..*Lista med frågor som ingår i formuläret. Varje fråga representeras av en instans av datatypen QuestionType.
results0..*Lista med resultat som är genererade utifrån formulärsvaren i ett formulär (en formulärinstans). Varje resultat i listan representeras av den komplexa datatypen ResultType. (Se nedan)

results 0..* (ResultType)

Lista med resultat.

AttributKardinalitetBeskrivning
name1..1Namn på resultat
alternativeName0..1Alternativt namn på resultat. Kommer endast med om designern angivit alternativt namn för resultatet.
value1..1Resultatets värde

questions 0..* (QuestionType)

Lista med frågor i ett formulär. Frågor som är av typen media eller informationstext kommer inte med i exporten då de inte har några svar.

AttributKardinalitetBeskrivning
question1..1

Frågetexten - frågan.

T.ex. Hur mår du?

index1..1Index/löpsiffra på frågan. Löpsiffran visar på vilken fråga, i ordningen, det är inom formuläret. Det kan förekomma "luckor" i denna serie av ordnings-index. Detta kan exempelvis inträffa om formuläret är designat med följdfrågor, d v s frågor som endast presenteras för invånaren/patienten om svaret på tidigare fråga innehåller specifikt/specifika svar. Indexsiffran som visas för en viss fråga är persistent mellan olika exporter av samma formulär (som är genererad utifrån en specifik version av en formulärmall. Det betyder att om exempelvis frågan "Hur mår du?" får index 5 i ett uttag så kommer samma fråga i andra formulärinstanser (som bygger på samma mall) att få samma index.
inputType1..1

Typ av gränssnittsinmatning för frågan. Exempelvis huruvida frågan gäller ett textsvar, en "rullgardin" med förvalda svar, checkboxar som tillåter flera svar mm.

Möjliga värden är:

"TEXT" = Textinmatning 

(Om frågor i aktivitetsplaner är av typen "text" kommer de alltid att innehålla numreriska heltal)

"TEXTAREA" = Textarea

"NUMBER" = Sifferinmatning

"CHECKBOX" = Checkbox

"RADIO" = Radioknapp

"SELECT" = Select

"SCALE" = Skala

"NONE" = N/A

"RANGE" = Slider i formulär eller skala i aktivitetsplan

"MATRIXCHECKBOX" = Matris checkbox 

"MATRIXRADIO" = Matris radioknapp

superiourIndex0..1Index för den fråga som föranledde denna fråga. Detta värde finns endast om frågan är av typen följdfråga.
min0..1Vid inputType RANGE/SCALE anger detta värde minsta giltiga värdet
max0..1Vid inputType RANGE/SCALE anger detta värde högsta giltiga värdet
minText0..1Textuell beskrivning av minsta värdet vid inputType RANGE/SCALE
maxText0..1Textuell beskrivning av högsta värdet vid inputType RANGE/SCALE
interval0..1Tal som anger det minsta steg mellan svar en invånare kan ange vid inputType RANGE.
unit0..1

Enhet för frågan. Gäller endast aktivitetsplaner. Kan vara:

cm, km, meter, kg, gram, mmHg, mmol/l, timmar, minuter, st, ggr

description0..1N/A
answerAlternatives0..*

Lista med möjliga svar vid frågor som har fasta svarsalternativ (förhandsval).

Varje svarsalternativ i listan representeras av en instans av datatypen AnswerAlternativesType.

answers0..*

Lista med svar. Listan kan bestå av mer än ett svar då frågan rör en flervalsfråga


answerAlternatives 0..* (AnswerAlternativeType)

Lista med svarsalternativ.

AttributKardinalitetBeskrivning
index1..1Index/löpsiffra för svarsalternativet. Varje svarsalternativ får ett unikt löpnummer inom frågan. Detta index används sedan för att förmedla svaret/svaren som invånaren/patienten valde
answer1..1Den textuella representationen av svaret. Exempelvis "JA", "NEJ". Gäller vid checkboxar och liknande frågor.

answers 0..* (AnswerType)

Lista med svar

AttributKardinalitetBeskrivning
answer1..1Svaret som invånare angav eller valde från en förvals/flervalsfråga
answerAlternativeIndex0..1Om svaret härstammar från en förvalsfråga eller flervalsfråga håller detta attribut svarsalternativets index (se AnswerAlternativeType ovan).

measurementBatteries 0..* (MeasurementBatteryType)

De mätbatterier som har genomförts under momentets gång. I varje mätbatteri ingår ett eller flera formulär.

AttributKardinalitetBeskrivning
name1..1Namn på mätbatteri
alternativeName0..1Alternativt namn på mätbatteri. Kommer endast med om designern angivit detta.
status

1..1

Status för mätbatteriet:

MISSED: Invånaren har missat att fylla i mätbatteriet under utsatt tid.

SAVED: Invånaren har fyllt i samtliga formulär som ingår i mätbatteriet.

CANCELLED: Behandlaren har avbrutit mätbatteriet.

Ett mätbatteri som pågår kommer inte med i exporten. 

Mätbatterier som har status MISSED eller CANCELLED kan helt sakna formulärfrågor/svar. Har dock invånaren hunnit sparat ett eller flera formulär men inte alla formulär i ett mätbatteri kommer dessa att komma med. 

createdDate1..1

Tidpunkt då mätbatteriet blivit tillgängligt för invånaren. Visas som yyyy-MM-dd'T'hh:mm:ss+<tidszon>.

measurementEventDate1..1

Tidpunkt då mätbatteriet besvarats (dvs samtliga formulär som ingår har besvarats) av invånaren, alternativt den tidpunkt det satts till missad eller avbruten i systemet. Visas som yyyy-MM-dd'T'hh:mm:ss+<tidszon>.

forms0..*Lista med formulärinstanser som är besvarade i mätbatteriet. Populeras endast om mätbatteriet har formulär som besvarats.

Bilagor

FilBeskrivning
Schemafil för XML exportformatet

Projektfil för modellering av datamodell och för automatgenerering av schemafil (XSD)

Projektfilen är i Visual Paradigm format

Version 1.1 exportformatet (XML).




exportDate 1..1

exportDate1..1Tidsstämpel för när exporten skedde, t.ex. 2015-10-12T09:26:06+02


systemName 1..1

systemName1..1Namnet på systemet "Stöd och behandling"

export 0..*

Ett exporterat moment

treatmentProgramGeneral 1..1

Behandlingsprogram.

processId1..1Id för processen
name1..1

Behandlingens namn.

T.ex. Rehabilitering efter knäskada

version1..1

Behandlingens version. Format majorVersion.MinorVersion.

T.ex. 1.1

careUnit 1..1

Vårdgivare/vårdenhet eller enhet.

careGiverHsaId1..1

Vårdgivare hsa-id. Motsvarar HSA-identitet på den vårdgivare aktuellt uppdrag tillhör.

careGiverName1..1Vårdgivarens namn.
careUnitHsaId1..1

Vårdenhet hsa-id. Motsvarar HSA-identitet på den vårdenhet aktuellt uppdrag tillhör.

careUnitName1..1Vårdenhetens namn. Kan vara tomt om det är en kopplad enhet.
unitHsaId1..1Enhet hsa-id. Kopplad enhets HSA-identitet. Tomt om det är en vårdenhet.
unitName1..1Enhetens namn. Kopplad enhets namn. Tomt om det är en vårdenhet.
handler1..*Information om ansvarig behandlare
handler.handlerHsaId1..1Ansvarig behandlares hsa-id. 
handler.handlerName1..1Ansvarig behandlares namn.
handler.handlerStartDate1..1Datumet då ansvarig behandlaree startade/blev tilldelad momentet
handler.handlerEndDate0..1

Datumet då ansvarig behandlare inte längre har ansvaret över momentet. Om handlerEndDate inte är satt betyder det att momentet fortfarande pågår eller är i vidmakthållande.

treatmentData 1..1

startDate1..1

Behandlingsstart enligt formatet yyyy-mm-dd+<tidszon>.

T.ex. 2015-01-13+01:00

endDate0..1

Slutdatum enligt formatet yyyy-mm-dd+<tidszon>.

T.ex. 2016-12-20+01:00

lastRead1..1

Senaste invånaraktivitet enligt formatet yyyy-mm-dd+<tidszon>. Kan vara tomt om invånaren aldrig varit aktiv enligt momentets definition på aktivitet.

T.ex. 2015-01-13+01:00 

maintainDate

0..1

Datumet då momentet sattes i vidmakthållande av behandlaren enligt formatet yyyy-mm-dd+<tidszon>

T.ex. 2017-02-26+01:00

status1..1

Status på behandlingen vid exportens tidpunkt.

  • INPROGRESS (pågående)
  • MAINTAIN (i vidmakthållande)
  • DONE (avslutad)
terminationReason0..1Avslutningsorsak om momentet är avslutat. Beskrivning av möjliga koder finns här Snomed CT
terminationReason.name1..1Titel på avslutningsorsak enligt Snomed. Tom om avslutningsorsak är satt till "Övrigt" eller om momentet avslutades innan release 1.12
terminationReason.code1..1Kod till avslutningsorsak i Snomed. Tom om avslutningsorsak är satt till "Övrigt" eller om momentet avslutades innan release 1.12
terminationReason.nameInSob1..1Namn för avlslutningsorsak som används i Stöd och behandling. Tom om momentet avslutades innan release 1.12

resident 0..1

Patient/invånare.

firstName1..1

Patientens förnamn. Ersätts med "skyddad" om personuppgiften är skyddad.

T.ex. Skyddad

Om patienten inte har ett förnamn anges "NOT DEFINED"

lastName1..1

Patientens efternamn. Ersätts med "identitet" om personuppgiften är skyddad.

T.ex. Identitet

Om patienten inte har ett efternamn anges "NOT DEFINED"

socialSecurityNumber1..1

Personnummer enligt formatet yyyymmdd-nnnn.

T.ex. 19121212-1212

gender0..1Patientens kön.
age0..1Patientens ålder vid uttaget. 

module 0..*

Även moduler som inte har någon modulhändelse förljer med i exporten.

date0..1

Datum för modulhändelse (statusändring) enligt formatet yyyy-mm-dd.

T.ex. 2015-01-13.

Om modulen aldrig satts som synlig, har invånaren aldrig fått tillgång till innehållet och då saknas detta fält.

index1..1

Modulens index.

T.ex. 1

name1..1

Modules namn

T.ex. "Första modulen"

status1..1

Modulens status

  • START
  • STOP
  • PENDING

START visar när modulen satts som tillgänglig för invånaren. Detta kan vara när behandlaren manuellt startat modulen, alternativt när modulen gjordes synlig i samband med vidmakthållande.

STOP visar när behandlaren manuellt har satt en modul som avklarat. Moduler loggas inte som STOP i samband med vidmakthållande eller avslut av moment.

Moduler har status PENDING om de aldrig satts som synliga, och invånaren därför aldrig fått tillgång till innehållet. 

form 0..*

Formulär

referenceId1..1Detta id används för att refereras till från övriga XML-dokumentet, t.ex. från resultForm. Id är unikt inom den exportade XML och samma gäller för aktiviteter.
name1..1

Formulärets namn.

T.ex. Hälsodeklaration

templateId1..1

Mall-id för formuläret. Unikt per version, moment och enhet i Stöd och behandling.

version1..1

Versions-id för formuläret i Stöd och behandling. För närvarande finns ingen versionshantering av formuär i Stöd och behandling och versionen kommer därför vara 1 för alla formulär.

originalTemplateId1..1Mall-id som gäller för utgivarenheten (i Designverktyget). Endast de moment som publicerats/exporterats efter release 1.12 kommer att ha ett värde då informationen inte funnit i Stöd och behandling tidigare, övriga kommer att vara tomma. De enda formulär som idag har versionshantering är gemensamma formulär därför kommer originalTemplateId skilja mellan versioner av momentet för icke gemensamma formulär.  
originalTemplateVersion1..1

Versionsnummer för utgivarenhetens formulärmall (designverktyget). De enda formulär som idag har versionshantering är gemensamma formulär. momentspecifika formulär kommer därför ha versionsnummer 1. Endast de moment som publicerats/exporterats efter release 1.12 kommer att ha ett värde då informationen inte funnit i Stöd och behandling tidigare, övriga kommer att vara tomma

referralDate0..1

Om formulär är av typen "kalender" anges här datumet för kalenderdagen. Vid "kalender" så kommer datumet anges på följande vis:

2015-10-09T00:00:00+0200

dvs vid "kalender" är tidpunkten alltid 00:00:00

lastSaveDate1..1Den exakta tidpunkten formuläret senast sparades.

2015-10-09T08:55:03+0200

questionsError0..1Om ett fel uppstår vid hämtande av frågor och svar på formulär anges orsaken här. Om detta fält anges finns inga questions.
questions0..*En lista med frågor i formuläret.
questions.question1..1

Frågan.

T.ex. Hur mår du?

questions.pageNumber

1..1

Ett formulär är uppbyggt av sidor som i sin tur är uppbyggt av block som i sin tur är uppbyggt av frågor. Detta värde anger nummer på sidan frågan tillhör. I dagsläget använder Stöd och behandling bara en sida och värdet på denna är därför alltid 1.

questions.blockNumber1..1Ett formulär är uppbyggt av sidor som i sin tur är uppbyggt av block som i sin tur är uppbyggt av frågor. Detta värde anger nummer på blocket i sidan frågan tillhör.
questions.questionNumber1..1Ett formulär är uppbyggt av sidor som i sin tur är uppbyggt av block som i sin tur är uppbyggt av frågor. Detta värde anger nummer på frågan i blocket frågan tillhör.
questions.superiorPageNumber0..1Ett formulär är uppbyggt av sidor som i sin tur är uppbyggt av block som i sin tur är uppbyggt av frågor. Om frågan är en följdfråga refererar detta fält till pageNumber på den överordnade frågan.
questions.superiorBlockNumber0..1Ett formulär är uppbyggt av sidor som i sin tur är uppbyggt av block som i sin tur är uppbyggt av frågor. Om frågan är en följdfråga refererar detta fält till blockNumber på den överordnade frågan.
questions.superiorQuestionNumber0..1Ett formulär är uppbyggt av sidor som i sin tur är uppbyggt av block som i sin tur är uppbyggt av frågor. Om frågan är en följdfråga refererar detta fält till questionNumber på den överordnade frågan.

questions.superiorAnswerAlternativeNumbers

0..*Om frågan är en följdfråga anger denna de svarsvärden som leder till att följdfrågan visas.
questions.description0..1

Om frågan är av typen informationstext står texten här.

questions.inputType1..1

Typ av fråga. Namn på typerna motvarar följande i Stöd och behandling:

"text" = Textinmatning

"textarea" = Textarea

"number" = Sifferinmatning

"checkbox" = Checkbox

"radio" = Radioknapp

"select" = Select

"scale" = Skala

"none" = Alla mediatyper samt Infotext

"range" = Slider

"matrix-checkbox" = Matris checkbox 

"matrix-radio" = Matris radioknapp

answer1..1Svaret på frågan. Kommer oavsett om invånaren besvarat frågan eller inte. 
answer.answers0..*

Invånarens svar

T.ex. Bra (vid fritextstfråga)

T.ex. 2 (svarsalternativ radio, checkbox etc)

Om frågan har givna svarsalternativ och invånaren ej svarar kommer inte detta fält.

answer.answerAlternatives0..*Svarsalternativ (endast vid flervalsfråga t.ex. radio)
answer.answerAlternatives.alternativeValue1..1

Svarsalternativets namn.

T.ex. Bra

answer.answerAlternatives.alternativeNumber1..1

Svarsalternativets värde.

T.ex. 2

question.answerMinValue

question.answerMaxValue

0..1Vid slider anger dessa fält det max- och minvärden som satts på frågan.
question.answerInterval0..1Formulär som har frågor som är av typen "slider" har ett fält som anger det intervall som svar kan sättas till mellan det min- och maxvärde som finns.

activityForm 0..*

Aktivitet

referenceId1..1Detta id används för att refereras till från övriga XML-dokumentet, t.ex. från resultForm. Id är unikt inom den exportade XML och samma id:n gäller för formulär.
name1..1

Aktivitetens namn.

status1..1

Vilken status varje aktivitet har i systemet:

MISSED, SKIPPED, SAVED samt CANCELLED.

Obesvarade aktiviteter visas inte i XML-filen.

templateId1..1Mall-id som är unikt för varje startat moment i stöd och behandling. 
version1..1

Versions-id i stöd och behandling. För närvarande finns ingen versionshantering för aktiviteter i Stöd och behandling och versionen kommer därför vara 1 för alla

originalTemplateId1..1Mall-id som gäller för utgivarenheten (Designverktyget). Kommer endast att finnas för de moment som publicerats/exporterats efter release 1.12 då informationen inte funnit i Stöd och behandling tidigare. Unikt id per majorversion. Om behandlare skapar aktiviteter i Stöd och behandling kommer detta fält vara tomt.
originalTemplateVersion1..1

Versionsnummer för utgivarenhetens formulärmall (Designverktyget). Kommer endast att finnas för de moment som publicerats/exporterats efter release 1.12 då informationen inte funnits i Stöd och behandling tidigare. Om behandlare skapar aktiviteter i Stöd och behandling kommer detta fält vara tomt. För närvarande finns ingen versionshantering för aktiviteter i Designverktyget och versionen kommer därför vara 1 för alla som inte är tomma.

activityDate1..1

Dag och tidp för den planerade aktiviteten, visas enligt:

2015-10-12T08:00:00+0200

activityEventDate1..1Den exakta tidpunkten aktiviteten senast sparades alternativt då den satts som avbruten eller missad.

2015-10-09T08:55:03+0200

questionsError0..1Om ett fel uppstår vid hämtande av frågor och svar på formulär anges orsaken här. Om detta fält anges finns inga questions.
questions0..*En lista med frågor i formuläret.
questions.question1..1

Frågan.

T.ex. Hur mår du?

questions.pageNumber

1..1

Ett formulär är uppbyggt av sidor som i sin tur är uppbyggt av block som i sin tur är uppbyggt av frågor. Detta värde anger nummer på sidan frågan tillhör. I dagsläget använder Stöd och behandling bara en sida och värdet på denna är därför alltid 1.

questions.blockNumber1..1Ett formulär är uppbyggt av sidor som i sin tur är uppbyggt av block som i sin tur är uppbyggt av frågor. Detta värde anger nummer på blocket i sidan frågan tillhör.
questions.questionNumber1..1Ett formulär är uppbyggt av sidor som i sin tur är uppbyggt av block som i sin tur är uppbyggt av frågor. Detta värde anger nummer på frågan i blocket frågan tillhör.
questions.description0..1Om frågan är av typen informationstext står texten här.
questions.questionUnit0..1

För registreringar på aktiviteter anger detta fält vilken måttenhet som avses,  t.ex. km, minuter, st

questions.inputType1..1

Typ av fråga. Namn på typerna motvarar följande i Stöd och behandling:

"text" = Textinmatning

"textarea" = Textarea

"radio" = Radioknapp


"none" = Infotext

"range" = Skala

answer1..1Svaret på frågan. Kommer oavsett om invånaren besvarat frågan eller inte. 
answer.answers0..*

Invånarens svar

T.ex. Bra (vid fritextstfråga)

T.ex. 2 (svarsalternativ radio, checkbox etc)

Om frågan har givna svarsalternativ och invånaren ej svarar kommer inte detta fält.

answer.answerAlternatives0..*Svarsalternativ (endast vid flervalsfråga t.ex. radio)
answer.answerAlternatives.alternativeValue1..1

Svarsalternativets namn.

T.ex. Bra

answer.answerAlternatives.alternativeNumber1..1

Svarsalternativets värde.

T.ex. 2

question.answerMinValue

question.answerMaxValue

0..1Vid skala anger dessa fält det max- och minvärden som satts på frågan.

question.answerMinText

question.answerMaxText

0..1Vid skala anges även namn för max- och minvärden.

measurement 0..*

Mätbatteri

formReference0..*Referens till vilket/vilka formulär som besvarats i mätbatteriet.
formReference.formReferenceId1..1Detta id används för att refereras till det formulär som hör till mätbatteriet och motsvarar "referenceId" i form (se ovan). Referensid finns endast om formulär i mätbatteriet är besvarat av invånaren.
formReference.formReferenceName1..1

Namnet på det tillhörande formuläret, om sådan finns.

status1..1

Vilken status varje mätbatteri har i systemet:

MISSED, SAVED eller CANCELLED.

Mätbatterier som har status MISSED eller CANCELLED kan helt sakna formReference. Har dock invånaren hunnit sparat ett eller flera men inte alla formulär i ett mätbatteri kommer dessa att komma med. 

name1..1

Mätbatteriets namn

schedule0..1

Hur mätbatteriet har schemalagts:

  • MODULE_START om mätbatteriet startas i samband med modul
  • REPETITION om mätbatteriet startar med repetition
  • DATE om mätbatteriet startar vid ett tillfälle

Om behandlaren manuellt tagit bort ett mätbatteri kommer schemat inte att kunna komma med.

createdDate1..1

Tidpunkt då mätbatteriet blivit tillgängligt för invånaren enligt schemaläggning, visas enligt:

2015-10-12T08:00:00+0200

measurementEventDate1..1

Tidpunkt då mätbatteriet besvarats (dvs samtliga formulär som ingår har besvarats) av invånaren, alternativt den tidpunkt det satts till missad i systemet, visas enligt:

2015-10-12T08:00:00+0200

startModuleIndex0..*De index som motsvarar de moduler som mätbatteriet startar i samband med. Förutsätter att mätbatteriet startas per modul. Motsvarar index som finns i module (se ovan) och fungerar som referens. Om behandlaren manuellt tagit bort ett mätbatteri kommer schemat inte att kunna komma med.
repetitionInterval0..1Antal dagar mellan varje repetion av mätbatteriet. Förutsätter att mätbatteriet startas per repetition. Om behandlaren manuellt tagit bort ett mätbatteri kommer scemat inte att kunna komma med.

resultForm 0..*

En lista av de resultat som urvalet matchar. 

Observera

  1. Det kan finnas flera result.value.value som pekar på samma result.value.formReferenceId. Detta är möjligt då invånaren kan svara på samma formulär flera gånger, både vad gäller aktiviteter och vanliga formulär. När flera result.value.value pekar på samma result.value.formReferenceId så är det resultatet med det senaste result.value.lastSaveDate som är det resultat som stämmer överens med svaren i det formulär som refereras. 
formName1..1Namnet på formuläret resultat baserades på
activity1..1

Baserades resultatet på en aktivitet? Möjliga värden:

  • true
  • false
result0..*

En lista med resultat för ett givet formulär. Varje formulär kan ha flera resultat kopplat till sig.

result.alternativeName1..1Alternativt namn som är angett för detta resultatet
result.resultName1..1Namnet på resultatet
result.value0..*En lista med resultatvärden för ett givet resultat. Varje resultat har en lista med värden.
result.value.formReferenceId0..*ReferenceId på det form som resultatet baserades på.
result.value.referralDate1..1

Om resultatet baserades på ett formulär av typen "kalender" eller en "aktivitet" anges här datumet då själva aktiviteten eller kalendern gällde. Vid "kalender" så kommer datumet anges på följande vis:

2015-10-09T00:00:00+0200

Om aktivitet anges datumet på följande vis:

2015-10-12T08:00:00+0200

dvs skillnaden är att vid aktivitet anges även tidpunkten, vid "kalender" är tidpunkten alltid 00:00:00

result.value.lastSaveDate1..1Den exakta tidpunkten resultatet skapades.

2015-10-09T08:55:03+0200

result.value.value1..1Det faktiska resultatet.

connectedProcesses 0..*

id

1..1

ProcessId på det länkade moment.
name1..1Namn på det länkade momentet
version1..1Versionsnumret för det länkade momentet. Skrivs som 1.1 (major + minor)


message 0..*

date1..1

Datum då medelandet skickades:

2015-10-12T08:00:00+0200

senderType

1..1

Om invånare eller behandlaren skickat meddelandet.

Har värdet RESIDENT eller HANDLER.

handlerName0..1Namnet på behandlaren om denne har skickat meddelandet.
handlerHsaId0..1Hsa-id på behandlaren om denne har skickat meddelandet.
conversationType1..1

Om meddelandet är en kommentar eller inte.

Har värdet MESSAGE eller COMMENT.

categories 1..1

category0..*Kategori som satts på detta momentet


9 Comments

User icon

Fälten:

borde ligga en nivå över, utanför <export> noderna. Exportdatum och namn på system är alltid samma, de två kan inte skilja sig mellan de exporterade behandlingarna

User icon

Kardinaliteten på unitHsaId och unitName är satta till (1..1). Men i export XMLerna saknas noderna om data inte finns. Noderna borde alltid finnas men vara tomma.

Kontrollera samtidigt att careGiverHsaId, careGiverName, careUnitHsaId, careUnitName följer specen ovan

User icon

Om en invånare har skyddad identitet ger vi inte ut för- och efternamn. Däremot ger vi ut personnummer. Vill vi det?

User icon

Samtliga attribut under resident (invånaren) har kardinaliteten (0..1) i specen ovan. Stämmer det verkligen? Ålder och kön ska alltid komma med, borde inte de vara (1..1). Om användaren väljer att "anonymisera" uttaget. Då ska inte namn och personnummer komma med, däremot övriga. Vad händer i ett sådant fall, kommer namn och personnummer noderna med tomma eller saknas de helt?

User icon

Specifikationen ovan saknar kardinalitet för samtliga noder för översta nivån, förutom exportDate och systemName. Vissa av dem borde vara obligatoriska, exempelvis treatmentProgramGeneral och CareUnit → (1..1).

Andra, så som exempelvis form, messge m fl borde ha kardinalitet (0..*)

User icon

Enligt specifikationen ovan är formReference noden frivillig i measurement noden (0..*).

Kan det inträffa att det inte finns något formulär att referera till om vi exporterar en mätning?

User icon

Thomas Fafoutis Vi i teamet har nu gått igenom denna dokumentation och gjort ganska många uppdateringar. 
Du får gärna gå igenom dokumentet ett varv till för att säkerställa att din implementering av XML-konverteraren fortfarande håller.
En brasklapp för SOB-4680 som förmodligen inte kommer att fixas till release 1.12. 
Om den inte åtgärdas så kommer dokumentationen gällande Form> referenceID och Activityform>referenceID att ändras ovan pga den.   

User icon

Är den här klar för publicering Carola Anetoft och Thomas Fafoutis?

User icon

Jenny Axelsson Ja den är klar för publicering. Kontrollera att inte våra kommentarer på denna sida kommer med i pdfén.

User icon
Write a comment…
  • Inga etiketter