FHIR Release 3 (STU) Current Build
This page is part of FHIR STU 3 (v3.0.1) in it's permanent home (it will always be available at this URL). It has been superceded by R4 . For a full list of available versions, see the Directory of published versions .

12.18 12.20 Resource ActivityDefinition - Content

Clinical Decision Support Work Group Maturity Level : 2   Trial Use Security Category : Anonymous Compartments : Not linked to any defined compartments

This resource allows for the definition of some activity to be performed, independent of a particular patient, practitioner, or other performance context.

This resource is a definition resource from a FHIR workflow perspective - see Workflow , specifically Definition .

An ActivityDefinition is a shareable, consumable description of some activity to be performed. It may be used to specify actions to be taken as part of a workflow, order set, or protocol, or it may be used independently as part of a catalog of activities such as orderables.

For more information on how activity definitions can be used to construct request resources, see the Realizing Applying an ActivityDefinition topic below.

In general, an activity definition is simply a conceptual description of some specific action that should be taken. An instance of an ActivityDefinition does not indicate that any action has been performed (as an event resource does), nor does it indicate the actual intent to carry out any particular action (as a request resource does). Instead, an activity definition provides a reusable template that can be used to construct specific request resources such as ProcedureRequest ServiceRequest and MedicationRequest . This is different than a DataElement in that ActivityDefinitions are generally broader than data elements, which are typically used to describe more granular elements, such as a blood pressure, or the answer to a particular question.

Note that this is conceptually similar to the Task resource as well, with the distinction being that ActivityDefinition represents the description of a task in the abstract, while the Task resource is used to track a specific instance of a task as it moves through the steps of a workflow.

This resource is referenced by CarePlan , CatalogEntry , ClinicalUseIssue , Communication , DeviceRequest , EvidenceVariable , FamilyMemberHistory , MedicationAdministration , MedicationRequest , MessageDefinition , NutritionOrder , PlanDefinition , Procedure , ProcedureRequest , ReferralRequest ServiceRequest and Task .

This resource implements the Definition pattern.

Structure

Name Flags Card. Type Description & Constraints doco
. . ActivityDefinition I TU DomainResource The definition of a specific activity to be taken, independent of any particular patient or context
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . url Σ 0..1 uri Logical URI to reference Canonical identifier for this activity definition definition, represented as a URI (globally unique)
. . . identifier Σ 0..* Identifier Additional identifier for the activity definition
. . . version Σ 0..1 string Business version of the activity definition
. . . name Σ I 0..1 string Name for this activity definition (computer friendly)
. . . title Σ 0..1 string Name for this activity definition (human friendly)
. . . subtitle 0..1 string Subordinate title of the activity definition
... status ?! Σ 1..1 code draft | active | retired | unknown
PublicationStatus ( Required )
. . . experimental ?! Σ 0..1 boolean For testing purposes, not real usage
. . . subject[x] 0..1 Type of individual the activity definition is intended for
Subject type ( Extensible )
.... subjectCodeableConcept CodeableConcept
.... subjectReference Reference ( Group )
. . . date Σ 0..1 dateTime Date this was last changed
. . . publisher Σ 0..1 string Name of the publisher (organization or individual)
. . . contact Σ 0..* ContactDetail Contact details for the publisher
.. . description Σ 0..1 markdown Natural language description of the activity definition
. . . useContext Σ 0..* UsageContext The context that the content is intended to support
... jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for activity definition (if applicable)
Jurisdiction ( Extensible )
.. . purpose 0..1 markdown Why this activity definition is defined
. . . usage 0..1 string Describes the clinical usage of the asset activity definition
... copyright 0..1 markdown Use and/or publishing restrictions
. . . approvalDate 0..1 date When the activity definition was approved by publisher
. . . lastReviewDate 0..1 date When the activity definition was last reviewed
. . . effectivePeriod Σ 0..1 Period When the activity definition is expected to be used
. . . useContext topic Σ 0..* UsageContext Context the content is intended to support jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for activity definition (if applicable) E.g. Education, Treatment, Assessment, etc.
Jurisdiction ValueSet DefinitionTopic ( Extensible Example )
. . . topic author 0..* CodeableConcept ContactDetail E.g. Education, Treatment, Assessment, etc DefinitionTopic ( Example ) Who authored the content
. . . contributor editor 0..* Contributor ContactDetail A Who edited the content contributor
. . . contact reviewer Σ 0..* ContactDetail Contact details for Who reviewed the publisher content
. . copyright . endorser 0..1 0..* markdown ContactDetail Use and/or publishing restrictions Who endorsed the content
. . . relatedArtifact 0..* RelatedArtifact Additional documentation, citations, etc etc.
. . . library 0..* Reference canonical ( Library ) Logic used by the asset activity definition
. . . kind Σ 0..1 code Kind of resource
ResourceType RequestResourceType ( Required )
. . . profile 0..1 canonical ( StructureDefinition ) What profile the resource needs to conform to
.. . code Σ 0..1 CodeableConcept Detail type of activity
Procedure Codes (SNOMED CT) ( Example )
. . . intent 0..1 code proposal | plan | order
RequestIntent ( Required )
... priority 0..1 code routine | urgent | asap | stat
Request priority ( Required )
... doNotPerform ?! Σ 0..1 boolean True if the activity should not be performed
. . . timing[x] 0..1 When activity is to occur
. . . . timingTiming Timing
. . . . timingDateTime dateTime
. . . . timingAge Age
.... timingPeriod Period
. . . . timingRange Range
. . . . timingDuration Duration
. . . location 0..1 Reference ( Location ) Where it should happen
. . . participant 0..* BackboneElement Who should participate in the action
. . . . type 1..1 code patient | practitioner | related-person | device
ActionParticipantType ( Required )
. . . . role 0..1 CodeableConcept E.g. Nurse, Surgeon, Parent, etc etc.
ActionParticipantRole Action participant role ( Example )
. . . product[x] 0..1 What's administered/supplied
SNOMED CT Medication Codes ( Example )
. . . . productReference Reference ( Medication | Substance )
. . . . productCodeableConcept CodeableConcept
. . . quantity 0..1 SimpleQuantity How much is administered/consumed/supplied
. . . dosage 0..* Dosage Detailed dosage instructions
. . . bodySite 0..* CodeableConcept What part of body to perform on
SNOMED CT Body Structures ( Example )
. . . transform specimenRequirement 0..1 0..* Reference ( StructureMap SpecimenDefinition ) Transform What specimens are required to apply the template perform this action
. . dynamicValue . observationRequirement 0..* BackboneElement Reference ( ObservationDefinition ) Dynamic aspects of the definition What observations are required to perform this action
. . . observationResultRequirement 0..* Reference ( ObservationDefinition ) What observations must be produced by this action
. . description . transform 0..1 string canonical ( StructureMap ) Natural language description of Transform to apply the dynamic value template
. . path . dynamicValue 0..1 0..* string BackboneElement The path to Dynamic aspects of the element to be set dynamically definition
. . . . language path 0..1 1..1 string Language of The path to the expression element to be set dynamically
. . . . expression 0..1 1..1 string Expression An expression that provides the dynamic value for the customization

doco Documentation for this format

UML Diagram ( Legend )

ActivityDefinition ( DomainResource ) An absolute URI that is used to identify this activity definition when it is referenced in a specification, model, design or an instance. instance; also called its canonical identifier. This SHALL be a URL, SHOULD be globally unique, unique and SHOULD be an a literal address at which at which an authoritative instance of this activity definition is (or will be) published. The This URL SHOULD include can be the major version target of a canonical reference. It SHALL remain the same when the activity definition. For more information see [Technical and Business Versions](resource.html#versions) definition is stored on different servers url : uri [0..1] A formal identifier that is used to identify this activity definition when it is represented in other formats, or referenced in a specification, model, design or an instance identifier : Identifier [0..*] The identifier that is used to identify this version of the activity definition when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the activity definition author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available. There is also no expectation that versions can be placed in a lexicographical sequence. To provide a version consistent with the Decision Support Service specification, use the format Major.Minor.Revision (e.g. 1.0.0). For more information on versioning knowledge assets, refer to the Decision Support Service specification. Note that a version is required for non-experimental active assets version : string [0..1] A natural language name identifying the activity definition. This name should be usable as an identifier for the module by machine processing applications such as code generation name : string [0..1] A short, descriptive, user-friendly title for the activity definition title : string [0..1] An explanatory or alternate title for the activity definition giving additional information about its content subtitle : string [0..1] The status of this activity definition. Enables tracking the life-cycle of the content (this element modifies the meaning of other elements) status : code [1..1] « The lifecycle status of a Value Set or Concept Map. an artifact. (Strength=Required) PublicationStatus ! » A boolean Boolean value to indicate that this activity definition is authored for testing purposes (or education/evaluation/marketing), education/evaluation/marketing) and is not intended to be used for genuine usage (this element modifies the meaning of other elements) experimental : boolean [0..1] A code or group definition that describes the intended subject of the activity being defined subject[x] : Type [0..1] « CodeableConcept | Reference ( Group ); The possible types of subjects for an activity (E.g. Patient, Practitioner, Organization, Location, etc.). (Strength=Extensible) SubjectType + » The date (and optionally time) when the activity definition was published. The date must change if and when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the activity definition changes date : dateTime [0..1] The name of the individual or organization or individual that published the activity definition publisher : string [0..1] Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] A free text natural language description of the activity definition from a consumer's perspective description : markdown [0..1] Explaination The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate activity definition instances useContext : UsageContext [0..*] A legal or geographic region in which the activity definition is intended to be used jurisdiction : CodeableConcept [0..*] « Countries and regions within which this artifact is targeted for use. (Strength=Extensible) Jurisdiction ValueSet + » Explanation of why this activity definition is needed and why it has been designed as it has purpose : markdown [0..1] A detailed description of how the asset activity definition is used from a clinical perspective usage : string [0..1] A copyright statement relating to the activity definition and/or its contents. Copyright statements are generally legal restrictions on the use and publishing of the activity definition copyright : markdown [0..1] The date on which the resource content was approved by the publisher. Approval happens once when the content is officially approved for usage approvalDate : date [0..1] The date on which the resource content was last reviewed. Review happens periodically after approval, approval but doesn't does not change the original approval date lastReviewDate : date [0..1] The period during which the activity definition content was or is planned to be in active use effectivePeriod : Period [0..1] The content was developed with a focus and intent of supporting the contexts that are listed. These terms may be used to assist with indexing and searching for appropriate activity definition instances useContext : UsageContext [0..*] A legal or geographic region in which the activity definition is intended to be used jurisdiction : CodeableConcept [0..*] Countries and regions within which this artifact is targeted for use (Strength=Extensible) Jurisdiction ValueSet + Descriptive topics related to the content of the activity. Topics provide a high-level categorization of the activity that can be useful for filtering and searching topic : CodeableConcept [0..*] « High-level categorization of the definition, used for searching, sorting, and filtering filtering. (Strength=Example) DefinitionTopic ?? » A contributor to An individiual or organization primarily involved in the content creation and maintenance of the asset, including authors, editors, reviewers, and endorsers content contributor author : Contributor ContactDetail [0..*] Contact details to assist a user in finding and communicating with An individual or organization primarily responsible for internal coherence of the publisher content contact editor : ContactDetail [0..*] A copyright statement relating to An individual or organization primarily responsible for review of some aspect of the activity definition and/or its contents. Copyright statements are generally legal restrictions on content reviewer : ContactDetail [0..*] An individual or organization responsible for officially endorsing the content for use and publishing of the activity definition in some setting copyright endorser : markdown ContactDetail [0..1] [0..*] Related artifacts such as additional documentation, justification, or bibliographic references relatedArtifact : RelatedArtifact [0..*] A reference to a Library resource containing any formal logic used by the asset activity definition library : Reference canonical [0..*] « Library » A description of the kind of resource the activity definition is representing. For example, a MedicationRequest, a ProcedureRequest, ServiceRequest, or a CommunicationRequest. Typically, but not always, this is a Request resource kind : code [0..1] « The kind of activity the definition is describing describing. (Strength=Required) ResourceType RequestResourceType ! » A profile to which the target of the activity definition is expected to conform profile : canonical [0..1] « StructureDefinition » Detailed description of the type of activity; e.g. What lab test, what procedure, what kind of encounter code : CodeableConcept [0..1] « Detailed type of the activity; e.g. CBC CBC. (Strength=Example) Procedure Codes (SNOMED CT) ProcedureCodes(SNOMEDCT) ?? » Indicates the level of authority/intentionality associated with the activity and where the request should fit into the workflow chain intent : code [0..1] « Codes indicating the degree of authority/intentionality associated with a request. (Strength=Required) RequestIntent ! » Indicates how quickly the activity should be addressed with respect to other requests priority : code [0..1] « Identifies the level of importance to be assigned to actioning the request. (Strength=Required) RequestPriority ! » Set this to true if the definition is to indicate that a particular activity should NOT be performed. If true, this element should be interpreted to reinforce a negative coding. For example NPO as a code with a doNotPerform of true would still indicate to NOT perform the action (this element modifies the meaning of other elements) doNotPerform : boolean [0..1] The period, timing or frequency upon which the described activity is to occur timing[x] : Type [0..1] « Timing | dateTime | Age | Period | Range | Duration » Identifies the facility where the activity will occur; e.g. home, hospital, specific clinic, etc location : Reference [0..1] « Location » Identifies the food, drug or other product being consumed or supplied in the activity product[x] : Type [0..1] « Reference ( Medication | Substance )| CodeableConcept ; Code describing the type of substance or medication medication. (Strength=Example) SNOMED CT Medication SNOMEDCTMedicationCodes ?? » Identifies the quantity expected to be consumed at once (per dose, per meal, etc.) quantity : Quantity ( SimpleQuantity ) [0..1] Provides detailed dosage instructions in the same way that they are described for MedicationRequest resources dosage : Dosage [0..*] Indicates the sites on the subject's body where the procedure should be performed (I.e. the target sites) bodySite : CodeableConcept [0..*] « A code that identifies the anatomical location location. (Strength=Example) SNOMED CT Body Structures SNOMEDCTBodyStructures ?? » Defines specimen requirements for the action to be performed, such as required specimens for a lab test specimenRequirement : Reference [0..*] « SpecimenDefinition » Defines observation requirements for the action to be performed, such as body weight or surface area observationRequirement : Reference [0..*] « ObservationDefinition » Defines the observations that are expected to be produced by the action observationResultRequirement : Reference [0..*] « ObservationDefinition » A reference to a StructureMap resource that defines a transform that can be executed to produce the intent resource using the ActivityDefinition instance as the input transform : Reference canonical [0..1] « StructureMap » Participant The type of participant in the action type : code [1..1] « The type of participant in the activity activity. (Strength=Required) ActionParticipantType ! » The role the participant should play in performing the described action role : CodeableConcept [0..1] « Defines roles played by participants for the action action. (Strength=Example) ActionParticipantRole ?? » DynamicValue A brief, natural language description of the intended semantics of the dynamic value description : string [0..1] The path to the element to be customized. This is the path on the resource that will hold the result of the calculation defined by the expression path : string [0..1] expression. The media specified path SHALL be a FHIRPath resolveable on the specified target type of the language for ActivityDefinition, and SHALL consist only of identifiers, constant indexers, and a restricted subset of functions. The path is allowed to contain qualifiers (.) to traverse sub-elements, as well as indexers ([x]) to traverse multiple-cardinality sub-elements (see the expression [Simple FHIRPath Profile](fhirpath.html#simple) for full details) language path : string [0..1] [1..1] An expression specifying the value of the customized element expression : string Expression [0..1] [1..1] Indicates who should participate in performing the action described participant [0..*] Dynamic values that will be evaluated to produce values for elements of the resulting resource. For example, if the dosage of a medication must be computed based on the patient's weight, a dynamic value would be used to specify an expression that calculated the weight, and the path on the intent request resource that would contain the result dynamicValue [0..*]

XML Template

<ActivityDefinition xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <

 <url value="[uri]"/><!-- 0..1 Canonical identifier for this activity definition, represented as a URI (globally unique) -->

 <identifier><!-- 0..* Identifier Additional identifier for the activity definition --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of the activity definition -->
 <

 <name value="[string]"/><!-- ?? 0..1 Name for this activity definition (computer friendly) -->

 <title value="[string]"/><!-- 0..1 Name for this activity definition (human friendly) -->
 <subtitle value="[string]"/><!-- 0..1 Subordinate title of the activity definition -->

 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <
 <
 <

 <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage -->
 <subject[x]><!-- 0..1 CodeableConcept|Reference(Group) Type of individual the activity definition is intended for --></subject[x]>
 <date value="[dateTime]"/><!-- 0..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>

 <description value="[markdown]"/><!-- 0..1 Natural language description of the activity definition -->
 <
 <
 <
 <
 <</effectivePeriod>
 <</useContext>

 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>

 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for activity definition (if applicable) --></jurisdiction>
 <</topic>
 <</contributor>
 <</contact>

 <purpose value="[markdown]"/><!-- 0..1 Why this activity definition is defined -->
 <usage value="[string]"/><!-- 0..1 Describes the clinical usage of the activity definition -->

 <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions -->
 <</relatedArtifact>
 <</library>
 <

 <approvalDate value="[date]"/><!-- 0..1 When the activity definition was approved by publisher -->
 <lastReviewDate value="[date]"/><!-- 0..1 When the activity definition was last reviewed -->
 <effectivePeriod><!-- 0..1 Period When the activity definition is expected to be used --></effectivePeriod>
 <topic><!-- 0..* CodeableConcept E.g. Education, Treatment, Assessment, etc. --></topic>
 <author><!-- 0..* ContactDetail Who authored the content --></author>
 <editor><!-- 0..* ContactDetail Who edited the content --></editor>
 <reviewer><!-- 0..* ContactDetail Who reviewed the content --></reviewer>
 <endorser><!-- 0..* ContactDetail Who endorsed the content --></endorser>
 <relatedArtifact><!-- 0..* RelatedArtifact Additional documentation, citations, etc. --></relatedArtifact>
 <library><!-- 0..* canonical(Library) Logic used by the activity definition --></library>
 <kind value="[code]"/><!-- 0..1 Kind of resource -->
 <profile><!-- 0..1 canonical(StructureDefinition) What profile the resource needs to conform to --></profile>

 <code><!-- 0..1 CodeableConcept Detail type of activity --></code>
 <</timing[x]>

 <intent value="[code]"/><!-- 0..1 proposal | plan | order -->
 <priority value="[code]"/><!-- 0..1 routine | urgent | asap | stat -->
 <doNotPerform value="[boolean]"/><!-- 0..1 True if the activity should not be performed -->
 <timing[x]><!-- 0..1 Timing|dateTime|Age|Period|Range|Duration When activity is to occur --></timing[x]>

 <location><!-- 0..1 Reference(Location) Where it should happen --></location>
 <participant>  <!-- 0..* Who should participate in the action -->
  <
  <</role>

  <type value="[code]"/><!-- 1..1 patient | practitioner | related-person | device -->
  <role><!-- 0..1 CodeableConcept E.g. Nurse, Surgeon, Parent, etc. --></role>

 </participant>
 <product[x]><!-- 0..1 Reference(Medication|Substance)|CodeableConcept What's administered/supplied --></product[x]>
 <quantity><!-- 0..1 Quantity(SimpleQuantity) How much is administered/consumed/supplied --></quantity>
 <dosage><!-- 0..* Dosage Detailed dosage instructions --></dosage>
 <bodySite><!-- 0..* CodeableConcept What part of body to perform on --></bodySite>
 <</transform>
 <
  <
  <
  <
  <

 <specimenRequirement><!-- 0..* Reference(SpecimenDefinition) What specimens are required to perform this action --></specimenRequirement>
 <observationRequirement><!-- 0..* Reference(ObservationDefinition) What observations are required to perform this action --></observationRequirement>
 <observationResultRequirement><!-- 0..* Reference(ObservationDefinition) What observations must be produced by this action --></observationResultRequirement>
 <transform><!-- 0..1 canonical(StructureMap) Transform to apply the template --></transform>
 <dynamicValue>  <!-- 0..* Dynamic aspects of the definition -->
  <path value="[string]"/><!-- 1..1 The path to the element to be set dynamically -->
  <expression><!-- 1..1 Expression An expression that provides the dynamic value for the customization --></expression>

 </dynamicValue>
</ActivityDefinition>

JSON Template

{doco
  "resourceType" : "ActivityDefinition",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "

  "url" : "<uri>", // Canonical identifier for this activity definition, represented as a URI (globally unique)

  "identifier" : [{ Identifier }], // Additional identifier for the activity definition
  "version" : "<string>", // Business version of the activity definition
  "

  "name" : "<string>", // C? Name for this activity definition (computer friendly)

  "title" : "<string>", // Name for this activity definition (human friendly)
  "subtitle" : "<string>", // Subordinate title of the activity definition

  "status" : "<code>", // R!  draft | active | retired | unknown
  "
  "
  "

  "experimental" : <boolean>, // For testing purposes, not real usage
  // subject[x]: Type of individual the activity definition is intended for. One of these 2:
  "subjectCodeableConcept" : { CodeableConcept },
  "subjectReference" : { Reference(Group) },
  "date" : "<dateTime>", // Date last changed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher

  "description" : "<markdown>", // Natural language description of the activity definition
  "
  "
  "
  "
  "
  "

  "useContext" : [{ UsageContext }], // The context that the content is intended to support

  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for activity definition (if applicable)
  "
  "
  "

  "purpose" : "<markdown>", // Why this activity definition is defined
  "usage" : "<string>", // Describes the clinical usage of the activity definition

  "copyright" : "<markdown>", // Use and/or publishing restrictions
  "
  "
  "

  "approvalDate" : "<date>", // When the activity definition was approved by publisher
  "lastReviewDate" : "<date>", // When the activity definition was last reviewed
  "effectivePeriod" : { Period }, // When the activity definition is expected to be used
  "topic" : [{ CodeableConcept }], // E.g. Education, Treatment, Assessment, etc.
  "author" : [{ ContactDetail }], // Who authored the content
  "editor" : [{ ContactDetail }], // Who edited the content
  "reviewer" : [{ ContactDetail }], // Who reviewed the content
  "endorser" : [{ ContactDetail }], // Who endorsed the content
  "relatedArtifact" : [{ RelatedArtifact }], // Additional documentation, citations, etc.
  "library" : [{ canonical(Library) }], // Logic used by the activity definition
  "kind" : "<code>", // Kind of resource
  "profile" : { canonical(StructureDefinition) }, // What profile the resource needs to conform to

  "code" : { CodeableConcept }, // Detail type of activity
  

  "intent" : "<code>", // proposal | plan | order
  "priority" : "<code>", // routine | urgent | asap | stat
  "doNotPerform" : <boolean>, // True if the activity should not be performed
  // timing[x]: When activity is to occur. One of these 6:
  "timingTiming" : { Timing },
  "timingDateTime" : "<dateTime>",
  "timingAge" : { Age },

  "timingPeriod" : { Period },
  "timingRange" : { Range },
  "timingDuration" : { Duration },

  "location" : { Reference(Location) }, // Where it should happen
  "participant" : [{ // Who should participate in the action
    "
    "

    "type" : "<code>", // R!  patient | practitioner | related-person | device
    "role" : { CodeableConcept } // E.g. Nurse, Surgeon, Parent, etc.

  }],
  // product[x]: What's administered/supplied. One of these 2:
  "productReference" : { Reference(Medication|Substance) },
  "productCodeableConcept" : { CodeableConcept },
  "quantity" : { Quantity(SimpleQuantity) }, // How much is administered/consumed/supplied
  "dosage" : [{ Dosage }], // Detailed dosage instructions
  "bodySite" : [{ CodeableConcept }], // What part of body to perform on
  "
  "
    "
    "
    "
    "

  "specimenRequirement" : [{ Reference(SpecimenDefinition) }], // What specimens are required to perform this action
  "observationRequirement" : [{ Reference(ObservationDefinition) }], // What observations are required to perform this action
  "observationResultRequirement" : [{ Reference(ObservationDefinition) }], // What observations must be produced by this action
  "transform" : { canonical(StructureMap) }, // Transform to apply the template
  "dynamicValue" : [{ // Dynamic aspects of the definition
    "path" : "<string>", // R!  The path to the element to be set dynamically
    "expression" : { Expression } // R!  An expression that provides the dynamic value for the customization

  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco
[ a fhir:ActivityDefinition;
  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:

  fhir:ActivityDefinition.url [ uri ]; # 0..1 Canonical identifier for this activity definition, represented as a URI (globally unique)

  fhir:ActivityDefinition.identifier [ Identifier ], ... ; # 0..* Additional identifier for the activity definition
  fhir:ActivityDefinition.version [ string ]; # 0..1 Business version of the activity definition
  fhir:ActivityDefinition.name [ string ]; # 0..1 Name for this activity definition (computer friendly)
  fhir:ActivityDefinition.title [ string ]; # 0..1 Name for this activity definition (human friendly)
  fhir:ActivityDefinition.subtitle [ string ]; # 0..1 Subordinate title of the activity definition

  fhir:ActivityDefinition.status [ code ]; # 1..1 draft | active | retired | unknown
  fhir:
  fhir:
  fhir:

  fhir:ActivityDefinition.experimental [ boolean ]; # 0..1 For testing purposes, not real usage
  # ActivityDefinition.subject[x] : 0..1 Type of individual the activity definition is intended for. One of these 2
    fhir:ActivityDefinition.subjectCodeableConcept [ CodeableConcept ]
    fhir:ActivityDefinition.subjectReference [ Reference(Group) ]
  fhir:ActivityDefinition.date [ dateTime ]; # 0..1 Date last changed
  fhir:ActivityDefinition.publisher [ string ]; # 0..1 Name of the publisher (organization or individual)
  fhir:ActivityDefinition.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher

  fhir:ActivityDefinition.description [ markdown ]; # 0..1 Natural language description of the activity definition
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:ActivityDefinition.useContext [ UsageContext ], ... ; # 0..* The context that the content is intended to support

  fhir:ActivityDefinition.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for activity definition (if applicable)
  fhir:
  fhir:
  fhir:

  fhir:ActivityDefinition.purpose [ markdown ]; # 0..1 Why this activity definition is defined
  fhir:ActivityDefinition.usage [ string ]; # 0..1 Describes the clinical usage of the activity definition

  fhir:ActivityDefinition.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions
  fhir:
  fhir:
  fhir:

  fhir:ActivityDefinition.approvalDate [ date ]; # 0..1 When the activity definition was approved by publisher
  fhir:ActivityDefinition.lastReviewDate [ date ]; # 0..1 When the activity definition was last reviewed
  fhir:ActivityDefinition.effectivePeriod [ Period ]; # 0..1 When the activity definition is expected to be used
  fhir:ActivityDefinition.topic [ CodeableConcept ], ... ; # 0..* E.g. Education, Treatment, Assessment, etc.
  fhir:ActivityDefinition.author [ ContactDetail ], ... ; # 0..* Who authored the content
  fhir:ActivityDefinition.editor [ ContactDetail ], ... ; # 0..* Who edited the content
  fhir:ActivityDefinition.reviewer [ ContactDetail ], ... ; # 0..* Who reviewed the content
  fhir:ActivityDefinition.endorser [ ContactDetail ], ... ; # 0..* Who endorsed the content
  fhir:ActivityDefinition.relatedArtifact [ RelatedArtifact ], ... ; # 0..* Additional documentation, citations, etc.
  fhir:ActivityDefinition.library [ canonical(Library) ], ... ; # 0..* Logic used by the activity definition
  fhir:ActivityDefinition.kind [ code ]; # 0..1 Kind of resource
  fhir:ActivityDefinition.profile [ canonical(StructureDefinition) ]; # 0..1 What profile the resource needs to conform to

  fhir:ActivityDefinition.code [ CodeableConcept ]; # 0..1 Detail type of activity
  # . One of these 4

  fhir:ActivityDefinition.intent [ code ]; # 0..1 proposal | plan | order
  fhir:ActivityDefinition.priority [ code ]; # 0..1 routine | urgent | asap | stat
  fhir:ActivityDefinition.doNotPerform [ boolean ]; # 0..1 True if the activity should not be performed
  # ActivityDefinition.timing[x] : 0..1 When activity is to occur. One of these 6

    fhir:ActivityDefinition.timingTiming [ Timing ]
    fhir:ActivityDefinition.timingDateTime [ dateTime ]
    fhir:ActivityDefinition.timingAge [ Age ]

    fhir:ActivityDefinition.timingPeriod [ Period ]
    fhir:ActivityDefinition.timingRange [ Range ]
    fhir:ActivityDefinition.timingDuration [ Duration ]

  fhir:ActivityDefinition.location [ Reference(Location) ]; # 0..1 Where it should happen
  fhir:ActivityDefinition.participant [ # 0..* Who should participate in the action
    fhir:
    fhir:

    fhir:ActivityDefinition.participant.type [ code ]; # 1..1 patient | practitioner | related-person | device
    fhir:ActivityDefinition.participant.role [ CodeableConcept ]; # 0..1 E.g. Nurse, Surgeon, Parent, etc.

  ], ...;
  # ActivityDefinition.product[x] : 0..1 What's administered/supplied. One of these 2
    fhir:ActivityDefinition.productReference [ Reference(Medication|Substance) ]
    fhir:ActivityDefinition.productCodeableConcept [ CodeableConcept ]
  fhir:ActivityDefinition.quantity [ Quantity(SimpleQuantity) ]; # 0..1 How much is administered/consumed/supplied
  fhir:ActivityDefinition.dosage [ Dosage ], ... ; # 0..* Detailed dosage instructions
  fhir:ActivityDefinition.bodySite [ CodeableConcept ], ... ; # 0..* What part of body to perform on
  fhir:
  fhir:
    fhir:
    fhir:
    fhir:
    fhir:

  fhir:ActivityDefinition.specimenRequirement [ Reference(SpecimenDefinition) ], ... ; # 0..* What specimens are required to perform this action
  fhir:ActivityDefinition.observationRequirement [ Reference(ObservationDefinition) ], ... ; # 0..* What observations are required to perform this action
  fhir:ActivityDefinition.observationResultRequirement [ Reference(ObservationDefinition) ], ... ; # 0..* What observations must be produced by this action
  fhir:ActivityDefinition.transform [ canonical(StructureMap) ]; # 0..1 Transform to apply the template
  fhir:ActivityDefinition.dynamicValue [ # 0..* Dynamic aspects of the definition
    fhir:ActivityDefinition.dynamicValue.path [ string ]; # 1..1 The path to the element to be set dynamically
    fhir:ActivityDefinition.dynamicValue.expression [ Expression ]; # 1..1 An expression that provides the dynamic value for the customization

  ], ...;
]

Changes since DSTU2 R3

ActivityDefinition
ActivityDefinition.status
  • Change value set from http://hl7.org/fhir/ValueSet/publication-status|4.0.0 to http://hl7.org/fhir/ValueSet/publication-status|4.1.0
ActivityDefinition.kind
  • Change value set from http://hl7.org/fhir/ValueSet/request-resource-types|4.0.0 to http://hl7.org/fhir/ValueSet/request-resource-types|4.1.0
ActivityDefinition.intent
  • Change value set from http://hl7.org/fhir/ValueSet/request-intent|4.0.0 to http://hl7.org/fhir/ValueSet/request-intent|4.1.0
ActivityDefinition.priority
  • Change value set from http://hl7.org/fhir/ValueSet/request-priority|4.0.0 to http://hl7.org/fhir/ValueSet/request-priority|4.1.0
ActivityDefinition.participant.type
  • Change value set from http://hl7.org/fhir/ValueSet/action-participant-type|4.0.0 to http://hl7.org/fhir/ValueSet/action-participant-type|4.1.0

This resource did not exist in Release 2 See the Full Difference for further information

This analysis is available as XML or JSON .

See R3 <--> R4 Conversion Maps (status = 9 tests that all execute ok. 2 fail round-trip testing and 9 r3 resources are invalid (0 errors). )

Structure

Name Flags Card. Type Description & Constraints doco
. . ActivityDefinition I TU DomainResource The definition of a specific activity to be taken, independent of any particular patient or context
+ Warning: Name should be usable as an identifier for the module by machine processing applications such as code generation
Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
. . . url Σ 0..1 uri Logical URI to reference Canonical identifier for this activity definition definition, represented as a URI (globally unique)
. . . identifier Σ 0..* Identifier Additional identifier for the activity definition
. . . version Σ 0..1 string Business version of the activity definition
. . . name Σ I 0..1 string Name for this activity definition (computer friendly)
. . . title Σ 0..1 string Name for this activity definition (human friendly)
. . . subtitle 0..1 string Subordinate title of the activity definition
... status ?! Σ 1..1 code draft | active | retired | unknown
PublicationStatus ( Required )
. . . experimental ?! Σ 0..1 boolean For testing purposes, not real usage
. . . subject[x] 0..1 Type of individual the activity definition is intended for
Subject type ( Extensible )
.... subjectCodeableConcept CodeableConcept
.... subjectReference Reference ( Group )
. . . date Σ 0..1 dateTime Date this was last changed
. . . publisher Σ 0..1 string Name of the publisher (organization or individual)
. . . contact Σ 0..* ContactDetail Contact details for the publisher
.. . description Σ 0..1 markdown Natural language description of the activity definition
. . . useContext Σ 0..* UsageContext The context that the content is intended to support
... jurisdiction Σ 0..* CodeableConcept Intended jurisdiction for activity definition (if applicable)
Jurisdiction ( Extensible )
.. . purpose 0..1 markdown Why this activity definition is defined
. . . usage 0..1 string Describes the clinical usage of the asset activity definition
... copyright 0..1 markdown Use and/or publishing restrictions
. . . approvalDate 0..1 date When the activity definition was approved by publisher
. . . lastReviewDate 0..1 date When the activity definition was last reviewed
. . . effectivePeriod Σ 0..1 Period When the activity definition is expected to be used
. . . useContext Σ 0..* UsageContext Context the content is intended to support jurisdiction topic Σ 0..* CodeableConcept Intended jurisdiction for activity definition (if applicable) E.g. Education, Treatment, Assessment, etc.
Jurisdiction ValueSet DefinitionTopic ( Extensible Example )
. . . topic author 0..* CodeableConcept ContactDetail E.g. Education, Treatment, Assessment, etc DefinitionTopic ( Example ) Who authored the content
. . . contributor editor 0..* Contributor ContactDetail A Who edited the content contributor
. . . contact reviewer Σ 0..* ContactDetail Contact details for Who reviewed the publisher content
. . copyright . endorser 0..1 0..* markdown ContactDetail Use and/or publishing restrictions Who endorsed the content
. . . relatedArtifact 0..* RelatedArtifact Additional documentation, citations, etc etc.
. . . library 0..* Reference canonical ( Library ) Logic used by the asset activity definition
. . . kind Σ 0..1 code Kind of resource
ResourceType RequestResourceType ( Required )
. . . profile 0..1 canonical ( StructureDefinition ) What profile the resource needs to conform to
.. . code Σ 0..1 CodeableConcept Detail type of activity
Procedure Codes (SNOMED CT) ( Example )
. . . intent 0..1 code proposal | plan | order
RequestIntent ( Required )
... priority 0..1 code routine | urgent | asap | stat
Request priority ( Required )
... doNotPerform ?! Σ 0..1 boolean True if the activity should not be performed
. . . timing[x] 0..1 When activity is to occur
. . . . timingTiming Timing
. . . . timingDateTime dateTime
. . . . timingAge Age
.... timingPeriod Period
. . . . timingRange Range
. . . . timingDuration Duration
. . . location 0..1 Reference ( Location ) Where it should happen
. . . participant 0..* BackboneElement Who should participate in the action
. . . . type 1..1 code patient | practitioner | related-person | device
ActionParticipantType ( Required )
. . . . role 0..1 CodeableConcept E.g. Nurse, Surgeon, Parent, etc etc.
ActionParticipantRole Action participant role ( Example )
. . . product[x] 0..1 What's administered/supplied
SNOMED CT Medication Codes ( Example )
. . . . productReference Reference ( Medication | Substance )
. . . . productCodeableConcept CodeableConcept
. . . quantity 0..1 SimpleQuantity How much is administered/consumed/supplied
. . . dosage 0..* Dosage Detailed dosage instructions
. . . bodySite 0..* CodeableConcept What part of body to perform on
SNOMED CT Body Structures ( Example )
. . . transform specimenRequirement 0..1 0..* Reference ( StructureMap SpecimenDefinition ) Transform What specimens are required to apply the template perform this action
. . dynamicValue . observationRequirement 0..* BackboneElement Reference ( ObservationDefinition ) Dynamic aspects of the definition What observations are required to perform this action
. . . observationResultRequirement 0..* Reference ( ObservationDefinition ) What observations must be produced by this action
. . description . transform 0..1 string canonical ( StructureMap ) Natural language description of Transform to apply the dynamic value template
. . path . dynamicValue 0..1 0..* string BackboneElement The path to Dynamic aspects of the element to be set dynamically definition
. . . . language path 0..1 1..1 string Language of The path to the expression element to be set dynamically
. . . . expression 0..1 1..1 string Expression An expression that provides the dynamic value for the customization

doco Documentation for this format

UML Diagram ( Legend )

ActivityDefinition ( DomainResource ) An absolute URI that is used to identify this activity definition when it is referenced in a specification, model, design or an instance. instance; also called its canonical identifier. This SHALL be a URL, SHOULD be globally unique, unique and SHOULD be an a literal address at which at which an authoritative instance of this activity definition is (or will be) published. The This URL SHOULD include can be the major version target of a canonical reference. It SHALL remain the same when the activity definition. For more information see [Technical and Business Versions](resource.html#versions) definition is stored on different servers url : uri [0..1] A formal identifier that is used to identify this activity definition when it is represented in other formats, or referenced in a specification, model, design or an instance identifier : Identifier [0..*] The identifier that is used to identify this version of the activity definition when it is referenced in a specification, model, design or instance. This is an arbitrary value managed by the activity definition author and is not expected to be globally unique. For example, it might be a timestamp (e.g. yyyymmdd) if a managed version is not available. There is also no expectation that versions can be placed in a lexicographical sequence. To provide a version consistent with the Decision Support Service specification, use the format Major.Minor.Revision (e.g. 1.0.0). For more information on versioning knowledge assets, refer to the Decision Support Service specification. Note that a version is required for non-experimental active assets version : string [0..1] A natural language name identifying the activity definition. This name should be usable as an identifier for the module by machine processing applications such as code generation name : string [0..1] A short, descriptive, user-friendly title for the activity definition title : string [0..1] An explanatory or alternate title for the activity definition giving additional information about its content subtitle : string [0..1] The status of this activity definition. Enables tracking the life-cycle of the content (this element modifies the meaning of other elements) status : code [1..1] « The lifecycle status of a Value Set or Concept Map. an artifact. (Strength=Required) PublicationStatus ! » A boolean Boolean value to indicate that this activity definition is authored for testing purposes (or education/evaluation/marketing), education/evaluation/marketing) and is not intended to be used for genuine usage (this element modifies the meaning of other elements) experimental : boolean [0..1] A code or group definition that describes the intended subject of the activity being defined subject[x] : Type [0..1] « CodeableConcept | Reference ( Group ); The possible types of subjects for an activity (E.g. Patient, Practitioner, Organization, Location, etc.). (Strength=Extensible) SubjectType + » The date (and optionally time) when the activity definition was published. The date must change if and when the business version changes and it must change if the status code changes. In addition, it should change when the substantive content of the activity definition changes date : dateTime [0..1] The name of the individual or organization or individual that published the activity definition publisher : string [0..1] Contact details to assist a user in finding and communicating with the publisher contact : ContactDetail [0..*] A free text natural language description of the activity definition from a consumer's perspective description : markdown [0..1] Explaination The content was developed with a focus and intent of supporting the contexts that are listed. These contexts may be general categories (gender, age, ...) or may be references to specific programs (insurance plans, studies, ...) and may be used to assist with indexing and searching for appropriate activity definition instances useContext : UsageContext [0..*] A legal or geographic region in which the activity definition is intended to be used jurisdiction : CodeableConcept [0..*] « Countries and regions within which this artifact is targeted for use. (Strength=Extensible) Jurisdiction ValueSet + » Explanation of why this activity definition is needed and why it has been designed as it has purpose : markdown [0..1] A detailed description of how the asset activity definition is used from a clinical perspective usage : string [0..1] A copyright statement relating to the activity definition and/or its contents. Copyright statements are generally legal restrictions on the use and publishing of the activity definition copyright : markdown [0..1] The date on which the resource content was approved by the publisher. Approval happens once when the content is officially approved for usage approvalDate : date [0..1] The date on which the resource content was last reviewed. Review happens periodically after approval, approval but doesn't does not change the original approval date lastReviewDate : date [0..1] The period during which the activity definition content was or is planned to be in active use effectivePeriod : Period [0..1] The content was developed with a focus and intent of supporting the contexts that are listed. These terms may be used to assist with indexing and searching for appropriate activity definition instances useContext : UsageContext [0..*] A legal or geographic region in which the activity definition is intended to be used jurisdiction : CodeableConcept [0..*] Countries and regions within which this artifact is targeted for use (Strength=Extensible) Jurisdiction ValueSet + Descriptive topics related to the content of the activity. Topics provide a high-level categorization of the activity that can be useful for filtering and searching topic : CodeableConcept [0..*] « High-level categorization of the definition, used for searching, sorting, and filtering filtering. (Strength=Example) DefinitionTopic ?? » A contributor to An individiual or organization primarily involved in the content creation and maintenance of the asset, including authors, editors, reviewers, and endorsers content contributor author : Contributor ContactDetail [0..*] Contact details to assist a user in finding and communicating with An individual or organization primarily responsible for internal coherence of the publisher content contact editor : ContactDetail [0..*] A copyright statement relating to An individual or organization primarily responsible for review of some aspect of the activity definition and/or its contents. Copyright statements are generally legal restrictions on content reviewer : ContactDetail [0..*] An individual or organization responsible for officially endorsing the content for use and publishing of the activity definition in some setting copyright endorser : markdown ContactDetail [0..1] [0..*] Related artifacts such as additional documentation, justification, or bibliographic references relatedArtifact : RelatedArtifact [0..*] A reference to a Library resource containing any formal logic used by the asset activity definition library : Reference canonical [0..*] « Library » A description of the kind of resource the activity definition is representing. For example, a MedicationRequest, a ProcedureRequest, ServiceRequest, or a CommunicationRequest. Typically, but not always, this is a Request resource kind : code [0..1] « The kind of activity the definition is describing describing. (Strength=Required) ResourceType RequestResourceType ! » A profile to which the target of the activity definition is expected to conform profile : canonical [0..1] « StructureDefinition » Detailed description of the type of activity; e.g. What lab test, what procedure, what kind of encounter code : CodeableConcept [0..1] « Detailed type of the activity; e.g. CBC CBC. (Strength=Example) Procedure Codes (SNOMED CT) ProcedureCodes(SNOMEDCT) ?? » Indicates the level of authority/intentionality associated with the activity and where the request should fit into the workflow chain intent : code [0..1] « Codes indicating the degree of authority/intentionality associated with a request. (Strength=Required) RequestIntent ! » Indicates how quickly the activity should be addressed with respect to other requests priority : code [0..1] « Identifies the level of importance to be assigned to actioning the request. (Strength=Required) RequestPriority ! » Set this to true if the definition is to indicate that a particular activity should NOT be performed. If true, this element should be interpreted to reinforce a negative coding. For example NPO as a code with a doNotPerform of true would still indicate to NOT perform the action (this element modifies the meaning of other elements) doNotPerform : boolean [0..1] The period, timing or frequency upon which the described activity is to occur timing[x] : Type [0..1] « Timing | dateTime | Age | Period | Range | Duration » Identifies the facility where the activity will occur; e.g. home, hospital, specific clinic, etc location : Reference [0..1] « Location » Identifies the food, drug or other product being consumed or supplied in the activity product[x] : Type [0..1] « Reference ( Medication | Substance )| CodeableConcept ; Code describing the type of substance or medication medication. (Strength=Example) SNOMED CT Medication SNOMEDCTMedicationCodes ?? » Identifies the quantity expected to be consumed at once (per dose, per meal, etc.) quantity : Quantity ( SimpleQuantity ) [0..1] Provides detailed dosage instructions in the same way that they are described for MedicationRequest resources dosage : Dosage [0..*] Indicates the sites on the subject's body where the procedure should be performed (I.e. the target sites) bodySite : CodeableConcept [0..*] « A code that identifies the anatomical location location. (Strength=Example) SNOMED CT Body Structures SNOMEDCTBodyStructures ?? » Defines specimen requirements for the action to be performed, such as required specimens for a lab test specimenRequirement : Reference [0..*] « SpecimenDefinition » Defines observation requirements for the action to be performed, such as body weight or surface area observationRequirement : Reference [0..*] « ObservationDefinition » Defines the observations that are expected to be produced by the action observationResultRequirement : Reference [0..*] « ObservationDefinition » A reference to a StructureMap resource that defines a transform that can be executed to produce the intent resource using the ActivityDefinition instance as the input transform : Reference canonical [0..1] « StructureMap » Participant The type of participant in the action type : code [1..1] « The type of participant in the activity activity. (Strength=Required) ActionParticipantType ! » The role the participant should play in performing the described action role : CodeableConcept [0..1] « Defines roles played by participants for the action action. (Strength=Example) ActionParticipantRole ?? » DynamicValue A brief, natural language description of the intended semantics of the dynamic value description : string [0..1] The path to the element to be customized. This is the path on the resource that will hold the result of the calculation defined by the expression path : string [0..1] expression. The media specified path SHALL be a FHIRPath resolveable on the specified target type of the language for ActivityDefinition, and SHALL consist only of identifiers, constant indexers, and a restricted subset of functions. The path is allowed to contain qualifiers (.) to traverse sub-elements, as well as indexers ([x]) to traverse multiple-cardinality sub-elements (see the expression [Simple FHIRPath Profile](fhirpath.html#simple) for full details) language path : string [0..1] [1..1] An expression specifying the value of the customized element expression : string Expression [0..1] [1..1] Indicates who should participate in performing the action described participant [0..*] Dynamic values that will be evaluated to produce values for elements of the resulting resource. For example, if the dosage of a medication must be computed based on the patient's weight, a dynamic value would be used to specify an expression that calculated the weight, and the path on the intent request resource that would contain the result dynamicValue [0..*]

XML Template

<ActivityDefinition xmlns="http://hl7.org/fhir"> doco
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <

 <url value="[uri]"/><!-- 0..1 Canonical identifier for this activity definition, represented as a URI (globally unique) -->

 <identifier><!-- 0..* Identifier Additional identifier for the activity definition --></identifier>
 <version value="[string]"/><!-- 0..1 Business version of the activity definition -->
 <

 <name value="[string]"/><!-- ?? 0..1 Name for this activity definition (computer friendly) -->

 <title value="[string]"/><!-- 0..1 Name for this activity definition (human friendly) -->
 <subtitle value="[string]"/><!-- 0..1 Subordinate title of the activity definition -->

 <status value="[code]"/><!-- 1..1 draft | active | retired | unknown -->
 <
 <
 <

 <experimental value="[boolean]"/><!-- 0..1 For testing purposes, not real usage -->
 <subject[x]><!-- 0..1 CodeableConcept|Reference(Group) Type of individual the activity definition is intended for --></subject[x]>
 <date value="[dateTime]"/><!-- 0..1 Date last changed -->
 <publisher value="[string]"/><!-- 0..1 Name of the publisher (organization or individual) -->
 <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact>

 <description value="[markdown]"/><!-- 0..1 Natural language description of the activity definition -->
 <
 <
 <
 <
 <</effectivePeriod>
 <</useContext>

 <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext>

 <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for activity definition (if applicable) --></jurisdiction>
 <</topic>
 <</contributor>
 <</contact>

 <purpose value="[markdown]"/><!-- 0..1 Why this activity definition is defined -->
 <usage value="[string]"/><!-- 0..1 Describes the clinical usage of the activity definition -->

 <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions -->
 <</relatedArtifact>
 <</library>
 <

 <approvalDate value="[date]"/><!-- 0..1 When the activity definition was approved by publisher -->
 <lastReviewDate value="[date]"/><!-- 0..1 When the activity definition was last reviewed -->
 <effectivePeriod><!-- 0..1 Period When the activity definition is expected to be used --></effectivePeriod>
 <topic><!-- 0..* CodeableConcept E.g. Education, Treatment, Assessment, etc. --></topic>
 <author><!-- 0..* ContactDetail Who authored the content --></author>
 <editor><!-- 0..* ContactDetail Who edited the content --></editor>
 <reviewer><!-- 0..* ContactDetail Who reviewed the content --></reviewer>
 <endorser><!-- 0..* ContactDetail Who endorsed the content --></endorser>
 <relatedArtifact><!-- 0..* RelatedArtifact Additional documentation, citations, etc. --></relatedArtifact>
 <library><!-- 0..* canonical(Library) Logic used by the activity definition --></library>
 <kind value="[code]"/><!-- 0..1 Kind of resource -->
 <profile><!-- 0..1 canonical(StructureDefinition) What profile the resource needs to conform to --></profile>

 <code><!-- 0..1 CodeableConcept Detail type of activity --></code>
 <</timing[x]>

 <intent value="[code]"/><!-- 0..1 proposal | plan | order -->
 <priority value="[code]"/><!-- 0..1 routine | urgent | asap | stat -->
 <doNotPerform value="[boolean]"/><!-- 0..1 True if the activity should not be performed -->
 <timing[x]><!-- 0..1 Timing|dateTime|Age|Period|Range|Duration When activity is to occur --></timing[x]>

 <location><!-- 0..1 Reference(Location) Where it should happen --></location>
 <participant>  <!-- 0..* Who should participate in the action -->
  <
  <</role>

  <type value="[code]"/><!-- 1..1 patient | practitioner | related-person | device -->
  <role><!-- 0..1 CodeableConcept E.g. Nurse, Surgeon, Parent, etc. --></role>

 </participant>
 <product[x]><!-- 0..1 Reference(Medication|Substance)|CodeableConcept What's administered/supplied --></product[x]>
 <quantity><!-- 0..1 Quantity(SimpleQuantity) How much is administered/consumed/supplied --></quantity>
 <dosage><!-- 0..* Dosage Detailed dosage instructions --></dosage>
 <bodySite><!-- 0..* CodeableConcept What part of body to perform on --></bodySite>
 <</transform>
 <
  <
  <
  <
  <

 <specimenRequirement><!-- 0..* Reference(SpecimenDefinition) What specimens are required to perform this action --></specimenRequirement>
 <observationRequirement><!-- 0..* Reference(ObservationDefinition) What observations are required to perform this action --></observationRequirement>
 <observationResultRequirement><!-- 0..* Reference(ObservationDefinition) What observations must be produced by this action --></observationResultRequirement>
 <transform><!-- 0..1 canonical(StructureMap) Transform to apply the template --></transform>
 <dynamicValue>  <!-- 0..* Dynamic aspects of the definition -->
  <path value="[string]"/><!-- 1..1 The path to the element to be set dynamically -->
  <expression><!-- 1..1 Expression An expression that provides the dynamic value for the customization --></expression>

 </dynamicValue>
</ActivityDefinition>

JSON Template

{doco
  "resourceType" : "ActivityDefinition",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "

  "url" : "<uri>", // Canonical identifier for this activity definition, represented as a URI (globally unique)

  "identifier" : [{ Identifier }], // Additional identifier for the activity definition
  "version" : "<string>", // Business version of the activity definition
  "

  "name" : "<string>", // C? Name for this activity definition (computer friendly)

  "title" : "<string>", // Name for this activity definition (human friendly)
  "subtitle" : "<string>", // Subordinate title of the activity definition

  "status" : "<code>", // R!  draft | active | retired | unknown
  "
  "
  "

  "experimental" : <boolean>, // For testing purposes, not real usage
  // subject[x]: Type of individual the activity definition is intended for. One of these 2:
  "subjectCodeableConcept" : { CodeableConcept },
  "subjectReference" : { Reference(Group) },
  "date" : "<dateTime>", // Date last changed
  "publisher" : "<string>", // Name of the publisher (organization or individual)
  "contact" : [{ ContactDetail }], // Contact details for the publisher

  "description" : "<markdown>", // Natural language description of the activity definition
  "
  "
  "
  "
  "
  "

  "useContext" : [{ UsageContext }], // The context that the content is intended to support

  "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for activity definition (if applicable)
  "
  "
  "

  "purpose" : "<markdown>", // Why this activity definition is defined
  "usage" : "<string>", // Describes the clinical usage of the activity definition

  "copyright" : "<markdown>", // Use and/or publishing restrictions
  "
  "
  "

  "approvalDate" : "<date>", // When the activity definition was approved by publisher
  "lastReviewDate" : "<date>", // When the activity definition was last reviewed
  "effectivePeriod" : { Period }, // When the activity definition is expected to be used
  "topic" : [{ CodeableConcept }], // E.g. Education, Treatment, Assessment, etc.
  "author" : [{ ContactDetail }], // Who authored the content
  "editor" : [{ ContactDetail }], // Who edited the content
  "reviewer" : [{ ContactDetail }], // Who reviewed the content
  "endorser" : [{ ContactDetail }], // Who endorsed the content
  "relatedArtifact" : [{ RelatedArtifact }], // Additional documentation, citations, etc.
  "library" : [{ canonical(Library) }], // Logic used by the activity definition
  "kind" : "<code>", // Kind of resource
  "profile" : { canonical(StructureDefinition) }, // What profile the resource needs to conform to

  "code" : { CodeableConcept }, // Detail type of activity
  

  "intent" : "<code>", // proposal | plan | order
  "priority" : "<code>", // routine | urgent | asap | stat
  "doNotPerform" : <boolean>, // True if the activity should not be performed
  // timing[x]: When activity is to occur. One of these 6:
  "timingTiming" : { Timing },
  "timingDateTime" : "<dateTime>",
  "timingAge" : { Age },

  "timingPeriod" : { Period },
  "timingRange" : { Range },
  "timingDuration" : { Duration },

  "location" : { Reference(Location) }, // Where it should happen
  "participant" : [{ // Who should participate in the action
    "
    "

    "type" : "<code>", // R!  patient | practitioner | related-person | device
    "role" : { CodeableConcept } // E.g. Nurse, Surgeon, Parent, etc.

  }],
  // product[x]: What's administered/supplied. One of these 2:
  "productReference" : { Reference(Medication|Substance) },
  "productCodeableConcept" : { CodeableConcept },
  "quantity" : { Quantity(SimpleQuantity) }, // How much is administered/consumed/supplied
  "dosage" : [{ Dosage }], // Detailed dosage instructions
  "bodySite" : [{ CodeableConcept }], // What part of body to perform on
  "
  "
    "
    "
    "
    "

  "specimenRequirement" : [{ Reference(SpecimenDefinition) }], // What specimens are required to perform this action
  "observationRequirement" : [{ Reference(ObservationDefinition) }], // What observations are required to perform this action
  "observationResultRequirement" : [{ Reference(ObservationDefinition) }], // What observations must be produced by this action
  "transform" : { canonical(StructureMap) }, // Transform to apply the template
  "dynamicValue" : [{ // Dynamic aspects of the definition
    "path" : "<string>", // R!  The path to the element to be set dynamically
    "expression" : { Expression } // R!  An expression that provides the dynamic value for the customization

  }]
}

Turtle Template

@prefix fhir: <http://hl7.org/fhir/> .doco
[ a fhir:ActivityDefinition;
  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:

  fhir:ActivityDefinition.url [ uri ]; # 0..1 Canonical identifier for this activity definition, represented as a URI (globally unique)

  fhir:ActivityDefinition.identifier [ Identifier ], ... ; # 0..* Additional identifier for the activity definition
  fhir:ActivityDefinition.version [ string ]; # 0..1 Business version of the activity definition
  fhir:ActivityDefinition.name [ string ]; # 0..1 Name for this activity definition (computer friendly)
  fhir:ActivityDefinition.title [ string ]; # 0..1 Name for this activity definition (human friendly)
  fhir:ActivityDefinition.subtitle [ string ]; # 0..1 Subordinate title of the activity definition

  fhir:ActivityDefinition.status [ code ]; # 1..1 draft | active | retired | unknown
  fhir:
  fhir:
  fhir:

  fhir:ActivityDefinition.experimental [ boolean ]; # 0..1 For testing purposes, not real usage
  # ActivityDefinition.subject[x] : 0..1 Type of individual the activity definition is intended for. One of these 2
    fhir:ActivityDefinition.subjectCodeableConcept [ CodeableConcept ]
    fhir:ActivityDefinition.subjectReference [ Reference(Group) ]
  fhir:ActivityDefinition.date [ dateTime ]; # 0..1 Date last changed
  fhir:ActivityDefinition.publisher [ string ]; # 0..1 Name of the publisher (organization or individual)
  fhir:ActivityDefinition.contact [ ContactDetail ], ... ; # 0..* Contact details for the publisher

  fhir:ActivityDefinition.description [ markdown ]; # 0..1 Natural language description of the activity definition
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:ActivityDefinition.useContext [ UsageContext ], ... ; # 0..* The context that the content is intended to support

  fhir:ActivityDefinition.jurisdiction [ CodeableConcept ], ... ; # 0..* Intended jurisdiction for activity definition (if applicable)
  fhir:
  fhir:
  fhir:

  fhir:ActivityDefinition.purpose [ markdown ]; # 0..1 Why this activity definition is defined
  fhir:ActivityDefinition.usage [ string ]; # 0..1 Describes the clinical usage of the activity definition

  fhir:ActivityDefinition.copyright [ markdown ]; # 0..1 Use and/or publishing restrictions
  fhir:
  fhir:
  fhir:

  fhir:ActivityDefinition.approvalDate [ date ]; # 0..1 When the activity definition was approved by publisher
  fhir:ActivityDefinition.lastReviewDate [ date ]; # 0..1 When the activity definition was last reviewed
  fhir:ActivityDefinition.effectivePeriod [ Period ]; # 0..1 When the activity definition is expected to be used
  fhir:ActivityDefinition.topic [ CodeableConcept ], ... ; # 0..* E.g. Education, Treatment, Assessment, etc.
  fhir:ActivityDefinition.author [ ContactDetail ], ... ; # 0..* Who authored the content
  fhir:ActivityDefinition.editor [ ContactDetail ], ... ; # 0..* Who edited the content
  fhir:ActivityDefinition.reviewer [ ContactDetail ], ... ; # 0..* Who reviewed the content
  fhir:ActivityDefinition.endorser [ ContactDetail ], ... ; # 0..* Who endorsed the content
  fhir:ActivityDefinition.relatedArtifact [ RelatedArtifact ], ... ; # 0..* Additional documentation, citations, etc.
  fhir:ActivityDefinition.library [ canonical(Library) ], ... ; # 0..* Logic used by the activity definition
  fhir:ActivityDefinition.kind [ code ]; # 0..1 Kind of resource
  fhir:ActivityDefinition.profile [ canonical(StructureDefinition) ]; # 0..1 What profile the resource needs to conform to

  fhir:ActivityDefinition.code [ CodeableConcept ]; # 0..1 Detail type of activity
  # . One of these 4

  fhir:ActivityDefinition.intent [ code ]; # 0..1 proposal | plan | order
  fhir:ActivityDefinition.priority [ code ]; # 0..1 routine | urgent | asap | stat
  fhir:ActivityDefinition.doNotPerform [ boolean ]; # 0..1 True if the activity should not be performed
  # ActivityDefinition.timing[x] : 0..1 When activity is to occur. One of these 6

    fhir:ActivityDefinition.timingTiming [ Timing ]
    fhir:ActivityDefinition.timingDateTime [ dateTime ]
    fhir:ActivityDefinition.timingAge [ Age ]

    fhir:ActivityDefinition.timingPeriod [ Period ]
    fhir:ActivityDefinition.timingRange [ Range ]
    fhir:ActivityDefinition.timingDuration [ Duration ]

  fhir:ActivityDefinition.location [ Reference(Location) ]; # 0..1 Where it should happen
  fhir:ActivityDefinition.participant [ # 0..* Who should participate in the action
    fhir:
    fhir:

    fhir:ActivityDefinition.participant.type [ code ]; # 1..1 patient | practitioner | related-person | device
    fhir:ActivityDefinition.participant.role [ CodeableConcept ]; # 0..1 E.g. Nurse, Surgeon, Parent, etc.

  ], ...;
  # ActivityDefinition.product[x] : 0..1 What's administered/supplied. One of these 2
    fhir:ActivityDefinition.productReference [ Reference(Medication|Substance) ]
    fhir:ActivityDefinition.productCodeableConcept [ CodeableConcept ]
  fhir:ActivityDefinition.quantity [ Quantity(SimpleQuantity) ]; # 0..1 How much is administered/consumed/supplied
  fhir:ActivityDefinition.dosage [ Dosage ], ... ; # 0..* Detailed dosage instructions
  fhir:ActivityDefinition.bodySite [ CodeableConcept ], ... ; # 0..* What part of body to perform on
  fhir:
  fhir:
    fhir:
    fhir:
    fhir:
    fhir:

  fhir:ActivityDefinition.specimenRequirement [ Reference(SpecimenDefinition) ], ... ; # 0..* What specimens are required to perform this action
  fhir:ActivityDefinition.observationRequirement [ Reference(ObservationDefinition) ], ... ; # 0..* What observations are required to perform this action
  fhir:ActivityDefinition.observationResultRequirement [ Reference(ObservationDefinition) ], ... ; # 0..* What observations must be produced by this action
  fhir:ActivityDefinition.transform [ canonical(StructureMap) ]; # 0..1 Transform to apply the template
  fhir:ActivityDefinition.dynamicValue [ # 0..* Dynamic aspects of the definition
    fhir:ActivityDefinition.dynamicValue.path [ string ]; # 1..1 The path to the element to be set dynamically
    fhir:ActivityDefinition.dynamicValue.expression [ Expression ]; # 1..1 An expression that provides the dynamic value for the customization

  ], ...;
]

Changes since DSTU2 Release 3

ActivityDefinition
ActivityDefinition.status
  • Change value set from http://hl7.org/fhir/ValueSet/publication-status|4.0.0 to http://hl7.org/fhir/ValueSet/publication-status|4.1.0
ActivityDefinition.kind
  • Change value set from http://hl7.org/fhir/ValueSet/request-resource-types|4.0.0 to http://hl7.org/fhir/ValueSet/request-resource-types|4.1.0
ActivityDefinition.intent
  • Change value set from http://hl7.org/fhir/ValueSet/request-intent|4.0.0 to http://hl7.org/fhir/ValueSet/request-intent|4.1.0
ActivityDefinition.priority
  • Change value set from http://hl7.org/fhir/ValueSet/request-priority|4.0.0 to http://hl7.org/fhir/ValueSet/request-priority|4.1.0
ActivityDefinition.participant.type
  • Change value set from http://hl7.org/fhir/ValueSet/action-participant-type|4.0.0 to http://hl7.org/fhir/ValueSet/action-participant-type|4.1.0

This resource did not exist in Release 2 See the Full Difference for further information

This analysis is available as XML or JSON .

See R3 <--> R4 Conversion Maps (status = 9 tests that all execute ok. 2 fail round-trip testing and 9 r3 resources are invalid (0 errors). )

 

Alternate See the Profiles & Extensions and the alternate definitions: Master Definition ( XML , + JSON ), , XML Schema / Schematron (for ) + JSON Schema , ShEx (for Turtle ) + see the extensions , the spreadsheet version & the dependency analysis a

Path Definition Type Reference
ActivityDefinition.status The lifecycle status of a Value Set or Concept Map. an artifact. Required PublicationStatus
ActivityDefinition.subject[x] The possible types of subjects for an activity (E.g. Patient, Practitioner, Organization, Location, etc.). Extensible SubjectType
ActivityDefinition.jurisdiction Countries and regions within which this artifact is targeted for use use. Extensible Jurisdiction ValueSet
ActivityDefinition.topic High-level categorization of the definition, used for searching, sorting, and filtering filtering. Example DefinitionTopic
ActivityDefinition.kind The kind of activity the definition is describing describing. Required ResourceType RequestResourceType
ActivityDefinition.code Detailed type of the activity; e.g. CBC CBC. Example Procedure ProcedureCodes(SNOMEDCT)
ActivityDefinition.intent Codes (SNOMED CT) indicating the degree of authority/intentionality associated with a request. Required RequestIntent
ActivityDefinition.priority Identifies the level of importance to be assigned to actioning the request. Required RequestPriority
ActivityDefinition.participant.type The type of participant in the activity activity. Required ActionParticipantType
ActivityDefinition.participant.role Defines roles played by participants for the action action. Example ActionParticipantRole
ActivityDefinition.product[x] Code describing the type of substance or medication medication. Example SNOMED CT Medication Codes SNOMEDCTMedicationCodes
ActivityDefinition.bodySite A code that identifies the anatomical location location. Example SNOMED CT Body Structures SNOMEDCTBodyStructures

id Level Location Description Expression
adf-0 Warning (base) Name should be usable as an identifier for the module by machine processing applications such as code generation name.matches('[A-Z]([A-Za-z0-9_]){0,254}') Realizing

An ActivityDefinition resource provides a description, or template, of an action to performed. These actions can be purely text-based descriptions of the action to be performed, only interpretable by a human user, or they can be structured definitions with enough information to construct a resource to represent the request or activity directly. This process of converting the ActivityDefinition into a specific request resource in a particular context is performed with the $apply operation.

In the simplest case, the process maps the elements specified in the ActivityDefinition to the corresponding elements on the request a resource of the appropriate type, using the kind element of the definition to determine the type of resource to be created.

More dynamic scenarios can be achieved in one of two ways, either by providing dynamicValue expressions, or by specifying a StructureMap that transforms the definition into the appropriate request resource.

Note that systems will likely vary widely in the degree of support they provide for the $apply operation. In particular, the fact that a system supports applying definitions of one category, does not imply that it supports applying definitions for all categories. For example, a service focused on medication order sets may have sophisticated support for MedicationRequest activities, but no support at all for the ProcedureRequest ServiceRequest activities.

The following diagram illustrates the relationship between the PlanDefinition and ActivityDefinition resources, as well as a typical realization application to CarePlan, RequestGroup, and Request resources:

relationship-between-action-and-activity-definition

To accommodate the variability in systems and use cases, this specification is not prescriptive about exactly how an ActivityDefinition is applied to produce target request or event resources. However, the approach depicted above provides a general framework for the process, and the following steps provide more detail on the potential approach:

  1. Create the target resource of the type specified by the kind element and focused on the Patient in context
  2. Set the status of the target resource to Note draft
  3. Apply the structural elements of the ActivityDefinition to implementers: There the target resource such as code , timing , doNotPerform , product , quantity , dosage , and so on
  4. Resolve the participant element based on the user in context
  5. Resolve the location element based on the location in context
  6. If the transform element is some overlap between specified, apply the content transform to the resource. Note that can be specified the referenced StructureMap may actually construct the resource, rather than taking an instance. See the StructureMap for more information
  7. Apply any dynamicValue elements (in the order in which they appear in PlanDefinition.actionDefinition and the ActivityDefinition resource. Part resource) by evaluating the expression and setting the value of the work for FHIR Release 4 will be appropriate element of the target resource (as specified by the dynamicValue.path element)

Note that the parameters to resolve the overlap $apply operation are available within dynamicValue CQL and this will likely result in some minor changes FHIRPath expressions as context variables, accessible by the name of the parameter prefixed with a percent (%) symbol. For example, to access the structures. subject given to the apply, use the expression %subject .

Because the ActivityDefinition resource can be used to describe many different types of request resources, profiles of the resource will be useful in communicating additional constraints and expectations about how the resource should be used in a particular context. For example, a profile of ActivityDefinition may specify that it is intended to describe medication orders within an order set. Such a profile would indicate that the quantity element should not be used, but the dosage element must be.

Search parameters for 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
composed-of reference What resource is being referenced ActivityDefinition.relatedArtifact.where(type='composed-of').resource
(Any)
context token A use context assigned to the activity definition (ActivityDefinition.useContext.value as CodeableConcept)
context-quantity quantity A quantity- or range-valued use context assigned to the activity definition (ActivityDefinition.useContext.value as Quantity) | (ActivityDefinition.useContext.value as Range)
context-type token A type of use context assigned to the activity definition ActivityDefinition.useContext.code
context-type-quantity composite A use context type and quantity- or range-based value assigned to the activity definition On ActivityDefinition.useContext:
  context-type: code
  context-quantity: value.as(Quantity) | value.as(Range)
context-type-value composite A use context type and value assigned to the activity definition On ActivityDefinition.useContext:
  context-type: code
  context: value.as(CodeableConcept)
date date The activity definition publication date ActivityDefinition.date
depends-on reference What resource is being referenced ActivityDefinition.relatedArtifact.where(type='depends-on').resource | ActivityDefinition.library
( Library , Any)
derived-from reference What resource is being referenced ActivityDefinition.relatedArtifact.where(type='derived-from').resource
(Any)
description string The description of the activity definition ActivityDefinition.description
effective date The time during which the activity definition is intended to be in use ActivityDefinition.effectivePeriod
identifier token External identifier for the activity definition ActivityDefinition.identifier
jurisdiction token Intended jurisdiction for the activity definition ActivityDefinition.jurisdiction
name string Computationally friendly name of the activity definition ActivityDefinition.name
predecessor reference What resource is being referenced ActivityDefinition.relatedArtifact.where(type='predecessor').resource
(Any)
publisher string Name of the publisher of the activity definition ActivityDefinition.publisher
status token The current status of the activity definition ActivityDefinition.status
successor reference What resource is being referenced ActivityDefinition.relatedArtifact.where(type='successor').resource
(Any)
title string The human-friendly name of the activity definition ActivityDefinition.title
topic token Topics associated with the module ActivityDefinition.topic
url uri The uri that identifies the activity definition ActivityDefinition.url
version token The business version of the activity definition ActivityDefinition.version