This
page
is
part
of
the
FHIR
Specification
(v5.0.0:
R5
-
STU
v6.0.0-ballot2:
Release
6
Ballot
(2nd
Draft)
(see
Ballot
Notes
).
This
is
the
The
current
published
version
in
it's
permanent
home
(it
will
always
be
available
at
this
URL).
is
5.0.0
.
For
a
full
list
of
available
versions,
see
the
Directory
of
published
versions
Orders
and
Observations
Work
Group
|
Maturity Level : 1 | Trial Use | Security Category : Patient | Compartments : Patient |
A record of a device being used by a patient where the record is the result of a report from the patient or a clinician.
This resource is an event resource from a FHIR workflow perspective - see Workflow . It is the intent of the Orders and Observation Workgroup to align this resource with the workflow pattern for event resources .
This resource records the use of a healthcare-related device by a patient. The record is the result of a report of use by the patient, a provider or a related person. The resource can be used to note the use of an assistive device such as a wheelchair or hearing aid, a contraceptive such an intra-uterine device, or other implanted devices such as a pacemaker.
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
|
|---|---|---|---|---|
|
TU | DomainResource |
Record
of
use
of
a
device
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
Σ | 0..* | Identifier |
External
identifier
for
this
record
|
|
Σ | 0..* | Reference ( ServiceRequest ) |
Fulfills
plan,
proposal
or
order
|
|
?! Σ | 1..1 | code |
active
|
completed
|
not-done
|
entered-in-error
+
Binding: Device Usage Status ( Required ) |
|
0..* | CodeableConcept |
The
category
of
the
statement
-
classifying
how
the
statement
is
made
|
|
|
Σ | 1..1 | Reference ( Patient ) |
Patient
using
device
|
|
Σ | 0..* | Reference ( ServiceRequest | Procedure | Claim | Observation | QuestionnaireResponse | DocumentReference ) |
Supporting
information
|
|
Σ | 0..1 | Reference ( Encounter | EpisodeOfCare ) |
The
encounter
or
episode
of
care
that
establishes
the
context
for
this
device
use
statement
|
|
Σ | 0..1 |
How
often
the
device
was
used
|
|
|
Timing | |||
|
Period | |||
|
dateTime | |||
|
Σ | 0..1 | dateTime |
When
the
statement
was
made
(and
recorded)
|
|
0..1 | CodeableConcept |
The
status
of
the
device
usage,
for
example
always,
sometimes,
never.
This
is
not
the
same
as
the
status
of
the
statement
Binding: Device Usage Status ( Required ) |
|
|
0..* | CodeableConcept |
The
reason
for
asserting
the
usage
status
-
for
example
forgot,
lost,
stolen,
broken
|
|
|
0..1 | BackboneElement |
How
device
is
being
used
|
|
|
1..1 | CodeableConcept |
always
|
never
|
sometimes
Binding: Device Usage Adherence Code ( Example ) |
|
|
1..* | CodeableConcept |
lost
|
stolen
|
prescribed
|
broken
|
burned
|
forgot
Binding: Device Usage Adherence Reason ( Example ) |
|
|
Σ | 0..1 | Reference ( Patient | Practitioner | PractitionerRole | RelatedPerson | Organization ) |
Who
made
the
statement
|
|
Σ | 1..1 | CodeableReference ( Device | DeviceDefinition ) |
Code
or
Reference
to
device
used
|
|
Σ | 0..* | CodeableReference ( Condition | Observation | DiagnosticReport | DocumentReference | Procedure ) |
Why
device
was
used
|
|
Σ | 0..1 | CodeableReference ( BodyStructure ) |
Target
body
site
Binding: SNOMED CT Body Structures ( Example ) |
|
0..* | Annotation |
Addition
details
(comments,
instructions)
|
|
Documentation
for
this
format
|
||||
See the Extensions for this resource
UML Diagram ( Legend )
XML Template
<DeviceUsage xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier External identifier for this record --></identifier> <basedOn><!-- 0..* Reference(ServiceRequest) Fulfills plan, proposal or order --></basedOn> <status value="[code]"/><!-- 1..1 active | completed | not-done | entered-in-error + --> <category><!-- 0..* CodeableConcept The category of the statement - classifying how the statement is made --></category> <patient><!-- 1..1 Reference(Patient) Patient using device --></patient> <derivedFrom><!-- 0..* Reference(Claim|DocumentReference|Observation|Procedure| QuestionnaireResponse|ServiceRequest) Supporting information --></derivedFrom> <context><!-- 0..1 Reference(Encounter|EpisodeOfCare) The encounter or episode of care that establishes the context for this device use statement --></context> <timing[x]><!-- 0..1 Timing|Period|dateTime How often the device was used --></timing[x]> <dateAsserted value="[dateTime]"/><!-- 0..1 When the statement was made (and recorded) --> <usageStatus><!-- 0..1 CodeableConcept The status of the device usage, for example always, sometimes, never. This is not the same as the status of the statement --></usageStatus> <usageReason><!-- 0..* CodeableConcept The reason for asserting the usage status - for example forgot, lost, stolen, broken --></usageReason> <adherence> <!-- 0..1 How device is being used --> <code><!-- 1..1 CodeableConcept always | never | sometimes --></code> <reason><!-- 1..* CodeableConcept lost | stolen | prescribed | broken | burned | forgot --></reason> </adherence> <informationSource><!-- 0..1 Reference(Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who made the statement --></informationSource> <device><!-- 1..1 CodeableReference(Device|DeviceDefinition) Code or Reference to device used --></device> <reason><!-- 0..* CodeableReference(Condition|DiagnosticReport|DocumentReference| Observation|Procedure) Why device was used --></reason> <bodySite><!-- 0..1 CodeableReference(BodyStructure) Target body site --></bodySite> <note><!-- 0..* Annotation Addition details (comments, instructions) --></note> </DeviceUsage>
JSON Template
{
"resourceType" : "DeviceUsage",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // External identifier for this record
"basedOn" : [{ Reference(ServiceRequest) }], // Fulfills plan, proposal or order
"status" : "<code>", // R! active | completed | not-done | entered-in-error +
"category" : [{ CodeableConcept }], // The category of the statement - classifying how the statement is made
"patient" : { Reference(Patient) }, // R! Patient using device
"derivedFrom" : [{ Reference(Claim|DocumentReference|Observation|Procedure|
QuestionnaireResponse|ServiceRequest) }], // Supporting information
"context" : { Reference(Encounter|EpisodeOfCare) }, // The encounter or episode of care that establishes the context for this device use statement
// timing[x]: How often the device was used. One of these 3:
"timingTiming" : { Timing },
"timingPeriod" : { Period },
"timingDateTime" : "<dateTime>",
"dateAsserted" : "<dateTime>", // When the statement was made (and recorded)
"usageStatus" : { CodeableConcept }, // The status of the device usage, for example always, sometimes, never. This is not the same as the status of the statement
"usageReason" : [{ CodeableConcept }], // The reason for asserting the usage status - for example forgot, lost, stolen, broken
"adherence" : { // How device is being used
"code" : { CodeableConcept }, // R! always | never | sometimes
"reason" : [{ CodeableConcept }] // R! lost | stolen | prescribed | broken | burned | forgot
},
"informationSource" : { Reference(Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson) }, // Who made the statement
"device" : { CodeableReference(Device|DeviceDefinition) }, // R! Code or Reference to device used
"reason" : [{ CodeableReference(Condition|DiagnosticReport|DocumentReference|
Observation|Procedure) }], // Why device was used
"bodySite" : { CodeableReference(BodyStructure) }, // Target body site
"note" : [{ Annotation }] // Addition details (comments, instructions)
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:DeviceUsage; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:identifier ( [ Identifier ] ... ) ; # 0..* External identifier for this record fhir:basedOn ( [ Reference(ServiceRequest) ] ... ) ; # 0..* Fulfills plan, proposal or order fhir:status [ code ] ; # 1..1 active | completed | not-done | entered-in-error + fhir:category ( [ CodeableConcept ] ... ) ; # 0..* The category of the statement - classifying how the statement is made fhir:patient [ Reference(Patient) ] ; # 1..1 Patient using device fhir:derivedFrom ( [ Reference(Claim|DocumentReference|Observation|Procedure|QuestionnaireResponse| ServiceRequest) ] ... ) ; # 0..* Supporting information fhir:context [ Reference(Encounter|EpisodeOfCare) ] ; # 0..1 The encounter or episode of care that establishes the context for this device use statement # timing[x] : 0..1 How often the device was used. One of these 3 fhir:timing [ a fhir:Timing ; Timing ] fhir:timing [ a fhir:Period ; Period ] fhir:timing [ a fhir:dateTime ; dateTime ] fhir:dateAsserted [ dateTime ] ; # 0..1 When the statement was made (and recorded) fhir:usageStatus [ CodeableConcept ] ; # 0..1 The status of the device usage, for example always, sometimes, never. This is not the same as the status of the statement fhir:usageReason ( [ CodeableConcept ] ... ) ; # 0..* The reason for asserting the usage status - for example forgot, lost, stolen, broken fhir:adherence [ # 0..1 How device is being used fhir:code [ CodeableConcept ] ; # 1..1 always | never | sometimes fhir:reason ( [ CodeableConcept ] ... ) ; # 1..* lost | stolen | prescribed | broken | burned | forgot ] ; fhir:informationSource [ Reference(Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Who made the statement fhir:device [ CodeableReference(Device|DeviceDefinition) ] ; # 1..1 Code or Reference to device used fhir:reason ( [ CodeableReference(Condition|DiagnosticReport|DocumentReference|Observation|Procedure) ] ... ) ; # 0..* Why device was used fhir:bodySite [ CodeableReference(BodyStructure) ] ; # 0..1 Target body site fhir:note ( [ Annotation ] ... ) ; # 0..* Addition details (comments, instructions) ]
Changes from both R4 and R4B
| DeviceUsage |
|
| DeviceUsage |
|
| DeviceUsage.status |
|
| DeviceUsage.category |
|
| DeviceUsage.patient |
|
| DeviceUsage.context |
|
| DeviceUsage.dateAsserted |
|
| DeviceUsage.usageStatus |
|
| DeviceUsage.usageReason |
|
| DeviceUsage.adherence |
|
| DeviceUsage.adherence.code |
|
| DeviceUsage.adherence.reason |
|
| DeviceUsage.informationSource |
|
| DeviceUsage.device |
|
| DeviceUsage.reason |
|
| DeviceUsage.bodySite |
|
| DeviceUseStatement.subject |
|
| DeviceUseStatement.recordedOn |
|
| DeviceUseStatement.source |
|
| DeviceUseStatement.reasonCode |
|
| DeviceUseStatement.reasonReference |
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .
Structure
| Name | Flags | Card. | Type |
Description
&
Constraints
|
|---|---|---|---|---|
|
TU | DomainResource |
Record
of
use
of
a
device
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension |
|
|
Σ | 0..* | Identifier |
External
identifier
for
this
record
|
|
Σ | 0..* | Reference ( ServiceRequest ) |
Fulfills
plan,
proposal
or
order
|
|
?! Σ | 1..1 | code |
active
|
completed
|
not-done
|
entered-in-error
+
Binding: Device Usage Status ( Required ) |
|
0..* | CodeableConcept |
The
category
of
the
statement
-
classifying
how
the
statement
is
made
|
|
|
Σ | 1..1 | Reference ( Patient ) |
Patient
using
device
|
|
Σ | 0..* | Reference ( ServiceRequest | Procedure | Claim | Observation | QuestionnaireResponse | DocumentReference ) |
Supporting
information
|
|
Σ | 0..1 | Reference ( Encounter | EpisodeOfCare ) |
The
encounter
or
episode
of
care
that
establishes
the
context
for
this
device
use
statement
|
|
Σ | 0..1 |
How
often
the
device
was
used
|
|
|
Timing | |||
|
Period | |||
|
dateTime | |||
|
Σ | 0..1 | dateTime |
When
the
statement
was
made
(and
recorded)
|
|
0..1 | CodeableConcept |
The
status
of
the
device
usage,
for
example
always,
sometimes,
never.
This
is
not
the
same
as
the
status
of
the
statement
Binding: Device Usage Status ( Required ) |
|
|
0..* | CodeableConcept |
The
reason
for
asserting
the
usage
status
-
for
example
forgot,
lost,
stolen,
broken
|
|
|
0..1 | BackboneElement |
How
device
is
being
used
|
|
|
1..1 | CodeableConcept |
always
|
never
|
sometimes
Binding: Device Usage Adherence Code ( Example ) |
|
|
1..* | CodeableConcept |
lost
|
stolen
|
prescribed
|
broken
|
burned
|
forgot
Binding: Device Usage Adherence Reason ( Example ) |
|
|
Σ | 0..1 | Reference ( Patient | Practitioner | PractitionerRole | RelatedPerson | Organization ) |
Who
made
the
statement
|
|
Σ | 1..1 | CodeableReference ( Device | DeviceDefinition ) |
Code
or
Reference
to
device
used
|
|
Σ | 0..* | CodeableReference ( Condition | Observation | DiagnosticReport | DocumentReference | Procedure ) |
Why
device
was
used
|
|
Σ | 0..1 | CodeableReference ( BodyStructure ) |
Target
body
site
Binding: SNOMED CT Body Structures ( Example ) |
|
0..* | Annotation |
Addition
details
(comments,
instructions)
|
|
Documentation
for
this
format
|
||||
See the Extensions for this resource
XML Template
<DeviceUsage xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <identifier><!-- 0..* Identifier External identifier for this record --></identifier> <basedOn><!-- 0..* Reference(ServiceRequest) Fulfills plan, proposal or order --></basedOn> <status value="[code]"/><!-- 1..1 active | completed | not-done | entered-in-error + --> <category><!-- 0..* CodeableConcept The category of the statement - classifying how the statement is made --></category> <patient><!-- 1..1 Reference(Patient) Patient using device --></patient> <derivedFrom><!-- 0..* Reference(Claim|DocumentReference|Observation|Procedure| QuestionnaireResponse|ServiceRequest) Supporting information --></derivedFrom> <context><!-- 0..1 Reference(Encounter|EpisodeOfCare) The encounter or episode of care that establishes the context for this device use statement --></context> <timing[x]><!-- 0..1 Timing|Period|dateTime How often the device was used --></timing[x]> <dateAsserted value="[dateTime]"/><!-- 0..1 When the statement was made (and recorded) --> <usageStatus><!-- 0..1 CodeableConcept The status of the device usage, for example always, sometimes, never. This is not the same as the status of the statement --></usageStatus> <usageReason><!-- 0..* CodeableConcept The reason for asserting the usage status - for example forgot, lost, stolen, broken --></usageReason> <adherence> <!-- 0..1 How device is being used --> <code><!-- 1..1 CodeableConcept always | never | sometimes --></code> <reason><!-- 1..* CodeableConcept lost | stolen | prescribed | broken | burned | forgot --></reason> </adherence> <informationSource><!-- 0..1 Reference(Organization|Patient|Practitioner| PractitionerRole|RelatedPerson) Who made the statement --></informationSource> <device><!-- 1..1 CodeableReference(Device|DeviceDefinition) Code or Reference to device used --></device> <reason><!-- 0..* CodeableReference(Condition|DiagnosticReport|DocumentReference| Observation|Procedure) Why device was used --></reason> <bodySite><!-- 0..1 CodeableReference(BodyStructure) Target body site --></bodySite> <note><!-- 0..* Annotation Addition details (comments, instructions) --></note> </DeviceUsage>
JSON Template
{
"resourceType" : "DeviceUsage",
// from Resource: id, meta, implicitRules, and language
// from DomainResource: text, contained, extension, and modifierExtension
"identifier" : [{ Identifier }], // External identifier for this record
"basedOn" : [{ Reference(ServiceRequest) }], // Fulfills plan, proposal or order
"status" : "<code>", // R! active | completed | not-done | entered-in-error +
"category" : [{ CodeableConcept }], // The category of the statement - classifying how the statement is made
"patient" : { Reference(Patient) }, // R! Patient using device
"derivedFrom" : [{ Reference(Claim|DocumentReference|Observation|Procedure|
QuestionnaireResponse|ServiceRequest) }], // Supporting information
"context" : { Reference(Encounter|EpisodeOfCare) }, // The encounter or episode of care that establishes the context for this device use statement
// timing[x]: How often the device was used. One of these 3:
"timingTiming" : { Timing },
"timingPeriod" : { Period },
"timingDateTime" : "<dateTime>",
"dateAsserted" : "<dateTime>", // When the statement was made (and recorded)
"usageStatus" : { CodeableConcept }, // The status of the device usage, for example always, sometimes, never. This is not the same as the status of the statement
"usageReason" : [{ CodeableConcept }], // The reason for asserting the usage status - for example forgot, lost, stolen, broken
"adherence" : { // How device is being used
"code" : { CodeableConcept }, // R! always | never | sometimes
"reason" : [{ CodeableConcept }] // R! lost | stolen | prescribed | broken | burned | forgot
},
"informationSource" : { Reference(Organization|Patient|Practitioner|
PractitionerRole|RelatedPerson) }, // Who made the statement
"device" : { CodeableReference(Device|DeviceDefinition) }, // R! Code or Reference to device used
"reason" : [{ CodeableReference(Condition|DiagnosticReport|DocumentReference|
Observation|Procedure) }], // Why device was used
"bodySite" : { CodeableReference(BodyStructure) }, // Target body site
"note" : [{ Annotation }] // Addition details (comments, instructions)
}
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:DeviceUsage; fhir:nodeRole fhir:treeRoot; # if this is the parser root # from Resource: .id, .meta, .implicitRules, and .language # from DomainResource: .text, .contained, .extension, and .modifierExtension fhir:identifier ( [ Identifier ] ... ) ; # 0..* External identifier for this record fhir:basedOn ( [ Reference(ServiceRequest) ] ... ) ; # 0..* Fulfills plan, proposal or order fhir:status [ code ] ; # 1..1 active | completed | not-done | entered-in-error + fhir:category ( [ CodeableConcept ] ... ) ; # 0..* The category of the statement - classifying how the statement is made fhir:patient [ Reference(Patient) ] ; # 1..1 Patient using device fhir:derivedFrom ( [ Reference(Claim|DocumentReference|Observation|Procedure|QuestionnaireResponse| ServiceRequest) ] ... ) ; # 0..* Supporting information fhir:context [ Reference(Encounter|EpisodeOfCare) ] ; # 0..1 The encounter or episode of care that establishes the context for this device use statement # timing[x] : 0..1 How often the device was used. One of these 3 fhir:timing [ a fhir:Timing ; Timing ] fhir:timing [ a fhir:Period ; Period ] fhir:timing [ a fhir:dateTime ; dateTime ] fhir:dateAsserted [ dateTime ] ; # 0..1 When the statement was made (and recorded) fhir:usageStatus [ CodeableConcept ] ; # 0..1 The status of the device usage, for example always, sometimes, never. This is not the same as the status of the statement fhir:usageReason ( [ CodeableConcept ] ... ) ; # 0..* The reason for asserting the usage status - for example forgot, lost, stolen, broken fhir:adherence [ # 0..1 How device is being used fhir:code [ CodeableConcept ] ; # 1..1 always | never | sometimes fhir:reason ( [ CodeableConcept ] ... ) ; # 1..* lost | stolen | prescribed | broken | burned | forgot ] ; fhir:informationSource [ Reference(Organization|Patient|Practitioner|PractitionerRole|RelatedPerson) ] ; # 0..1 Who made the statement fhir:device [ CodeableReference(Device|DeviceDefinition) ] ; # 1..1 Code or Reference to device used fhir:reason ( [ CodeableReference(Condition|DiagnosticReport|DocumentReference|Observation|Procedure) ] ... ) ; # 0..* Why device was used fhir:bodySite [ CodeableReference(BodyStructure) ] ; # 0..1 Target body site fhir:note ( [ Annotation ] ... ) ; # 0..* Addition details (comments, instructions) ]
Changes from both R4 and R4B
| DeviceUsage |
|
| DeviceUsage |
|
| DeviceUsage.status |
|
| DeviceUsage.category |
|
| DeviceUsage.patient |
|
| DeviceUsage.context |
|
| DeviceUsage.dateAsserted |
|
| DeviceUsage.usageStatus |
|
| DeviceUsage.usageReason |
|
| DeviceUsage.adherence |
|
| DeviceUsage.adherence.code |
|
| DeviceUsage.adherence.reason |
|
| DeviceUsage.informationSource |
|
| DeviceUsage.device |
|
| DeviceUsage.reason |
|
| DeviceUsage.bodySite |
|
| DeviceUseStatement.subject |
|
| DeviceUseStatement.recordedOn |
|
| DeviceUseStatement.source |
|
| DeviceUseStatement.reasonCode |
|
| DeviceUseStatement.reasonReference |
|
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .
Additional definitions: Master Definition XML + JSON , XML Schema / Schematron + JSON Schema , ShEx (for Turtle ) + see the extensions , the spreadsheet version & the dependency analysis
| Path | ValueSet | Type | Documentation |
|---|---|---|---|
| DeviceUsage.status | DeviceUsageStatus | Required |
A coded concept indicating the current status of the Device Usage. |
| DeviceUsage.usageStatus | DeviceUsageStatus | Required |
A coded concept indicating the current status of the Device Usage. |
| DeviceUsage.adherence.code | DeviceUsageAdherenceCode | Example |
A coded concept indicating the adherence of device usage. |
| DeviceUsage.adherence.reason | DeviceUsageAdherenceReason | Example |
A coded concept indicating the adherence of device usage. |
| DeviceUsage.bodySite | SNOMEDCTBodyStructures | Example |
This
value
set
includes
all
codes
from
SNOMED
CT
|
Notes to reviewers:
At this time, the code bindings are placeholders to be fleshed out upon further review by the community.
Search parameters for this resource. See also the full list of search parameters for this resource , and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
| Name | Type | Description | Expression | In Common |
| device | token | Search by device | DeviceUsage.device.concept | |
| identifier | token | Search by identifier | DeviceUsage.identifier | 65 Resources |
| patient | reference | Search by patient who used / uses the device |
DeviceUsage.patient
( Patient ) |
|
| status | token | The status of the device usage | DeviceUsage.status |