hl7:ClinicalDocument
|
|
1 … 1 |
|
Elemento root per la struttura XML che rappresenta il documento CDA. Ogni documento
CDA iniziare con l'elemento ClinicalDocument , che comprende gli attributi speciali
xsi:schemaLocation, xmlns e xmlsn:xsi, i quali specificano il riferimento ad un namespace
esterno, come esemplificato nel codice XML seguente:
|
(Refrio) |
@classCode
|
cs |
1 … 1 |
F |
DOCCLIN |
@moodCode
|
cs |
1 … 1 |
F |
EVN |
|
Example |
<hl7:ClinicalDocument xsi:schemaLocation="urn:hl7-org:v3 CDA.xsd"> ... </hl7:ClinicalDocument> |
hl7:realmCode
|
CS |
1 … 1 |
R |
Questo elemento segnala l’attuazione di vincoli specifici del dominio di autenticazione.
Il valore del suo attributo @code identifica il dominio di identificazione in questione.
Questo elemento non dovrebbe essere utilizzato per identificare il paese di origine.
|
(Refrio) |
|
Example |
<realmCode code="IT"/> |
hl7:typeId
|
II |
1 … 1 |
M |
Elemento che indica che il documento è strutturato secondo le specifiche HL7-CDA .
L'elemento rappresenta un identificatore univoco (di tipo HL7 Instance Identifier)
ed è composto dagli attributi seguenti.
|
(Refrio) |
@root
|
uid |
1 … 1 |
F |
2.16.840.1.113883.1.3 |
@extension
|
st |
1 … 1 |
F |
POCD_MT000040UV02 |
hl7:templateId
|
II |
1 … * |
M |
Elemento che indica il template di riferimento per il documento CDA.
L'elemento <templateId> (di tipo HL7 Instance Identifier) è composto da un attributo
@root che riporta un codice OID, un attributo @extension che riporta un codice specifico.
I template possono essere utilizzati per individuare, in relazione alla tipologia
di documento espresso dall'elemento <code>, un insieme di restrizioni/linee guida
da applicare all'intero documento o ad una specifica sezione dello stesso.
Nel caso specifico, dal momento che l'elemento <code> indica il codice relativo al
documento di "Referto di Laboratorio Analisi", l'elemento <templateId> identificherà
la specifica versione del template che dovrebbe essere utilizzata dal document consumer
per la validazione del documento corrente.
L'elemento <templateId> può, in questo contesto, permettere la progressiva evoluzione
dei modelli di documento CDA utilizzati.
L'elemento <templateId> rappresenta un identificatore univoco ed è composto dagli
attributi seguenti.
Cambiando la versione del template viene modificata la cifra dell'attributo @extension
e non dell'attributo @root.
L'attributo @extension è rappresentativo della specifica versione del template di
riferimento.
Nel caso in cui ci sia l’esigenza di introdurre vincoli aggiuntivi, si possono utilizzare
ulteriori istanze che identificano i riferimenti ad eventuali template che rappresentano
dei raffinamenti rispetto al template Referto di Laboratorio Analisi HL7 Italia.
|
|
(Refrio) |
@root
|
uid |
1 … 1 |
F |
2.16.840.1.113883.2.9.10.1.1 |
@extension
|
st |
1 … 1 |
R |
Versione del Template.
|
hl7:id
|
II |
1 … 1 |
R |
Elemento che identifica univocamente l'istanza di ogni documento CDA.
L'elemento <id> è un valore del tipo HL7 "Instance Identifier" ed è composto in generale
da un attributo @root che riporta un codice OID, un attributo @extension che riporta
un codice specifico ed un attributo @assigningAuthorityName con il nome dell'organizzazione
che è responsabile della identificazione posta nell’attributo @extension.
Ogni singola istanza di documento CDA (Referto Laboratorio Analisi) DEVE essere 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.
|
|
(Refrio) |
@root
|
uid |
1 … 1 |
R |
Identificativo univoco del dominio di identificazione. Tale OID – riconosciuto pubblicamente
– è usato per garantire l'univocità dell'identificativo a livello globale.
|
@extension
|
st |
1 … 1 |
R |
Identificativo dell’istanza CDA del documento. Tale identificativo è unico all’interno
del dominio di identificazione. È tipicamente originato dal sistema che genera il
documento, secondo regole condivise all’interno dello spazio di identificazione, in
maniera tale da assicurare l'univocità di tale attributo
all'interno del medesimo dominio.
|
@assigningAuthorityName
|
st |
1 … 1 |
R |
Nome dell’organizzazione responsabile per il dominio di identificazione dei documenti. |
hl7:code
|
CE |
1 … 1 |
R |
Elemento che indica la tipologia di documento.
L'elemento <code> riporta un codice che identifica la tipologia di documento a cui
il CDA si riferisce. Il valore deve fare riferimento al sistema di codifica LOINC.
In particolare, si dovrà utilizzare il codice LOINC “1502-2” - Referto di Laboratorio
Analisi - per identificare il documento clinico strutturato deò Laboratorio Analisi
(LIS).
|
(Refrio) |
@code
|
|
1 … 1 |
F |
1502-2 |
@codeSystem
|
|
1 … 1 |
F |
2.16.840.1.113883.6.1 |
@codeSystemName
|
|
0 … 1 |
F |
LOINC |
@displayName
|
|
0 … 1 |
F |
Referto di laboratorio |
@code
|
CONF |
1 … 1 |
F |
1502-2 |
@codeSystem
|
1 … 1 |
F |
2.16.840.1.113883.6.1 (Logical Observation Identifier Names and Codes) |
@codeSystemName
|
1 … 1 |
F |
LOINC |
hl7:translation
|
CD |
0 … * |
|
Per indirizzare le problematiche di mapping della codifica LOINC di <ClinicalDocument>/<code>
in un altro sistema di codifica, ad esempio un sistema di codifica locale, si rimanda
all’uso di <code>/<translation>.
|
(Refrio) |
hl7:title
|
ST |
0 … 1 |
|
L'elemento rappresenta il titolo del documento CDA
|
(Refrio) |
sdtc:statusCode
|
CS |
0 … 1 |
|
Estensione che indica lo stato del documento.
L’attributo @code di tale elemento può essere valorizzato con “active” nel caso in
cui il referto non è ancora finalizzato, o con “completed” se il documento è nel suo
stato finale.
Si raccomanda di usare questa estensione solo nel caso del referto non ancora finalizzato
("active").
|
(Refrio) |
|
Example |
<statusCode code="active"/> |
hl7:effectiveTime
|
TS |
1 … 1 |
M |
Elemento che indica la data di creazione del documento CDA. L'elemento <effectiveTime>
rappresenta un codice temporale, che sarà essere valorizzato attraverso un tipo Time
Stamp (TS), come presentato di seguito. Tale valore deve essere quello del client
utilizzato dal document source, opportunamente certificato.
|
(Refrio) |
@value
|
|
1 … 1 |
R |
Valore: [YYYYMMDDHHMMSS+|-ZZZZ]: Anno, mese, giorno, ora, minuti, secondi. Le ore
devono essere riportate nell'intervallo 00:00:00 - 23:59:59. ZZZZ rappresenta l'offset
rispetto al tempo di Greenwich (GMT – Greenwich Mean Time). Il valore dell'offset
dipenderà dalle impostazioni di ora legale; per l'Italia potrà
variare fra ZZZZ valorizzato con +0100 oppure +0200 (nel caso di ora legale).
|
hl7:confidentialityCode
|
CE |
1 … 1 |
M |
Elemento che specifica il livello di riservatezza del documento. L'elemento <confidentialityCode>
riporta un codice che identifica il livello di confidenzialità del documento CDA secondo
la codifica di "Confidentiality" di HL7 definito dal seguente vocabolario.
-
N (normal): Regole normali di confidenzialità (secondo le buone e corrette pratiche
mediche). Ad esempio: Il paziente o suoi tutori/delegati possono sempre accedere al
documento, o Solo gli operatori autorizzati per scopi medici o sanitari, all’interno
di un mandato assistenziale o di un consenso specifico, possono accedere al documento.
-
V (very restricted): Accesso Molto Ristretto, come dichiarato dal Referente Privacy
dell’erogatore del servizio sanitario. Questa voce è in corso di definizione, si può
interpretare come accessibile solo al paziente e suoi tutori/delegati e dal medico
autore del documento.
|
|
(Refrio) |
|
CONF |
|
|
Example |
<confidentialityCode code="N" codeSystem="2.16.840.1.113883.5.25" codeSystemName="HL7 Confidentiality"/> |
hl7:languageCode
|
CS |
1 … 1 |
M |
Elemento che indica la lingua in cui è redatto il documento. L'elemento rappresenta
un codice conforme alle specifiche dell'IETF (Internet Engineering Task Force) RFC
3066 (OID:2.16.840.1.113883.6.121).
|
(Refrio) |
|
Example |
<languageCode code="“it-IT”/"/> |
hl7:setId
|
II |
0 … 1 |
|
Elemento che consente di gestire le revisioni del documento, o eventuali addendum
integrativi.
<setId> e <versionNumber> sono, secondo lo standard CDA, elementi opzionali, o meglio,
condizionalmente obbligatori.
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.
Tutte le nuove versioni del documento devono avere un <id> univoco e diverso da quello
delle versioni precedenti ed un <setId> uguale a quello definito nel primo documento
pubblicato.
Il nuovo documento creato tramite il replace deve comprendere un elemento <relatedDocument>
che punta al documento sostituito.
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>.
Nel caso di addendum integrativo al documento, questo deve avere un <id> univoco e
diverso da quello dei documenti precedenti associati, l’elemento <setId> assume un
nuovo valore rispetto al documento iniziale, mentre l'elemento <versionNumber> riparte
per ciascun addendum.
Il nuovo documento addendum deve comprendere un elemento <relatedDocument> che punta
al documento iniziale.
|
(Refrio) |
@root
|
uid |
1 … 1 |
R |
Identificativo univoco del dominio di identificazione. Tale OID – riconosciuto pubblicamente
– è usato per garantire l'univocità dell'identificativo a livello globale.
|
@extension
|
st |
1 … 1 |
R |
Identificativo dell’insieme di istanze che definiscono le diverse versioni di questo
documento. Tale identificativo è unico all’interno del dominio di identificazione.
È tipicamente originato dal sistema che genera il documento, secondo regole condivise
all’interno dello spazio di identificazione, in maniera tale da assicurare l'univocità
di tale attributo
all'interno del medesimo dominio.
|
@assigningAuthorityName
|
st |
0 … 1 |
|
Nome dell’organizzazione responsabile per il dominio di identificazione dei documenti.
|
hl7:versionNumber
|
INT |
0 … 1 |
|
|
(Refrio) |
@value
|
int |
1 … 1 |
R |
Ad ogni successiva versione del documento, in caso di sostituzione, tale numero deve
essere incrementato di una unità (partendo da 1).
|
Included |
1 … 1 |
|
from 2.16.840.1.113883.3.1937.777.63.10.332 CDA recordTarget LAB (2023‑07‑04 15:03:30)
Elemento che identifica il soggetto a cui il documento si riferisce.
Si osserva che il soggetto della prestazione può essere di tre tipologie:
-
Paziente (Human Patient),
-
Soggetto non appartenente alla specie umana (Non-Human Subject), ad esempio un animale
|
hl7:recordTarget
|
|
1 … 1 |
R |
|
CDArecordTarget LAB |
@typeCode
|
cs |
0 … 1 |
F |
RCT |
@contextControlCode
|
cs |
0 … 1 |
F |
OP |
hl7:patientRole
|
|
1 … 1 |
R |
Nel caso di Paziente (Human Patient)
L'elemento patientRole deve prevedere al suo interno almeno un elemento di tipo id, destinato ad accogliere la chiave identificativa del paziente, secondo gli schemi
assegnati da ogni singola organizzazione, ed eventualmente ulteriori elementi di tipo
id, destinati ad accogliere le informazioni relative ad altri identificativi (regionali,
nazionali, europei, termporanei, ecc).
Nel caso del Soggetto non appartenente alla specie umana (Non-Human Subject)
L’id rappresenta l’identificativo del soggetto non appartenente alla specie umana
|
CDArecordTarget LAB |
@classCode
|
cs |
0 … 1 |
F |
PAT |
hl7:id
|
II |
1 … * |
R |
Nel caso di Paziente (Human Patient) 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;
|
CDArecordTarget LAB |
@root
|
uid |
1 … 1 |
R |
Nel caso in cui l'identificativo sia rappresentato dal CF, il root sarà valorizzato
con 2.16.840.1.113883.2.9.4.3.2.
Nel caso in cui l'identificativo sia rappresentato dal Numero di Identificazione Personale
TEAM (Soggetti assicurati da istituzioni estere), il root sarà valorizzato con 2.16.840.1.113883.2.9.4.3.7
(Numero di Tessera TEAM estera), e 2.16.840.1.113883.2.9.4.3.3 (Numero di identificazione
personale TEAM).
Nel caso in cui l'identificativo sia rappresentato dal codice ENI (Europei Non Iscritti
al SSN), il root sarà valorizzato con "2.16.840.1.113883.2.9.4.3.18" (assegnazione
a livello nazionale) o con l'OID locale se l'assegnazione avviene a livello regionale.
Nel caso in cui l'identificativo sia rappresentato dal codice STP (Stranieri Temporaneamente
Presenti), il root sarà valorizzato con "2.16.840.1.113883.2.9.4.3.17" (assegnazione
a livello nazionale) o con l'OID locale se l'assegnazione avviene a livello regionale.
Nel caso in cui l'identificativo sia rappresentato dal codice ANA (Codice Anagrafica
Nazionale degli Assistiti), il root sarà valorizzato con "2.16.840.1.113883.2.9.4.3.15".
|
|
@extension
|
st |
1 … 1 |
R |
|
@assigningAuthorityName
|
st |
0 … 1 |
|
|
|
Example |
<id root="2.16.840.1.113883.2.9.4.3.2" extension="RSSMRA81T20H501L" assigningAuthorityName="MEF"/> |
hl7:addr
|
AD |
0 … * |
|
Elemento utilizzato per richiamare l’indirizzo del paziente. Possono esistere più
occorrenze dell’elemento per specificare i dati di residenza ed i dati di domicilio.
Contains 2.16.840.1.113883.3.1937.777.63.10.34 CDA addr (DYNAMIC)
|
CDArecordTarget LAB |
@use
|
set_cs |
1 … 1 |
R |
|
|
CONF |
|
|
Example |
<addr use="H"> <country>100</country> <state>120</state> <county>RM</county> <city>Roma</city> <censusTract>058091</censusTract> <postalCode>00187</postalCode> <streetAddressLine>Via Aurora 12</streetAddressLine></addr> |
hl7:telecom
|
TEL |
0 … * |
|
|
CDArecordTarget LAB |
@use
|
set_cs |
1 … 1 |
R |
|
|
CONF |
|
|
Example |
<telecom use="HP" value="mailto:mario.rossi@gmail.com"/> |
hl7:patient
|
|
0 … 1 |
R |
Nel caso di Paziente (Human Patient) l'elemento patient è obbligatorio.
|
CDArecordTarget LAB |
@classCode
|
cs |
0 … 1 |
F |
PSN |
@determinerCode
|
cs |
0 … 1 |
F |
INSTANCE |
hl7:name
|
|
0 … * |
|
Contains 2.16.840.1.113883.3.1937.777.63.10.60 CDA name (DYNAMIC)
|
CDArecordTarget LAB |
|
Example |
<name> <family>Guido</family> <given>Rossi</given></name> |
hl7:administrativeGenderCode
|
CE |
1 … 1 |
R |
|
CDArecordTarget LAB |
|
CONF |
|
|
Example |
<administrativeGenderCode code="M" codeSystem="2.16.840.1.113883.5.1" codeSystemName="HL7 AdministrativeGender" displayName="Maschio"/> |
hl7:birthTime
|
TS |
0 … 1 |
C |
|
CDArecordTarget LAB |
|
Example |
<birthTime value="19800329"/> |
hl7:guardian
|
|
0 … * |
|
|
CDArecordTarget LAB |
@classCode
|
cs |
0 … 1 |
F |
GUARD |
hl7:id
|
II |
0 … * |
|
|
CDArecordTarget LAB |
@root
|
uid |
1 … 1 |
R |
|
@extension
|
st |
1 … 1 |
R |
|
@assigningAuthorityName
|
|
0 … 1 |
|
|
hl7:code
|
CE |
0 … 1 |
|
|
CDArecordTarget LAB |
|
CONF |
shall be drawn from concept domain "RoleCode" |
|
hl7:addr
|
AD |
0 … * |
|
Contains 2.16.840.1.113883.3.1937.777.63.10.34 CDA addr (DYNAMIC)
|
CDArecordTarget LAB |
@use
|
set_cs |
1 … 1 |
R |
|
|
CONF |
|
hl7:telecom
|
TEL |
0 … * |
|
|
CDArecordTarget LAB |
@use
|
set_cs |
1 … 1 |
R |
|
|
CONF |
|
Choice |
|
|
Elements to choose from:
|
hl7:guardianPerson
|
|
0 … 1 |
|
Contains 2.16.840.1.113883.3.1937.777.63.10.54 CDA person (DYNAMIC)
|
CDArecordTarget LAB |
hl7:guardianOrganization
|
|
0 … 1 |
|
Contains 2.16.840.1.113883.3.1937.777.63.10.58 CDA Organization (DYNAMIC)
|
CDArecordTarget LAB |
hl7:birthplace
|
|
0 … 1 |
|
|
CDArecordTarget LAB |
@classCode
|
cs |
0 … 1 |
F |
BIRTHPL |
hl7:place
|
|
1 … 1 |
R |
|
CDArecordTarget LAB |
@classCode
|
cs |
0 … 1 |
F |
PLC |
@determinerCode
|
cs |
0 … 1 |
F |
INSTANCE |
hl7:addr
|
AD |
0 … 1 |
|
Contains 2.16.840.1.113883.3.1937.777.63.10.116 CDA AddressBirthPlace (DYNAMIC)
|
CDArecordTarget LAB |
@use
|
set_cs |
1 … 1 |
R |
|
|
CONF |
|
hl7:providerOrganization
|
|
0 … 1 |
|
Contains 2.16.840.1.113883.3.1937.777.63.10.58 CDA Organization (DYNAMIC)
|
CDArecordTarget LAB |
Included |
1 … * |
M |
from 2.16.840.1.113883.3.1937.777.63.10.333 CDA author LAB (2023‑07‑04 16:12:11)
L'elemento author identifica il creatore, redattore materiale, del documento.
Le diverse section del Referto di Medicina di Laboratorio possono essere create da soggetti diversi pertanto
author è un elemento che può essere istanziato più volte.
L’elemento author/assignedAuthor/addr rappresenta l’indirizzo dell’autore.
In author deve essere presente un elemento author/assignedAuthor/assignedPerson/name contenente nome e cognome dell’autore Non può essere utilizzato il @nullFlavor per indicare l’indisponibilità del dato
|
hl7:author
|
|
1 … * |
M |
L'elemento author rappresenta l'autore del documento.
|
CDAarLAB |
@typeCode
|
cs |
0 … 1 |
F |
AUT |
@contextControlCode
|
cs |
0 … 1 |
F |
OP |
hl7:functionCode
|
CE |
0 … 1 |
|
|
CDAarLAB |
hl7:time
|
TS |
1 … 1 |
R |
|
CDAarLAB |
hl7:assignedAuthor
|
|
1 … 1 |
R |
Il tag è <assignedAuthor> e può contenere al suo interno:
• un tag <id> che identifica univocamente il medico autore del documento tramite il
suo codice fiscale;
• un tag <assignedPerson> che definisce il nome e cognome dell’autore del documento;
• un tag <representedOrganization> che prevede al suo interno un tag che identifica
univocamente la struttura/organizzazione di appartenenza dell’autore
|
CDAarLAB |
@classCode
|
cs |
0 … 1 |
F |
ASSIGNED |
hl7:id
|
II |
1 … * |
R |
Definisce l’identificativo dell'operatore sanitario che è l'autore di questo documento.
Almeno un elemento id deve essere valorizzato con il codice fiscale.
|
CDAarLAB |
@root
|
uid |
1 … 1 |
R |
|
@extension
|
st |
1 … 1 |
R |
|
@assigningAuthorityName
|
st |
0 … 1 |
|
|
hl7:code
|
CE |
0 … 1 |
|
|
CDAarLAB |
hl7:addr
|
AD |
0 … * |
|
L’elemento addr rappresenta l’indirizzo dell’autore.
Contains 2.16.840.1.113883.3.1937.777.63.10.34 CDA addr (DYNAMIC)
|
CDAarLAB |
@use
|
set_cs |
1 … 1 |
R |
|
|
CONF |
|
hl7:telecom
|
TEL |
0 … * |
|
L'elemento telecom dettaglia i recapiti di contatto dell'autore.
|
CDAarLAB |
@use
|
set_cs |
1 … 1 |
R |
|
|
CONF |
|
Choice |
|
|
Elements to choose from:
|
hl7:assignedPerson
|
|
0 … 1 |
|
La sezione contiene un elemento assignedPerson che riporta i dati relativi all’autore all'interno delle sezioni opportune.
Contains 2.16.840.1.113883.3.1937.777.63.10.54 CDA person (DYNAMIC)
|
CDAarLAB |
@classCode
|
cs |
0 … 1 |
F |
PSN |
@determinerCode
|
cs |
0 … 1 |
F |
INSTANCE |
hl7:assignedAuthoringDevice
|
|
0 … 1 |
|
L'elemento assignedAuthoringDevice indica il dispositivo e/o l’applicazione software
che ha generato il documento.
Contains 2.16.840.1.113883.3.1937.777.63.10.35 CDA assignedAuthoringDevice (DYNAMIC)
|
CDAarLAB |
@classCode
|
cs |
0 … 1 |
F |
DEV |
@determinerCode
|
cs |
0 … 1 |
F |
INSTANCE |
hl7:representedOrganization
|
|
0 … 1 |
|
Contains 2.16.840.1.113883.3.1937.777.63.10.58 CDA Organization (DYNAMIC)
|
CDAarLAB |
Included |
1 … 1 |
M |
from 2.16.840.1.113883.3.1937.777.63.10.334 CDA custodian LAB (2023‑07‑04 16:41:41)
Il custodian è l’organizzazione responsabile della conservazione dell’originale del
documento, al momento della generazione.
|
hl7:custodian
|
|
1 … 1 |
M |
Il custodian è l’organizzazione responsabile della conservazione dell’originale del
documento, al momento della generazione.
|
CDAcnLAB |
@typeCode
|
cs |
0 … 1 |
F |
CST |
hl7:assignedCustodian
|
|
1 … 1 |
R |
Contains 2.16.840.1.113883.3.1937.777.63.10.75 CDA assignedCustodian (DYNAMIC)
|
CDAcnLAB |
@classCode
|
cs |
0 … 1 |
F |
ASSIGNED |
Included |
0 … * |
|
from 2.16.840.1.113883.3.1937.777.63.10.337 CDA informationRecipient LAB (2023‑07‑05 12:28:10)
informationRecipient è un elemento che identifica la persona (e.g medico di base) od organizzazione a cui è destinato
il documento. Se presente, l’indirizzo e i recapiti telefonici possono essere riportati
nell’elemento intendedRecipient, il nome deve essere riportato nell’elemento
intendedRecipient/informationRecipient .
|
hl7:informationRecipient
|
|
0 … * |
|
L'elemento informationRecipient indica la persona (e.g medico di base) o l'organizzazione
a cui è destinato il documento.
|
CDAitLAB |
@typeCode
|
cs |
0 … 1 |
F |
PRCP |
hl7:intendedRecipient
|
|
1 … 1 |
R |
L'elemento intendedRecipient indica la persona (e.g medico di base) od organizzazione
a cui è destinato il documento.
|
|
CDAitLAB |
@classCode
|
cs |
0 … 1 |
F |
ASSIGNED |
hl7:id
|
II |
0 … * |
R |
|
CDAitLAB |
@root
|
uid |
1 … 1 |
R |
|
@extension
|
st |
1 … 1 |
R |
|
@assigningAuthorityName
|
|
0 … 1 |
|
|
hl7:addr
|
AD |
0 … 1 |
|
Contains 2.16.840.1.113883.3.1937.777.63.10.34 CDA addr (DYNAMIC)
|
CDAitLAB |
@use
|
set_cs |
1 … 1 |
R |
|
|
CONF |
|
hl7:telecom
|
TEL |
0 … * |
|
|
CDAitLAB |
@use
|
set_cs |
1 … 1 |
R |
|
|
CONF |
|
hl7:informationRecipient
|
|
0 … 1 |
|
Contains 2.16.840.1.113883.3.1937.777.63.10.54 CDA person (DYNAMIC)
|
CDAitLAB |
hl7:receivedOrganization
|
|
0 … 1 |
|
Contains 2.16.840.1.113883.3.1937.777.63.10.58 CDA Organization (DYNAMIC)
|
CDAitLAB |
Included |
1 … 1 |
M |
from 2.16.840.1.113883.3.1937.777.63.10.336 CDA legalAuthenticator LAB (2023‑07‑04 18:38:29)
Elemento che identifica il soggetto che ha legalmente autenticato il documento (firmatario
del documento).
|
hl7:legalAuthenticator
|
|
1 … 1 |
M |
L'elemento legalAuthenticator rappresenta l’attore che ha legalmente autenticato il
documento prodotto in locale
|
CDAlator |
@typeCode
|
cs |
0 … 1 |
F |
LA |
@contextControlCode
|
cs |
0 … 1 |
F |
OP |
hl7:time
|
TS |
1 … 1 |
R |
L'elemento time indica la data e l'orario in cui è stata apposta la firma al documento.
|
CDAlator |
hl7:signatureCode
|
CS |
1 … 1 |
R |
L'elemento signatureCode indica se il documento locale è stato firmato elettronicamente
o manualmente.
|
CDAlator |
@code
|
|
1 … 1 |
F |
S |
hl7:assignedEntity
|
|
1 … 1 |
R |
Contains 2.16.840.1.113883.3.1937.777.63.10.36 CDA AssignedEntity (DYNAMIC)
|
CDAlator |
Included |
0 … * |
|
from 2.16.840.1.113883.3.1937.777.63.10.335 CDA authenticator LAB (2023‑07‑04 17:02:02)
Elemento che identifica il soggetto che effettua la validazione clinica del Referto
di Medicina di Laboratorio o di una sua parte, ossia il validatore.
Si osserva che l’authenticator non ha il potere di autenticare legalmente il documento.
Un Referto di Medicina di Laboratorio può avere più di un validatore per gli esami
in esso contenuti. Sia in caso di validatore singolo che in caso di validatori multipli,
tutti i validatori devono essere mappati a livello di Header nell’elemeno authenticator .
|
hl7:authenticator
|
|
0 … * |
|
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.
|
|
CDAarLAB |
@typeCode
|
cs |
0 … 1 |
F |
AUTHEN |
hl7:time
|
TS |
1 … 1 |
R |
L'elemento time indica la data e ora in cui è stata apposta la firma. Il formato può
essere scelto con la precisione voluta.
|
CDAarLAB |
hl7:signatureCode
|
CS |
1 … 1 |
R |
|
CDAarLAB |
@code
|
|
1 … 1 |
F |
S |
|
Il tag <signatureCode> indica che il documento è stato firmato digitalmente.
|
hl7:assignedEntity
|
|
1 … 1 |
R |
Contains 2.16.840.1.113883.3.1937.777.63.10.36 CDA AssignedEntity (DYNAMIC)
|
CDAarLAB |
Included |
0 … 1 |
|
from 1.3.6.1.4.1.19376.1.3.10.9.14 XD-LAB InFulfillmentOf Order (DYNAMIC)
inFulfillmentOf è un elemento OBBLIGATORIO di cui deve esistere almeno una istanza che indica che il documento CDA prodotto è
stato creato in risposta ad una precedente richiesta. In inFulfillmentOf/order possono essere mappati gli identificativi, ad esempio, 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;
-
la/le prescrizione/i.
L’istanza obbligatoria di inFulfillmentOf/order/id DEVE rappresentare l’identificativo univoco della richiesta (Placer Order Number) che perviene
al laboratorio di analisi. Per quanto concerne il mapping della data e ora della richiesta
si rimanda a 2.4.2.8.
|
hl7:inFulfillmentOf
|
|
0 … 1 |
|
|
(Refrio) |
hl7:order
|
|
1 … 1 |
R |
|
(Refrio) |
hl7:id
|
II |
1 … * |
R |
It represents the Placer Order or the Placer Group that was fulfilled, the id of which
is carried by inFulfillmentOf/order/id.
|
(Refrio) |
Included |
0 … 1 |
|
from 1.3.6.1.4.1.19376.1.3.10.9.15 XD-LAB DocumentationOf (DYNAMIC)
L’elemento documentationOf è un elemento OPZIONALE che indica l’atto che viene documentato nel documento clinico.
L’elemento serviceEvent/statusCode rappresenta un’estensione del CDA R2 proposta da 785 IHE in Rif 11 per gestire il
caso d’uso in cui è necessario gestire l’informazione relativa allo stato di produzione
del Referto di Medicina di Laboratorio (parziale o completo) (namespace xmlns:lab=”urn:oid:1.3.6.1.4.1.19376.1.3.2”).
|
hl7:documentationOf
|
|
0 … 1 |
|
|
(Refrio) |
hl7:serviceEvent
|
|
1 … 1 |
R |
|
(Refrio) |
hl7:effectiveTime
|
IVL_TS |
0 … 1 |
|
Use of sub element documentationOf/serviceEvent/effectiveTime to document the time
boundaries of events in the document is appropriate.
|
(Refrio) |
lab:statusCode
|
CS |
0 … 1 |
|
This Laboratory Report Content Module can express both final and non-final reports.
To distinguish between the two, the statusCode element has been added to the documentationOf/serviceEvent
element. A non-final report is a report documenting a serviceEvent, which is in the
status "active". This sub-element serviceEvent/statusCode is optional. When it is
not present
the serviceEvent is assumed to be in the status "completed".
|
(Refrio) |
|
CONF |
|
hl7:performer
|
|
0 … * |
|
Laboratory Performer template in the CDA header
Contains 1.3.6.1.4.1.19376.1.3.3.1.7 Laboratory Performer (DYNAMIC)
|
(Refrio) |
Included |
0 … 1 |
|
from 1.3.6.1.4.1.19376.1.3.10.9.16 XD-LAB RelatedDocument (DYNAMIC)
relatedDocument viene utilizzato nella gestione delle trasformazioni successive alla prima versione
del documento. relatedDocument è un elemento OPZIONALE alla prima generazione di un documento CDA ed è OBBLIGATORIO per le trasformazioni successive.
Si rimanda a Rif 10 per i dettagli relativi agli elementi relatedDocument/@typeCode, relatedDocument, parentDocument/id, parentDocument/setId
e parentDocument/versionNumber.
|
hl7:relatedDocument
|
|
0 … 1 |
|
|
(Refrio) |
@typeCode
|
cs |
1 … 1 |
F |
RPLC |
|
relatedDocument@typeCode attribute SHALL be valued "RPLC".
|
hl7:parentDocument
|
|
1 … 1 |
R |
|
(Refrio) |
hl7:id
|
II |
1 … 1 |
R |
SHALL be equal to ClinicalDocument/ id of the replaced document.
|
(Refrio) |
hl7:setId
|
II |
1 … 1 |
R |
SHALL have the same value in the new report as in the replaced report.
|
(Refrio) |
hl7:versionNumber
|
INT |
1 … 1 |
|
SHALL have the same value as in the replaced report (when provided there)
|
(Refrio) |
Included |
0 … 1 |
|
from 1.3.6.1.4.1.19376.1.3.10.9.20 XD-LAB ComponentOf (DYNAMIC)
L’elemento componentOf è OPZIONALE e, se presente, DEVE essere uno ed uno solo. componentOf/encompassingEncounter descrive l’incontro tra assistito e la struttura sanitaria durante il quale è stato
richiesto il servizio che ha fornito come risultato la generazione del Referto di
Medicina di Laboratorio. L’incontro tra
assistito e la struttura può avvenire per esempio nell’ambito di un ricovero, nell’ambito
di un’accettazione di un punto prelievi/ambulatorio, etc.
encompassingEncounter/id è un elemento OPZIONALE ed in generale rappresenta il numero nosologico del ricovero.
encompassingEncounter/code PUÒ essere utilizzato per indicare il tipo di identificativo gestito nell’ambito del Referto
di Medicina di Laboratorio. 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.
Nel caso in cui, nel Referto di Medicina di Laboratorio, in encompassingEncounter/id venga gestito solo il numero nosologico, non è necessario l’utilizzo dell’encompassingEncounter/code.
La persona responsabile della struttura dove avviene l’incontro con l’assistito (ad
esempio il reparto ospedaliero o il punto prelievi) viene gestita nell’elemento encompassingEncounter/responsibleParty in cui in responsibleParty/assignedEntity/id viene riportato l’identificativo del responsabile. Si osserva che
encompassingEncounter/responsibleParty/assignedEntity/code PUÒ essere valorizzato con RESPRSN (responsible party).
Se l’elemento è presente, l’indirizzo e i recapiti telefonici possono essere riportati
nell’elemento assignedEntity, il nome DEVE essere riportato nell’elemento assignedEntity/assignedPerson (Vedi § 2.3 - Persone ed Organizzazioni).
Si rimanda a Rif 10 per i dettagli relativi agli elementi encompassingEncounter/effectiveTime (istante temporale, o l’intervallo di tempo in cui l’incontro stesso ha avuto luogo),
encompassingEncounter/location/healthCareFacility (luogo in cui si è svolto l'incontro tra il paziente e la struttura sanitaria).
|
hl7:componentOf
|
|
0 … 1 |
|
|
(Refrio) |
hl7:encompassingEncounter
|
|
1 … 1 |
R |
|
(Refrio) |
hl7:id
|
II |
1 … * |
M |
|
(Refrio) |
hl7:effectiveTime
|
IVL_TS |
1 … 1 |
M |
|
(Refrio) |
hl7:encounterParticipant
|
|
0 … * |
|
|
(Refrio) |
@typeCode
|
cs |
1 … 1 |
R |
|
hl7:time
|
IVL_TS |
1 … 1 |
R |
|
(Refrio) |
hl7:assignedEntity
|
|
1 … 1 |
R |
|
(Refrio) |
hl7:addr
|
AD |
1 … * |
R |
|
(Refrio) |
hl7:telecom
|
TEL |
1 … * |
R |
|
(Refrio) |
hl7:assignedPerson
|
|
0 … 1 |
R |
|
(Refrio) |
hl7:representedOrganization
|
|
0 … 1 |
R |
|
(Refrio) |
|
Schematron assert |
role |
error
|
|
|
test |
not(hl7:assignedPerson) or hl7:assignedPerson/hl7:name |
|
|
Message |
the <name> sub-element of <assignedPerson> SHALL be present. |
|
hl7:component
|
|
1 … 1 |
|
CDA BODY
|
(Refrio) |
@typeCode
|
cs |
1 … 1 |
F |
COMP |
@contextConductionInd
|
bl |
1 … 1 |
F |
true |
hl7:structuredBody
|
|
1 … 1 |
|
Livello 2: human-readable body
Un Referto di Medicina di Laboratorio DEVE avere un body di tipo structuredBody. Il body è organizzato secondo una gerarchia di section in cui è presente il contenuto human-readable del documento. La gerarchia di section
PUÒ al più essere organizzata su due livelli:
-
section di specialità (ad esempio Hematology studies), rappresenta il livello più “alto” di
section;
-
section foglia, rappresenta il livello “inferiore” di section.
Il CDA del Referto di Medicina di Laboratorio DEVE contenere l’elemento structuredBody
|
(Refrio) |
@classCode
|
cs |
1 … 1 |
F |
DOCBODY |
@moodCode
|
cs |
1 … 1 |
F |
EVN |
hl7:confidentialityCode
|
CE |
0 … 1 |
|
|
(Refrio) |
|
CONF |
|
hl7:component
|
|
1 … * |
R |
Il Referto di Medicina di Laboratorio DEVE contenere almeno una structuredBody/component/section di specialità. La section di specialità PUÒ essere instanziata più volte quando ad esempio nel referto sono presenti esami afferenti
a diverse specialità, in questo caso si potranno trovare diverse section
di specialità, una per ciascuna specialità gestita nel referto del laboratorio.
La structuredBody/component/section di specialità PUÒ contenere una o più section foglie innestate, che possono rappresentare una sottosezione del Referto di Medicina
di Laboratorio ad esempio una batteria di esami (vedi EMOCROMO), un singolo esame
o lo studio completo di un campione (vedi la Microbiologia). Se la section
di specialità non contiene section foglie innestate allora è di per sè una section foglia.
Contains 1.3.6.1.4.1.19376.1.3.3.2.1 Laboratory Specialty Section (DYNAMIC)
|
(Refrio) |
|
Schematron assert |
role |
error
|
|
|
test |
/hl7:templateId[@root='1.3.6.1.4.1.19376.1.3.1.6'] |
|
|
Message |
Lab report SHALL contain Laboratory Observation |
|