Release 4 5 Snapshot #1

This page is part of the FHIR Specification (v4.0.1: R4 - Mixed Normative and STU ) in it's permanent home (it will always be available at this URL). (v5.0.0-snapshot1: Release 5 Snapshot #1). The current version which supercedes this version is 5.0.0 . For a full list of available versions, see the Directory of published versions . Page versions: R4B R4 R3

Extension: patientInstruction

Orders and Observations Work Group   Maturity Level : 1 Informative Use Context : Any

URL for this extension: 


http://hl7.org/fhir/StructureDefinition/devicerequest-patientInstruction

Status: draft. Extension maintained by: Health Level Seven, Inc. - FHIR WG

Simple concise instructions to be read by the patient. For example “twice a day” rather than “BID.”.

Comment :

Should use only common terms and sentences. Use of unfamiliar words and jargon should be avoided.

Context of Use: Use on Element ID DeviceRequest

Extension Content

Summary

Name Flags Card. Type Description & Constraints doco
. . patientInstruction 0..* Extension URL = http://hl7.org/fhir/StructureDefinition/devicerequest-patientInstruction
patientInstruction: Simple concise instructions to be read by the patient. For example “twice a day” rather than “BID.”.


Use on Element ID DeviceRequest
. . . lang 1..1 code Code for Language.

. . . content 1..1 string The actual text containing the instructions.


doco Documentation for this format

Full Structure

I I
Name Flags Card. Type Description & Constraints doco
. . extension 0..* Extension URL = http://hl7.org/fhir/StructureDefinition/devicerequest-patientInstruction
patientInstruction: Simple concise instructions to be read by the patient. For example “twice a day” rather than “BID.”.


Use on Element ID DeviceRequest
. . . Slices for extension I 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
. . . extension:lang I 1..1 Extension Language
. . . extension . id I 0..0 0..1 string Unique id for inter-element referencing
.... Slices for extension 0..0
. . . . url 1..1 uri "lang"
. . . . value[x] 1..1 code Value of extension
Binding: Common Languages ( preferred )
Max Binding: All Languages : IETF language tag

. . . extension:content 1..1 Extension Text
. . . . id 0..1 string Unique id for inter-element referencing
. . . . Slices for extension I 0..0
. . . . url 1..1 uri "content"
. . . . value[x] I 1..1 string Value of extension
. . . value[x] I 0 .. 0
. . . . valueBase64Binary base64Binary
. . . . valueBoolean boolean
. . . . valueCanonical canonical () (Any)
. . . . valueCode code
. . . . valueDate date
. . . . valueDateTime dateTime
. . . . valueDecimal decimal
. . . . valueId id
. . . . valueInstant instant
. . . . valueInteger integer
. . . . valueMarkdown valueInteger64 markdown integer64
. . . . valueOid valueMarkdown oid markdown
. . . . valuePositiveInt valueOid positiveInt oid
. . . . valueString valuePositiveInt string positiveInt
. . . . valueTime valueString time string
. . . . valueUnsignedInt valueTime unsignedInt time
. . . . valueUri valueUnsignedInt uri unsignedInt
. . . . valueUrl valueUri url uri
. . . . valueUuid valueUrl url
.... valueUuid uuid
. . . . valueAddress Address
. . . . valueAddress valueAge Address Age
. . . . valueAge valueAnnotation Age Annotation
. . . . valueAnnotation valueAttachment Annotation Attachment
. . . . valueAttachment valueCodeableConcept Attachment CodeableConcept
. . . . valueCodeableConcept valueCodeableReference CodeableConcept CodeableReference
. . . . valueCoding Coding
. . . . valueContactPoint ContactPoint
. . . . valueCount Count
. . . . valueDistance Distance
. . . . valueDuration Duration
. . . . valueHumanName HumanName
. . . . valueIdentifier Identifier
. . . . valueMoney Money
. . . . valuePeriod Period
. . . . valueQuantity Quantity
. . . . valueRange Range
. . . . valueRatio Ratio
. . . valueReference . valueRatioRange Reference RatioRange ()
. . . valueSampledData . valueReference SampledData Reference (Any)
. . . . valueSignature valueSampledData Signature SampledData
. . . . valueTiming valueSignature Timing Signature
. . . . valueContactDetail valueTiming ContactDetail Timing
. . . . valueContributor valueContactDetail Contributor ContactDetail
. . . . valueDataRequirement valueContributor DataRequirement Contributor
. . . . valueExpression valueDataRequirement Expression DataRequirement
. . . . valueParameterDefinition valueExpression ParameterDefinition Expression
. . . . valueRelatedArtifact valueParameterDefinition RelatedArtifact ParameterDefinition
. . . . valueTriggerDefinition valueRelatedArtifact TriggerDefinition RelatedArtifact
. . . . valueUsageContext valueTriggerDefinition UsageContext TriggerDefinition
. . . . valueDosage valueUsageContext Dosage UsageContext
. . . . valueMeta valueDosage Dosage
.... valueMeta Meta

doco Documentation for this format

XML Template 

<!-- patientInstruction -->doco

< xmlns="http://hl7.org/fhir"

<extension xmlns="http://hl7.org/fhir"

     url="http://hl7.org/fhir/StructureDefinition/devicerequest-patientInstruction" >
 <-- extension sliced by value:url  in the specified orderOpen-->
 <extension url="lang"> ?? 1..1 Extension  <!-- ?? 1..1 Language -->
  <

  <valueCode value="[code]"/><!-- ?? 1..1 Value of extension -->

 </extension>
 <extension url="content"> ?? 1..1 Extension  <!-- ?? 1..1 Text -->
  <

  <valueString value="[string]"/><!-- ?? 1..1 Value of extension -->

 </extension>
</extension>

JSON Template 

{ // patientInstruction
    "extension" : [ //  sliced by value:url  in the specified order, Open 
      { // Language // C? R! 
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "lang", // R! 
        "

        "valueCode" : "<code>" // C? R! Value of extension

      },
      { // Text // C? R! 
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "content", // R! 
        "

        "valueString" : "<string>" // C? R! Value of extension

      }
    ],
    "url" : "http://hl7.org/fhir/StructureDefinition/devicerequest-patientInstruction", // R! 


// value[x]: Value of extension. One of these 53:
  }

Summary

Name Flags Card. Type Description & Constraints doco
. . patientInstruction 0..* Extension URL = http://hl7.org/fhir/StructureDefinition/devicerequest-patientInstruction
patientInstruction: Simple concise instructions to be read by the patient. For example “twice a day” rather than “BID.”.


Use on Element ID DeviceRequest
. . . lang 1..1 code Code for Language.

. . . content 1..1 string The actual text containing the instructions.


doco Documentation for this format

Full Structure

I I
Name Flags Card. Type Description & Constraints doco
. . extension 0..* Extension URL = http://hl7.org/fhir/StructureDefinition/devicerequest-patientInstruction
patientInstruction: Simple concise instructions to be read by the patient. For example “twice a day” rather than “BID.”.


Use on Element ID DeviceRequest
. . . Slices for extension I 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
. . . extension:lang I 1..1 Extension Language
. . . extension . id I 0..0 0..1 string Unique id for inter-element referencing
.... Slices for extension 0..0
. . . . url 1..1 uri "lang"
. . . . value[x] 1..1 code Value of extension
Binding: Common Languages ( preferred )
Max Binding: All Languages : IETF language tag

. . . extension:content 1..1 Extension Text
. . . . id 0..1 string Unique id for inter-element referencing
. . . . Slices for extension I 0..0
. . . . url 1..1 uri "content"
. . . . value[x] I 1..1 string Value of extension
. . . value[x] I 0 .. 0
. . . . valueBase64Binary base64Binary
. . . . valueBoolean boolean
. . . . valueCanonical canonical () (Any)
. . . . valueCode code
. . . . valueDate date
. . . . valueDateTime dateTime
. . . . valueDecimal decimal
. . . . valueId id
. . . . valueInstant instant
. . . . valueInteger integer
. . . . valueMarkdown valueInteger64 markdown integer64
. . . . valueOid valueMarkdown oid markdown
. . . . valuePositiveInt valueOid positiveInt oid
. . . . valueString valuePositiveInt string positiveInt
. . . . valueTime valueString time string
. . . . valueUnsignedInt valueTime unsignedInt time
. . . . valueUri valueUnsignedInt uri unsignedInt
. . . . valueUrl valueUri url uri
. . . . valueUuid valueUrl url
.... valueUuid uuid
. . . . valueAddress Address
. . . . valueAddress valueAge Address Age
. . . . valueAge valueAnnotation Age Annotation
. . . . valueAnnotation valueAttachment Annotation Attachment
. . . . valueAttachment valueCodeableConcept Attachment CodeableConcept
. . . . valueCodeableConcept valueCodeableReference CodeableConcept CodeableReference
. . . . valueCoding Coding
. . . . valueContactPoint ContactPoint
. . . . valueCount Count
. . . . valueDistance Distance
. . . . valueDuration Duration
. . . . valueHumanName HumanName
. . . . valueIdentifier Identifier
. . . . valueMoney Money
. . . . valuePeriod Period
. . . . valueQuantity Quantity
. . . . valueRange Range
. . . . valueRatio Ratio
. . . valueReference . valueRatioRange Reference RatioRange ()
. . . valueSampledData . valueReference SampledData Reference (Any)
. . . . valueSignature valueSampledData Signature SampledData
. . . . valueTiming valueSignature Timing Signature
. . . . valueContactDetail valueTiming ContactDetail Timing
. . . . valueContributor valueContactDetail Contributor ContactDetail
. . . . valueDataRequirement valueContributor DataRequirement Contributor
. . . . valueExpression valueDataRequirement Expression DataRequirement
. . . . valueParameterDefinition valueExpression ParameterDefinition Expression
. . . . valueRelatedArtifact valueParameterDefinition RelatedArtifact ParameterDefinition
. . . . valueTriggerDefinition valueRelatedArtifact TriggerDefinition RelatedArtifact
. . . . valueUsageContext valueTriggerDefinition UsageContext TriggerDefinition
. . . . valueDosage valueUsageContext Dosage UsageContext
. . . . valueMeta valueDosage Dosage
.... valueMeta Meta

doco Documentation for this format

XML Template 

<!-- patientInstruction -->doco

< xmlns="http://hl7.org/fhir"

<extension xmlns="http://hl7.org/fhir"

     url="http://hl7.org/fhir/StructureDefinition/devicerequest-patientInstruction" >
 <-- extension sliced by value:url  in the specified orderOpen-->
 <extension url="lang"> ?? 1..1 Extension  <!-- ?? 1..1 Language -->
  <

  <valueCode value="[code]"/><!-- ?? 1..1 Value of extension -->

 </extension>
 <extension url="content"> ?? 1..1 Extension  <!-- ?? 1..1 Text -->
  <

  <valueString value="[string]"/><!-- ?? 1..1 Value of extension -->

 </extension>
</extension>

JSON Template 

{ // patientInstruction
    "extension" : [ //  sliced by value:url  in the specified order, Open 
      { // Language // C? R! 
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "lang", // R! 
        "

        "valueCode" : "<code>" // C? R! Value of extension

      },
      { // Text // C? R! 
        // from Element: extension
        "extension" : [ //  sliced by value:url  in the specified order, Open ]
        "url" : "content", // R! 
        "

        "valueString" : "<string>" // C? R! Value of extension

      }
    ],
    "url" : "http://hl7.org/fhir/StructureDefinition/devicerequest-patientInstruction", // R! 


// value[x]: Value of extension. One of these 53:
  }

 

Constraints

  • ele-1 : All FHIR elements must have a @value or children (xpath: @value|f:*|h:div )
  • ext-1 : Must have either extensions or value[x], not both (xpath: exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')]) )
  • ele-1 : On Extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension: @value|f:*|h:div )
  • ext-1 : On Extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]) )
  • ele-1 : On Extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension: @value|f:*|h:div )
  • ext-1 : On Extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]) )
  • ele-1 : On Extension.extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension.extension: @value|f:*|h:div )
  • ext-1 : On Extension.extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]) )
  • ele-1 : On Extension.extension.value[x]: All FHIR elements must have a @value or children (xpath on Extension.extension.value[x]: @value|f:*|h:div )
  • ele-1 : On Extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension: @value|f:*|h:div )
  • ext-1 : On Extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]) )
  • ele-1 : On Extension.extension.extension: All FHIR elements must have a @value or children (xpath on Extension.extension.extension: @value|f:*|h:div )
  • ext-1 : On Extension.extension.extension: Must have either extensions or value[x], not both (xpath on Extension.extension.extension: exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")]) )
  • ele-1 : On Extension.extension.value[x]: All FHIR elements must have a @value or children (xpath on Extension.extension.value[x]: @value|f:*|h:div )
  • ele-1 : On Extension.value[x]: All FHIR elements must have a @value or children (xpath on Extension.value[x]: @value|f:*|h:div )