| 1 Definition | 2 Functional Requirements | 3 Syntax | 4 Semantics |
1 Definition
A Clinical Record Qualifier specifies metadata describing a Clinical Record Data instance including:
- the Type of clinical record (e.g. diagnosis, observation, procedure, medication, laboratory result),
- the Representation and coding system used to encode the clinical record (e.g. ICD, SNOMED CT, LOINC),
- the Clinical context and scope of the record (e.g. encounter‑based, longitudinal, problem‑oriented).
The Clinical Record Qualifier is used in conjunction with Clinical Record Data and is aggregated by a Clinical Record Object.
The combination of Clinical Record Data and Clinical Record Qualifier is called a Clinical Record Object, specified by AIH-HSP V1.1
2 Functional Requirements
ECG Qualifier must allow the expression of the following Elements:
- Sub-Type
- Format
Users needing support of other entries in MPAI-TFA should make a documented request to the MPAI Secretariat to consider addition of such entries.
The Qualifier may include Findings: what the data show. Each Finding has an identifier (FindingID), a Code, the Coding System of the Code, chosen among those of this domain, the name of the label set when the Code is from a data set’s own labels (LabelSet), and where in the data the Finding is (Where). Who set a Finding and how sure that source is are not part of the Qualifier: they are in the AIH Data that carries the data (FindingTrust).
3 Syntax
https://schemas.mpai.community/TFA/V1.5/data/ClinicalRecordQualifier.json
4 Semantics
| Label | Description |
|---|---|
| Header | Clinical Record Qualifier Header – Standard “TFA‑CRQ‑Vx.y”. |
| ClinicalRecordType | Type of clinical record described by the Clinical Record Data. |
| Examples include Diagnosis, Observation, Procedure, Medication, Laboratory Result, Vital Sign (symbolic), Allergy or Intolerance, Care Plan, Clinical Note (structured). | |
| CodingSystem | Coding or vocabulary system used to encode the clinical record. |
| Examples include ICD‑9, ICD‑10, ICD‑11, SNOMED CT, LOINC, ATC, RxNorm, or local EHR coding systems. | |
| RecordRepresentation | Representation form of the clinical record. |
| Examples include coded value, coded value with textual description, structured attribute‑value set. | |
| ClinicalContext | Clinical scope under which the record is valid. |
| Examples include encounter‑based, longitudinal patient record, problem‑oriented record, episode‑of‑care record. | |
| EHRSource | Indicator or identifier of the originating Electronic Health Record (EHR) system, if applicable. |
| DataXMData | Information about this Clinical Record Qualifier Intsance. |
| DescrMetadata | Descriptive Metadata. |
Findings
| Label | Description |
| Findings | What the data show, each Finding coded in a vocabulary of this domain: the labels a Neural Network Model learns from and is checked against. |
| FindingID | Identifier of the Finding; the FindingTrust of AIH Data refers to it. |
| Code | The Finding, as the Coding System writes it. |
| CodingSystem | One of: ICD9, ICD10, ICD11, SNOMEDCT, LOINC, ATC, RxNorm, LocalEHR, DatasetLabelSet. |
| LabelSet | The name of the label set when the CodingSystem is DatasetLabelSet (a data set’s own labels, e.g. NIH ChestX-ray14). |
| Where | Where in the data the Finding is: RecordEntry (the entry of the record). |