3.6 Recupero riferimenti documento

Il protocollo di comunicazione da utilizzare per il servizio di recupero riferimenti documento deve essere conforme alla transazione IHE [ITI-18] Registry Stored Query[1] con stored query di tipo GetDocuments e returnType di tipo ObjectRef. La transazione, secondo la terminologia IHE, prevede l’invio di una query da un attore XDS Document Consumer (in questo caso il nodo regionale della RCD) ad un attore XDS Document Registry (in questo caso il nodo regionale della RDA dell’assistito), in maniera mediata dall’attore National Gateway dell’INI. Pertanto, l’attore XDS Document Consumer effettua una richiesta al National Gateway che si occupa di inoltrare il messaggio all’attore XDS Document Registry. 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 recupero riferimenti documento.

Messaggio di richiesta Recupero riferimenti documento (flussi RCD->INI, INI->RDA)
 

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

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. Valore: UPDATE

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

no

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

Identificativo assistito

asserzione attributo

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

Codice fiscale dell’assistito cui si riferisce la richiesta

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 documento

specifico per messaggio

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

Identificativo del documento di cui si vogliono recuperare i referimeni ai metadati memorizzati nel registry.

si

$XDSDocumentEntryUniqueId

 

Messaggio di risposta Recupero riferimenti documento con successo (flussi RDA->INI, INI->RCD)

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

 

Campo

Tipologia

Codifica

Descrizione

Obbligatorio

Dato XDS (ove applicabile)

Stato risposta

specifico per messaggio

Come da specifiche IHE

Successo/
Fallimento

si

AdhocQueryResponse.status

Identificativo univoco dell’oggetto documento all’interno del Registry

specifico per messaggio

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

Necessario per creare relazioni tra i documenti

si

XDSDocumentEntry.entryUUID (ITI TF:3 4.2.3.2.7)

Versione dell’oggetto documento all’interno del Registry

Specifico per messaggio

Formato codifica conforme alla specifiche IHE

Necessario per creare relazioni tra i documenti

Esempio:

 

<VersionInfo versionName=”1” />

si

 

 

Messaggio di risposta Recupero riferimenti documento con fallimento (flussi RDA->INI, INI->RCD, 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 RCD 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 RCD (per segnalare errori di formulazione della richiesta o altri errori);
  • generato dall’INI, per il flusso di comunicazione tra l’INI e la RDA per segnalare 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

 

A titolo esemplificativo, in appendice A7, 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

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