Page History
| Navitabs | ||||
|---|---|---|---|---|
| ||||
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
...
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
Version | Dato | Ansvarlig | Beskrivelse |
|---|---|---|---|
1.0 | 18.08.2016 | Systematic | Initiel udgave |
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
Formålet med denne sektion er at give et overblik over definitioner og dokumenter, der benyttes i dette dokument.
Definition | Beskrivelse |
|---|---|
DDS | Dokumentdelingsservice |
IHE | Integrating the Healthcare Enterprise |
NSI | National Sundheds-IT |
NSP | Den Nationale Service Platform (inden for sundheds-IT) |
PIH | Privacy Information Header |
PIW | Privacy Information Wrapper |
XDS | Cross-Enterprise Document Sharing |
SES | Svareksponeringsservice |
Alias | Beskrivelse | ||||||
|---|---|---|---|---|---|---|---|
| Driftsvejledningen for Svareksponeringsservice XDS-adaptere, (SSE/11734/OHB/0017) | ||||||
PIH-spec | Kommende dokument | ||||||
PIW-spec | Kommende dokument | ||||||
| SvarEksponeringsService ServiceKontrakt v.1.04.pdf |
Deling af dokumenter sker gennem følgende aktører:
...
I ovenstående er Svareksponeringsservice XDS-adaptere nedbrudt i logiske komponenter. Disse er implementeret i komponenter navngivet som vist i Tabel 1.
Logisk komponent | Implementation | Funktion |
|---|---|---|
Svareksponerings-service XDS Registry Adapter | sxa-documentmetadataprovider | Returnerer dokumentmetadata |
Svareksponerings-service XDS Repository Adapter | sxa-documentprovider | Kalder Svareksponerings-servicen og pakker returneret dokument ind i wrapper (PIW), der returneres. |
| Wiki Markup |
|---|
<ac:structured-macro ac:name="anchor" ac:schema-version="1" ac:macro-id="be0c61ee-ba87-4038-83d9-b3de9adee819"><ac:parameter ac:name="">_Ref414969084</ac:parameter></ac:structured-macro>{*}Tabel 1* *Implementation af komponenterne i Svareksponeringsservice XDS-adaptere*
I \[Driftsvejledningen\] er beskrevet konfiguration for Svareksponeringsservice XDS-adaptere, hvor navngivning af property-filer, log-konfigurationsfiler etc. følger navngivningen brugt for implementationen. |
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
ID | Beskrivelse | Rationale |
|---|---|---|
SES.XDS.Registry.Adapter.Intet.Kald | Opslag på patient skal give dokumentmetadata uden kald af Svareksponeringsservice. | For at minimere svartid på opslag, da dette foretages for alle patienter. |
SES.XDS.Registry.Adapter.Ingen.Persistering.Søgeparametre | Søgeparametre givet ved opslag på patient persisteres ikke til anvendelse på dokumentindhentningstidspunktet. | Fravalg af persistering simplificerer løsning og giver mere frihed mht. deployering På decentrale NSP må der ikke persisteres.. |
SES.XDS.Registry.Adapter.Begrænsede.Søgeparametre | Ikke alle muligheder for angivelse af søgeparametre ved opslag understøttes. Se Tabel 4. | Visse søgeparametre kan relativt let matches mod de metadata, der de facto returneres fra Svareksponeringsservice XDS Registry Adapter og dermed filtreres allerede i opslaget. |
SES.XDS.Registry.Adapter.Encoding.Af.Søgeparametre | Søgeparametre ved opslag bæres videre til indhentning af dokument ved at encode informationen i documentUniqueId/uniqueId. | Dette sker for at undgå persistering mellem opslag og indhentning af dokument. |
SES.XDS.Registry.Adapter.Intet.Patientnavn | Metadata-attributten DocumentEntry.sourcePatientInfo er obligatorisk jf. den danske metadata-profil, som Dokumentdelingsservicen typisk anvendes med. Attributten indeholder patientnavn, kodning af patientens køn samt fødselsdato. | Dokumentanvendere forventes at kende navn ud fra patient-id (cpr-nummeret). |
Tabel 2 Arkitekturbeslutning for Svareksponeringsservice XDS Registry Adapter
| Anchor | ||||
|---|---|---|---|---|
|
ID | Beskrivelse | Rationale |
|---|---|---|
SES.XDS.Repository.Adapter.Datagrundlag.Relation.Parameter | Svareksponeringsservicen har obligatorisk kaldparameter Relation, der beskriver forholdet med bruger og patient.
|
SES.XDS.Repository.Adapter.PIH.Via.PIW | Laboratoriesvarsdokumentet samt en PIH-varedeklaration, der beskriver dokumentet, indlejres i et Privacy Information Wrapper dokument, der returneres ved indhentning af dokument. | PIW genkendes af Dokumentdelingsservicen, der kan foretage samtykkekontrollen ud fra PIH og foretages filtrering af Svareksponeringsservices-dokumentet. |
Tabel 3 Arkitekturbeslutninger for Svareksponeringsservice XDS Repository Adapter
...
Ved dokumentkildes opslag på dokumentmetadata på Dokumentdelingsservicen understøttes en søgevariant benævnt FindDocuments. I Tabel 4 er vist de søgeparametre denne understøtter, hvorvidt de er valgfrie eller krævede, samt om der i FindDocuments understøttes en eller flere værdier for samme søgeparameter.
FindDocuments Query Parameter | Krævet (K)/valgfrit | Kardinalitet (M for mange) | Håndteres af filter på opslag | Encodes i dokumentid | Bæres til kald af Svareksponeringsservice | Filtrering efter kald | Håndteres | Kommentar |
$XDSDocumentEntryPatientId | K |
x | x |
x |
$XDSDocumentEntryClassCode |
M | x |
x | Skal indeholde konfigurerbar værdi hvis anført, ellers tomt metadata-resultat | |||
$XDSDocumentEntryTypeCode |
M | x |
x | Skal indeholde konfigurerbar værdi hvis anført, ellers tomt metadata-resultat | ||||
$XDSDocumentEntryPracticeSettingCode |
M |
x | x |
x | Er delvist håndteret, idet udvalgte værdier bæres til kaldet af Svareksponeringsservicen. | ||
$XDSDocumentEntryCreationTimeFrom |
x |
x | Må ikke være anført, ellers tomt metadata-resultat | |||
$XDSDocumentEntryCreationTimeTo |
x |
x |
x
Må ikke være anført, ellers tomt metadata-resultat |
$XDSDocumentEntryServiceStartTimeFrom |
x |
x | x |
$XDSDocumentEntryServiceStartTimeTo |
|
| x | Bruges, hvis $XDSDocumentEntryServiceStartTimeFrom ikke er anført | ||
$XDSDocumentEntryServiceStopTimeFrom |
|
| x | Bruges, hvis $XDSDocumentEntryServiceStopTimeTo ikke er anført | |
$XDSDocumentEntryServiceStopTimeTo |
x |
x | x |
$XDSDocumentEntryHealthcareFacilityTypeCode |
M |
÷ |
Er ikke håndteret, men kunne være håndteret ved match mod konfigureret værdi (som de øvrige). | ||
$XDSDocumentEntryEventCodeList |
M | x Der laves konfigurerbart filter på søgeparametre på opslagstidspunktet. |
x | Skal indeholde konfigurerbar(e) værdi(er) hvis anført, ellers tomt metadata-resultat | |||
$XDSDocumentEntryConfidentialityCode |
M | x |
x | Skal indeholde konfigurerbar værdi hvis anført, ellers tomt metadata-resultat | ||||
$XDSDocumentEntryAuthorPerson |
M | x |
x | Må ikke være anført, ellers tomt metadata-resultat. Grundet manglende i indhold i svar fra svareksponeringsservice. | ||||
$XDSDocumentEntryFormatCode |
M | x |
x | Skal indeholde konfigurerbar værdi hvis anført, ellers tomt metadata-resultat | |||
$XDSDocumentEntryStatus | K | M | x |
x | Skal indeholde approved, ellers tomt metadata-resultat | |||
$XDSDocumentEntryType |
M | x |
x | Skal indeholde On-demand typen, ellers tomt metadata-resultat |
| Anchor | ||||
|---|---|---|---|---|
|
I tabellens kolonne "Håndteres af filter på opslag" er med kryds markeret de søgeparametre, der håndteres af Svareksponeringsservice XDS Registry Adapter på tidspunktet for opslag på dokumentmetadata.
Visse søgeparametre skal, hvis de er anvendt af dokumentanvender, indeholde bestemt værdi. Har en dokumentanvender fx anført værdier for $XDSDocumentEntryType, så skal disse afspejle typen On-demand. Er der kun anført stabile dokumenter vil Svareksponeringsservice XDS-adaptere ikke tilbyde dokument og der skabes et tomt metadata-resultat på opslaget.
Andre søgeparametre, der håndteres på opslagstidspunktet, skal, såfremt dokumentanvenderen har anført værdi(er), indeholde bestemte værdier. Svareksponeringsservice XDS-adaptere returnerer dokument af type laboratoriesvarsdokument, hvorfor det giver mening, at dokumentmetadata returneret fra Svareksponeringsservice XDS-adaptere specificerer denne type. Har dokumentanvenderen søgt på andre typer, kan der returneres tomt metadata-resultatet på opslaget. Søger dokumentanvender på andre dokumenttyper og laboratoriesvarsdokumenttypen, da giver det mening at returnere dokumentmetadata. Dette er generaliseret som et filter, hvor der matches mod et konfigurerbart sæt af værdier, der, hvis de pågældende søgeparametre er anført, skal være blandt anførte værdier (er de ikke konfigureret foretages ingen filtrering på den konkrete søgeparameter).
Tabellens kolonne "Bæres til kald af Svareksponeringsservice" markerer de værdier fra søgeparametre, hvis værdier anvendes ved kaldet af Svareksponeringsservicen. Som nævnt i afsnit 3.1 encodes disse søgeparametre i dokumentid returneret som dokumentmetadata fra Svareksponeringsservice XDS Registry Adapter. Dokumentid anvendes ved indhentning af dokument og derved er de tilgængelige for Svareksponeringsservice XDS Repository Adapter og kan decodes til kald af Svareksponeringsservicen.
I kolonnen "Filtrering efter kald" er med kryds markeret de søgeparametre, hvor der foretages filtrering efter kaldet af Svareksponeringsservicen er foretaget.
I samme kolonne er der med minus markeret de ikke-håndterede søgeparametre, hvor tilsvarende håndtering ville kræve:
...
| Anchor | ||||
|---|---|---|---|---|
|
| Wiki Markup |
|---|
Det primære udgangspunkt for forståelse af koden er konfigurationen af webservicen, der foretages i maven-artefaktet sxa-documentmetadataprovider-war. Konfigurationen i web.xml udpeger MetadataProviderWS i hjælpebiblioteket, der delegerer ansvaret for at fremskaffe dokumentmetadata til interfacet DocumentMetadataProvider. Svareksponeringsservice XDS Registry Adapter's implementation af dette interface er DocumentMetadataProviderImpl.
!worddavd9827311193ca9ca4cc229c1389c25fe.png|height=302,width=490!
*Tabel 5 Overordnet design af Svareksponeringsservice XDS Registry Adapter*
DocumentMetadataProviderImpl benytter MetadataQueryFilter til at afgøre, om opslagets søgeparametre er forenelige med at returnere dokumentmetadata ud fra konfigurerbare filter-værdier, dvs. om der skal returneres dokumentmetadata eller ej. I \[Driftsvejledningen\] er konfiguration og logik for filteret beskrevet.
Skal dokumentmetadata returneres, skaber DocumentMetadataProviderImpl disse som givet i Tabel 6. |
Metadata-attribut | Værdi bestemmes af |
patientId | Query |
sourcePatientId | Query |
UniqueId (DocumentUniqueId) | Encoding af query parametre |
Author.authorPerson | Metadata-konfiguration |
Author.authorInstitution | Metadata-konfiguration |
classCode | Metadata-konfiguration |
confidentialityCode | Metadata-konfiguration |
eventCodeList | Metadata-konfiguration |
creationTime | Null (må ikke anføres for on-demand dokument) |
formatCode | Metadata-konfiguration |
HealthcareFacilityTypeCode | Metadata-konfiguration |
practiceSettingCode | Metadata-konfiguration |
serviceStartTime | Værdi fra query overføres, ellers anvendes patientens fødselsdato, hvis den kan udledes af patientId |
serviceStopTime | Værdi fra query overføres, ellers null |
availabilityStatus | Hardcoded til Available |
typeCode | Metadata-konfiguration |
mimeType | Metadata-konfiguration |
languageCode | Metadata-konfiguration |
homeCommunityId | Metadata-konfiguration |
repositoryUniqueId | Metadata-konfiguration |
title | Metadata-konfiguration |
entryUUID | UUID-repræsentation af uniqueId |
objectType | Hardcoded til On-demand |
| Anchor | ||||
|---|---|---|---|---|
|
...
En dokumentanvender kan ved opslag på dokumentmetadata vælge forskellige kombinationer af start- og slut-datoangivelser for behandlingsperiode samt evt. intervaller, som start- og slut-datoer skal ligge inden for. Svareksponeringsservicen understøtter ikke intervaller som inputparametre, hvorfor der i stedet anvendes maksimalt udspændende start- og stop-datoer.
| Anchor | ||||
|---|---|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
| Wiki Markup |
|---|
Svareksponeringsservicens snitflade er beskrevet i \[SES snitflade\]. |