juliangruendner commented 3 months ago

Overview

The UI, backend and ontology have to be extended to make the selected Concepts / or criteria for an attribute of a criterion searchable by valueSet / criteriaSet.

There are two type of searches that have to be distinguished.

Searching for a criterion (including context) within a value set of criteria (referencedCriteria)
Searching for a codeableConcept (without context) within a value set of codeableConcepts

1. Searching for a criterion as part of a value set

One criterion can be part of mulitple value sets. It is therefore necessary to extend each criterion with the additional information about the criteriaSets: ["http://fdpg.mii.cds/CriteriaSet/Diagnose/icd-10-gm"] and then add the referencedCriteriaSets to the ui profile as approppriate:

In profile:

"referenceCriteriaSets": 
[
    "http://fdpg.mii.cds/CriteriaSet/Diagnose/icd-10-gm",
    "http://sct.info"
]

In ES Input:

{
  "_index": "ontology",
  "_id": "88ae83ad-511d-37df-bf5e-c95c9224499d",
  "_version": 2,
  "_seq_no": 64465,
  "_primary_term": 2,
  "found": true,
  "_source": {
    "name": "Abnormer Blutdruckwert ohne Diagnose",
    "availability": 456,
    "terminology": "http://fhir.de/CodeSystem/bfarm/icd-10-gm",
    "termcode": "R03",
    "selectable": true,
    "context": {
      "code": "Diagnose",
      "display": "Diagnose",
      "system": "fdpg.mii.cds",
      "version": "1.0.0"
    },
    "termcodes": [
      {
        "code": "R03",
        "display": "Abnormer Blutdruckwert ohne Diagnose",
        "system": "http://fhir.de/CodeSystem/bfarm/icd-10-gm",
        "version": "2023"
      }
    ],
    "criteriaSets": [
        "http://fdpg.mii.cds/CriteriaSet/Diagnose/icd-10-gm",
        "http://fhir.de/CodeSystem/bfarm/icd-10-gm"
    ]
    "translations": [],
    "parents": [
      {
        "name": "Symptome, die das Kreislaufsystem und das Atmungssystem betreffen",
        "contextualized_termcode_hash": "6dba40ee-54d7-3875-853d-0ee96c9ea5ef"
      }
    ],
    "children": [
      {
        "name": "Erhöhter Blutdruckwert ohne Diagnose eines Bluthochdrucks",
        "contextualized_termcode_hash": "d20e003b-d3c4-3abd-9bae-375b6974f0f2"
      },
      {
        "name": "Unspezifischer niedriger Blutdruckwert",
        "contextualized_termcode_hash": "c61d6f59-6065-3dce-b85f-5d03998c6de5"
      }
    ],
    "related_terms": []
  }
}

in ES Search:

GET
/terminology/entry/search/?searchterm=Diabetes&criteriaSet=http://fdpg.mii.cds/CriteriaSet/Diagnose/icd-10-gm,http://fhir.de/CodeSystem/bfarm/icd-10-gm

criteriaSet is a param - keyword (exact match filter) and transparent for the user - only used internally and added automatically based on the attribute information from the ui profile

2. Searching for a codeableConcept (without context) within a value set of codeableConcepts

in profile:

{
    "allowedUnits": [],
    "attributeCode": {
        "code": "icd-o-3",
        "display": "icd-o-3",
        "system": "http://hl7.org/fhir/StructureDefinition",
        "version": null
    },
    "max": null,
    "min": null,
    "optional": true,
    "precision": 1,
    "referenceCriteriaSet": null,
    "referencedValueSet": "http://hl7.org/fhir/sid/icd-o-3",
    "type": "concept"
}

in ES input:

{
"valueSets": [
    "http://hl7.org/fhir/sid/icd-o-3"
]
"termcode": {
                    "code": "C76.2",
                    "display": "Abdomen o.n.A.",
                    "system": "http://hl7.org/fhir/sid/icd-o-3",
                    "version": "Erste_Revision"
}
}

in ES Search:

GET
/codeableConcept/entry/search/?searchterm=Diabetes&valueSet=http://hl7.org/fhir/sid/icd-o-3,http://second-value-set

Shayan1375 commented 3 months ago

General:

When the checkbox is selected, automatically add the item. The "Add" button becomes obsolete.
If not, what happens if an item is selected but "Add" is not clicked? --> The item is lost in a new search.
How does CCDL handle multiple criteriaSet/valueSet?
We need a variable 'systemDisplay'.
pageSize and page must be included in the endpoint --> Pagination.

1. CodeableConcepts --> Reference

API Request:

GET /terminology/entry/search?criteriaSet=http://fdpg.mii.cds/CriteriaSet/Diagnose/icd-10-gm,http://fhir.de/CodeSystem/bfarm/icd-10-gm&searchterm=Diabetes

Response:

{
  "totalHits": 42,
  "results": [
    {
      "name": "Diabetes Mellitus",
      "id": "203e04cd-4f0a-321b-b1ad-9ec6d211e0a8",
      "availability": 119578,
      "context": "Diagnosis",
      "terminology": "icd-10",
      "termcode": "E10-E14",
      "kdsModule": "Condition",
      "selectable": true
    }
  ]
}

Internal Steps:

When the 'select' button is clicked, we use the ID from the response to call the 'criteria-profile-da' endpoint and 'translate' the criterion.
Update the data model, specifically ElasticSearchResult.

External Steps:

We need a starter list when the UI is launched.
Must be able to search by code.
Filter by terminology and context.

2. CodeableConcepts --> Searching ValueSets