This is the Continuous Integration Build of FHIR (will be incorrect/inconsistent at times).
See the Directory of published versions
FHIR Infrastructure ![]() | Maturity Level: 1 | Trial Use | Security Category: Anonymous | Compartments: No defined compartments |
Provides a definition of an actor - a system, individual, non-system device, or collective - that plays a role in a process, such as data exchange, along with associated obligations.
The ActorDefinition Resource represents an actor that can play the role of a participant in some kind of described process.
ActorDefinitions can be referenced in several places:
Like all canonical resources, ActorDefinitions can be defined, published and managed in ImplementationGuides and used to describe expected capabilities and roles within the IG, but can also be leveraged (via dependencies) by other implementation guides.
Both ActorDefinition and CapabilityStatement> describe 'systems'. However, ActorDefinition does not presume those systems will have FHIR interfaces and does not directly speak to what the systems do, while CapabilityStatement is focused on describing the FHIR interface of a system in terms of exactly what interactions, operations, messages, etc. it can consume and produce. A CapabilityStatement may point to one or more ActorDefinitions to allow expression of the detailed data behaviors associated with a FHIR system.
Device can also be used to represent a 'system', but the concern there is about the metadata such as manufacturer, software version, etc., not the interoperability capabilities or how it integrates with other systems.
Patient, Practitioner, PractitionerRole and RelatedPerson can all represent individual people or animals, which ActorDefinition also does. However ActorDefinition refers to a 'type' of individual, while the others all refer to specific individuals. ActorDefinition is interested in capability, while the other resources are focused on characteristics.
Structure
Name | Flags | Card. | Type | Description & Constraints![]() |
---|---|---|---|---|
![]() ![]() |
TU | DomainResource | A system or non-system participant involved in an information exchange process + 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 Interfaces Implemented: CanonicalResource | |
![]() ![]() ![]() |
ΣC | 0..1 | uri | Canonical identifier for this actor definition, represented as a URI (globally unique) + Warning: URL should not contain | or # - these characters make processing canonical references problematic |
![]() ![]() ![]() |
Σ | 0..* | Identifier | Additional identifier for the actor definition (business identifier) |
![]() ![]() ![]() |
Σ | 0..1 | string | Business version of the actor definition |
![]() ![]() ![]() |
Σ | 0..1 | How to compare versions Binding: Version Algorithm (Extensible) | |
![]() ![]() ![]() ![]() |
string | |||
![]() ![]() ![]() ![]() |
Coding | |||
![]() ![]() ![]() |
ΣC | 0..1 | string | Name for this actor definition (computer friendly) |
![]() ![]() ![]() |
ΣT | 0..1 | string | Name for this actor definition (human friendly) |
![]() ![]() ![]() |
?!Σ | 1..1 | code | draft | active | retired | unknown Binding: PublicationStatus (Required) |
![]() ![]() ![]() |
Σ | 0..1 | boolean | For testing only - never for real usage |
![]() ![]() ![]() |
Σ | 0..1 | dateTime | Date last changed |
![]() ![]() ![]() |
ΣT | 0..1 | string | Name of the publisher/steward (organization or individual) |
![]() ![]() ![]() |
Σ | 0..* | ContactDetail | Contact details for the publisher |
![]() ![]() ![]() |
T | 0..1 | markdown | Natural language description of the actor |
![]() ![]() ![]() |
ΣTU | 0..* | UsageContext | The context that the content is intended to support |
![]() ![]() ![]() |
ΣXD | 0..* | CodeableConcept | Intended jurisdiction for actor definition (if applicable) Binding: Jurisdiction ValueSet (Extensible) |
![]() ![]() ![]() |
T | 0..1 | markdown | Why this actor definition is defined |
![]() ![]() ![]() |
T | 0..1 | markdown | Use and/or publishing restrictions |
![]() ![]() ![]() |
T | 0..1 | string | Copyright holder and year(s) |
![]() ![]() ![]() |
Σ | 1..1 | code | system | non-system | individual | patient | practitioner | related-person | device | collective | care-team | group | healthcare-service | organization Binding: Actor Definition Actor Type (Required) |
![]() ![]() ![]() |
T | 0..1 | markdown | Explanation and details about the actor |
![]() ![]() ![]() |
0..* | url | Reference to more information about the actor | |
![]() ![]() ![]() |
0..* | canonical(ActorDefinition) | Parent actor definition | |
![]() ![]() |
See the Extensions for this resource
UML Diagram (Legend)
XML Template
<ActorDefinition xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <url value="[uri]"/><!-- 0..1 Canonical identifier for this actor definition, represented as a URI (globally unique) --> <identifier><!-- 0..* Identifier Additional identifier for the actor definition (business identifier) --></identifier> <version value="[string]"/><!-- 0..1 Business version of the actor definition --> <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]> <name value="[string]"/><!-- I 0..1 Name for this actor definition (computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this actor definition (human friendly) --> <status value="[code]"/><!-- 1..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- 0..1 For testing only - never for real usage --> <date value="[dateTime]"/><!-- 0..1 Date last changed --> <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- 0..1 Natural language description of the actor --> <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for actor definition (if applicable) --></jurisdiction> <purpose value="[markdown]"/><!-- 0..1 Why this actor definition is defined --> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <copyrightLabel value="[string]"/><!-- 0..1 Copyright holder and year(s) --> <type value="[code]"/><!-- 1..1 system | non-system | individual | patient | practitioner | related-person | device | collective | care-team | group | healthcare-service | organization --> <documentation value="[markdown]"/><!-- 0..1 Explanation and details about the actor --> <reference value="[url]"/><!-- 0..* Reference to more information about the actor --> <baseDefinition><!-- 0..* canonical(ActorDefinition) Parent actor definition --></baseDefinition> </ActorDefinition>
JSON Template
{"resourceType" : "ActorDefinition", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "url" : "<uri>", // Canonical identifier for this actor definition, represented as a URI (globally unique) "identifier" : [{ Identifier }], // Additional identifier for the actor definition (business identifier) "version" : "<string>", // Business version of the actor definition // versionAlgorithm[x]: How to compare versions. One of these 2: "versionAlgorithmString" : "<string>", "versionAlgorithmCoding" : { Coding }, "name" : "<string>", // I Name for this actor definition (computer friendly) "title" : "<string>", // Name for this actor definition (human friendly) "status" : "<code>", // R! draft | active | retired | unknown "experimental" : <boolean>, // For testing only - never for real usage "date" : "<dateTime>", // Date last changed "publisher" : "<string>", // Name of the publisher/steward (organization or individual) "contact" : [{ ContactDetail }], // Contact details for the publisher "description" : "<markdown>", // Natural language description of the actor "useContext" : [{ UsageContext }], // The context that the content is intended to support "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for actor definition (if applicable) "purpose" : "<markdown>", // Why this actor definition is defined "copyright" : "<markdown>", // Use and/or publishing restrictions "copyrightLabel" : "<string>", // Copyright holder and year(s) "type" : "<code>", // R! system | non-system | individual | patient | practitioner | related-person | device | collective | care-team | group | healthcare-service | organization "documentation" : "<markdown>", // Explanation and details about the actor "reference" : ["<url>"], // Reference to more information about the actor "baseDefinition" : ["<canonical(ActorDefinition)>"] // Parent actor definition }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:ActorDefinition; 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:url [ uri ] ; # 0..1 Canonical identifier for this actor definition, represented as a URI (globally unique) fhir:identifier ( [ Identifier ] ... ) ; # 0..* Additional identifier for the actor definition (business identifier) fhir:version [ string ] ; # 0..1 Business version of the actor definition # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2 fhir:versionAlgorithm [ a fhir:string ; string ] fhir:versionAlgorithm [ a fhir:Coding ; Coding ] fhir:name [ string ] ; # 0..1 I Name for this actor definition (computer friendly) fhir:title [ string ] ; # 0..1 Name for this actor definition (human friendly) fhir:status [ code ] ; # 1..1 draft | active | retired | unknown fhir:experimental [ boolean ] ; # 0..1 For testing only - never for real usage fhir:date [ dateTime ] ; # 0..1 Date last changed fhir:publisher [ string ] ; # 0..1 Name of the publisher/steward (organization or individual) fhir:contact ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher fhir:description [ markdown ] ; # 0..1 Natural language description of the actor fhir:useContext ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support fhir:jurisdiction ( [ CodeableConcept ] ... ) ; # 0..* Intended jurisdiction for actor definition (if applicable) fhir:purpose [ markdown ] ; # 0..1 Why this actor definition is defined fhir:copyright [ markdown ] ; # 0..1 Use and/or publishing restrictions fhir:copyrightLabel [ string ] ; # 0..1 Copyright holder and year(s) fhir:type [ code ] ; # 1..1 system | non-system | individual | patient | practitioner | related-person | device | collective | care-team | group | healthcare-service | organization fhir:documentation [ markdown ] ; # 0..1 Explanation and details about the actor fhir:reference ( [ url ] ... ) ; # 0..* Reference to more information about the actor fhir:baseDefinition ( [ canonical(ActorDefinition) ] ... ) ; # 0..* Parent actor definition ]
Changes from both R4 and R4B
This resource did not exist in Release R4
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.
Structure
Name | Flags | Card. | Type | Description & Constraints![]() |
---|---|---|---|---|
![]() ![]() |
TU | DomainResource | A system or non-system participant involved in an information exchange process + 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 Interfaces Implemented: CanonicalResource | |
![]() ![]() ![]() |
ΣC | 0..1 | uri | Canonical identifier for this actor definition, represented as a URI (globally unique) + Warning: URL should not contain | or # - these characters make processing canonical references problematic |
![]() ![]() ![]() |
Σ | 0..* | Identifier | Additional identifier for the actor definition (business identifier) |
![]() ![]() ![]() |
Σ | 0..1 | string | Business version of the actor definition |
![]() ![]() ![]() |
Σ | 0..1 | How to compare versions Binding: Version Algorithm (Extensible) | |
![]() ![]() ![]() ![]() |
string | |||
![]() ![]() ![]() ![]() |
Coding | |||
![]() ![]() ![]() |
ΣC | 0..1 | string | Name for this actor definition (computer friendly) |
![]() ![]() ![]() |
ΣT | 0..1 | string | Name for this actor definition (human friendly) |
![]() ![]() ![]() |
?!Σ | 1..1 | code | draft | active | retired | unknown Binding: PublicationStatus (Required) |
![]() ![]() ![]() |
Σ | 0..1 | boolean | For testing only - never for real usage |
![]() ![]() ![]() |
Σ | 0..1 | dateTime | Date last changed |
![]() ![]() ![]() |
ΣT | 0..1 | string | Name of the publisher/steward (organization or individual) |
![]() ![]() ![]() |
Σ | 0..* | ContactDetail | Contact details for the publisher |
![]() ![]() ![]() |
T | 0..1 | markdown | Natural language description of the actor |
![]() ![]() ![]() |
ΣTU | 0..* | UsageContext | The context that the content is intended to support |
![]() ![]() ![]() |
ΣXD | 0..* | CodeableConcept | Intended jurisdiction for actor definition (if applicable) Binding: Jurisdiction ValueSet (Extensible) |
![]() ![]() ![]() |
T | 0..1 | markdown | Why this actor definition is defined |
![]() ![]() ![]() |
T | 0..1 | markdown | Use and/or publishing restrictions |
![]() ![]() ![]() |
T | 0..1 | string | Copyright holder and year(s) |
![]() ![]() ![]() |
Σ | 1..1 | code | system | non-system | individual | patient | practitioner | related-person | device | collective | care-team | group | healthcare-service | organization Binding: Actor Definition Actor Type (Required) |
![]() ![]() ![]() |
T | 0..1 | markdown | Explanation and details about the actor |
![]() ![]() ![]() |
0..* | url | Reference to more information about the actor | |
![]() ![]() ![]() |
0..* | canonical(ActorDefinition) | Parent actor definition | |
![]() ![]() |
See the Extensions for this resource
XML Template
<ActorDefinition xmlns="http://hl7.org/fhir"><!-- from Resource: id, meta, implicitRules, and language --> <!-- from DomainResource: text, contained, extension, and modifierExtension --> <url value="[uri]"/><!-- 0..1 Canonical identifier for this actor definition, represented as a URI (globally unique) --> <identifier><!-- 0..* Identifier Additional identifier for the actor definition (business identifier) --></identifier> <version value="[string]"/><!-- 0..1 Business version of the actor definition --> <versionAlgorithm[x]><!-- 0..1 string|Coding How to compare versions --></versionAlgorithm[x]> <name value="[string]"/><!-- I 0..1 Name for this actor definition (computer friendly) --> <title value="[string]"/><!-- 0..1 Name for this actor definition (human friendly) --> <status value="[code]"/><!-- 1..1 draft | active | retired | unknown --> <experimental value="[boolean]"/><!-- 0..1 For testing only - never for real usage --> <date value="[dateTime]"/><!-- 0..1 Date last changed --> <publisher value="[string]"/><!-- 0..1 Name of the publisher/steward (organization or individual) --> <contact><!-- 0..* ContactDetail Contact details for the publisher --></contact> <description value="[markdown]"/><!-- 0..1 Natural language description of the actor --> <useContext><!-- 0..* UsageContext The context that the content is intended to support --></useContext> <jurisdiction><!-- 0..* CodeableConcept Intended jurisdiction for actor definition (if applicable) --></jurisdiction> <purpose value="[markdown]"/><!-- 0..1 Why this actor definition is defined --> <copyright value="[markdown]"/><!-- 0..1 Use and/or publishing restrictions --> <copyrightLabel value="[string]"/><!-- 0..1 Copyright holder and year(s) --> <type value="[code]"/><!-- 1..1 system | non-system | individual | patient | practitioner | related-person | device | collective | care-team | group | healthcare-service | organization --> <documentation value="[markdown]"/><!-- 0..1 Explanation and details about the actor --> <reference value="[url]"/><!-- 0..* Reference to more information about the actor --> <baseDefinition><!-- 0..* canonical(ActorDefinition) Parent actor definition --></baseDefinition> </ActorDefinition>
JSON Template
{"resourceType" : "ActorDefinition", // from Resource: id, meta, implicitRules, and language // from DomainResource: text, contained, extension, and modifierExtension "url" : "<uri>", // Canonical identifier for this actor definition, represented as a URI (globally unique) "identifier" : [{ Identifier }], // Additional identifier for the actor definition (business identifier) "version" : "<string>", // Business version of the actor definition // versionAlgorithm[x]: How to compare versions. One of these 2: "versionAlgorithmString" : "<string>", "versionAlgorithmCoding" : { Coding }, "name" : "<string>", // I Name for this actor definition (computer friendly) "title" : "<string>", // Name for this actor definition (human friendly) "status" : "<code>", // R! draft | active | retired | unknown "experimental" : <boolean>, // For testing only - never for real usage "date" : "<dateTime>", // Date last changed "publisher" : "<string>", // Name of the publisher/steward (organization or individual) "contact" : [{ ContactDetail }], // Contact details for the publisher "description" : "<markdown>", // Natural language description of the actor "useContext" : [{ UsageContext }], // The context that the content is intended to support "jurisdiction" : [{ CodeableConcept }], // Intended jurisdiction for actor definition (if applicable) "purpose" : "<markdown>", // Why this actor definition is defined "copyright" : "<markdown>", // Use and/or publishing restrictions "copyrightLabel" : "<string>", // Copyright holder and year(s) "type" : "<code>", // R! system | non-system | individual | patient | practitioner | related-person | device | collective | care-team | group | healthcare-service | organization "documentation" : "<markdown>", // Explanation and details about the actor "reference" : ["<url>"], // Reference to more information about the actor "baseDefinition" : ["<canonical(ActorDefinition)>"] // Parent actor definition }
Turtle Template
@prefix fhir: <http://hl7.org/fhir/> .[ a fhir:ActorDefinition; 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:url [ uri ] ; # 0..1 Canonical identifier for this actor definition, represented as a URI (globally unique) fhir:identifier ( [ Identifier ] ... ) ; # 0..* Additional identifier for the actor definition (business identifier) fhir:version [ string ] ; # 0..1 Business version of the actor definition # versionAlgorithm[x] : 0..1 How to compare versions. One of these 2 fhir:versionAlgorithm [ a fhir:string ; string ] fhir:versionAlgorithm [ a fhir:Coding ; Coding ] fhir:name [ string ] ; # 0..1 I Name for this actor definition (computer friendly) fhir:title [ string ] ; # 0..1 Name for this actor definition (human friendly) fhir:status [ code ] ; # 1..1 draft | active | retired | unknown fhir:experimental [ boolean ] ; # 0..1 For testing only - never for real usage fhir:date [ dateTime ] ; # 0..1 Date last changed fhir:publisher [ string ] ; # 0..1 Name of the publisher/steward (organization or individual) fhir:contact ( [ ContactDetail ] ... ) ; # 0..* Contact details for the publisher fhir:description [ markdown ] ; # 0..1 Natural language description of the actor fhir:useContext ( [ UsageContext ] ... ) ; # 0..* The context that the content is intended to support fhir:jurisdiction ( [ CodeableConcept ] ... ) ; # 0..* Intended jurisdiction for actor definition (if applicable) fhir:purpose [ markdown ] ; # 0..1 Why this actor definition is defined fhir:copyright [ markdown ] ; # 0..1 Use and/or publishing restrictions fhir:copyrightLabel [ string ] ; # 0..1 Copyright holder and year(s) fhir:type [ code ] ; # 1..1 system | non-system | individual | patient | practitioner | related-person | device | collective | care-team | group | healthcare-service | organization fhir:documentation [ markdown ] ; # 0..1 Explanation and details about the actor fhir:reference ( [ url ] ... ) ; # 0..* Reference to more information about the actor fhir:baseDefinition ( [ canonical(ActorDefinition) ] ... ) ; # 0..* Parent actor definition ]
Changes from both R4 and R4B
This resource did not exist in Release R4
See the Full Difference for further information
This analysis is available for R4 as XML or JSON and for R4B as XML or JSON.
Additional definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) , the spreadsheet version & the dependency analysis
Path | ValueSet | Type | Documentation |
---|---|---|---|
ActorDefinition.versionAlgorithm[x] | VersionAlgorithm | Extensible | Indicates the mechanism used to compare versions to determine which is more current. |
ActorDefinition.status | PublicationStatus | Required | The lifecycle status of an artifact. |
ActorDefinition.jurisdiction | JurisdictionValueSet | Extensible | This value set defines a base set of codes for country, country subdivision and region for indicating where a resource is intended to be used. Note: The codes for countries and country subdivisions are taken from ISO 3166 |
ActorDefinition.type | ActorDefinitionActorType | Required | The type of actor - system or human. |
UniqueKey | Level | Location | Description | Expression |
![]() | Warning | (base) | Name should be usable as an identifier for the module by machine processing applications such as code generation | name.exists() implies name.matches('^[A-Z]([A-Za-z0-9_]){1,254}$') |
![]() | Warning | ActorDefinition.url | URL should not contain | or # - these characters make processing canonical references problematic | exists() implies matches('^[^|# ]+$') |
Search parameters for this resource. See also the full list of search parameters for this resource, and check the Extensions registry for search parameters on extensions related to this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.
Name | Type | Description | Expression | In Common |
context | token | A use context assigned to the Actor Definition | (ActorDefinition.useContext.value.ofType(CodeableConcept)) | 30 Resources |
context-quantity | quantity | A quantity- or range-valued use context assigned to the Actor Definition | (ActorDefinition.useContext.value.ofType(Quantity)) | (ActorDefinition.useContext.value.ofType(Range)) | 30 Resources |
context-type | token | A type of use context assigned to the Actor Definition | ActorDefinition.useContext.code | 30 Resources |
context-type-quantity | composite | A use context type and quantity- or range-based value assigned to the Actor Definition | On ActorDefinition.useContext: context-type: code context-quantity: value.ofType(Quantity) | value.ofType(Range) |
30 Resources |
context-type-value | composite | A use context type and value assigned to the Actor Definition | On ActorDefinition.useContext: context-type: code context: value.ofType(CodeableConcept) |
30 Resources |
date | date | The Actor Definition publication date | ActorDefinition.date | 31 Resources |
description | string | The description of the Actor Definition | ActorDefinition.description | 29 Resources |
identifier | token | External identifier for the Actor Definition | ActorDefinition.identifier | 35 Resources |
jurisdiction | token | Intended jurisdiction for the Actor Definition | ActorDefinition.jurisdiction | 27 Resources |
publisher | string | Name of the publisher of the Actor Definition | ActorDefinition.publisher | 31 Resources |
status | token | The current status of the Actor Definition | ActorDefinition.status | 35 Resources |
title | string | The human-friendly name of the Actor Definition | ActorDefinition.title | 28 Resources |
type | token | The type of actor | ActorDefinition.type | |
url | uri | The uri that identifies the Actor Definition | ActorDefinition.url | 34 Resources |
version | token | The business version of the Actor Definition | ActorDefinition.version | 32 Resources |