Template  CDA ClinicalDocument (with nonXMLBody)

ClinicalDocument/typeId è un elemento che identifica i vincoli imposti dalle specifiche HL7 CDA Rel 2.0 ossia identifica la versione del CDA a cui il documento fa riferimento.

L'elemento <typeId> rappresenta un identificatore univoco (di tipo HL7 Instance Identifier).

ClinicalDocument/templateId è un elemento che identifica la specifica versione del template che dovrebbe essere utilizzata dal document consumer per la validazione del documento corrente. I template permettono di definire, per una certa tipologia di documenti (ClinicalDocument/code) dei vincoli e linee guida da applicare al documento stesso.

L'elemento templateId permette di avere un documento la cui struttura interna sia condivisa a livello italiano

L'elemento id rappresenta l'identificativo univoco del documento.

Ogni singola istanza di documento CDA viene dotata di un IDENTIFICATIVO UNIVERSALMENTE UNIVOCO, che andrà specificato nell'elemento <id> del documento.

L’assegnazione ad ogni entità generatrice di documenti di un nodo OID, a cui riferirsi per generare sequenze univoche di identificatori, garantisce l’unicità dei documenti.

L'elemento translation viene utilizzato per andare a mappare il codice LOINC del tipo di documento da generare, in un sistema di codifica locale.

L'elemento title specifica il titolo del documento

L'elemento statusCode indica lo stato del documento.

Questa estensione del CDA può essere usata per indicare che il referto non è nel suo stato finale. L'assenza dell'elemento identifica che il documento è nel suo stato finale (“completed”). Si raccomanda di usare questa estensione solo nel caso di referto non ancora finalizzato.

L'elemento effectiveTime indica giorno e ora della creazione dell’istanza del documento.

L’elemento confidentialityCode rappresenta il livello di riservatezza dell’intero documento e dei dati in esso contenuti.

Il documento contiene l’elemento ClinicalDocument/confidentialityCode

• L’attributo ClinicalDocument/confidentialityCode/@codeSystem, individua l’OID del sistema di codifica e viene valorizzato con “2.16.840.1.113883.5.25”.

• L’attributo ClinicalDocument/confidentialityCode/@code, indica il codice di riservatezza del documento. I possibili valori sono “N” Normal, “V” Very Restricted

• Per i documenti contenenti dati a maggior tutela dell’anonimato, l’elemento ClinicalDocument/confidentialityCode/@code viene valorizzato con il valore “V”.

• L’attributo ClinicalDocument/confidentialityCode/@codeSystemName, indica il nome del sistema di codifica utilizzato. L’attributo, se presente, viene valorizzato con “HL7 Confidentiality”

"Normal" o "Very Restrict"

L'elemento languageCode identifica il tipo di linguaggio utilizzato nel documento.

L'elemento setId rappresenta l’identificativo comune a tutte le revisioni di uno specifico documento.

Nel caso di sostituzione del documento, l'elemento <setId> ha un valore costante tra le diverse versioni del medesimo documento, mentre l'elemento <versionNumber> cambia al variare della revisione.

Anche l'elemento <setId>, come l'elemento <id>, DEVE essere globalmente unico. È CONSIGLIATO, pertanto, valorizzare, alla prima creazione del documento, i campi <setId> e <id> allo stesso modo, modificando successivamente nelle diverse revisioni solo l'elemento <id> con un nuovo IUD e lasciando costante il valore dell'elemento <setId>.

L'attributo @root, valorizzato con un identificativo, garantisce l'univocità dell'istanza dell'identificativo a livello globale.

L'attributo @extension valorizzato con un identificativo unico all'interno del dominio di identificazione

L'attributo @assigningAuthorityName valorizzato con il nome dell'organizzazione responsabile per il dominio di identificazione dei documenti

L'elemento versionNumber identifica le versioni successive del documento.

Il documento DEVE contenere uno ed un solo elemento <ClinicalDocument>/<versionNumber> valorizzato con un intero positivo a partire dal numero 1. La progressione delle versioni incrementerà il numero di versione di 1 (sequenza delle versioni densa).

L'elemento recordTarget codifica i dati identificativi ed anagrafici del paziente.

Il soggetto della prestazione PUÒ essere di tre tipologie:

• Soggetto Umano (Human Patient),

• Soggetto non appartenente alla specie umana (Non-Human Subject), ad esempio un animale,

• Soggetto appartenente alla specie umana (soggetto) associato con soggetto non appartenente alla specie umana (Human Patient with Non-Human Subject),

L'elemento patientRole identifica il soggetto della prestazione.

L'elemento id può essere valorizzato con le seguenti informazioni:

• Cittadino italiano o straniero residente, iscritto SSN (Codice Fiscale)

• Soggetti assicurati da istituzioni estere (TEAM);

• Europei non iscritti al SSN (ENI)

• Stranieri Temporaneamente Presenti (STP);

• Codice ANA

Nel caso in cui il codice ENI venga assegnato a livello nazionale, il tag patientRole/id/@root DEVE essere valorizzato con il seguente codice [2.16.840.1.113883.2.9.4.3.18]

Nel caso in cui il codice ENI venga assegnato a livello regionale, il tag patientRole/id/@root DEVE essere valorizzato con l’OID locale assegnato dall’organizzazione che ha rilasciato il codice identificativo.

L'attributo @extension indica il valore cifrato secondo le specifiche MEF.

Codice ENI di 16 caratteri assegnato al cittadino europeo non iscritto al SSN e non provvisto di TEAM. Deve iniziare con la stringa "ENI".

L'attributo @assigningAuthorityName indica il nome dell’organizzazione che ha rilasciato il codice identificativo

L'elemento addr viene utilizzato per codificare l’indirizzo.

Si osserva che, nell’elemento addr, l’attributo @use DEVE essere valorizzato con i valori seguenti:

• per indicare l’indirizzo di domicilio: @use =”HP” (primary home);

• per indicare l’indirizzo di residenza: @use =”H” (home);

• per indicare un indirizzo temporaneo: @use =”TMP” (temporary address).

L'elemento telecom è un numero telefonico (Voce o Fax), un indirizzo di posta elettronica (E-mail), o altro indirizzo di una risorsa raggiungibile con un'apparecchiatura di telecomunicazione. L'indirizzo viene specificato tramite un Universal Resource Locator URL qualificato da una specifica di tempo e codici di uso che aiutano nella decisione, di quale indirizzo scegliere, per una certa ora o giorno e finalità o scopo. In modo analogo al tag addr, i numeri di telefono, codificati con il tag telecom, sono caratterizzati dall’attributo use.

Si osserva che l’attributo @use viene utilizzato per specificare il tipo di indirizzo raggiungibile da un’apparecchiatura di telecomunicazione. La differenziazione è realizzata attraverso l’attributo @use che assume valori da definirsi nel contesto di utilizzo del documento, ad esempio: “HP” Telefono/e-mail Casa; “WP” Telefono/e-mail Ufficio; “MC” Cellulare (contatto mobile).

L'elemento patient è un elemento che contiene i dati anagrafici del soggetto della prestazione.

Solo per soggetti umani, l’elemento patientRole/patient DEVE contenere l’elemento patient/administrativeGenderCode (sesso).

L’elemento OBBLIGATORIO patient/administrativeGenderCode contiene al suo interno gli attributi:

• @code: che identifica il sesso dichiarato del paziente;

• @codeSystem: che riporta l’OID fisso “2.16.840.1.113883.5.1”;

• @codeSystemName: che riporta la stringa fissa “HL7 AdministrativeGender”

L’elemento <birthTime> identifica la data di nascita del paziente.

L’elemento <guardian> definisce il tutore/genitore che rappresenta il minore. E' un elemento opzionale, entità o una persona che agisce o è autorizzata ad agire come responsabile del paziente (persona o organizzazione).

L'elemento guardianPerson si utilizza solo per i minori che hanno bisogno di un responsabile di riferimento. guardianPerson è colui che ha la "patria potestà" sul soggetto di cura; non è obbligatorio, andrebbe messo per i pazienti pediatrici.

L'elemento guardianOrganization si usa per i minori che sono stati dati in affidamento ad una struttura; non è obbligatorio, andrebbe messo per i pazienti pediatrici.

L'elemento birthPlace indica il luogo di nascita dl paziente. Nel caso in cui il paziente è nato in Italia ed il tag presenta l’elemento <ClinicalDocument>/<recordTarget>/<patientRole>/<patient>/<birthPlace> (luogo di nascita) , tale elemento DEVE includere al suo interno il censusTract, per identificare il codice del comune di nascita, e l’elemento city, per il nome del comune di nascita.

ProviderOrganization è l'entità (di livello superiore) che fa giocare il “ruolo” di paziente alla persona, di conseguenza può contenere ad esempio la struttura che ha erogato la prestazione, quella che l'ha registrato, l'ASL, la regione, etc.

L'elemento author rappresenta l'autore del documento.

L'elemento time indica data e ora della creazione del documento.

L'elemento assignedAuthor indica l'utente che gioca il ruolo di autore. Il documento può essere generato da un operatore sanitario, da un portale web o da un dispositivo ad accesso pubblico.

L’elemento author/assignedAuthor/telecom riporta i recapiti dell’autore.

L'elemento assignedPerson viene usato per descrivere l'autore del documento

L'elemento assignedAuthoringDevice indica il dispositivo e/o l’applicazione software che ha generato il documento.

Il tag <representedOrganization> contiene al suo interno un tag <id> e un tag <name> che riportano rispettivamente l'identificativo e il nome della struttura/organizzazione a cui è associato l’autore.

L'elemento dataEnterer rappresenta la persona che trasforma un testo dettato nel documento CDA.

L'elemento time indica la data e ora in cui è stata trascritto il documento. Il formato può essere scelto con la precisione voluta.

L’informant è un elemento che serve a descrivere la persona che ha fornito informazioni di interesse per il documento.

Si suggerisce il suo utilizzo se la fonte di informazioni non non è né l’autore né il paziente. Per tale elemento deve essere specificato o l’elemento: assignedEntity.assignedPerson.name oppure l’elemento: relatedEntity.relatedPerson.name.

Il custodian è l’organizzazione responsabile della conservazione dell’originale del documento, al momento della generazione, esso registra usualmente l’identificativo della Struttura Sanitaria a cui appartiene l’author.

Normalmente identifica la struttura presso la quale è generato il documento (cioè la struttura in cui ha luogo il contatto sanitario del paziente), il custodian potrà essere anche la stessa organizzazione relativa all’AREA-DOMINIO, utilizzando un modello centralizzato.

ClinicalDocument.custodian secondo le specifiche di CDA R2 è un elemento obbligatorio ed è unico.

L'elemento informationRecipient indica la persona (e.g medico di base) o l'organizzazione a cui è destinato il documento.

L'elemento intendedRecipient indica la persona (e.g medico di base) od organizzazione a cui è destinato il documento.

L'elemento legalAuthenticator rappresenta l’attore che ha legalmente autenticato il documento prodotto in locale

L'elemento time indica la data e l'orario in cui è stata apposta la firma al documento.

L'elemento signatureCode indica se il documento locale è stato firmato elettronicamente o manualmente.

L'elemento authenticator rappresenta un partecipante che attesta l'accuratezza del documento ma che non ha il potere di autenticare legalmente il documento. Sia l'authenticator che il legalAuthenticator possono firmare digitalmente il documento ma l'authenticator può essere diverso dal legalAuthenticator.

L'elemento time indica la data e ora in cui è stata apposta la firma. Il formato può essere scelto con la precisione voluta.

Il tag <signatureCode> indica che il documento è stato firmato digitalmente.

L'elemento participant è usato per rappresentare tutti coloro (persone od organizzazioni) che sono in qualche modo coinvolti nell’atto descritto, ma non esplicitamente referenziate in altri elementi (author, informant, authenticator,etc.). Non devono essere necessariamente entità coinvolte direttamente nell’atto documentato.

L'attributo typeCode indica il valore da ricercarsi nel ruolo svolto dal soggetto che si intende descrivere

L'elemento associatedPerson viene usato per descrivere in forma leggibile il soggetto che ha partecipato alla

stesura del documento.

Con l'elemento scopingOrganization si indica la struttura che ha effettuato la prenotazione.

L'elemento inFulfillmentOf è utilizzato per indicare che il documento è stato creato in risposta ad una precedente richiesta.

Nell'elemento order possono essere mappati gli identificativi delle seguenti tipologie di richieste:

• la/le richieste gestita/e dal punto prelievi verso il laboratorio di analisi;

• la/le richieste pervenuta/e da un determinato reparto all’interno di una struttura ospedaliera verso il laboratorio di analisi;

▪ richiesta interna ad un ricovero

▪ richiesta interna al PS

• la/le prescrizione/i cartacea/e

• la/le prescrizione/i dematerializzata/e

L'elemento id rappresenta l'identificativo univoco della richiesta.

Nell'elemento priorityCode viene gestita la tipologia di priorità associata alla richiesta.

priorityCode è un data type di tipo CE le cui componenti DEVONO essere valorizzate come segue:

• code (OBBLIGATORIO). Tale attributo di tipo ST (Character String) DEVE assumere uno dei valori del vocabolario HL7 ActPriority;

• codeSystem (OBBLIGATORIO). Tale attributo DEVE assumere il valore costante 1220 2.16.840.1.113883.5.7;

• codeSystemName (RACCOMANDATO). Tale attributo di tipo ST (Character String) DEVE assumere il valore costante HL7 ActPriority;

• displayName (OPZIONALE). Tale attributo di tipo ST (Character String) viene valorizzato con la descrizione (Print Name) del codice nel vocabolario HL7 ActPriority.

L'elemento relatedDocument viene utilizzato nella gestione delle trasformazioni successive alla prima versione del documento; è un elemento OPZIONALE alla prima generazione di un documento CDA ed è OBBLIGATORIO per le trasformazioni successive.

L’attributo relatedDocument/@typeCode PUÒ essere valorizzato come segue:

• APND (append): DEVE essere usato in caso di documenti CDA ottenuti aggiungendo al documento “sorgente”;

• RPLC (replace): DEVE essere usato in caso di documenti CDA ottenuti sostituendo il documento “sorgente”;

• XFRM (Transform): DEVE essere usato in caso di documenti CDA ottenuti tramite una trasformazione del documento “sorgente”.

L'elemento id rappresenta l'identificativo del documento padre.

L'elemento setId rappresenta l'identificativo comune a tutte le revisioni del documento.

L'elemento versionNumber rappresenta la versione del documento.

L'elemento componentOf indica l'incontro tra l'assistito e la struttura sanitaria durante il quale l’atto documentato o l'evento è avvenuto

il tag id rappresenta l'identificativo univoco dell'encounter. Ad esempio nel caso in cui il serviceEvent documentato nel documento clinico sia stato erogato durante un ricovero ospedaliero in encompassingEncounter.id sarà gestito il numero nosologico.

Il tag <code> può essere utilizzato per definire la provenienza del soggetto che effettua la prestazione.

l'elemento encompassingEncounter/code PUÒ assumere per esempio i seguenti valori:

• IMP (inpatient encounter) per rappresentare il numero nosologico,

• AMB (ambulatory) per rappresentare l’identificativo di un incontro avvenuto in una struttura ambulatoriale.

L'elemento responsibleParty indica la persona responsabile della struttura dove avviene l'incontro con il soggetto che effettua la prestazione.

L’elemento location rappresenta il luogo in cui si è svolto l'incontro tra il soggetto e la struttura sanitaria; ad esempio, nel caso in cui l'incontro sia un ricovero ospedaliero, il tag location.healthCareFacility può rappresentare il reparto della struttura ospedaliera.