3.6 Recupero riferimenti documento | Fascicolo Sanitario Elettronico

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