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

Профиль ресурса: Роль медицинского работника

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

Роль медицинского работника. Применяется для передачи сведений о его специализации и должности во время оказания медицинской помощи. Раздел Информация об организации и медработнике

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

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

Профиль включает в себя следующие данные:

  • тип медицинского работника (например, руководитель, врач или средний медицинский персонал);
  • специальность медицинского работника и его специализация;
  • информация о расписании медицинского работника (дате и времени приема пациентов).

Профиль используется в следующих случаях:

  • сохранение в ЦИСЗ информации о роли медицинского работника в организации здравоохранения;
  • валидация сведений о роли медицинского работника в организации здравоохранения, поступающих из МИС ОЗ.

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

You can also check for usages in the FHIR IG Statistics

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

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

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

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Роли с которыми связан практикующий специалист
... id 1..1 id Логический идентификатор этого артефакта
... meta 1..1 Meta Метаданные о ресурсе
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... versionId 0..1 id Идентификатор версии. Указывается версия ресурса, который подлежит редактированию, если предусмотрено правилами. Если версия не указана, то ресурс считается новым.
.... lastUpdated 0..1 instant Дата и время последнего обновления
.... source 0..0 Определяет, откуда берется ресурс
.... profile 1..1 canonical(StructureDefinition) Ссылка на профиль
Требуемый шаблон: https://fhir.by/StructureDefinition/PractitionerRoleBy
.... security 0..0 Метки безопасности, примененные к этому ресурсу
.... tag 0..0 Теги, применяемые к этому ресурсу
... implicitRules 0..0 Набор правил, в соответствии с которыми был создан этот контент
... contained 0..0 Автономные встроенные ресурсы
... Разрезы для extension 1..* Extension Extension
Разрез: Не упорядочено, Закрыто от value:$this.url
.... extension:practitionerPosition 1..1 (Комплекс) Информация о должности сотрудника
URL: https://fhir.by/StructureDefinition/PractitionerPosition
.... extension:registration S 0..1 (Комплекс) Информация о регистрации сотрудника в ЦИСЗ
URL: https://fhir.by/StructureDefinition/PractitionerRoleRegistration
... modifierExtension 0..0 Extension
... identifier 0..0 Идентификаторы для роли/местоположения
... period 0..1 Period Период, в течение которого сотрудник занимал должность и основание для снятия с должности
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... Разрезы для extension 0..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
..... extension:reasonString S 0..1 string Основание для снятия с должности или увольнения
URL: https://fhir.by/StructureDefinition/PractitionerRolePeriodEndReasonString
.... start 1..1 dateTime Дата принятия на должность
.... end 0..1 dateTime Дата снятия с должности
... practitioner 1..1 Reference(Медицинский работник) Ссылка на ресурс Медицинский работник (Practitioner)
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
... organization 1..1 Reference(Учреждение здравоохранения) Ссылка на ресурс Учреждение здравоохранения (Organization), в которое принят сотрудник
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
... code 0..0 Роли, которые может выполнять этот медицинский работник
... specialty 0..0 Специальность медицинского работника
... location 0..* Reference(Структурное подразделение) Ссылка на ресурс Структурное подразделение (Location), в которое принят сотрудник. Может быть частью другого более крупного структурного подразделения
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
... healthcareService 0..0 Медицинские услуги, предоставляемые для организации/месторасположения данной должности
... contact 0..0 Официальные контактные данные, относящиеся к данной должности специалиста
... characteristic 0..0 Набор характеристик (атрибутов)
... communication 0..0 Язык, который специалист (в этой роли) может использовать при общении с пациентами
... availability 0..0 Время, в течение которого специалист доступен в данном месте и/или в медицинской службе (включая исключения)
... endpoint 0..0 Endpoints for interacting with the practitioner in this role

doco Документация для этого формата
НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Роли с которыми связан практикующий специалист
... id Σ 1..1 id Логический идентификатор этого артефакта
... meta Σ 1..1 Meta Метаданные о ресурсе
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... versionId Σ 0..1 id Идентификатор версии. Указывается версия ресурса, который подлежит редактированию, если предусмотрено правилами. Если версия не указана, то ресурс считается новым.
.... lastUpdated Σ 0..1 instant Дата и время последнего обновления
.... profile Σ 1..1 canonical(StructureDefinition) Ссылка на профиль

Требуемый шаблон: https://fhir.by/StructureDefinition/PractitionerRoleBy
... text 0..1 Narrative Краткое изложение текста ресурса для интерпретации человеком
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
.... extension:practitionerPosition 1..1 (Комплекс) Информация о должности сотрудника
URL: https://fhir.by/StructureDefinition/PractitionerPosition
.... extension:registration S 0..1 (Комплекс) Информация о регистрации сотрудника в ЦИСЗ
URL: https://fhir.by/StructureDefinition/PractitionerRoleRegistration
... active Σ 0..1 boolean Активно ли используется эта запись о роли практикующего специалиста
... period Σ 0..1 Period Период, в течение которого сотрудник занимал должность и основание для снятия с должности
.... Разрезы для extension 0..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
..... extension:reasonString S 0..1 string Основание для снятия с должности или увольнения
URL: https://fhir.by/StructureDefinition/PractitionerRolePeriodEndReasonString
.... start ΣC 1..1 dateTime Дата принятия на должность
.... end ΣC 0..1 dateTime Дата снятия с должности
... practitioner Σ 1..1 Reference(Медицинский работник) Ссылка на ресурс Медицинский работник (Practitioner)
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... type Σ 0..1 uri Тип ресурса
Привязка: ResourceType (extensible): Ресурс (или, для логических моделей, URI логической модели).
.... identifier ΣC 0..1 Identifier Идентификатор ресурса, если не известна ссылка на него
.... display ΣC 0..1 string Текстовая трактовка ресурса
... organization Σ 1..1 Reference(Учреждение здравоохранения) Ссылка на ресурс Учреждение здравоохранения (Organization), в которое принят сотрудник
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... type Σ 0..1 uri Тип ресурса
Привязка: ResourceType (extensible): Ресурс (или, для логических моделей, URI логической модели).
.... identifier ΣC 0..1 Identifier Идентификатор ресурса, если не известна ссылка на него
.... display ΣC 0..1 string Текстовая трактовка ресурса
... location Σ 0..* Reference(Структурное подразделение) Ссылка на ресурс Структурное подразделение (Location), в которое принят сотрудник. Может быть частью другого более крупного структурного подразделения
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... type Σ 0..1 uri Тип ресурса
Привязка: ResourceType (extensible): Ресурс (или, для логических моделей, URI логической модели).
.... identifier ΣC 0..1 Identifier Идентификатор ресурса, если не известна ссылка на него
.... display ΣC 0..1 string Текстовая трактовка ресурса

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

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

Путь Статус Использование ValueSet Версия Источник
PractitionerRole.practitioner.​type Base extensible Resource Types 📍5.0.0 Стандарт FHIR
PractitionerRole.organization.​type Base extensible Resource Types 📍5.0.0 Стандарт FHIR
PractitionerRole.location.​type Base extensible Resource Types 📍5.0.0 Стандарт FHIR

Ограничения

Id Градация Путь(и) Описание Выражение
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole 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 PractitionerRole 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 PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 лучшая практика PractitionerRole A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ВСЕ** элементы All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ВСЕ** расширения Must have either extensions or value[x], not both extension.exists() != value.exists()

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

Summary

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

Структуры

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

Расширения

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

Полная Схема

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Роли с которыми связан практикующий специалист
... id Σ 1..1 id Логический идентификатор этого артефакта
... meta Σ 1..1 Meta Метаданные о ресурсе
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... versionId Σ 0..1 id Идентификатор версии. Указывается версия ресурса, который подлежит редактированию, если предусмотрено правилами. Если версия не указана, то ресурс считается новым.
.... lastUpdated Σ 0..1 instant Дата и время последнего обновления
.... profile Σ 1..1 canonical(StructureDefinition) Ссылка на профиль

Требуемый шаблон: https://fhir.by/StructureDefinition/PractitionerRoleBy
... text 0..1 Narrative Краткое изложение текста ресурса для интерпретации человеком
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
.... extension:practitionerPosition 1..1 (Комплекс) Информация о должности сотрудника
URL: https://fhir.by/StructureDefinition/PractitionerPosition
.... extension:registration S 0..1 (Комплекс) Информация о регистрации сотрудника в ЦИСЗ
URL: https://fhir.by/StructureDefinition/PractitionerRoleRegistration
... active Σ 0..1 boolean Активно ли используется эта запись о роли практикующего специалиста
... period Σ 0..1 Period Период, в течение которого сотрудник занимал должность и основание для снятия с должности
.... Разрезы для extension 0..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
..... extension:reasonString S 0..1 string Основание для снятия с должности или увольнения
URL: https://fhir.by/StructureDefinition/PractitionerRolePeriodEndReasonString
.... start ΣC 1..1 dateTime Дата принятия на должность
.... end ΣC 0..1 dateTime Дата снятия с должности
... practitioner Σ 1..1 Reference(Медицинский работник) Ссылка на ресурс Медицинский работник (Practitioner)
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... type Σ 0..1 uri Тип ресурса
Привязка: ResourceType (extensible): Ресурс (или, для логических моделей, URI логической модели).
.... identifier ΣC 0..1 Identifier Идентификатор ресурса, если не известна ссылка на него
.... display ΣC 0..1 string Текстовая трактовка ресурса
... organization Σ 1..1 Reference(Учреждение здравоохранения) Ссылка на ресурс Учреждение здравоохранения (Organization), в которое принят сотрудник
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... type Σ 0..1 uri Тип ресурса
Привязка: ResourceType (extensible): Ресурс (или, для логических моделей, URI логической модели).
.... identifier ΣC 0..1 Identifier Идентификатор ресурса, если не известна ссылка на него
.... display ΣC 0..1 string Текстовая трактовка ресурса
... location Σ 0..* Reference(Структурное подразделение) Ссылка на ресурс Структурное подразделение (Location), в которое принят сотрудник. Может быть частью другого более крупного структурного подразделения
.... id 0..1 id Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
Разрез: Не упорядочено, Открыто от value:url
.... reference ΣC 1..1 string Ссылка на ресурс в виде относительного URL
.... type Σ 0..1 uri Тип ресурса
Привязка: ResourceType (extensible): Ресурс (или, для логических моделей, URI логической модели).
.... identifier ΣC 0..1 Identifier Идентификатор ресурса, если не известна ссылка на него
.... display ΣC 0..1 string Текстовая трактовка ресурса

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

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

Путь Статус Использование ValueSet Версия Источник
PractitionerRole.practitioner.​type Base extensible Resource Types 📍5.0.0 Стандарт FHIR
PractitionerRole.organization.​type Base extensible Resource Types 📍5.0.0 Стандарт FHIR
PractitionerRole.location.​type Base extensible Resource Types 📍5.0.0 Стандарт FHIR

Ограничения

Id Градация Путь(и) Описание Выражение
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole 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 PractitionerRole 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 PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 лучшая практика PractitionerRole A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ВСЕ** элементы All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ВСЕ** расширения Must have either extensions or value[x], not both extension.exists() != value.exists()

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

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

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole Роли с которыми связан практикующий специалист
... id 1..1 id Логический идентификатор этого артефакта
... meta 1..1 Meta Метаданные о ресурсе
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... extension 0..0 Extension
.... versionId 0..1 id Идентификатор версии. Указывается версия ресурса, который подлежит редактированию, если предусмотрено правилами. Если версия не указана, то ресурс считается новым.
.... lastUpdated 0..1 instant Дата и время последнего обновления
.... source 0..0 Определяет, откуда берется ресурс
.... profile 1..1 canonical(StructureDefinition) Ссылка на профиль
Требуемый шаблон: https://fhir.by/StructureDefinition/PractitionerRoleBy
.... security 0..0 Метки безопасности, примененные к этому ресурсу
.... tag 0..0 Теги, применяемые к этому ресурсу
... implicitRules 0..0 Набор правил, в соответствии с которыми был создан этот контент
... contained 0..0 Автономные встроенные ресурсы
... Разрезы для extension 1..* Extension Extension
Разрез: Не упорядочено, Закрыто от value:$this.url
.... extension:practitionerPosition 1..1 (Комплекс) Информация о должности сотрудника
URL: https://fhir.by/StructureDefinition/PractitionerPosition
.... extension:registration S 0..1 (Комплекс) Информация о регистрации сотрудника в ЦИСЗ
URL: https://fhir.by/StructureDefinition/PractitionerRoleRegistration
... modifierExtension 0..0 Extension
... identifier 0..0 Идентификаторы для роли/местоположения
... period 0..1 Period Период, в течение которого сотрудник занимал должность и основание для снятия с должности
.... id 0..0 Уникальный идентификатор для межэлементных ссылок
.... Разрезы для extension 0..1 Extension Extension
Разрез: Не упорядочено, Закрыто от value:url
..... extension:reasonString S 0..1 string Основание для снятия с должности или увольнения
URL: https://fhir.by/StructureDefinition/PractitionerRolePeriodEndReasonString
.... start 1..1 dateTime Дата принятия на должность
.... end 0..1 dateTime Дата снятия с должности
... practitioner 1..1 Reference(Медицинский работник) Ссылка на ресурс Медицинский работник (Practitioner)
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
... organization 1..1 Reference(Учреждение здравоохранения) Ссылка на ресурс Учреждение здравоохранения (Organization), в которое принят сотрудник
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
... code 0..0 Роли, которые может выполнять этот медицинский работник
... specialty 0..0 Специальность медицинского работника
... location 0..* Reference(Структурное подразделение) Ссылка на ресурс Структурное подразделение (Location), в которое принят сотрудник. Может быть частью другого более крупного структурного подразделения
.... extension 0..0 Extension
.... reference 1..1 string Ссылка на ресурс в виде относительного URL
... healthcareService 0..0 Медицинские услуги, предоставляемые для организации/месторасположения данной должности
... contact 0..0 Официальные контактные данные, относящиеся к данной должности специалиста
... characteristic 0..0 Набор характеристик (атрибутов)
... communication 0..0 Язык, который специалист (в этой роли) может использовать при общении с пациентами
... availability 0..0 Время, в течение которого специалист доступен в данном месте и/или в медицинской службе (включая исключения)
... endpoint 0..0 Endpoints for interacting with the practitioner in this role

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

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

Summary

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

Структуры

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

Расширения

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

 


Примечания:

Для предотвращения дублирования значений адресов на нескольких ресурсах, ресурс PractitionerRole не содержит адреса, адрес содержится в связанном ресурсе location.

Ресурс PractitionerRole может использоваться для представления нескольких местоположений в одном экземпляре ресурса, но при использовании этого подхода различать разные контактные номера, разную доступность или разные услуги в каждом подразделении станет невозможно, так как при представлении нескольких местоположений в одном экземпляре ресурса и/или нескольких специальностей все детали применимы ко всем местоположениям.

Рекомендовано использовать один ресурс Location для одного экземпляра ресурса PractitionerRole.

Связи ресурса PractitionerRole:

            mindmap
  root((PractitionerRole))
    practitioner
            Медицинский работник
    organization
        Учреждение здравоохранения
    location
        Структурное подразделение
    healthcareService
        HealthcareService

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

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

GET [FHIR_BASE]/PractitionerRole/[id]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

GET [FHIR_BASE]/PractitionerRole?role=value&...

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

Параметр поиска Тип Описание Выражение Пример
_id token По логическому идентификатору PractitionerRole.id GET [FHIR_BASE]/PractitionerRole?_id=123456
_profile reference По профилю медицинского работника PractitionerRole.meta.profile GET [FHIR_BASE]/PractitionerRole?_profile=https://fhir.by/StructureDefinition/PractitionerRoleBy
active token Активно ли используется эта запись о роли практикующего врача PractitionerRole.active GET [FHIR_BASE]/PractitionerRole?active=true
date date Период, в течение которого практикующий специалист уполномочен выполнять эти функции PractitionerRole.period GET [FHIR_BASE]/PractitionerRole?date=2024-08-01
identifier token Идентификационный номер PractitionerRole.identifier GET [FHIR_BASE]/PractitionerRole?identifier=000001101
location reference Одно из мест, где этот практикующий врач оказывает медицинскую помощь PractitionerRole.location(Location) GET [FHIR_BASE]/PractitionerRole?location=surgery.1
organization reference Название организации, которую представляет практикующий специалист или от имени которой он действует PractitionerRole.organization(Organization) GET [FHIR_BASE]/PractitionerRole?organization=Organization/12345678901234
practitioner reference Практикующий специалист, способный предоставлять определенные услуги для организации PractitionerRole.practitioner(Practitioner) GET [FHIR_BASE]/PractitionerRole?practitioner=Practitioner/0009
position-rate token Поисковый параметр для занимаемой ставки работника PractitionerRole.extension(‘https://fhir.by/StructureDefinition/PractitionerPosition’).extension(‘https://fhir.by/StructureDefinition/PractitionerPositionRate’).value.as(CodeableConcept).coding.code GET [FHIR_BASE]/PractitionerRole?position-rate=4
position-type token Поисковый параметр для должности работника PractitionerRole.extension(‘https://fhir.by/StructureDefinition/PractitionerPosition’).extension(‘https://fhir.by/StructureDefinition/PractitionerPositionType’).value.as(CodeableConcept).coding.code GET [FHIR_BASE]/PractitionerRole?position-type=surgeon

Поиск по логическому идентификатору

GET [FHIR_BASE]/PractitionerRole?_id=123- возвращает медицинского работника с логическим идентификатором 123

GET [FHIR_BASE]/PractitionerRole?_id=123,321- возвращает медицинского работника с логическими идентификаторами 123 ИЛИ 321

GET [FHIR_BASE]/PractitionerRole?_id=123&_id=321- возвращает пустой список медицинских работников - применение логического И в данном случае не имеет смысла, но поддерживается системой

Учитывая, что логический идентификатор уникален, поиск по логическому идентификатору всегда приведет к нулю или единице записей. Во многих отношениях поиск функционально эквивалентен простому методу получения ресурса. Однако есть некоторые различия в использовании поиска вместо чтения:

  • Операции поиска всегда возвращают ресурс Bundle.

  • Если логический идентификатор существует и ресурс может быть возвращен, результатом будет Bundle, содержащий ресурс, а не сам ресурс.

  • Если логический идентификатор не существует или не может быть возвращен, результатом действительного поиска все равно будет Bundle. Bundle МОЖЕТ включать дополнительную информацию в форме OperationOutcome.

  • Доступен дополнительный функционал поиска. Например, запрос ресурса «PractitionerRole» по логическому идентификатору, а также установка критериев поиска identifier вернет медицинского работника только в том случае, если идентификатор совпал.

Поиск по профилю ресурса.

​Параметр поиска _profile используется для сопоставления ресурсов на основе значений в элементе Resource.meta.profile

Параметр поиска _profile определяется как параметр ссылочного типа.

GET [FHIR_BASE]/PractitionerRole?_profile=https://fhir.by/StructureDefinition/PractitionerRoleBy

НЕ допускается использование ТОЛЬКО параметра поиска _profile, ДОЛЖЕН использоваться ТОЛЬКО в комбинации с каким-либо другим параметром поиска (_id, name)

Поиск по роли роли медицинского работника.

Параметр поиска role определяется как параметр типа token.

Примеры поиска по роли роли медицинского работника:

GET [FHIR_BASE]/PractitionerRole?role=general-practitioner

Поиск по медицинскому работнику роли медицинского работника.

Параметр поиска practitioner определяется как параметр типа reference.

Примеры поиска по идентификатору:

GET [FHIR_BASE]/PractitionerRole?practitioner=93e9572a-6051-11ef-8116-f4e5db6d3a96 - возвращает роли медицинских работников, у которых медицинский работник имеет логический идентификатор 93e9572a-6051-11ef-8116-f4e5db6d3a96

GET [FHIR_BASE]/PractitionerRole?practitioner=93e9572a-6051-11ef-8116-f4e5db6d3a96,94783036-6051-11ef-8116-f4e5db6d3a96 - возвращает роли медицинских работников, у которых медицинские работники имеют логические идентификаторы 93e9572a-6051-11ef-8116-f4e5db6d3a96, 94783036-6051-11ef-8116-f4e5db6d3a96

Поиск по идентификатору.

Параметр поиска identifier определяется как параметр типа token.

Примеры поиска по идентификатору:

GET [FHIR_BASE]/PractitionerRole?identifier:of-type=http://fhir.by/ValueSet/PersonalDocumentType|INP|4310587A055PB9 - возвращает медицинских работников у которых Идентификационный номер равен 4310587A055PB9

GET [FHIR_BASE]/PractitionerRole?identifier=4310587A055PB9 - возвращает медицинских работников у которых идентификатор любого типа равен 4310587A055PB9

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

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