Руководство к использованию стандарта FHIR в ЦИСЗ
0.2.6803 - ci-build

Профиль ресурса: Данные показателя лабораторного исследования

Официальный URL: https://fhir.by/StructureDefinition/ObservationLabTest
Active as of 2026-06-25 Имя: ObservationLabTest

Данные показателя лабораторного исследования. Раздел Лабораторная диагностика

Описание профиля:

ObservationLabTest представляет собой профиль ресурса Observation, адаптированный для использования в клинико-диагностических лабораториях (КДЛ), в химико-токсикологических лабораториях (ХимТокс).

Профиль описывает процесс регистрации и хранения результатов одного показателя из лабораторного анализа.

ObservationLabTest предназначен для фиксации и представления значений, полученных в результате выполнения лабораторных тестов, в виде отдельного наблюдения, что позволяет структурировать и анализировать данные на уровне каждого отдельного показателя.

Основная цель ObservationLabTest — обеспечение точной и детализированной записи результатов конкретного теста, который является частью более общего лабораторного анализа. Профиль используется для передачи данных, таких как численные значения, качественные результаты, или интерпретации, относящиеся к отдельным параметрам исследования.

ObservationLabTest фокусируется на каждом отдельном показателе в рамках общего анализа, что позволяет более детально отслеживать изменения в клинических данных. После проведения анализа каждый результат фиксируется в соответствующем ObservationLabTest и может быть использован для формирования полного диагностического отчета (DiagnosticReport), который объединяет все наблюдения для получения общей клинической картины.

Профиль поддерживает взаимодействие с:

  • организациями здравоохранения (OrganizationBy);
  • пациентами (PatientWithIdentificationNumber или PatientWithoutIdentificationNumber или AnonymousPatientBy);
  • ролями медицинских работников (PractitionerRoleBy);
  • направлениями на исследования (ServiceRequestLab);
  • образцами биоматериала (SpecimenLab).

Использование:

You can also check for usages in the FHIR IG Statistics

Контент профиля

Описание профилей и принципов работы различных представлений..

Профиль ресурса: Observation

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Observation C 0..* Observation Осмотры, обследования, опросы и измерения
Constraints: ObservationLabTestStatusRule
... meta 1..1 Meta Метаданные о ресурсе
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... versionId 0..0 Идентификатор конкретной версии
.... lastUpdated 0..1 instant Дата и время последнего обновления
.... source 0..0 Определяет, откуда берется ресурс
.... profile 1..1 canonical(StructureDefinition) Ссылка на профиль
Требуемый шаблон: https://fhir.by/StructureDefinition/ObservationLabTest
.... security 0..0 Метки безопасности, примененные к этому ресурсу
.... tag 0..0 Теги, применяемые к этому ресурсу
... implicitRules 0..0 Набор правил, в соответствии с которыми был создан этот контент
... language 0..0 Язык содержания ресурса
... text 0..0 Краткое изложение текста ресурса для интерпретации человеком
... contained 0..0 Автономные встроенные ресурсы
... extension 0..0 Extension
... modifierExtension 0..0 Extension
... identifier 1..1 Identifier Идентификатор создавшей результат по показателю ЛИС
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... use 0..0 usual | official | temp | secondary | old (Если известно)
.... type 0..0 Описание идентификатора
.... system 0..0 Пространство имен для значения идентификатора
.... value 1..1 string Идентификатор результат по показателю ЛИС. Должен быть уникален для данного УЗ
.... period 0..0 Период времени, в течение которого идентификатор действителен для использования
.... assigner 1..1 Reference(Учреждение здравоохранения) Ссылка на УЗ, создавшее результат по показателю ЛИС
..... Разрезы для extension 1..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
...... extension:locationReference 1..1 Reference(Структурное подразделение) Ссылка на структурное подразделение
URL: https://fhir.by/StructureDefinition/LocationReference
..... reference 1..1 string Ссылка на ресурс в виде относительного URL
..... type 0..0 Тип ресурса
..... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... instantiates[x] 0..0 Создает экземпляр ИХ определения ObservationDefinition
... basedOn 0..1 Reference(Направление на исследования, выполняемые в лаборатории) Направление, на основании которого было проведено исследование
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... triggeredBy 0..0 Запускающее наблюдение (наблюдения)
... partOf 0..0 Часть события, на которое ссылается ссылка
... status 1..1 code Статус наблюдения. (registered | final . registered – на момент создания исследования и описание к нему, final – после первичного добавления описания исследования)
... category 0..0 Классификация типов наблюдений
... code 1..1 CodeableConcept Код показателя
Привязка: Справочник лабораторных исследований (required)
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... coding 1..1 Coding Концепт показателя
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... system 1..1 uri Ссылка на справочник
..... version 0..0 Версия системы
..... code 1..1 code Код
..... userSelected 0..0 Если эта кодировка была выбрана непосредственно пользователем
.... text 0..0 Простое текстовое представление концепции
... subject 1..1 Reference(Пациент | Пациент без ИН | Анонимный пациент) Ссылка на пациента
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... focus 0..0 О чем идет речь в наблюдении, если оно не касается предмета записи
... encounter 0..0 Медицинское мероприятие, во время которого проводится это наблюдение
... Разрезы для effective[x] 1..1 dateTime Клинически значимое время/период наблюдения
Разрез: Не упорядочено, Открыто от type:$this
.... effective[x]:effectiveDateTime 1..1 dateTime Дата измерения показателя
... issued 0..0 Дата и время выхода этой версии
... performer 0..1 Reference(Роль медицинского работника) Ссылка на работника ЛИС несущего ответственность за наблюдение
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... Разрезы для value[x] 0..1 Значение показателя
Разрез: Не упорядочено, Открыто от type:$this
.... valueQuantity Quantity
.... valueString string
.... valueBoolean boolean
.... value[x]:valueQuantity 0..1 Quantity Фактический результат
Привязка: Справочник единиц измерения для лабораторных исследований (required)
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... value 1..1 decimal Числовое значение (с неявной точностью)
..... comparator 0..0 < | <= | >= | > | ad - как понимать значение
..... system 1..1 uri Система, определяющая форму кодированной единицы измерения
..... code 1..1 code Код единицы измерения. Если значение безразмерное, указывать код #369
... dataAbsentReason 0..0 Почему отсутствует результат
... interpretation 0..0 Высокий, низкий, нормальный и т. д
... note 0..1 Annotation Комментарий к показателю
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... author[x] 0..0 Individual responsible for the annotation
.... time 0..0 Когда была сделана аннотация
... bodySite 0..0 Исследуемая часть тела
... bodyStructure 0..0 Исследуемая структура тела
... method 0..1 CodeableConcept Метод исследования
Привязка: Справочник лабораторных методов исследования (required)
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... system 1..1 uri Ссылка на справочник
..... version 0..0 Версия системы
..... code 1..1 code Код
..... userSelected 0..0 Если эта кодировка была выбрана непосредственно пользователем
.... text 0..0 Простое текстовое представление концепции
... specimen 0..1 Reference(Образец материала для лабораторного исследования) Ссылка на биоматериал
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... device 0..0 Ссылка на устройство, которое генерирует измерения, или настройки устройства для этого устройства
... referenceRange 0..1 BackboneElement Референсные значения по показателю
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... modifierExtension 0..0 Extension
.... low 0..1 SimpleQuantity(5.0.0) Нижний предел, если применимо
.... high 0..1 SimpleQuantity(5.0.0) Верхний предел, если применимо
.... normalValue 0..0 Normal value, if relevant
.... type 0..0 Определитель контрольного диапазона
.... appliesTo 0..0 Популяция контрольного диапазона
.... age 0..0 Применимый возрастной диапазон, если это уместно
... hasMember 0..0 Связанный ресурс, принадлежащий группе наблюдения
... derivedFrom 0..0 Связанный ресурс, с помощью которого производится наблюдение
... component 0..0 Результаты по компонентам

doco Документация для этого формата

Терминологические привязки (дифференциал)

Путь Статус Использование ValueSet Версия Источник
Observation.code Base required Справочник лабораторных исследований 📦0.2.6803 этот IG
Observation.value[x]:valueQuantity Base required Справочник единиц измерения для лабораторных исследований 📦0.2.6803 этот IG
Observation.method Base required Справочник лабораторных методов исследования 📦0.2.6803 этот IG

Ограничения

Id Градация Путь(и) Описание Выражение
ObservationLabTestStatusRule error Observation Статус ресурса может иметь значения registered | final status = 'registered' or status = 'final'
НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Observation C 0..* Observation Осмотры, обследования, опросы и измерения
Constraints: obs-6, obs-7, obs-8, ObservationLabTestStatusRule
... id Σ 0..1 id Логический идентификатор этого артефакта
... meta Σ 1..1 Meta Метаданные о ресурсе
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... lastUpdated Σ 0..1 instant Дата и время последнего обновления
.... profile Σ 1..1 canonical(StructureDefinition) Ссылка на профиль

Требуемый шаблон: https://fhir.by/StructureDefinition/ObservationLabTest
... identifier Σ 1..1 Identifier Идентификатор создавшей результат по показателю ЛИС
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... value ΣC 1..1 string Идентификатор результат по показателю ЛИС. Должен быть уникален для данного УЗ
Пример General: 123456
.... assigner Σ 1..1 Reference(Учреждение здравоохранения) Ссылка на УЗ, создавшее результат по показателю ЛИС
..... id 0..1 id Уникальный идентификатор для межэлементных ссылок
..... Разрезы для extension 1..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
...... extension:locationReference 1..1 Reference(Структурное подразделение) Ссылка на структурное подразделение
URL: https://fhir.by/StructureDefinition/LocationReference
..... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
..... display ΣC 0..1 string Текстовая трактовка ресурса
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... status ?!Σ 1..1 code Статус наблюдения. (registered | final . registered – на момент создания исследования и описание к нему, final – после первичного добавления описания исследования)
Привязка: ObservationStatus (required): Коды, определяющие статус наблюдения.
... code ΣC 1..1 CodeableConcept Код показателя
Привязка: Справочник лабораторных исследований (required)
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... coding Σ 1..1 Coding Концепт показателя
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... system Σ 1..1 uri Ссылка на справочник
..... code ΣC 1..1 code Код
..... display ΣC 0..1 string Значение кода
... subject Σ 1..1 Reference(Пациент | Пациент без ИН | Анонимный пациент) Ссылка на пациента
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... Разрезы для effective[x] Σ 1..1 dateTime Клинически значимое время/период наблюдения
Разрез: Не упорядочено, Закрыто от type:$this
.... effective[x]:effectiveDateTime Σ 1..1 dateTime Дата измерения показателя
... performer Σ 0..1 Reference(Роль медицинского работника) Ссылка на работника ЛИС несущего ответственность за наблюдение
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... Разрезы для value[x] ΣC 0..1 Значение показателя
Разрез: Не упорядочено, Открыто от type:$this
.... valueQuantity Quantity
.... valueString string
.... valueBoolean boolean
.... value[x]:valueQuantity ΣC 0..1 Quantity Фактический результат
Привязка: Справочник единиц измерения для лабораторных исследований (required)
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... value Σ 1..1 decimal Числовое значение (с неявной точностью)
..... unit Σ 0..1 string Представление единицы измерения
..... system ΣC 1..1 uri Система, определяющая форму кодированной единицы измерения
..... code ΣC 1..1 code Код единицы измерения. Если значение безразмерное, указывать код #369
... note 0..1 Annotation Комментарий к показателю
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... text Σ 1..1 markdown Текстовое содержимое аннотации
... method 0..1 CodeableConcept Метод исследования
Привязка: Справочник лабораторных методов исследования (required)
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... system Σ 1..1 uri Ссылка на справочник
..... code ΣC 1..1 code Код
..... display ΣC 0..1 string Значение кода
... specimen C 0..1 Reference(Образец материала для лабораторного исследования) Ссылка на биоматериал
Constraints: obs-9
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... referenceRange C 0..1 BackboneElement Референсные значения по показателю
Constraints: obs-3
.... low C 0..1 SimpleQuantity(5.0.0) Нижний предел, если применимо
.... high C 0..1 SimpleQuantity(5.0.0) Верхний предел, если применимо
.... text C 0..1 markdown Текстовый диапазон ссылок в наблюдении

doco Документация для этого формата

Привязки к терминологии

Путь Статус Использование ValueSet Версия Источник
Observation.triggeredBy.​type Base required triggered Bytype 📍5.0.0 Стандарт FHIR
Observation.status Base required Observation Status 📍5.0.0 Стандарт FHIR
Observation.code Base required Справочник лабораторных исследований 📦0.2.6803 этот IG
Observation.value[x]:valueQuantity Base required Справочник единиц измерения для лабораторных исследований 📦0.2.6803 этот IG
Observation.method Base required Справочник лабораторных методов исследования 📦0.2.6803 этот IG
Observation.component.​code Base example LOINC Codes 📍5.0.0 Стандарт FHIR
Observation.component.​dataAbsentReason Base extensible Data Absent Reason 📍5.0.0 Стандарт FHIR
Observation.component.​interpretation Base extensible Observation Interpretation Codes 📍5.0.0 Стандарт FHIR

Ограничения

Id Градация Путь(и) Описание Выражение
ObservationLabTestStatusRule error Observation Статус ресурса может иметь значения registered | final status = 'registered' or status = 'final'
dom-2 error Observation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Observation If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Observation If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Observation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 лучшая практика Observation A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ВСЕ** элементы Все элементы FHIR должны иметь @value или дочерние элементы hasValue() or (children().count() > id.count())
ext-1 error **ВСЕ** расширения Must have either extensions or value[x], not both extension.exists() != value.exists()
obs-3 error Observation.referenceRange Must have at least a low or a high or text low.exists() or high.exists() or text.exists()
obs-6 error Observation dataAbsentReason SHALL only be present if Observation.value[x] is not present dataAbsentReason.empty() or value.empty()
obs-7 error Observation If Observation.component.code is the same as Observation.code, then Observation.value SHALL NOT be present (the Observation.component.value[x] holds the value). value.empty() or component.code.where(coding.intersect(%resource.code.coding).exists()).empty()
obs-8 error Observation bodyStructure SHALL only be present if Observation.bodySite is not present bodySite.exists() implies bodyStructure.empty()
obs-9 error Observation.specimen If Observation.specimen is a reference to Group, the group can only have specimens (reference.resolve().exists() and reference.resolve() is Group) implies reference.resolve().member.entity.resolve().all($this is Specimen)

Профиль ресурса: Observation

Summary

Обязательный: 15 элементs(9 вложенные обязательны элементs)
Запрещено: 78 элементs

Структуры

Эта структура относится к этим другим структурам:

Расширения

Эта структура ссылается на эти расширения:

Разрезы

Эта структура определяет следующие Разрезы:

  • Элемент 1 разрешен в зависимости от значения Observation.effective[x]
  • Элемент 1 разрешен в зависимости от значения Observation.value[x]

Полная Схема

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Observation C 0..* Observation Осмотры, обследования, опросы и измерения
Constraints: obs-6, obs-7, obs-8, ObservationLabTestStatusRule
... id Σ 0..1 id Логический идентификатор этого артефакта
... meta Σ 1..1 Meta Метаданные о ресурсе
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... lastUpdated Σ 0..1 instant Дата и время последнего обновления
.... profile Σ 1..1 canonical(StructureDefinition) Ссылка на профиль

Требуемый шаблон: https://fhir.by/StructureDefinition/ObservationLabTest
... identifier Σ 1..1 Identifier Идентификатор создавшей результат по показателю ЛИС
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... value ΣC 1..1 string Идентификатор результат по показателю ЛИС. Должен быть уникален для данного УЗ
Пример General: 123456
.... assigner Σ 1..1 Reference(Учреждение здравоохранения) Ссылка на УЗ, создавшее результат по показателю ЛИС
..... id 0..1 id Уникальный идентификатор для межэлементных ссылок
..... Разрезы для extension 1..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
...... extension:locationReference 1..1 Reference(Структурное подразделение) Ссылка на структурное подразделение
URL: https://fhir.by/StructureDefinition/LocationReference
..... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
..... display ΣC 0..1 string Текстовая трактовка ресурса
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... status ?!Σ 1..1 code Статус наблюдения. (registered | final . registered – на момент создания исследования и описание к нему, final – после первичного добавления описания исследования)
Привязка: ObservationStatus (required): Коды, определяющие статус наблюдения.
... code ΣC 1..1 CodeableConcept Код показателя
Привязка: Справочник лабораторных исследований (required)
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... coding Σ 1..1 Coding Концепт показателя
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... system Σ 1..1 uri Ссылка на справочник
..... code ΣC 1..1 code Код
..... display ΣC 0..1 string Значение кода
... subject Σ 1..1 Reference(Пациент | Пациент без ИН | Анонимный пациент) Ссылка на пациента
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... Разрезы для effective[x] Σ 1..1 dateTime Клинически значимое время/период наблюдения
Разрез: Не упорядочено, Закрыто от type:$this
.... effective[x]:effectiveDateTime Σ 1..1 dateTime Дата измерения показателя
... performer Σ 0..1 Reference(Роль медицинского работника) Ссылка на работника ЛИС несущего ответственность за наблюдение
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... Разрезы для value[x] ΣC 0..1 Значение показателя
Разрез: Не упорядочено, Открыто от type:$this
.... valueQuantity Quantity
.... valueString string
.... valueBoolean boolean
.... value[x]:valueQuantity ΣC 0..1 Quantity Фактический результат
Привязка: Справочник единиц измерения для лабораторных исследований (required)
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... value Σ 1..1 decimal Числовое значение (с неявной точностью)
..... unit Σ 0..1 string Представление единицы измерения
..... system ΣC 1..1 uri Система, определяющая форму кодированной единицы измерения
..... code ΣC 1..1 code Код единицы измерения. Если значение безразмерное, указывать код #369
... note 0..1 Annotation Комментарий к показателю
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... text Σ 1..1 markdown Текстовое содержимое аннотации
... method 0..1 CodeableConcept Метод исследования
Привязка: Справочник лабораторных методов исследования (required)
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... coding Σ 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
..... system Σ 1..1 uri Ссылка на справочник
..... code ΣC 1..1 code Код
..... display ΣC 0..1 string Значение кода
... specimen C 0..1 Reference(Образец материала для лабораторного исследования) Ссылка на биоматериал
Constraints: obs-9
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... display ΣC 0..1 string Текстовая трактовка ресурса
... referenceRange C 0..1 BackboneElement Референсные значения по показателю
Constraints: obs-3
.... low C 0..1 SimpleQuantity(5.0.0) Нижний предел, если применимо
.... high C 0..1 SimpleQuantity(5.0.0) Верхний предел, если применимо
.... text C 0..1 markdown Текстовый диапазон ссылок в наблюдении

doco Документация для этого формата

Привязки к терминологии

Путь Статус Использование ValueSet Версия Источник
Observation.triggeredBy.​type Base required triggered Bytype 📍5.0.0 Стандарт FHIR
Observation.status Base required Observation Status 📍5.0.0 Стандарт FHIR
Observation.code Base required Справочник лабораторных исследований 📦0.2.6803 этот IG
Observation.value[x]:valueQuantity Base required Справочник единиц измерения для лабораторных исследований 📦0.2.6803 этот IG
Observation.method Base required Справочник лабораторных методов исследования 📦0.2.6803 этот IG
Observation.component.​code Base example LOINC Codes 📍5.0.0 Стандарт FHIR
Observation.component.​dataAbsentReason Base extensible Data Absent Reason 📍5.0.0 Стандарт FHIR
Observation.component.​interpretation Base extensible Observation Interpretation Codes 📍5.0.0 Стандарт FHIR

Ограничения

Id Градация Путь(и) Описание Выражение
ObservationLabTestStatusRule error Observation Статус ресурса может иметь значения registered | final status = 'registered' or status = 'final'
dom-2 error Observation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Observation If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().ofType(canonical) | %resource.descendants().ofType(uri) | %resource.descendants().ofType(url))) or descendants().where(reference = '#').exists() or descendants().where(ofType(canonical) = '#').exists() or descendants().where(ofType(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error Observation If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5 error Observation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 лучшая практика Observation A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ВСЕ** элементы Все элементы FHIR должны иметь @value или дочерние элементы hasValue() or (children().count() > id.count())
ext-1 error **ВСЕ** расширения Must have either extensions or value[x], not both extension.exists() != value.exists()
obs-3 error Observation.referenceRange Must have at least a low or a high or text low.exists() or high.exists() or text.exists()
obs-6 error Observation dataAbsentReason SHALL only be present if Observation.value[x] is not present dataAbsentReason.empty() or value.empty()
obs-7 error Observation If Observation.component.code is the same as Observation.code, then Observation.value SHALL NOT be present (the Observation.component.value[x] holds the value). value.empty() or component.code.where(coding.intersect(%resource.code.coding).exists()).empty()
obs-8 error Observation bodyStructure SHALL only be present if Observation.bodySite is not present bodySite.exists() implies bodyStructure.empty()
obs-9 error Observation.specimen If Observation.specimen is a reference to Group, the group can only have specimens (reference.resolve().exists() and reference.resolve() is Group) implies reference.resolve().member.entity.resolve().all($this is Specimen)

Схема различий

Профиль ресурса: Observation

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. Observation C 0..* Observation Осмотры, обследования, опросы и измерения
Constraints: ObservationLabTestStatusRule
... meta 1..1 Meta Метаданные о ресурсе
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... versionId 0..0 Идентификатор конкретной версии
.... lastUpdated 0..1 instant Дата и время последнего обновления
.... source 0..0 Определяет, откуда берется ресурс
.... profile 1..1 canonical(StructureDefinition) Ссылка на профиль
Требуемый шаблон: https://fhir.by/StructureDefinition/ObservationLabTest
.... security 0..0 Метки безопасности, примененные к этому ресурсу
.... tag 0..0 Теги, применяемые к этому ресурсу
... implicitRules 0..0 Набор правил, в соответствии с которыми был создан этот контент
... language 0..0 Язык содержания ресурса
... text 0..0 Краткое изложение текста ресурса для интерпретации человеком
... contained 0..0 Автономные встроенные ресурсы
... extension 0..0 Extension
... modifierExtension 0..0 Extension
... identifier 1..1 Identifier Идентификатор создавшей результат по показателю ЛИС
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... use 0..0 usual | official | temp | secondary | old (Если известно)
.... type 0..0 Описание идентификатора
.... system 0..0 Пространство имен для значения идентификатора
.... value 1..1 string Идентификатор результат по показателю ЛИС. Должен быть уникален для данного УЗ
.... period 0..0 Период времени, в течение которого идентификатор действителен для использования
.... assigner 1..1 Reference(Учреждение здравоохранения) Ссылка на УЗ, создавшее результат по показателю ЛИС
..... Разрезы для extension 1..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
...... extension:locationReference 1..1 Reference(Структурное подразделение) Ссылка на структурное подразделение
URL: https://fhir.by/StructureDefinition/LocationReference
..... reference 1..1 string Ссылка на ресурс в виде относительного URL
..... type 0..0 Тип ресурса
..... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... instantiates[x] 0..0 Создает экземпляр ИХ определения ObservationDefinition
... basedOn 0..1 Reference(Направление на исследования, выполняемые в лаборатории) Направление, на основании которого было проведено исследование
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... triggeredBy 0..0 Запускающее наблюдение (наблюдения)
... partOf 0..0 Часть события, на которое ссылается ссылка
... status 1..1 code Статус наблюдения. (registered | final . registered – на момент создания исследования и описание к нему, final – после первичного добавления описания исследования)
... category 0..0 Классификация типов наблюдений
... code 1..1 CodeableConcept Код показателя
Привязка: Справочник лабораторных исследований (required)
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... coding 1..1 Coding Концепт показателя
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... system 1..1 uri Ссылка на справочник
..... version 0..0 Версия системы
..... code 1..1 code Код
..... userSelected 0..0 Если эта кодировка была выбрана непосредственно пользователем
.... text 0..0 Простое текстовое представление концепции
... subject 1..1 Reference(Пациент | Пациент без ИН | Анонимный пациент) Ссылка на пациента
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... focus 0..0 О чем идет речь в наблюдении, если оно не касается предмета записи
... encounter 0..0 Медицинское мероприятие, во время которого проводится это наблюдение
... Разрезы для effective[x] 1..1 dateTime Клинически значимое время/период наблюдения
Разрез: Не упорядочено, Открыто от type:$this
.... effective[x]:effectiveDateTime 1..1 dateTime Дата измерения показателя
... issued 0..0 Дата и время выхода этой версии
... performer 0..1 Reference(Роль медицинского работника) Ссылка на работника ЛИС несущего ответственность за наблюдение
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... Разрезы для value[x] 0..1 Значение показателя
Разрез: Не упорядочено, Открыто от type:$this
.... valueQuantity Quantity
.... valueString string
.... valueBoolean boolean
.... value[x]:valueQuantity 0..1 Quantity Фактический результат
Привязка: Справочник единиц измерения для лабораторных исследований (required)
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... value 1..1 decimal Числовое значение (с неявной точностью)
..... comparator 0..0 < | <= | >= | > | ad - как понимать значение
..... system 1..1 uri Система, определяющая форму кодированной единицы измерения
..... code 1..1 code Код единицы измерения. Если значение безразмерное, указывать код #369
... dataAbsentReason 0..0 Почему отсутствует результат
... interpretation 0..0 Высокий, низкий, нормальный и т. д
... note 0..1 Annotation Комментарий к показателю
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... author[x] 0..0 Individual responsible for the annotation
.... time 0..0 Когда была сделана аннотация
... bodySite 0..0 Исследуемая часть тела
... bodyStructure 0..0 Исследуемая структура тела
... method 0..1 CodeableConcept Метод исследования
Привязка: Справочник лабораторных методов исследования (required)
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... coding 1..1 Coding Код, определенный в справочнике НСИ Терминология
..... id 0..0 Уникальный идентификатор для межэлементных ссылок
..... extension 0..0 Extension
..... system 1..1 uri Ссылка на справочник
..... version 0..0 Версия системы
..... code 1..1 code Код
..... userSelected 0..0 Если эта кодировка была выбрана непосредственно пользователем
.... text 0..0 Простое текстовое представление концепции
... specimen 0..1 Reference(Образец материала для лабораторного исследования) Ссылка на биоматериал
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
.... type 0..0 Тип ресурса
.... identifier 0..0 Идентификатор ресурса, если не известна ссылка на него
... device 0..0 Ссылка на устройство, которое генерирует измерения, или настройки устройства для этого устройства
... referenceRange 0..1 BackboneElement Референсные значения по показателю
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... modifierExtension 0..0 Extension
.... low 0..1 SimpleQuantity(5.0.0) Нижний предел, если применимо
.... high 0..1 SimpleQuantity(5.0.0) Верхний предел, если применимо
.... normalValue 0..0 Normal value, if relevant
.... type 0..0 Определитель контрольного диапазона
.... appliesTo 0..0 Популяция контрольного диапазона
.... age 0..0 Применимый возрастной диапазон, если это уместно
... hasMember 0..0 Связанный ресурс, принадлежащий группе наблюдения
... derivedFrom 0..0 Связанный ресурс, с помощью которого производится наблюдение
... component 0..0 Результаты по компонентам

doco Документация для этого формата

Терминологические привязки (дифференциал)

Путь Статус Использование ValueSet Версия Источник
Observation.code Base required Справочник лабораторных исследований 📦0.2.6803 этот IG
Observation.value[x]:valueQuantity Base required Справочник единиц измерения для лабораторных исследований 📦0.2.6803 этот IG
Observation.method Base required Справочник лабораторных методов исследования 📦0.2.6803 этот IG

Ограничения

Id Градация Путь(и) Описание Выражение
ObservationLabTestStatusRule error Observation Статус ресурса может иметь значения registered | final status = 'registered' or status = 'final'

Профиль ресурса: Observation

Summary

Обязательный: 15 элементs(9 вложенные обязательны элементs)
Запрещено: 78 элементs

Структуры

Эта структура относится к этим другим структурам:

Расширения

Эта структура ссылается на эти расширения:

Разрезы

Эта структура определяет следующие Разрезы:

  • Элемент 1 разрешен в зависимости от значения Observation.effective[x]
  • Элемент 1 разрешен в зависимости от значения Observation.value[x]

 


Примечания:

Поиск ресурса

Поиск в контексте пациента:

GET [FHIR_BASE]/Patient/[patientId]/Observation?[parameter]=[value]

Поиск в контексте организации:

GET [FHIR_BASE]/Organization/[organizationId]/Observation?[parameter]=[value]

  • FHIR_BASE: URL-адрес сервера

  • parameter: параметр поиска (например, _id, status, code)

  • value: значение параметра поиска

Примеры запроса:

GET [FHIR_BASE]/Patient/[patientId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest&_id=00001&status=final GET [FHIR_BASE]/Organization/[organizationId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest&code=1.2.1

Поисковые параметры поддерживаемые для профиля ObservationLabTest

Параметр поиска Тип Описание Выражение Пример
_id token По логическому идентификатору Observation.id GET [FHIR_BASE]/Patient/[patientId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest&_id=1234567890
_profile reference По профилю Observation.meta.profile GET [FHIR_BASE]/Patient/[patientId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest
_lastUpdated date По дате последнего изменения (создания) Observation.meta.lastUpdated GET [FHIR_BASE]/Patient/[patientId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest&_lastUpdated=2025-05-05T10:30:00Z
identifier token Внутренний идентификатор в УЗ Observation.identifier.value GET [FHIR_BASE]/Patient/[patientId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest&identifier=1.3.12.2.1107.5.1.4.51877.30000005040804443535900000001
assigner reference Соотнесение с направляющим УЗ Observation.identifier.assigner GET [FHIR_BASE]/Patient/[patientId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest&assigner=Organization/123156789021
based-on reference По направлению Observation.basedOn (ServiceRequest) GET [FHIR_BASE]/Patient/[patientId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest&based-on=ServiceRequestLab/001
status token По статусу Observation.status GET [FHIR_BASE]/Patient/[patientId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest&status=active
code token По коду показателя Observation.code GET [FHIR_BASE]/Patient/[patientId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest&code=1.1.10
patient reference По пациенту Observation.subject (Patient) GET [FHIR_BASE]/Patient/[patientId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationLabTest&patient=Patient/001

Синтаксис метода получения ресурса

Метод получения осуществляет доступ к текущему содержимому ресурса. Взаимодействие осуществляется с помощью HTTP GET команды:

GET [FHIR_BASE]/Patient/[patientId]/Observation/[id]

Метод возвращает один экземпляр ресурса.

Возможные значения логического идентификатора («id») описаны в типе Id

При попытке доступа к несуществующему ресурсу будет возвращен HTTP статус код - 404 Not Found

Синтаксис поиска ресурса

Во всех поисковых взаимодействиях в этом руководстве используется HTTP GET команда со следующим синтаксисом:

GET [FHIR_BASE]/Patient/[patientId]/[Resource-type]?[parameter1]{:m1|m2|...}={c1|c2|...}[value1{,value2,...}]{&[parameter2]{:m1|m2|...}={c1|c2|...}[value1{,value2,...}]&...}

  • GET — это HTTP метод, используемый для получения ресурса.

  • Переменные указанные в «[]», обязательны для предоставления клиентом и будут заменены указанным строковым литералом.

  • Переменные указанные в «{}», не являются обязательными для предоставления клиентом и будут заменены указанным строковым литералом.

  • FHIR_BASE: URL-адрес сервера

  • Resource-type: имя типа ресурса (например, “Observation”).

  • parameter: параметры поиска, определенные для конкретного взаимодействия (например, «?observation=Observation/01»).

  • value: значение параметра поиска

  • {:m1 m2 …}: модификатор параметра поиска

  • {c1 c2 …}: компаратор параметра поиска

  • {,value2,…}: логическое ИЛИ

  • {&parameter2={:m1 m2 …}={c1 c2 …}[value1{,value2,…}]&…}: логическое И

Простой пример запроса поиска в RESTful с использованием HTTP GET команды: PatientBundle

GET [FHIR_BASE]/Patient/[patientId]/observation?category=value&...

Поддерживаемые параметры поиска ресурса Observation

Параметр поиска Тип Описание Выражение Пример
_id token По логическому идентификатору Observation.id GET [FHIR_BASE]/Patient/[patientId]/Observation?_id=1234567890
_profile reference По профилю Observation.meta.profile GET [FHIR_BASE]/Patient/[patientId]/Observation?_profile=https://fhir.by/StructureDefinition/ObservationSubjective
category token Классификация измерения или осмотра Observation.category GET [FHIR_BASE]/Patient/[patientId]/Observation?category=vital-signs
code token Код измерения или осмотраtype Observation.code GET [FHIR_BASE]/Patient/[patientId]/Observation?code=100002-5
combo-code token Код измерения или осмотра или код компонента измерения или осмотра Observation.code | Observation.component.code GET [FHIR_BASE]/Patient/[patientId]/Observation?code-value-string=code$100002-5,value$normal
component-code token Код компонента измерения или осмотра Observation.component.code GET [FHIR_BASE]/Patient/[patientId]/Observation?component-code=loinc\|100002-5
date date Клинически значимое время измерения или осмотра Observation.effective.ofType (dateTime) | Observation.effective.ofType (Period) GET [FHIR_BASE]/Patient/[patientId]/Observation?date=gt2024-09-09
encounter reference Прием пациента или встреча в рамках которой был зафиксирован показатель или измерение Observation.encounter GET [FHIR_BASE]/Patient/[patientId]/Observation?encounter=Encounter/0191
part-of reference Частью чего является показатель Observation.partOf GET [FHIR_BASE]/Patient/[patientId]/Observation?part-of=Procedure/94005
patient reference Пациент Observation.subject.where(resolve() is Patient) GET [FHIR_BASE]/Patient/[patientId]/Observation?patient=Patient/005
performer reference Тот, кто выполнял измерение или оценку Observation.performer GET [FHIR_BASE]/Patient/[patientId]/Observation?performer=Practitioner/1005
status token Статус измерения Observation.status GET [FHIR_BASE]/Patient/[patientId]/Observation?status=final
value-quantity quantity Значение показателя Observation.value.ofType GET [FHIR_BASE]/Patient/[patientId]/Observation?value-quantity=ge90
component-value-quantity quantity Значения показателя в компоненте Observation.component.value.ofType GET [FHIR_BASE]/Patient/[patientId]/Observation?component-value-quantity=eq50

Необходимо добавить описание Прав доступа!!!!!!

Для добавления описания нужно добавить файл input/rules/StructureDefinition-ObservationLabTest-rules.md