ЕСОЗ - публічна документація
RC_[NEW] Observations configuration
- Mykhaylo Khapchyk (SoE eHealth)
- 1 Config description
- 1.1 CATEGORY
- 1.2 COMPONENTS_UNIQUE
- 1.3 COMPONENTS_REQUIRED
- 1.4 COMPONENTS_ALLOWED
- 1.5 COMPONENTS_TYPE
- 1.6 COMPONENTS_BINDING
- 1.7 COMPONENTS_QUANTITY_CODES
- 1.8 COMPONENTS_QUANTITY_BOUNDARIES
- 1.9 COMPONENTS_ALLOWED_EXTENSIONS
- 1.10 COMPONENT_SCORE
- 1.11 RESULT_TYPE
- 1.12 RESULT_BINDING
- 1.13 RESULT_QUANTITY_CODES
- 1.14 RESULT_BOUNDARIES
- 1.15 RESULT_SCORE_CALCULATION
- 2 Config types
- 2.1 Component
- 2.2 Answer
- 2.3 Component_quantity
- 2.4 Result_quantity
- 3 Examples
Config description
CATEGORY
A list of categories allowed for this observation code
Type: object
Attributes | Type | Comments |
|---|---|---|
check | [Coding] |
|
Example:
{
"check": [
{
"system": "eHealth/observation_categories",
"code": "survey"
}
]
}COMPONENTS_UNIQUE
Specifies whether components within the observation must have unique codes. If enabled, duplicate components are not allowed
Type: object
Attributes | Type | Comments |
|---|---|---|
check | boolean |
|
{
"check": true
}COMPONENTS_REQUIRED
A list of required component codes that must be included in the observation
Type: object
Attributes | Type | Comments |
|---|---|---|
check | [Coding] |
|
Example:
{
"check": [
{
"code": "83184-2",
"system": "eHealth/LOINC/observation_codes"
},
{
"code": "83185-9",
"system": "eHealth/LOINC/observation_codes"
}
]
}COMPONENTS_ALLOWED
A list of all allowed component codes including those that are required
Type: object
Attributes | Type | Comments |
|---|---|---|
check | [Coding] |
|
Example:
{
"check": [
{
"code": "43184-2",
"system": "eHealth/LOINC/observation_codes"
},
{
"code": "43185-9",
"system": "eHealth/LOINC/observation_codes"
}
]
}COMPONENTS_TYPE
Defines the type of each component based on its code and system
Type: array
Attributes | Type | Comments |
|---|---|---|
condition |
| |
check | string |
|
Example:
[
{
"condition": {
"component_code": {
"code": "83184-2",
"system": "eHealth/LOINC/observation_codes"
}
},
"check": "codeable_concept"
}
]COMPONENTS_BINDING
Dictionary mapping for components with the codeable_concept type, defining valid codes for each component
Type: array
Attributes | Type | Comments |
|---|---|---|
condition |
| |
check | [string] |
|
Example:
[
{
"condition": {
"component_code": {
"code": "83184-2",
"system": "eHealth/LOINC/observation_codes"
}
},
"check": [
"eHealth/LOINC/LL5785-2"
]
}
]COMPONENTS_QUANTITY_CODES
A list of allowed unit codes for components with type quantity
Type: array
Example:
[
{
"condition": {
"component_code": {
"code": "83184-2",
"system": "eHealth/LOINC/observation_codes"
}
},
"check": [
{
"code": "g",
"system": "eHealth/ucum/units"
},
{
"code": "kg",
"system": "eHealth/ucum/units"
}
]
}
]COMPONENTS_QUANTITY_BOUNDARIES
Defines the valid range of values for components with type quantity depending on quantity code
Type: array
Attributes | Type | Comments |
|---|---|---|
condition |
| |
check | {Min_Max} |
|
Example:
[
{
"condition": {
"component_code": {
"code": "83184-2",
"system": "eHealth/LOINC/observation_codes"
},
"quantity_code": {
"code": "kg",
"system": "eHealth/ucum/units"
},
},
"check": {
"min": 0,
"max": 30
}
}
]COMPONENTS_ALLOWED_EXTENSIONS
A list of extensions that are permitted for use within observation components
Type: array
Attributes | Type | Comments |
|---|---|---|
check | [string] |
|
Example:
[
{
"check": [
"item_weight"
]
}
]COMPONENT_SCORE
Reference values for each component's score, used to validate the item_weight extension value for components with type codeable_concept
Type: array
Attributes | Type | Comments |
|---|---|---|
condition | {Answer} |
|
check | [integer] |
|
Example:
[
{
"condition": {
"answer": {
"code": "LA24937-7",
"system": "eHealth/LOINC/LL5785-2"
}
},
"check": 0
},
{
"condition": {
"answer": {
"code": "LA31630-9",
"system": "eHealth/LOINC/LL5785-2"
}
},
"check": 5
}
]RESULT_TYPE
Defines the type of observation result
Type: object
Attributes | Type | Comments |
|---|---|---|
check | string |
|
Example:
{
"check": "quantity"
}RESULT_BINDING
Dictionary mapping for observation result (in case when type is codeable_concept)
Type: object
Attributes | Type | Comments |
|---|---|---|
check | [string] |
|
Example:
{
"check": [
"eHealth/LOINC/Rancho_Los_Amigos"
]
}RESULT_QUANTITY_CODES
A list of allowed unit codes for observation result (in case when type is quantity)
Type: array
Attributes | Type | Comments |
|---|---|---|
check | [Coding] |
|
Example:
[
{
"check": [
{
"code": "g",
"system": "eHealth/ucum/units"
},
{
"code": "kg",
"system": "eHealth/ucum/units"
}
]
}
]RESULT_BOUNDARIES
Defines the valid range of values for observation result depending on quantity code (in case when type is quantity)
Type: array
Attributes | Type | Comments |
|---|---|---|
condition |
| |
check | {Min_Max} |
|
Example:
[
{
"condition": {
"quantity_code": {
"code": "kg",
"system": "eHealth/ucum/units"
},
},
"check": {
"min": 0,
"max": 30
}
}
]RESULT_SCORE_CALCULATION
The method used to calculate an overall score for the observation result
Type: object
Attributes | Type | Comments |
|---|---|---|
check | string |
|
Example:
{
"check": "SUM"
}Config types
Component
Attributes | Type | Comments |
|---|---|---|
component_code | {Coding} |
|
Answer
Attributes | Type | Comments |
|---|---|---|
answer | {Coding} |
|
Component_quantity
Result_quantity
Attributes | Type | Comments |
|---|---|---|
quantity_code | {Coding} |
|
Examples
Configuration for Observation code 96761-2 (Total score Barthel Index)
ЕСОЗ - публічна документація