3.2. FHIR profiles
3.2.1. Task-specific profiles
The following FHIR profiles have been introduced for the ProviderTask standard:
| CIM (concept) | FHIR resource | FHIR profile |
|---|---|---|
| Task | Task | pt-Task |
| ActivityDefinition | ActivityDefinition | pt-ActivityDefinition |
| ServiceRequest | ServiceRequest | pt-ServiceRequest |
| Endpoint | Endpoint | pt-Endpoint |
Table 1: Relevant pathology-specific profiles
Note the following:
- The Nictiz Profiling Guidelines for FHIR R4 have been used as guidelines for creating the profiles.
- The (element) descriptions present in the profiles are taken from the respective Logical Model the mapped concept originates from.
- The 'open world' modeling approach is adopted as much as possible. Notable exceptions are cardinalities that have been restricted based on the functional dataset of the MedMij use case, such as several minimum cardinalities.
In Figure 1, the profiles listed above are visualized, as well as the relations between them.
Could not find subject. File not found for 'subject=guides/medmij-r4-pathology-ig/images/Overview FHIR profiles.png'
Figure 1: Overview of FHIR profiles
3.2.2. Other profiles
FHIR R4 conformance resources developed by Nictiz (based on zib publication 2020) from the nl-core 0.12.0-beta.4 package are used and referenced where possible. In particular, the zibs and corresponding nl-core profiles collected in the table below are used.
| Zib | FHIR resource | FHIR profile |
|---|---|---|
| Patient | Patient | nl-core-patient |
| HealthProfessional | PractitionerRole Practitioner |
nl-core-HealthProfessional-PractitionerRole nl-core-HealthProfessional-Practitioner |
| HealthcareProvider | Location Organization |
nl-core-HealthcareProvider nl-core-HealthcareProvider-Organization |
Table 1: Relevant nl-core profiles
Note the following:
- Each occurrence of the zib HealthProfessional is normally represented by two FHIR resources: a PractitionerRole resource (instance of nl-core-HealthProfessional-PractitionerRole) and a Practitioner resource (instance of nl-core-HealthProfessional-Practitioner). The Practitioner resource is referenced from the PractitionerRole instance. For this reason, sending systems should fill the reference to the PractitionerRole instance where relevant, and not the Practitioner resource. Receiving systems can then retrieve the reference to the Practitioner resource from that PractitionerRole instance. In rare circumstances, there is only a Practitioner instance, in which case it is that instance which will be referenced instead. However, since this should be the exception, the nl-core-HealthProfessional-Practitioner profile is never explicitly mentioned as a target profile. This is in line with the Nictiz Profiling Guidelines for FHIR R4.
3.2.1. Report
| ProviderTasksTask (Task) | C | Task | |
| id | Σ | 0..1 | string |
| meta | Σ | 0..1 | Meta |
| implicitRules | Σ ?! | 0..1 | uri |
| language | 0..1 | codeBinding | |
| text | 0..1 | Narrative | |
| contained | 0..* | Resource | |
| extension | C | 0..* | Extension |
| resource-origin | C | 0..* | Extension |
| instantiates | C | 0..* | Extension |
| modifierExtension | ?! C | 0..* | Extension |
| identifier | 1..* | Identifier | |
| instantiatesCanonical | Σ | 0..1 | canonical(ActivityDefinition) |
| instantiatesUri | Σ | 0..1 | uri |
| basedOn | Σ C | 0..* | Reference(Resource) |
| groupIdentifier | Σ | 0..1 | Identifier |
| partOf | Σ C | 0..* | Reference(ProviderTasksTask) |
| status | Σ ?! | 1..1 | codeBinding |
| statusReason | Σ | 0..1 | CodeableConcept |
| businessStatus | Σ | 0..1 | CodeableConcept |
| intent | Σ | 1..1 | codeBinding |
| priority | 0..1 | codeBinding | |
| code | Σ | 0..1 | CodeableConcept |
| description | Σ | 0..1 | string |
| focus | Σ C | 0..1 | Reference(Resource) |
| for | Σ C | 1..1 | Reference(http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient) |
| encounter | Σ C | 0..1 | Reference(Encounter) |
| executionPeriod | Σ C | 0..1 | Period |
| authoredOn | C | 0..1 | dateTime |
| lastModified | Σ C | 0..1 | dateTime |
| requester | Σ C | 0..1 | Reference(Device | Organization | Practitioner | PractitionerRole | RelatedPerson | http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole) |
| performerType | 0..* | CodeableConceptBinding | |
| owner | Σ C | 1..1 | Reference(CareTeam | Device | HealthcareService | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson | http://nictiz.nl/fhir/StructureDefinition/nl-core-CareTeam | http://nictiz.nl/fhir/StructureDefinition/nl-core-ContactPerson | http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole | http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient) |
| location | Σ C | 0..1 | Reference(Location) |
| reasonCode | 0..1 | CodeableConcept | |
| reasonReference | C | 0..1 | Reference(Resource) |
| insurance | C | 0..* | Reference(ClaimResponse | Coverage) |
| note | 0..* | Annotation | |
| relevantHistory | C | 0..* | Reference(Provenance) |
| restriction | 0..1 | BackboneElement | |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| modifierExtension | Σ ?! C | 0..* | Extension |
| repetitions | 0..1 | positiveInt | |
| period | C | 0..1 | Period |
| recipient | C | 0..* | Reference(Group | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson) |
| input | 0..* | BackboneElement | |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| modifierExtension | Σ ?! C | 0..* | Extension |
| type | 1..1 | CodeableConcept | |
| value[x] | 1..1 | ||
| valueAddress | Address | ||
| valueAge | Age | ||
| valueAnnotation | Annotation | ||
| valueAttachment | Attachment | ||
| valueBase64Binary | base64Binary | ||
| valueBoolean | boolean | ||
| valueCanonical | canonical | ||
| valueCode | code | ||
| valueCodeableConcept | CodeableConcept | ||
| valueCoding | Coding | ||
| valueContactDetail | ContactDetail | ||
| valueContactPoint | ContactPoint | ||
| valueContributor | Contributor | ||
| valueCount | Count | ||
| valueDataRequirement | DataRequirement | ||
| valueDate | date | ||
| valueDateTime | dateTime | ||
| valueDecimal | decimal | ||
| valueDistance | Distance | ||
| valueDosage | Dosage | ||
| valueDuration | Duration | ||
| valueExpression | Expression | ||
| valueHumanName | HumanName | ||
| valueId | id | ||
| valueIdentifier | Identifier | ||
| valueInstant | instant | ||
| valueInteger | integer | ||
| valueMarkdown | markdown | ||
| valueMeta | Meta | ||
| valueMoney | Money | ||
| valueOid | oid | ||
| valueParameterDefinition | ParameterDefinition | ||
| valuePeriod | Period | ||
| valuePositiveInt | positiveInt | ||
| valueQuantity | Quantity | ||
| valueRange | Range | ||
| valueRatio | Ratio | ||
| valueReference | Reference | ||
| valueRelatedArtifact | RelatedArtifact | ||
| valueSampledData | SampledData | ||
| valueSignature | Signature | ||
| valueString | string | ||
| valueTime | time | ||
| valueTiming | Timing | ||
| valueTriggerDefinition | TriggerDefinition | ||
| valueUnsignedInt | unsignedInt | ||
| valueUri | uri | ||
| valueUrl | url | ||
| valueUsageContext | UsageContext | ||
| valueUuid | uuid | ||
| output | 0..* | BackboneElement | |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| modifierExtension | Σ ?! C | 0..* | Extension |
| type | 1..1 | CodeableConcept | |
| value[x] | 1..1 | ||
| valueAddress | Address | ||
| valueAge | Age | ||
| valueAnnotation | Annotation | ||
| valueAttachment | Attachment | ||
| valueBase64Binary | base64Binary | ||
| valueBoolean | boolean | ||
| valueCanonical | canonical | ||
| valueCode | code | ||
| valueCodeableConcept | CodeableConcept | ||
| valueCoding | Coding | ||
| valueContactDetail | ContactDetail | ||
| valueContactPoint | ContactPoint | ||
| valueContributor | Contributor | ||
| valueCount | Count | ||
| valueDataRequirement | DataRequirement | ||
| valueDate | date | ||
| valueDateTime | dateTime | ||
| valueDecimal | decimal | ||
| valueDistance | Distance | ||
| valueDosage | Dosage | ||
| valueDuration | Duration | ||
| valueExpression | Expression | ||
| valueHumanName | HumanName | ||
| valueId | id | ||
| valueIdentifier | Identifier | ||
| valueInstant | instant | ||
| valueInteger | integer | ||
| valueMarkdown | markdown | ||
| valueMeta | Meta | ||
| valueMoney | Money | ||
| valueOid | oid | ||
| valueParameterDefinition | ParameterDefinition | ||
| valuePeriod | Period | ||
| valuePositiveInt | positiveInt | ||
| valueQuantity | Quantity | ||
| valueRange | Range | ||
| valueRatio | Ratio | ||
| valueReference | Reference | ||
| valueRelatedArtifact | RelatedArtifact | ||
| valueSampledData | SampledData | ||
| valueSignature | Signature | ||
| valueString | string | ||
| valueTime | time | ||
| valueTiming | Timing | ||
| valueTriggerDefinition | TriggerDefinition | ||
| valueUnsignedInt | unsignedInt | ||
| valueUri | uri | ||
| valueUrl | url | ||
| valueUsageContext | UsageContext | ||
| valueUuid | uuid |
--- We have skipped the narrative for better readability of the resource ---
</text>
</telecom>
</contact>
<description value="This (FHIR) Task profile describes a patient-specific actionable item, intended to be presented to the patient in a client application (e.g., a PGO) and/or processed within the Koppeltaal workflow. It may optionally reference an ActivityDefinition that defines what should be launched or performed (module, questionnaire, information, measurement)." />
<purpose value="This profile represents a patient-specific actionable item, intended to be presented to the patient in a client application (e.g., a PGO) and/or processed in the Koppeltaal workflow, optionally instantiating an ActivityDefinition that can be launched or performed (module, questionnaire, information, measurement)." />
<copyright value="Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise." />
<definition value="A patient-specific actionable item, assigned to the patient and optionally linked to an ActivityDefinition describing what to launch or perform." />
</element>
</discriminator>
</slicing>
<definition value="A link to the ActivityDefinition that defines the launchable eHealth activity (i.e., what module/content should be launched or performed) associated with this Task. In both MedMij and Koppeltaal implementations, this link is carried using the Koppeltaal instantiates extension." />
</element>
</element>
</discriminator>
</slicing>
</element>
</type>
</element>
</type>
</element>
</type>
</element>
</element>
<definition value="An identifier that links together multiple tasks and other requests that were created in the same context. The groupIdentifier (system/value pair) can be used to group and filter related Tasks (e.g., all tasks belonging to the same digital activity or workflow package). In this profile, groupIdentifier.type.text is used to provide a human-readable group label for display in the PGO." />
</element>
</type>
</element>
<definition value="A free-text description of what is to be performed. Implementers should ensure the text is readable on mobile applications." />
</element>
<definition value="The patient who benefits from the performance of the service specified in the task." />
<comment value="In this profile, this element always refers to the patient for whom the task is intended." />
<requirements value="Used to track tasks outstanding for a beneficiary. Do not use to track the task owner or creator (see owner and creator respectively). This can also affect access control." />
</type>
</element>
<definition value="In Koppeltaal this element contains a reference to the person requesting the eHealth Task" />
<comment value="Each occurrence of the zib HealthProfessional is normally represented by _two_ FHIR resources: a PractitionerRole resource (instance of [nl-core-HealthProfessional-PractitionerRole](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole)) and a Practitioner resource (instance of [nl-core-HealthProfessional-Practitioner](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner)). The Practitioner resource is referenced from the PractitionerRole instance. For this reason, sending systems should fill the reference to the PractitionerRole instance here, and not the Practitioner resource. Receiving systems can then retrieve the reference to the Practitioner resource from that PractitionerRole instance.\n\nIn rare circumstances, there is only a Practitioner instance, in which case it is that instance which will be referenced here. However, since this should be the exception, the nl-core-HealthProfessional-Practitioner profile is not explicitly mentioned as a target profile." />
<targetProfile value="http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole" />
</type>
</element>
<definition value="Practitioner, CareTeam, RelatedPerson or Patient currently responsible for task execution." />
<comment value="For Koppeltaal: In Koppeltaal the patient is usually the person who executes the task. Note, this element is not intended to be used for access restriction. That is left to the relevant applications.\n\nEach occurrence of the zib HealthProfessional is normally represented by two FHIR resources: a PractitionerRole resource (instance of [nl-core-HealthProfessional-PractitionerRole](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole)) and a Practitioner resource (instance of [nl-core-HealthProfessional-Practitioner](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner)). The Practitioner resource is referenced from the PractitionerRole instance. For this reason, sending systems should fill the reference to the PractitionerRole instance here, and not the Practitioner resource. Receiving systems can then retrieve the reference to the Practitioner resource from that PractitionerRole instance.\n\nIn rare circumstances, there is only a Practitioner instance, in which case it is that instance which will be referenced here. However, since this should be the exception, the nl-core-HealthProfessional-Practitioner profile is not explicitly mentioned as a target profile.\n\n In ProviderTasks, the owner is typically the performer of the task (usually the patient), but execution may also be delegated to another responsible party such as a caregiver/contact person or a care team." />
<targetProfile value="http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole" />
</type>
</element>
</differential>
</StructureDefinition>
{
--- We have skipped the narrative for better readability of the resource ---
},
{
}
],
"description": "This (FHIR) Task profile describes a patient-specific actionable item, intended to be presented to the patient in a client application (e.g., a PGO) and/or processed within the Koppeltaal workflow. It may optionally reference an ActivityDefinition that defines what should be launched or performed (module, questionnaire, information, measurement).",
"purpose": "This profile represents a patient-specific actionable item, intended to be presented to the patient in a client application (e.g., a PGO) and/or processed in the Koppeltaal workflow, optionally instantiating an ActivityDefinition that can be launched or performed (module, questionnaire, information, measurement).",
"copyright": "Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise.",
{
"definition": "A patient-specific actionable item, assigned to the patient and optionally linked to an ActivityDefinition describing what to launch or perform.",
"Taak"
]
},
{
},
"definition": "A link to the ActivityDefinition that defines the launchable eHealth activity (i.e., what module/content should be launched or performed) associated with this Task. In both MedMij and Koppeltaal implementations, this link is carried using the Koppeltaal instantiates extension."
},
{
},
{
}
},
{
{
"http://medmij.nl/fhir/StructureDefinition/pt-ActivityDefinition"
]
}
]
},
{
{
}
]
},
{
]
},
{
},
{
"definition": "An identifier that links together multiple tasks and other requests that were created in the same context. The groupIdentifier (system/value pair) can be used to group and filter related Tasks (e.g., all tasks belonging to the same digital activity or workflow package). In this profile, groupIdentifier.type.text is used to provide a human-readable group label for display in the PGO."
},
{
]
},
{
"definition": "A free-text description of what is to be performed. Implementers should ensure the text is readable on mobile applications."
},
{
"definition": "The patient who benefits from the performance of the service specified in the task.",
"comment": "In this profile, this element always refers to the patient for whom the task is intended.",
"requirements": "Used to track tasks outstanding for a beneficiary. Do not use to track the task owner or creator (see owner and creator respectively). This can also affect access control.",
{
"http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient"
]
}
]
},
{
"definition": "In Koppeltaal this element contains a reference to the person requesting the eHealth Task",
"comment": "Each occurrence of the zib HealthProfessional is normally represented by _two_ FHIR resources: a PractitionerRole resource (instance of [nl-core-HealthProfessional-PractitionerRole](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole)) and a Practitioner resource (instance of [nl-core-HealthProfessional-Practitioner](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner)). The Practitioner resource is referenced from the PractitionerRole instance. For this reason, sending systems should fill the reference to the PractitionerRole instance here, and not the Practitioner resource. Receiving systems can then retrieve the reference to the Practitioner resource from that PractitionerRole instance.\n\nIn rare circumstances, there is only a Practitioner instance, in which case it is that instance which will be referenced here. However, since this should be the exception, the nl-core-HealthProfessional-Practitioner profile is not explicitly mentioned as a target profile.",
{
"http://hl7.org/fhir/StructureDefinition/Device",
"http://hl7.org/fhir/StructureDefinition/Organization",
"http://hl7.org/fhir/StructureDefinition/Practitioner",
"http://hl7.org/fhir/StructureDefinition/PractitionerRole",
"http://hl7.org/fhir/StructureDefinition/RelatedPerson",
"http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole"
]
}
]
},
{
"definition": "Practitioner, CareTeam, RelatedPerson or Patient currently responsible for task execution.",
"comment": "For Koppeltaal: In Koppeltaal the patient is usually the person who executes the task. Note, this element is not intended to be used for access restriction. That is left to the relevant applications.\n\nEach occurrence of the zib HealthProfessional is normally represented by two FHIR resources: a PractitionerRole resource (instance of [nl-core-HealthProfessional-PractitionerRole](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole)) and a Practitioner resource (instance of [nl-core-HealthProfessional-Practitioner](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner)). The Practitioner resource is referenced from the PractitionerRole instance. For this reason, sending systems should fill the reference to the PractitionerRole instance here, and not the Practitioner resource. Receiving systems can then retrieve the reference to the Practitioner resource from that PractitionerRole instance.\n\nIn rare circumstances, there is only a Practitioner instance, in which case it is that instance which will be referenced here. However, since this should be the exception, the nl-core-HealthProfessional-Practitioner profile is not explicitly mentioned as a target profile.\n\n In ProviderTasks, the owner is typically the performer of the task (usually the patient), but execution may also be delegated to another responsible party such as a caregiver/contact person or a care team.",
{
"http://hl7.org/fhir/StructureDefinition/Practitioner",
"http://hl7.org/fhir/StructureDefinition/PractitionerRole",
"http://hl7.org/fhir/StructureDefinition/Organization",
"http://hl7.org/fhir/StructureDefinition/CareTeam",
"http://hl7.org/fhir/StructureDefinition/HealthcareService",
"http://hl7.org/fhir/StructureDefinition/Patient",
"http://hl7.org/fhir/StructureDefinition/Device",
"http://hl7.org/fhir/StructureDefinition/RelatedPerson",
"http://nictiz.nl/fhir/StructureDefinition/nl-core-CareTeam",
"http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient",
"http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole",
"http://nictiz.nl/fhir/StructureDefinition/nl-core-ContactPerson"
]
}
]
}
]
}
}
3.2.2. Report
| ProviderTasksActivityDefinition (ActivityDefinition) | C | ActivityDefinition | |
| id | Σ | 0..1 | string |
| meta | Σ | 0..1 | Meta |
| implicitRules | Σ ?! | 0..1 | uri |
| language | 0..1 | codeBinding | |
| text | 0..1 | Narrative | |
| contained | 0..* | Resource | |
| extension | C | 1..* | Extension |
| resource-origin | C | 0..* | Extension |
| endpoint | C | 1..* | Extension |
| publisherId | C | 0..* | Extension |
| modifierExtension | ?! C | 0..* | Extension |
| url | Σ | 0..1 | uri |
| identifier | Σ | 0..* | Identifier |
| version | Σ | 0..1 | string |
| name | Σ C | 0..1 | string |
| title | Σ | 1..1 | string |
| subtitle | 0..1 | string | |
| status | Σ ?! | 1..1 | codeBinding |
| experimental | Σ | 0..1 | boolean |
| subject[x] | 0..1 | Binding | |
| subjectCodeableConcept | CodeableConcept | ||
| subjectReference | Reference(Group) | ||
| date | Σ | 0..1 | dateTime |
| publisher | Σ | 0..1 | string |
| contact | Σ | 0..* | ContactDetail |
| description | Σ | 0..1 | markdown |
| useContext | Σ | 0..* | UsageContext |
| jurisdiction | Σ | 0..* | CodeableConceptBinding |
| purpose | 0..1 | markdown | |
| usage | 0..1 | string | |
| copyright | 0..1 | markdown | |
| approvalDate | 0..1 | date | |
| lastReviewDate | 0..1 | date | |
| effectivePeriod | Σ C | 0..1 | Period |
| topic | 0..* | CodeableConceptBinding | |
| author | 0..* | ContactDetail | |
| editor | 0..* | ContactDetail | |
| reviewer | 0..* | ContactDetail | |
| endorser | 0..* | ContactDetail | |
| relatedArtifact | 0..* | RelatedArtifact | |
| library | 0..* | canonical(Library) | |
| kind | Σ | 0..1 | codeBinding |
| profile | 0..1 | canonical(StructureDefinition) | |
| code | Σ | 0..1 | CodeableConcept |
| intent | 0..1 | codeBinding | |
| priority | 0..1 | codeBinding | |
| doNotPerform | Σ ?! | 0..1 | boolean |
| timing[x] | 0..1 | ||
| timingAge | Age | ||
| timingDateTime | dateTime | ||
| timingDuration | Duration | ||
| timingPeriod | Period | ||
| timingRange | Range | ||
| timingTiming | Timing | ||
| location | C | 0..1 | Reference(Location) |
| participant | 0..* | BackboneElement | |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| modifierExtension | Σ ?! C | 0..* | Extension |
| type | 1..1 | codeBinding | |
| role | 0..1 | CodeableConcept | |
| product[x] | 0..1 | ||
| productCodeableConcept | CodeableConcept | ||
| productReference | Reference(Medication | Substance) | ||
| quantity | C | 0..1 | SimpleQuantity |
| dosage | 0..* | Dosage | |
| bodySite | 0..* | CodeableConcept | |
| specimenRequirement | C | 0..* | Reference(SpecimenDefinition) |
| observationRequirement | C | 0..* | Reference(ObservationDefinition) |
| observationResultRequirement | C | 0..* | Reference(ObservationDefinition) |
| transform | 0..1 | canonical(StructureMap) | |
| dynamicValue | 0..* | BackboneElement | |
| id | 0..1 | string | |
| extension | C | 0..* | Extension |
| modifierExtension | Σ ?! C | 0..* | Extension |
| path | 1..1 | string | |
| expression | C | 1..1 | Expression |
</telecom>
</contact>
<description value="This (FHIR) ActivityDefinition profile describes a reusable definition of a launchable digital (eHealth) activity that can be requested for a patient in MedMij and/or Koppeltaal workflows. It captures the clinical intent and the technical launch information (e.g., endpoint) so that systems can consistently create patient-specific Tasks that reference this definition." />
<copyright value="Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise." />
<definition value="Definition of a launchable digital (eHealth) activity that can be used as a template for patient-specific workflow requests. The definition may describe different activity types (e.g., launching a third-party module, presenting information, completing a questionnaire, or performing a measurement) and includes the technical launch details needed to invoke the activity in the correct context." />
</element>
</discriminator>
</slicing>
</element>
</type>
</element>
<definition value="Mandatory reference to the service application (endpoint) that provides the launchable eHealth activity. Can be more than one endpoint." />
</type>
</element>
</type>
</element>
</element>
</element>
<definition value="A detailed description of how the activity definition is used from a clinical perspective. In the MedMij use case, this text is intended for the healthcare professional who is selecting and assigning the activity to the patient." />
</element>
<definition value="Descriptive topics related to the content of the activity. The topic is used to indicate that the activity is intended or suitable for initialization by patients." />
<description value="High-level categorization of the definition, used for indicating special patient initialised activities" />
</binding>
</element>
</differential>
</StructureDefinition>
{
{
}
],
"description": "This (FHIR) ActivityDefinition profile describes a reusable definition of a launchable digital (eHealth) activity that can be requested for a patient in MedMij and/or Koppeltaal workflows. It captures the clinical intent and the technical launch information (e.g., endpoint) so that systems can consistently create patient-specific Tasks that reference this definition.",
"copyright": "Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise.",
{
"definition": "Definition of a launchable digital (eHealth) activity that can be used as a template for patient-specific workflow requests. The definition may describe different activity types (e.g., launching a third-party module, presenting information, completing a questionnaire, or performing a measurement) and includes the technical launch details needed to invoke the activity in the correct context."
},
{
},
},
{
{
}
]
},
{
"definition": "Mandatory reference to the service application (endpoint) that provides the launchable eHealth activity. Can be more than one endpoint.",
{
"http://koppeltaal.nl/fhir/StructureDefinition/KT2EndpointExtension"
]
}
]
},
{
{
}
]
},
{
},
{
},
{
"definition": "A detailed description of how the activity definition is used from a clinical perspective. In the MedMij use case, this text is intended for the healthcare professional who is selecting and assigning the activity to the patient."
},
{
"definition": "Descriptive topics related to the content of the activity. The topic is used to indicate that the activity is intended or suitable for initialization by patients.",
"description": "High-level categorization of the definition, used for indicating special patient initialised activities",
}
}
]
}
}
3.2.3. Report
| ProviderTasksEndpoint (Endpoint) | C | Endpoint | |
| id | Σ | 0..1 | string |
| meta | Σ | 0..1 | Meta |
| implicitRules | Σ ?! | 0..1 | uri |
| language | 0..1 | codeBinding | |
| text | 0..1 | Narrative | |
| contained | 0..* | Resource | |
| extension | C | 0..* | Extension |
| resource-origin | C | 0..1 | Extension |
| clientId | C | 0..1 | Extension(string) |
| modifierExtension | ?! C | 0..* | Extension |
| identifier | Σ | 0..* | Identifier |
| status | Σ ?! | 1..1 | codeBinding |
| connectionType | Σ | 1..1 | CodingBinding |
| name | Σ | 0..1 | string |
| managingOrganization | Σ C | 0..1 | Reference(Organization | http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization) |
| contact | C | 0..* | ContactPoint |
| period | Σ C | 0..1 | Period |
| payloadType | Σ | 1..* | CodeableConcept |
| payloadMimeType | Σ | 0..* | codeBinding |
| address | Σ | 1..1 | url |
| header | 0..* | string |
</telecom>
</contact>
<description value="This (FHIR) Endpoint profile represents the technical FHIR REST endpoint of a source system (XIS), used by a ProviderModule to retrieve and update task data and the required context for the ProviderModule use case." />
</discriminator>
</slicing>
</element>
</type>
</element>
</type>
</element>
</binding>
</element>
<targetProfile value="http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization" />
</type>
</element>
</differential>
</StructureDefinition>
{
{
}
],
"description": "This (FHIR) Endpoint profile represents the technical FHIR REST endpoint of a source system (XIS), used by a ProviderModule to retrieve and update task data and the required context for the ProviderModule use case.",
{
}
},
{
{
}
]
},
{
]
},
{
}
},
{
{
"http://hl7.org/fhir/StructureDefinition/Organization",
"http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthcareProvider-Organization"
]
}
]
}
]
}
}
3.2.4. Report
| ProviderTasksServiceRequest (ServiceRequest) | C | ServiceRequest | |
| id | Σ | 0..1 | string |
| meta | Σ | 0..1 | Meta |
| implicitRules | Σ ?! | 0..1 | uri |
| language | 0..1 | codeBinding | |
| text | 0..1 | Narrative | |
| contained | 0..* | Resource | |
| extension | C | 0..* | Extension |
| resource-origin | C | 0..* | Extension |
| modifierExtension | ?! C | 0..* | Extension |
| identifier | Σ | 0..* | Identifier |
| instantiatesCanonical | Σ | 0..* | canonical(ActivityDefinition | PlanDefinition) |
| instantiatesUri | Σ | 0..* | uri |
| basedOn | Σ C | 0..* | Reference(CarePlan | MedicationRequest | ServiceRequest) |
| replaces | Σ C | 0..* | Reference(ServiceRequest) |
| requisition | Σ | 0..1 | Identifier |
| status | Σ ?! | 1..1 | codeBinding |
| intent | Σ ?! | 1..1 | codeBinding |
| category | Σ | 0..* | CodeableConcept |
| priority | Σ | 0..1 | codeBinding |
| doNotPerform | Σ ?! | 0..1 | boolean |
| code | Σ | 0..1 | CodeableConcept |
| orderDetail | Σ C | 0..* | CodeableConcept |
| quantity[x] | Σ | 0..1 | |
| quantityQuantity | Quantity | ||
| quantityRange | Range | ||
| quantityRatio | Ratio | ||
| subject | Σ C | 1..1 | Reference(Device | Group | Location | Patient | http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient) |
| encounter | Σ C | 0..1 | Reference(Encounter) |
| occurrence[x] | Σ | 0..1 | |
| occurrenceDateTime | dateTime | ||
| occurrencePeriod | Period | ||
| occurrenceTiming | Timing | ||
| asNeeded[x] | Σ | 0..1 | |
| asNeededBoolean | boolean | ||
| asNeededCodeableConcept | CodeableConcept | ||
| authoredOn | Σ | 0..1 | dateTime |
| requester | Σ C | 0..1 | Reference(Device | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson | http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole) |
| performerType | Σ | 0..1 | CodeableConcept |
| performer | Σ C | 0..* | Reference(CareTeam | Device | HealthcareService | Organization | Patient | Practitioner | PractitionerRole | RelatedPerson) |
| locationCode | Σ | 0..* | CodeableConcept |
| locationReference | Σ C | 0..* | Reference(Location) |
| reasonCode | Σ | 0..* | CodeableConcept |
| reasonReference | Σ C | 0..* | Reference(Condition | DiagnosticReport | DocumentReference | Observation) |
| insurance | C | 0..* | Reference(ClaimResponse | Coverage) |
| supportingInfo | C | 0..* | Reference(Resource) |
| specimen | Σ C | 0..* | Reference(Specimen) |
| bodySite | Σ | 0..* | CodeableConcept |
| note | 0..* | Annotation | |
| patientInstruction | Σ | 0..1 | string |
| relevantHistory | C | 0..* | Reference(Provenance) |
--- We have skipped the narrative for better readability of the resource ---
</text>
</telecom>
</contact>
<description value="Clinical order for a patient-specific digital activity that a healthcare professional requests for a specific patient, such as completing a questionnaire, performing home measurements, viewing educational content, or launching a third-party module." />
<purpose value="To represent the clinical order to start or perform a specific digital (eHealth) activity for a patient. This ServiceRequest provides the clinical intent, context, requested schedule, and patient-specific instructions, and can serve as the basis for one or more Task resources that manage execution and tracking of the activity." />
<copyright value="Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise." />
<definition value="Patient-specific clinical order for requesting a digital (eHealth) activity in the ProviderTasks context. It links the patient, the requested activity definition, timing/schedule, and clinical rationale, and may include patient-specific instructions. It can be referenced by Task resources that coordinate execution and status tracking." />
</element>
</discriminator>
</slicing>
</element>
</type>
</element>
</type>
</element>
<comment value="Each occurrence of the zib HealthProfessional is normally represented by _two_ FHIR resources: a PractitionerRole resource (instance of [nl-core-HealthProfessional-PractitionerRole](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole)) and a Practitioner resource (instance of [nl-core-HealthProfessional-Practitioner](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner)). The Practitioner resource is referenced from the PractitionerRole instance. For this reason, sending systems should fill the reference to the PractitionerRole instance here, and not the Practitioner resource. Receiving systems can then retrieve the reference to the Practitioner resource from that PractitionerRole instance.\n\nIn rare circumstances, there is only a Practitioner instance, in which case it is that instance which will be referenced here. However, since this should be the exception, the nl-core-HealthProfessional-Practitioner profile is not explicitly mentioned as a target profile." />
<targetProfile value="http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole" />
</type>
</element>
<definition value="Patient or consumer-oriented instructions related to the requested activity. Use this element to convey patient-specific guidance that should be shown alongside the Task(s) executing this order (e.g. e.g., home blood pressure monitoring for 8 weeks, once daily in the morning)." />
</element>
</differential>
</StructureDefinition>
{
--- We have skipped the narrative for better readability of the resource ---
},
{
}
],
"description": "Clinical order for a patient-specific digital activity that a healthcare professional requests for a specific patient, such as completing a questionnaire, performing home measurements, viewing educational content, or launching a third-party module.",
"purpose": "To represent the clinical order to start or perform a specific digital (eHealth) activity for a patient. This ServiceRequest provides the clinical intent, context, requested schedule, and patient-specific instructions, and can serve as the basis for one or more Task resources that manage execution and tracking of the activity.",
"copyright": "Copyright and related rights waived via CC0, https://creativecommons.org/publicdomain/zero/1.0/. This does not apply to information from third parties, for example a medical terminology system. The implementer alone is responsible for identifying and obtaining any necessary licenses or authorizations to utilize third party IP in connection with the specification or otherwise.",
{
"definition": "Patient-specific clinical order for requesting a digital (eHealth) activity in the ProviderTasks context. It links the patient, the requested activity definition, timing/schedule, and clinical rationale, and may include patient-specific instructions. It can be referenced by Task resources that coordinate execution and status tracking.",
"Zorgopdracht",
"referral",
"referral request",
"transfer of care request"
]
},
{
}
},
{
{
}
]
},
{
{
"http://hl7.org/fhir/StructureDefinition/Patient",
"http://hl7.org/fhir/StructureDefinition/Group",
"http://hl7.org/fhir/StructureDefinition/Location",
"http://hl7.org/fhir/StructureDefinition/Device",
"http://nictiz.nl/fhir/StructureDefinition/nl-core-Patient"
]
}
]
},
{
"comment": "Each occurrence of the zib HealthProfessional is normally represented by _two_ FHIR resources: a PractitionerRole resource (instance of [nl-core-HealthProfessional-PractitionerRole](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole)) and a Practitioner resource (instance of [nl-core-HealthProfessional-Practitioner](http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-Practitioner)). The Practitioner resource is referenced from the PractitionerRole instance. For this reason, sending systems should fill the reference to the PractitionerRole instance here, and not the Practitioner resource. Receiving systems can then retrieve the reference to the Practitioner resource from that PractitionerRole instance.\n\nIn rare circumstances, there is only a Practitioner instance, in which case it is that instance which will be referenced here. However, since this should be the exception, the nl-core-HealthProfessional-Practitioner profile is not explicitly mentioned as a target profile.",
{
"http://hl7.org/fhir/StructureDefinition/Practitioner",
"http://hl7.org/fhir/StructureDefinition/PractitionerRole",
"http://hl7.org/fhir/StructureDefinition/Organization",
"http://hl7.org/fhir/StructureDefinition/Patient",
"http://hl7.org/fhir/StructureDefinition/RelatedPerson",
"http://hl7.org/fhir/StructureDefinition/Device",
"http://nictiz.nl/fhir/StructureDefinition/nl-core-HealthProfessional-PractitionerRole"
]
}
]
},
{
"definition": "Patient or consumer-oriented instructions related to the requested activity. Use this element to convey patient-specific guidance that should be shown alongside the Task(s) executing this order (e.g. e.g., home blood pressure monitoring for 8 weeks, once daily in the morning)."
}
]
}
}