Validation rules

HeadtoHelp is an extension of the Primary Mental Health Care Minimum Data Set (PMHC MDS); the current PMHC MDS Validations rules apply. These are available to be viewed at https://docs.pmhc-mds.com/data-specification/validation-rules.html.

This document defines validation rules between HeadtoHelp items and record types. The domain of individual HeadtoHelp items is defined in Record formats.

Current HeadtoHelp validations

1. Episode

Under the HeadtoHelp specification the following episode validations exist for Episodes as well as the default PMHC episode validations at https://docs.pmhc-mds.com/projects/data-specification/en/latest/validation-rules.html#episode

  1. Any changes to an Episode record require that HeadtoHelp Episode - Context be set to a value other than 9: Unknown.

2. HeadtoHelp - Episode

  1. Episode Key must be an existing PMHC episode within the PMHC MDS.
  2. !covid19 tag should be included in the Episode - Tags field of the corresponding PMHC episode, otherwise the system will automatically include it.
  3. If a HeadtoHelp Episode - Intake Organisation Path is specified, that organisation must be an existing organisation within the PMHC MDS.
  4. If a HeadtoHelp Episode - Intake Episode Key is specified, a HeadtoHelp Episode - Intake Organisation Path must also be specified.
  5. HeadtoHelp Episode - Referral Out Organisation Type is a multivalued field.
    • Multivalued fields can not have duplicates, For example, 1 1 1 is not allowed.
    • If 0: None/Not applicable is provided, no other values are permitted.
  6. Any changes to a HeadtoHelp Episode record require that HeadtoHelp Episode - Context be set to a value other than 9: Unknown.
  7. HeadtoHelp Episode - Context value of 9: Unknown cannot be used on new records.
  8. Existing records already containing a HeadtoHelp Episode - Context value of 9: Unknown may be updated to one of the non 9: Unknown values.
  9. Existing records already containing a HeadtoHelp Episode - Context value that is not 9: Unknown cannot be changed to 9: Unknown.
  10. HeadtoHelp Episode - Context shall only be allowed to be changed between 1: Intake and 2: Hub where all other validations pertaining to the new value for HeadtoHelp Episode - Context are satisfied.
  11. Where HeadtoHelp Episode - Context is set to 1: Intake HeadtoHelp Episode - Intake Organisation Path and HeadtoHelp Episode - Intake Episode Key must not be specified
  12. Where HeadtoHelp Episode - Context is set to 2: Hub HeadtoHelp Episode - Intake Organisation Path and HeadtoHelp Episode - Intake Episode Key should be specified

2. Collection Occasion

  1. Episode Key must be an existing PMHC episode within the PMHC MDS.
  2. The Collection Occasion - Date

3. K10+

  1. Collection Occasion Key must be an existing Collection Occasion within the PMHC MDS.
  2. If both item scores and a total score are specified, the item scores must add up to the total score (as per Scoring the K10+).
  3. K10+ records must not be associated with an Episode where HeadtoHelp Episode - Context is 1: Intake.

4. K5

  1. Collection Occasion Key must be an existing Collection Occasion within the PMHC MDS.
  2. If both item scores and a total score are specified, the item scores must add up to the total score (as per Scoring the K5).
  3. K5 records must not be associated with an Episode where HeadtoHelp Episode - Context is 1: Intake.

5. SDQ

  1. Collection Occasion Key must be an existing Collection Occasion within the PMHC MDS.
  2. Use the table at SDQ Data Elements to validate the items that are used in each version of the SDQ
  3. If both item scores and subscales are specified, the sum of the items must agree with the subscales score (as per Scoring the SDQ)
  4. If both subscales and total score are specified, the sum of the subscales must agree with the total score (as per Scoring the SDQ)
  5. SDQ records must not be associated with an Episode where HeadtoHelp Episode - Context is 1: Intake.

6. IAR-DST

  1. Collection Occasion Key must be an existing Collection Occasion within the PMHC MDS.
  2. Both all 8 domains and the level of care must be provided.
  3. The level of care must be consistent with the 8 domain scores provided.
  4. IAR-DST records must not be associated with an Episode where HeadtoHelp Episode - Context is 2: Hub.

7. HeadtoHelp - Service Contact

  1. HeadtoHelp - Service Contact - Practitioner Category is a multivalued field.
    • Multivalued fields can not have duplicates, For example, 1 1 1 is not allowed.
    • If 0: None/Not applicable is provided, no other values are permitted.

Current PMHC validations

HeadtoHelp is an extension of the Primary Mental Health Care Minimum Data Set (PMHC MDS); the current PMHC MDS Validations rules may apply, depending on how you add your HeadtoHelp data. The current PMHC MDS validations rules are available to be viewed at https://docs.pmhc-mds.com/data-specification/validation-rules.html.