hl7-be / pss

Prescription Search Support
Other
0 stars 0 forks source link

[Example] Step 1 - Given the existing data, query the structured list of indications (Radiology) #25

Closed NISN-SMALS closed 4 months ago

NISN-SMALS commented 6 months ago

Custom endpoint

GET - https://www.ehealth.fgov.be/standards/fhir/pss/OperationDefinition/getIndications? age=37&gender=female&snomed_code=763597000&freetext_indication=Ataxia&examination=114055

OperationDefinition specifications

{
  "resourceType": "OperationDefinition",
  "id": "indications",
  "url": "https://www.ehealth.fgov.be/standards/fhir/pss/OperationDefinition/getIndications",
  "version": "1.0.0",
  "name": "GetIndications",
  "status": "active",
  "kind": "operation",
  "code": "getIndications",
  "system": true,
  "type": false,
  "instance": false,
  "parameter": [
    {
      "name": "age",
      "use": "in",
      "min": 1,
      "max": "1",
      "type": "integer",
      "documentation": "Age of the patient"
    },
    {
      "name": "gender",
      "use": "in",
      "min": 1,
      "max": "1",
      "type": "code",
      "documentation": "Gender of the patient, possible values are: male, female, unknown"
    },
    {
      "name": "snomed_code",
      "use": "in",
      "min": 1,
      "max": "*",
      "type": "CodeableConcept",
      "documentation": "The SNOMED code(s) for the condition(s).",
      "binding": {
        "strength": "required",
        "valueSet": "https://www.ehealth.fgov.be/standards/fhir/pss/ValueSet/be-pss-indications"
      }
    },
    {
      "name": "freetext_indication",
      "use": "in",
      "min": 0,
      "max": "*",
      "type": "string",
      "documentation": "The free text indication(s) of the patient's condition(s)."
    },
    {
      "name": "examination",
      "use": "in",
      "min": 0,
      "max": "1",
      "type": "integer",
      "documentation": "Optional examination code"
    },
    {
      "name": "return",
      "use": "out",
      "min": 1,
      "max": "1",
      "type": "Questionnaire"
    }
  ]
}
costateixeira commented 6 months ago

Hi

I don't understand this endpoint but the request structure and syntax seem incorrect . We should organize a call

bdc-ehealth commented 6 months ago

@NISN-SMALS ,

Hello Nick, if you take a look at https://hl7.org/fhir/R4/operations.html#:~:text=If%20there%20is%20a%20single%20output%20parameter%20named%20%27return%27%20then%20the%20response%20MAY%20be%20the%20resource%20that%20is%20the%20return%20value%2C%20with%20no%20Parameters%20resource.%20These%20kinds%20of%20usage%20are%20discussed%20further%20below. you will see that if you want to return a Questionnaire as a single resource, then you will need to call your output parameter "return". Otherwise, you must wrap them in a Parameters resource.

bdc-ehealth commented 6 months ago

@NISN-SMALS ,

the parameters you use as input are relatively untyped: FHIR has a datatype Age for instance: https://hl7.org/fhir/R4/datatypes.html#Age For the gender, you could use a codeableConcept bound to to a valueset: https://hl7.org/fhir/R4/valueset-administrative-gender.html...

costateixeira commented 6 months ago

...or don't use an operation at all, and not put effort to improve that - Please consider that a custom operation is NOT a standard mechanism for this.

(the project can decide whatever they want for implementation. The national standard would need to review this)

On Thu, May 23, 2024 at 3:47 PM Bart Decuypere (eHealth) < @.***> wrote:

@NISN-SMALS https://github.com/NISN-SMALS ,

the parameters you use as input are relatively untyped: FHIR has a datatype Age for instance: https://hl7.org/fhir/R4/datatypes.html#Age For the gender, you could use a codeableConcept bound to to a valueset: https://hl7.org/fhir/R4/valueset-administrative-gender.html...

— Reply to this email directly, view it on GitHub https://github.com/hl7-be/pss/issues/25#issuecomment-2127152538, or unsubscribe https://github.com/notifications/unsubscribe-auth/AD3HUUBFB7GXRH74BJ45FN3ZDXXONAVCNFSM6AAAAABIE7Q3R6VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDCMRXGE2TENJTHA . You are receiving this because you commented.Message ID: @.***>

bdc-ehealth commented 6 months ago

results can be evaluated here: https://build.fhir.org/ig/hl7-be/pss/branches/issue-25/artifacts.html