3.1 Ricerca documenti

Il protocollo di comunicazione da utilizzare per il servizio di ricerca documenti deve essere conforme alla transazione IHE [ITI-18] Registry Stored Query[1], che, secondo la terminologia IHE, prevede l’invio di una query da un attore XDS Document Consumer (in questo caso il nodo regionale della RDE) ad un attore XDS Document Registry (in questo caso il nodo regionale della RDA dell’assistito), in maniera mediata dall’attore National Gateway. Pertanto, l’attore XDS Document Consumer effettua una richiesta al National Gateway che si occupa di inoltrare il messaggio all’attore XDS Document Registry. Le stored query consentite per la ricerca dei documenti sono FindDocuments e GetDocuments rispettivamente identificati con query ID:

  • urn:uuid:14d4debf-8f97-4251-9a74-a90016b0af0d;
  • urn:uuid:5c4f972b-d56b-40ac-a5fcc8ca9b40b9d4.

La richiesta da inviare al National Gateway deve contenere l’asserzione di attributo firmata dal sistema regionale richiedente. Di seguito si riporta il dataset della richiesta e della risposta del messaggio di ricerca documenti.

Messaggio di richiesta Ricerca documenti (flussi RDE->INI, INI->RDA, RDA->INI)

 

Campo

Tipologia

Codifica

Descrizione

Obbligatorio

Dato SAML/XDS (ove applicabile)

Identificativo utente

asserzione attributo

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Codice fiscale dell’utente che fa richiesta del servizio di interoperabilità

si

urn:oasis:names:tc:xacml:1.0:subject:subject-id

Identificativo organizzazione

asserzione attributo

Codifica secondo la  Tabella 5.4-3 del documento di Affinity Domain

Identificativo del dominio dell’utente

si

urn:oasis:names:tc:xspa:1.0:subject:organization-id

Descrizione organizzazione

asserzione attributo

Descrizione delle regioni/
province autonome italiane

Descrizione del dominio dell’utente

no

urn:oasis:names:tc:xspa:1.0:subject:organization

Struttura utente

asserzione attributo

Codifica HSP.11 - HSP.11bis - STS.11 - RIA.11, ovvero codifica ISTAT della Azienda (ASL) o codifica Tabella 5.4-3 del documento di Affinity Domain

Identificativo della struttura dell’operatore/professionista sanitario (nel caso in cui l’utente coincida con il paziente non deve essere valorizzato)

si

urn:oasis:names:tc:xspa:1.0:environment:locality

Ruolo utente

asserzione attributo

Vedi Tabella 5.4-1 del documento di Affinity Domain per la codifica ruoli

Ruolo dell’utente che effettua la richiesta

si

urn:oasis:names:tc:xacml:2.0:subject:role

Contesto operativo richiesta

asserzione attributo

Vedi tabella 5.4-2 del documento di Affinity Domain

Scopo d’uso della richiesta

si

urn:oasis:names:tc:xspa:1.0:subject:purposeofuse

Tipo documento

asserzione attributo

Codifica LOINC

Elenco dei tipi dei documenti da ricercare

si (solo se valorizzato il campo Tipo documento nel body)

urn:oasis:names:tc:xspa:1.0:resource:hl7:type

Identificativo assistito/genitore-tutore

asserzione attributo

Formato codifica  conforme alla specifiche IHE (ITI TF-3)

Codice Fiscale dell’assistito cui si riferisce la richiesta o del genitore/tutore che ha richiesto l’operazione

si

urn:oasis:names:tc:xacml:1.0:resource:resource-id

Presa in carico

asserzione attributo

Possibili valori: true/false

Indicazione sulla presa in carico del paziente

si

urn:oasis:names:tc:xspa:1.0:resource:patient:consent

Tipo Attività

asserzione attributo

Valore: READ

Tipo di attività: CREATE, READ, UPDATE, DELETE

si

urn:oasis:names:tc:xacml:1.0:action:action-id

Elenco Identificativi

assistito

asserzione di identificazione

 

Lista dei codici

fiscali associati

all’assistito, di

cui uno è quello

valido

si (solo per il flusso INI-RDA e per assistiti con più codifici fiscali)

 

Identificativo assistito

specifico per messaggio

Formato codifica  conforme alla specifiche IHE (ITI TF-3)

Codice fiscale dell’assistito per cui è stato prodotto il documento

si
(in caso di FindDocuments)

$XDSDocumentEntryPatientId

Stato documento

specifico per messaggio

urn:oasis:names:tc:ebxml-regrep:StatusType:Approved

Stato del documento: devono essere restituiti solo documenti con stato Approved

si

(in caso di FindDocuments)

$XDSDocumentEntryStatus

Tipo documento

specifico per messaggio

Codifica LOINC

Tipo documento indicato nel caso di stored query FindDocuments

no

$XDSDocumentEntryTypeCode

Intervallo temporale ricerca

specifico per messaggio

YYYY[MM[DD[hh[mm[ss]]]]]

Intervallo date indicato nel caso di stored query FindDocuments

no

$XDSDocumentEntryCreationTimeFrom

$XDSDocumentEntryCreationTimeTo

Identificativi documenti

specifico per messaggio

Formato codifica  conforme alla specifiche IHE (ITI TF-3)

Identificativi degli oggetti nel registry da trasferire. Questo elemento deve essere indicato nel caso di stored query GetDocuments

si (in caso di GetDocuments)

$XDSDocumentEntryUniqueId

 

oppure

 

$XDSDocumentEntryEntryUUID

 

Messaggio di risposta Ricerca dei documenti con successo (flussi RDA->INI, INI->RDE)

Ad esclusione dello stato della risposta, tutti gli altri elementi devono essere replicati per ogni oggetto soddisfacente i criteri di ricerca.

Questo messaggio di risposta è strutturato allo stesso modo sia per i flussi da RDA ad INI sia per i flussi da INI a RDE.

 

Campo

Tipologia

Codifica

Descrizione

Obbligatorio

Dato XDS (ove applicabile)

Stato risposta

specifico per messaggio

Come da specifiche IHE

Successo/
Fallimento

si

AdhocQueryResponse.status

Tipologia di struttura che ha prodotto il documento

specifico per messaggio

Da Affinity Domain, Tabella 2.8-1

Codifica della specialità o del tipo di struttura

si

XDSDocumentEntry. healthcareFacilityTypeCode (ITI TF:3 4.2.3.2.11)

Identificativo assistito

specifico per messaggio

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Codice fiscale dell’assistito per cui è stato prodotto il documento

si

XDSDocumentEntry.patientId (ITI TF:3 4.2.3.2.16)

Tipo MIME

specifico per messaggio

Da Affinity Domain, Tabella 2.10-1

Indica il mime type del documento

si

XDSDocumentEntry.mimeType (ITI TF:3 4.2.3.2.15)

Identificativo organizzazione

specifico per messaggio

Codifica OID nazionale delle regioni/
province autonome italiane, come specificato al paragrafo 2.9 del documento di Affinity Domanin.

Identificativo della regione di Assistenza

no

XDSDocumentEntry.homeCommunityId (ITI TF:3 4.2.3.2.12)

Identificativo repository

specifico per messaggio

Codifica OID, come specificato al paragrafo 2.14 del documento Affinity Domain

Identificativo del Repository che custodisce il documento

si

XDSDocumentEntry.repositoryUniqueId (ITI TF:3 4.2.3.2.18)

Identificativo documento

specifico per messaggio

Codifica OID, come specificato al paragrafo 2.19 del documento Affinity Domain

Identificativo del documento

si

XDSDocumentEntry.uniqueId (ITI TF:3 4.2.3.2.26)

Versione dell’oggetto documento all’interno del Registry

Specifico per messaggio

Formato codifica conforme alla specifiche IHE

Versione dell’oggetto documento all’interno del registry

Esempio:

 

<VersionInfo versionName=”1” />

si

 

Tipo documento (alto livello)

specifico per messaggio

Da Affinity Domain, Tabella 2.3-1

Descrive la tipologia di documento ad alto livello (Prescrizione, Report, Immagine, …). Viene riportata l'indicazione che il documento o dato è stato inserito dall'assistito (taccuino)

si

XDSDocumentEntry.classCode (ITI TF:3 4.2.3.2.3)

Tipologia documento (medio livello)

specifico per messaggio

Codifica LOINC (i possibili valori sono indicati in Tabella 2.18-1 del documento di Affinity Domain)

Descrive la tipologia di documento in modo più dettagliato (prescrizione specialistica, prescrizione farmaceutica, …)

si

XDSDocumentEntry.typeCode (ITI TF:3 4.2.3.2.25)

Tipologia documento (basso livello)

specifico per messaggio

Da Affinity Domain, Tabella 2.6-1

Unito al typeCode permette di individuare la struttura di un documento (es. template per i documenti in formato CDA R2)

si

XDSDocumentEntry.formatCode (ITI TF:3 4.2.3.2.9)

 

Identificativo univoco dell’oggetto documento all’interno del Registry

specifico per messaggio

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Identifica l’insieme di metadati associati ad un documento

si

XDSDocumentEntry.entryUUID (ITI TF:3 4.2.3.2.7)

Data validazione documento

specifico per messaggio

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Data di creazione del documento

si

XDSDocumentEntry.creationTime (ITI TF:3 4.2.3.2.6)

Autore del documento

specifico per messaggio

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Codice fiscale, struttura sanitaria, ruolo, specialità e riferimenti dell’autore del documento

si

XDSDocumentEntry.author (ITI TF:3 4.2.3.2.1)

Hash

specifico per messaggio

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Parametro caratterizzante il documento

si

XDSDocumentEntry.hash (ITI TF:3 4.2.3.2.10)

Size

specifico per messaggio

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Parametro caratterizzante il documento

si

XDSDocumentEntry.size (ITI TF:3 4.2.3.2.21)

Assetto organizzativo che ha portato alla creazione del documento

specifico per messaggio

Da Affinity Domain, Tabella 2.12-1

Es. Medicina Generale, Cardiochirurgia Pediatrica ecc.

si

XDSDocumentEntry. practiceSettingCode (ITI TF:3 4.2.3.2.17)

Identificativo del paziente al momento della creazione del documento

specifico per messaggio

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Questo valore non cambia a seguito del merge di più identificativi

si

XDSDocumentEntry.sourcePatientId (ITI TF 3: 4.2.3.2.23)

Lingua del documento

specifico per messaggio

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Indica la lingua del documento (il valore deve essere “it-IT”)

no

XDSDocumentEntry.languageCode (ITI TF 3: 4.2.3.2.14)

Data della prestazione

specifico per messaggio

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Indica le date di inizio e fine della prestazione sanitaria che ha comportato la produzione del documento

no

XDSDocumentEntry. serviceStartTime (ITI TF 3: 4.2.3.2.19)

XDSDocumentEntry. serviceStopTime (ITI TF 3: 4.2.3.2.20)

Riferimento al documento di prescrizione

specifico per messaggio

Formato codifica conforme alla specifiche IHE (ITI TF-3)

Nel caso i metadati fanno riferimento ad un documento referto prodotto a partire da un documento di prescrizione, questo metadato identifica il documento di prescrizione dematerializzata dal quale è generato il documento di referto.

no

XDSDocumentEntry.referenceIdList (ITI TF:3 4.2.3.2.28)

Conservazione sostitutiva

specifico per messaggio

Da Affinity Domain, come specificato al paragrafo 2.21 del documento Affinity Domain

Indica se il documento è memorizzato negli archivi di conservazione sostitutiva

si (solo nel caso in cui il documento è in conservazione)

urn:ita:2017:repository-type

Livello di confidenzialità

specifico per messaggio

Da Affinity Domain, Tabella 2.5-1

Indica il livello di confidenzialità del documento (ad es. se contiene informazioni a maggior tutela di anonimato). I documenti a maggior tutela di anonimato devono essere resituiti solo se il paziente ha deciso preventivamente di renderli visibili.

si

XDSDocumentEntry.confidentialityCode (ITI TF:3 4.2.3.2.5)

 

 

Messaggio di risposta Ricerca dei documenti con fallimento (flussi RDA->INI, INI->RDE, INI->RDA)

Il messaggio di risposta, in caso di errore, può essere:

  • generato dalla RDA, per il flusso di comunicazione tra la RDA e l’INI a seguito di messaggio di richiesta della RDE inoltrato dall’INI (per segnalare l’assenza di diritti di accesso o altri errori); il messaggio è inoltrato dall’INI alla RDE;
  • generato dall’INI, per il flusso di comunicazione tra la l’INI e la RDE (per segnalare l’assenza di consenso alla consultazione dell’assistito o altri errori);
  • generato dall’INI, per il flusso di comunicazione tra l’INI e la RDA (per segnalare l’assenza di consenso alla consultazione dell’assistito, che la regione chiamante è RDA dell’assistito o altri errori).

 

Campo

Tipologia

Codifica

Descrizione

Obbligatorio

Stato risposta

specifico per messaggio

Come da specifiche IHE

Successo/
Fallimento

si

Codice errore

specifico per messaggio

Come da specifiche IHE

Vedi tabella codici errore

si

 

Nel caso in cui la richiesta di ricerca documenti sia effettuta da un sistema di FSE che l’INI riconosce come RDA del paziente e il paziente (soggetto della query) ha espresso il consenso alla consultazione, l’INI invierà un messaggio di warning al sistema di FSE richiedente.

A titolo esemplificativo, in appendice A1, sono riportati i messaggi di richiesta e risposta del servizio. Per maggiori dettagli si rimanda alle specifiche tecniche ufficiali IHE.


Fallimento servizio

Codici di errore

AdhocQueryResponse/RegistryErrorList/RegistryError
 

Attributo

Tipo di dato

Valore

codeContext

String

Vedi tabella messaggi di errore

errorCode

String

[ERROR_CODE]

location

String

Indica la posizione dell’errore verificatosi

Severity

String

urn:oasis:names:tc:ebxml-regrep:ErrorSeverityType:Error

 

AdhocQueryResponse/RegistryErrorList/RegistryError.errorCode
 

[ERROR_CODE]

Descrizione

XDSRegistryBusy

Carico di lavoro eccessivo

XDSRegistryError

Errore interno: specificare solo se non sono disponibili codici più dettagliati

XDSRegistryOutOfResources

Poche risorse

XDSStoredQueryMissingParam

Parametro richiesto mancante per una stored query

XDSUnknownStoredQuery

Stored query non riconosciuta

 

Codici di warning

AdhocQueryResponse/RegistryErrorList/RegistryError
 

Attributo

Tipo di dato

Valore

codeContext

String

Vedi tabella messaggi di errore

errorCode

String

[ERROR_WARNING]

location

String

Indica la posizione del warning verificatosi

severity

String

urn:oasis:names:tc:ebxml-regrep:ErrorSeverityType:Warning

 

AdhocQueryResponse/RegistryErrorList/RegistryError.errorCode
 

[ERROR_WARNING]

Descrizione

XDSRegistryError

Nessun documento del tipo richiesto è registrato per il paziente indicato, oppure il dominio richiedente è RDA per il paziente.

 

Gestione errori di verifica delle asserzioni

Gli errori generati da eventuali fallimenti di controllo sulle asserzioni sono descritti nel capitolo 4.

 

[1] IHE ITI TF-2a 3.18

Ultimo aggiornamento: 06/02/2018