Dette dokument er en vejledning til brug for anvendere af FSK Registry. Da anvendelsen af FSK Registry sker via Dokumentdelingsservicen, starter dokumentet med et overblik over arkitekturen. Formålet med dette er at dokumentere, hvordan DDS og FSK Registry hænger sammen, og hvilke opgaver disse komponenter dækker hver især.
Da FSK Registrys primære opgave er at fortolke forespørgsler fra dokumentanvendere og levere konkrete svar på disse, indeholder dette dokument beskrivelser af:
Disse beskrivelser er bygget op med eksempler på requests og responses, hvor det giver mening. Eksemplerne stammer fra TEST2 miljøet.
Tilsidst i dokumentet dokumenteres det, hvordan et svar fra FSK Registry ser ud - herunder sammenhæng med Medcoms danske profilering: XDS Metadata for Document Sharing v. 0.95.
Dette dokument antager, at læseren er bekendt med basale koncepter indenfor IHE XDS, Dokumentdelingsservicen og CDA Dokumenter.
Der kan blandt andet henvises til følgende:
MedComs brug af HL7 standarder
DDS | Dokumentdelingsservice |
BRS | Behandlingsrelationsservice |
FSK | Fælles Stamkort |
XDS | Cross-Enterprise Document Sharing |
Fremsøgning af stamkort sker via DDS (se DDS Registry - Querying User's Guide og DDS Registry Querying Interface Description).
FSK Registry er således en kilde, som DDS anvender til at understøtte fremsøgingsforespørgsler fra anvendere.
Således foregår en forespørgsel mod FSK Registry på følgende måde:
DDS Registry forholder sig ikke til indholdet af den konkrete query, der kommer fra Dokumentanvenderen, men overlader til de bagvedliggende registre (herunder FSK Registry) at fortolke og besvare den konkrete query. I næste afsnit findes en detaljeret oversigt over, hvorledes FSK Registry fortolker indkommende queries.
FSK Registry implementerer transaktionen Registry Stored Query (ITI-18), som er beskrevet i IHE IT Infrastructure Technical Framework Volume 2a (ITI TF-2a) 10 Transactions Part A.
ITI-18 query beskeder følger ebXML Registry Information Mode Version (RIM) 3.0. Overordnet set findes der i en ITI-18 query 3 typer af parametre:
I det følgende afsnit vil vi gennemgå hver af disse 3 parameter-typer og angive, hvordan disse er understøttede/fortolkede i FSK Registry. Gennemgangen vil indeholde eksempler på queries, hvor dette giver mening.
FSK Registry melder tilbage til DDS med et response af ...TODO.
ReturnType kan som udgangspunkt antage een af følgende to værdier:
FSK Registry ignorerer ReturnCompoesedObjects parameteren. Alle queries besvarers, somom denne parameter er true.
FSK Registry ignorerer return type parameteren. Alle queries besvares, somom denne parameter er sat til LeafClass dvs. fuldt sæt af metadata.
DDS bruger de returnerede metadata til evt. at foretage filtrering i forhold til dataspecifikke spærringer. For at dette kan lade sig gøre, har DDS brug for adgang til det fulde sæt af metadata (LeafClass) og ikke kun objekt-ider (ObjectRef).
I IHE IT Infrastructure Technical Framework opereres med en række standard XDS Query identificeret med UUID'er. Nedenstående tabel viser den samlede oversigt over de definerede Query ID.
Kolonnen længst til højre viser, om FSK Registry forstår/understøtter den specifikke Query.
Query Name | Query ID | FSK Registry understøttelse |
---|---|---|
FindDocuments | urn:uuid:14d4debf-8f97-4251-9a74-a90016b0af0d | Ja |
FindSubmissionSets | urn:uuid:f26abbcb-ac74-4422-8a30-edb644bbc1a9 | Nej |
FindFolders | urn:uuid:958f3006-baad-4929-a4de-ff1114824431 | Nej |
GetAll | urn:uuid:10b545ea-725c-446d-9b95-8aeb444eddf3 | Nej |
GetDocuments | urn:uuid:5c4f972b-d56b-40ac-a5fc-c8ca9b40b9d4 | Nej |
GetFolders | urn:uuid:5737b14c-8a1a-4539-b659-e03a34a5e1e4 | Nej |
GetAssociations | urn:uuid:a7ae438b-4bc2-4642-93e9-be891f7bb155 | Nej |
GetDocumentsAndAssociations | urn:uuid:bab9529a-4a10-40b3-a01f-f68a615d247a | Nej |
GetSubmissionSets | urn:uuid:51224314-5390-4169-9b91-b1980040715a | Nej |
GetSubmissionSetAndContents | urn:uuid:e8e3cb2c-e39c-46b9-99e4-c12f57260b83 | Nej |
GetFolderAndContents | urn:uuid:b909a503-523d-4517-8acf-8e5834dfc4c7 | Nej |
GetFoldersForDocument | urn:uuid:10cae35a-c7f9-4cf5-b61e-fc3278ffb578 | Nej |
GetRelatedDocuments | urn:uuid:d90e5407-b356-4d91-a89f-873917b4b0e6 | Nej |
FindDocumentsByReferenceId | urn:uuid:12941a89-e02e-4be5-967c-ce4bfc8fe492 | Nej |
FSK Registry vil besvare en forespørgsel med ikke-understøttet Query ID med en fejl. Se f.eks. dette opslag:
som giver dette resultat:
De søgeparametre, der er kan anvendes er defineret udfra Query ID. Dette betyder at hver Query type (se tabellen ovenfor) medfører en liste af tvungne/optionelle søgeparametre. I de følgende afsnit gennemgås FSK Registrys understøttede Query typer, og for hver af disse angives søgeparametrene, som defineret i IHE IT Infrastructure Technical Framework Volume 2a (ITI TF-2a) 10 Transactions Part A. En kolonne udfor hver søgeparameter angiver FSK Registrys fortolkning (hvis nogen) af den medsendte parameter samt evt. valideringer.
Som defineret
FSK Registry er sat op med en række miljøspecifikke variable.