{
  "description": "Defines how a Task is used to ask for a Questionnaire to be completed. Each Task represents one PROMs Tool within a Collection Event.\\r\\n\\r\\nThis profile is based on the UKCore-Task and is heavily influenced by the [SDCTaskQuestionnaire](http://hl7.org/fhir/uv/sdc/STU3/StructureDefinition-sdc-task.profile.json.html).",
  "_filename": "Profile-DataStandardsWales-PSOM-Task.json",
  "package_name": "fhir.r4.wales.psom",
  "date": null,
  "derivation": "constraint",
  "publisher": "NHS Wales",
  "fhirVersion": "4.0.1",
  "name": "DataStandardsWalesPSOMTask",
  "mapping": [ {
    "name": "NHS Wales DSCN Metadata Mapping",
    "identity": "PROMs-Metadata-2024004"
  } ],
  "abstract": false,
  "copyright": "© 2023 NHS Wales.",
  "type": "Task",
  "experimental": null,
  "resourceType": "StructureDefinition",
  "title": "Data Standards Wales PSOM Task",
  "package_version": "1.0.0-rc3",
  "status": "draft",
  "id": "6ab51185-8d5a-4703-a9a7-961a2ced62f2",
  "kind": "resource",
  "url": "https://fhir.nhs.wales/StructureDefinition/DataStandardsWales-PSOM-Task",
  "version": null,
  "differential": {
    "element": [ {
      "id": "Task",
      "path": "Task",
      "constraint": [ {
        "key": "PSOM-Task-01",
        "human": "If the Task contains a questionnaire response, the completion date SHALL be provided.",
        "severity": "error",
        "expression": "output.where(type.coding.system = 'http://hl7.org/fhir/uv/sdc/CodeSystem/temp' and type.coding.code = 'questionnaire-response').exists() implies executionPeriod.end.exists()"
      } ]
    }, {
      "id": "Task.code",
      "min": 1,
      "path": "Task.code",
      "patternCodeableConcept": {
        "coding": [ {
          "code": "complete-questionnaire",
          "system": "http://hl7.org/fhir/uv/sdc/CodeSystem/temp"
        } ]
      }
    }, {
      "id": "Task.focus",
      "path": "Task.focus",
      "comment": "For referencing the CarePlan, the `.basedOn` or `.focus` element could be used. The SDC IG adopts the latter approach.  However, in our use case it is discouraged to use this element to refer to the CarePlan because `CarePlan.activity` already contains a reference to the Task. This would lead to a circular reference which could potentially lead to issues when updating or deleting resources."
    }, {
      "id": "Task.executionPeriod",
      "min": 1,
      "path": "Task.executionPeriod"
    }, {
      "id": "Task.executionPeriod.start",
      "min": 1,
      "path": "Task.executionPeriod.start",
      "short": "PROMs Issued Date",
      "mapping": [ {
        "map": "MPRPX002X",
        "comment": "PROMs Issued Date",
        "identity": "PROMs-Metadata-2024004"
      } ],
      "definition": "The date and time the PROMs form was issued to the patient. This is populated by the PROMs platform."
    }, {
      "id": "Task.executionPeriod.end",
      "path": "Task.executionPeriod.end",
      "short": "PROMs Completion Date & Time",
      "mapping": [ {
        "map": "MPRPX003X",
        "comment": "PROMs Completion Date & Time",
        "identity": "PROMs-Metadata-2024004"
      } ],
      "condition": [ "PSOM-Task-01" ],
      "definition": "The date and time the PROMs form was completed (or when the last item was recorded for incomplete records). If only the date component is captured, this can be provided without a time component. This is populated by the PROMs platform."
    }, {
      "id": "Task.location",
      "path": "Task.location",
      "type": [ {
        "code": "Reference",
        "targetProfile": [ "https://fhir.nhs.wales/StructureDefinition/DataStandardsWales-Location" ]
      } ],
      "short": "Event Location Code",
      "mapping": [ {
        "map": "MPRPX001X",
        "comment": "Event Location Code (implicit, main mapping is on Location.identifier)",
        "identity": "PROMs-Metadata-2024004"
      } ],
      "definition": "The code of the site where the PROMs form was initiated. This is populated by the Health Board system."
    }, {
      "id": "Task.reasonCode",
      "min": 1,
      "path": "Task.reasonCode",
      "short": "PROMs Trigger Event Type",
      "binding": {
        "strength": "extensible",
        "valueSet": "https://fhir.nhs.wales/ValueSet/DataStandardsWales-PSOM-TriggerEventType"
      },
      "mapping": [ {
        "map": "MPRPX007X",
        "comment": "PROMs Trigger Event Type",
        "identity": "PROMs-Metadata-2024004"
      } ],
      "definition": "The national code representing the type of healthcare or administrative event that triggers a requirement for a questionnaire (or onboarding process) to be completed."
    }, {
      "id": "Task.input",
      "min": 2,
      "path": "Task.input",
      "slicing": {
        "rules": "open",
        "discriminator": [ {
          "path": "type",
          "type": "value"
        } ]
      },
      "definition": "Additional information that may be needed in the execution of the Task populated by the Health Board."
    }, {
      "id": "Task.input:promsTriggerEventDate",
      "max": "1",
      "path": "Task.input",
      "comment": "Mandatory for healthcare pathway activity-based event types, e.g. referrals, outpatient appointments, interventions, etc. (i.e. not mandatory for event types not directly resulting from these, such as clinician or patient initiated event types).",
      "sliceName": "promsTriggerEventDate",
      "definition": "Indicates the date of the event that triggers a requirement for a questionnaire (or onboarding process) to be completed, irrespective of the date that the PROMs form was triggered/issued."
    }, {
      "id": "Task.input:promsTriggerEventDate.type",
      "path": "Task.input.type",
      "patternCodeableConcept": {
        "coding": [ {
          "code": "MPRPX013X",
          "system": "https://fhir.nhs.wales/CodeSystem/DataStandardsWales-PSOM-TaskInputType"
        } ]
      }
    }, {
      "id": "Task.input:promsTriggerEventDate.value[x]",
      "path": "Task.input.value[x]",
      "type": [ {
        "code": "dateTime"
      } ],
      "short": "PROMs Trigger Event Date",
      "mapping": [ {
        "map": "MPRPX013X",
        "comment": "PROMs Trigger Event Date",
        "identity": "PROMs-Metadata-2024004"
      } ],
      "definition": "The date of the event that triggers a requirement for a questionnaire (or onboarding process) to be completed, irrespective of the date that the PROMs form was triggered/issued."
    }, {
      "id": "Task.input:promsLaterality",
      "max": "1",
      "min": 1,
      "path": "Task.input",
      "sliceName": "promsLaterality",
      "definition": "Indicates the anatomical side associated with the questionnaire being completed."
    }, {
      "id": "Task.input:promsLaterality.type",
      "path": "Task.input.type",
      "patternCodeableConcept": {
        "coding": [ {
          "code": "MDEPX004X",
          "system": "https://fhir.nhs.wales/CodeSystem/DataStandardsWales-PSOM-TaskInputType"
        } ]
      }
    }, {
      "id": "Task.input:promsLaterality.value[x]",
      "path": "Task.input.value[x]",
      "type": [ {
        "code": "CodeableConcept"
      } ],
      "short": "PROMs Laterality",
      "binding": {
        "strength": "required",
        "valueSet": "https://fhir.nhs.wales/ValueSet/DataStandardsWales-PSOM-PROMsLaterality",
        "description": "Identifies the laterality"
      },
      "comment": "Note that if a patient completes a questionnaire for both left and right sides, two records should be generated and labelled as per the specified value set. Note also that this item is intended to capture the laterality specified as part of the patient’s PROMs pathway record as opposed to any patient reported laterality information which would be captured within the form itself.",
      "mapping": [ {
        "map": "MDEPX004X",
        "comment": "PROMs Laterality",
        "identity": "PROMs-Metadata-2024004"
      } ],
      "definition": "The anatomical side associated with the questionnaire being completed."
    }, {
      "id": "Task.input:questionnaire",
      "max": "1",
      "min": 1,
      "path": "Task.input",
      "sliceName": "questionnaire",
      "definition": "Indicates the questionnaire to be completed."
    }, {
      "id": "Task.input:questionnaire.type",
      "path": "Task.input.type",
      "patternCodeableConcept": {
        "coding": [ {
          "code": "questionnaire",
          "system": "http://hl7.org/fhir/uv/sdc/CodeSystem/temp"
        } ]
      }
    }, {
      "id": "Task.input:questionnaire.value[x]",
      "path": "Task.input.value[x]",
      "type": [ {
        "code": "canonical",
        "targetProfile": [ "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Questionnaire" ]
      } ],
      "short": "(Local) PROMs Tool",
      "mapping": [ {
        "map": "MPRPX006X",
        "comment": "PROMs Tool (implicit, main mapping is on Questionnaire.url)",
        "identity": "PROMs-Metadata-2024004"
      }, {
        "map": "MPRPX010X",
        "comment": "Local PROMs Tool (implicit, main mapping is on Questionnaire.url)",
        "identity": "PROMs-Metadata-2024004"
      }, {
        "map": "MPRPX012X",
        "comment": "PROMs Data Standard Version (implicit, main mapping is on Questionnaire.version)",
        "identity": "PROMs-Metadata-2024004"
      } ],
      "definition": "The Questionnaire that is requested to be filled in. A reference to the canonical identifier including the `.version` (MPRPX012X) of the PROMs Tool SHALL be implemented, to specify the correct version."
    }, {
      "id": "Task.input:responseEndpoint",
      "path": "Task.input",
      "sliceName": "responseEndpoint",
      "definition": "Indicates an endpoint the form should be posted to on completion."
    }, {
      "id": "Task.input:responseEndpoint.type",
      "path": "Task.input.type",
      "patternCodeableConcept": {
        "coding": [ {
          "code": "response-endpoint",
          "system": "http://hl7.org/fhir/uv/sdc/CodeSystem/temp"
        } ]
      }
    }, {
      "id": "Task.input:responseEndpoint.value[x]",
      "path": "Task.input.value[x]",
      "type": [ {
        "code": "url"
      } ]
    }, {
      "id": "Task.output",
      "path": "Task.output",
      "slicing": {
        "rules": "open",
        "discriminator": [ {
          "path": "type",
          "type": "value"
        } ]
      },
      "definition": "Outputs produced by the Task populated by the PROMs platform."
    }, {
      "id": "Task.output:response",
      "max": "1",
      "path": "Task.output",
      "condition": [ "PSOM-Task-01" ],
      "sliceName": "response"
    }, {
      "id": "Task.output:response.type",
      "path": "Task.output.type",
      "patternCodeableConcept": {
        "coding": [ {
          "code": "questionnaire-response",
          "system": "http://hl7.org/fhir/uv/sdc/CodeSystem/temp"
        } ]
      }
    }, {
      "id": "Task.output:response.value[x]",
      "path": "Task.output.value[x]",
      "type": [ {
        "code": "Reference",
        "targetProfile": [ "https://fhir.nhs.wales/StructureDefinition/DataStandardsWales-PSOM-QuestionnaireResponse" ]
      } ]
    } ]
  },
  "contact": [ {
    "name": "Data Standards",
    "telecom": [ {
      "use": "work",
      "value": "data.standards@wales.nhs.uk",
      "system": "email"
    } ]
  } ],
  "baseDefinition": "https://fhir.hl7.org.uk/StructureDefinition/UKCore-Task"
}