Единая платформа цифрового здравоохранения Узбекистана
0.5.0 - ci-build Uzbekistan флаг

Uzbekistan Digital Health Platform, опубликовано Ministry of Health of the Republic of Uzbekistan. Это руководство не является санкционированной публикацией; это непрерывная сборка для версии 0.5.0, созданной FHIR (HL7® FHIR® Standard) CI Build. Эта версия основана на нынешнем содержании https://github.com/uzinfocom-org/digital-health-ig/ и регулярно изменяется. Смотрите каталог опубликованных версий

Профиль ресурса: UZ Core PractitionerRole ( Экспериментальный )

Официальный URL: https://dhp.uz/fhir/core/StructureDefinition/uz-core-practitioner-role Версия: 0.5.0
Active по состоянию на 2025-03-12 Вычисляемое имя: UZCorePractitionerRole

Uzbekistan Core PractitionerRole profile, used to define roles of practitioners

Машинный перевод, требуется проверка человеком. Эта страница автоматически переведена с английского языка с помощью искусственного интеллекта и пока не проверена редактором. При любых расхождениях приоритет имеет оригинальная англоязычная версия.

UZ Core PractitionerRole - это связующее звено, которое помещает Practitioner внутрь Organization - и при необходимости в Location или предоставляет HealthcareService - с указанием роли и специальности. Это тот контекст, на который клинические ресурсы ссылаются как на исполнителя или заказчика: он отвечает на вопрос «в каком качестве и от чьего имени действовал данный специалист». Роли и специальности кодируются из национальных наборов значений, производных от Tibtoifa.

Когда клинический ресурс фиксирует, кто совершил действие, ссылайтесь на PractitionerRole, а не на «голый» Practitioner: один и тот же специалист может иметь несколько ролей, и только роль фиксирует то качество - и организацию, - от имени которой он действовал.

Обязательные элементы данных и элементы Must Support

Перечисленные ниже элементы должны присутствовать всегда (обязательные) либо должны поддерживаться при наличии данных (Must Support) - не все из них обязательны, но ваша система должна заполнять каждый элемент Must Support, когда располагает соответствующими данными, и обрабатывать его при получении. Это человекочитаемое резюме; формальные представления ниже задают точные кардинальности, типы и терминологические привязки.

Каждый UZ Core PractitionerRole должен содержать (Must Have)

Базовый ресурс FHIR PractitionerRole не имеет обязательных элементов, и данный профиль их не добавляет. На практике вы будете заполнять ссылки на practitioner и organization вместе (см. раздел Must Support ниже).

Каждый UZ Core PractitionerRole должен поддерживать (Must Support)

  • идентификатор роли;
  • флаг active;
  • ссылку на practitioner (кто действует);
  • ссылку на organization (работодатель или принимающая организация);
  • код роли (code) - должность/профессия, из национального набора значений ролей;
  • специальность - клиническая специализация, из национального набора значений специализаций профессий;
  • ссылку на location (где выполняется роль);
  • ссылку на healthcareService (услуга, которую обеспечивает роль).

Роль и специальность разделены на слайсы по национальным системам кодов DHP, но свободный текст (code.text) допускается там, где кодированное значение недоступно.

Построение JSON, шаг за шагом

Приведённые ниже примеры идут от наименьшего экземпляра, который примет сервер, до полностью кодированной роли. Скопируйте один из них и адаптируйте - каждое показанное значение проходит валидацию по данному профилю. Полные эталонные экземпляры приведены по ссылкам внизу страницы (кодированная роль, роль в свободном тексте).

Наименьший PractitionerRole, который следует отправлять

Базовый ресурс не имеет обязательных элементов, и данный профиль их не добавляет, но PractitionerRole полезен лишь тогда, когда он действительно связывает кого-то с каким-то местом. На практике минимум, который вы отправляете, - это practitioner (кто действует) и organization (от чьего имени), обе простые ссылки, плюс флаг active. Каждый ресурс UZ Core также должен указывать профиль, которому он заявляет о соответствии, в meta.profile:

{
  "resourceType": "PractitionerRole",
  "meta": {
    "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-practitioner-role"]
  },
  "active": true,
  "practitioner": { "reference": "Practitioner/example-practitioner" },
  "organization": { "reference": "Organization/example-organization" }
}

practitioner и organization - это простые значения Reference: цель располагается непосредственно под reference в виде Type/id. Они ссылаются соответственно на Practitioner и на Organization.

Реалистичная, кодированная роль

На практике вы указываете качество: code (должность/профессия) и specialty (клиническая специализация), а также то, где выполняется роль, через healthcareService. И code, и specialty - это списки CodeableConcept (не CodeableReference), и каждый из них разделён на слайсы по национальной системе кодов DHP, поэтому URI в system должен совпадать в точности. healthcareService - это список простых ссылок:

{
  "resourceType": "PractitionerRole",
  "meta": {
    "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-practitioner-role" ]
  },
  "active": true,
  "practitioner": { "reference": "Practitioner/example-practitioner" },
  "organization": { "reference": "Organization/example-organization" },
  "code": [
    {
      "coding": [
        {
          "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs",
          "code": "2212.14",
          "display": "Vrach ginekolog"
        }
      ]
    }
  ],
  "specialty": [
    {
      "coding": [
        {
          "system": "https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs",
          "code": "394585009",
          "display": "Akusherlik va ginekologiya"
        }
      ]
    }
  ],
  "healthcareService": [ { "reference": "HealthcareService/example-healthcareservice" } ]
}

Код роли code берётся из национальной системы position-and-profession-cs, а specialty - из profession-specialization-cs. Это две разделённые на слайсы системы в данном профиле; использование любой другой system просто оставляет слайс несопоставленным. О том, как формируются системы кодов DHP, см. Терминология.

Фиксация места выполнения роли

Роль также может ссылаться на Location, где она выполняется. location (как и healthcareService) - это список простых ссылок; обе встраиваются в тот же ресурс, что и кодированная роль выше:

{
  "healthcareService": [
    { "reference": "HealthcareService/example-healthcareservice" }
  ],
  "location": [
    { "reference": "Location/example-location" }
  ]
}

Когда кодированной роли нет

Если должность ещё отсутствует в национальном наборе значений, не придумывайте код - используйте свободный текст code.text вместо coding. Роль по-прежнему связывает practitioner с organization, она лишь описывает качество словами (полный экземпляр: роль в свободном тексте):

{
  "resourceType": "PractitionerRole",
  "meta": {
    "profile": ["https://dhp.uz/fhir/core/StructureDefinition/uz-core-practitioner-role"]
  },
  "active": true,
  "practitioner": { "reference": "Practitioner/example-practitioner" },
  "organization": { "reference": "Organization/example-organization" },
  "code": [
    { "text": "Surgeon at Republican Specialized Scientific Center of Surgery, inpatient care" }
  ],
  "healthcareService": [
    { "reference": "HealthcareService/example-healthcareservice" }
  ]
}

code.text несёт человекочитаемую роль; вы можете указать text вместе с coding или сам по себе, когда не подходит ни один национальный код. О том, когда стоит прибегнуть к свободному тексту вместо кода, см. Отсутствующие и скрытые данные.

​Примеры вызовов API и образец полезной нагрузки см. в разделе Быстрый старт внизу этой страницы.

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

You can also check for usages in the FHIR IG Statistics

Формальные представления содержимого профиля

Описание профилей, дифференциалов, снимков и их представлений.

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole(5.0.0) Roles/organizations the practitioner is associated with
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... contained 0..* Resource Contained, inline Resources
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Привязка: IdentifierUseVS (0.5.0) (required)
.... type Σ 0..1 CodeableConcept Description of identifier
Привязка: IdentifierTypeVS (0.5.0) (required)
... active SΣ 0..1 boolean Whether this practitioner role record is in active use
... practitioner SΣ 0..1 Reference(Practitioner) Practitioner that provides services for the organization
... organization SΣ 0..1 Reference(Organization) Organization where the roles are available
... code SΣ 0..* CodeableConcept Roles which this practitioner may perform
Привязка: PractitionerRole (example): The role a person plays representing an organization.
.... Разрезы для coding Σ 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:role SΣ 0..1 Coding Code defined by a terminology system
...... system SΣ 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs
...... code SΣC 1..1 code Symbol in syntax defined by the system
Привязка: PractitionerRoleVS (0.5.0) (required)
... specialty SΣ 0..* CodeableConcept Specific specialty of the practitioner
Привязка: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
.... Разрезы для coding Σ 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:dhpSpecialty SΣ 0..1 Coding Code defined by a terminology system
...... system SΣ 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs
...... code SΣC 1..1 code Symbol in syntax defined by the system
Привязка: ProfessionSpecializationVS (0.5.0) (required)
... location SΣ 0..* Reference(Location) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(HealthcareService) Healthcare services provided for this role's Organization/Location(s)

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

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

Путь Статус Использование ValueSet Версия Источник
PractitionerRole.identifier.​use Base required Types of possible identifier uses 📍0.5.0 этот IG
PractitionerRole.identifier.​type Base required Types of possible identifiers 📍0.5.0 этот IG
PractitionerRole.code Base example Practitioner Role 📍5.0.0 Стандарт FHIR
PractitionerRole.code.​coding:role.code Base required Practitioner roles 📍0.5.0 этот IG
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📍5.0.0 Стандарт FHIR
PractitionerRole.specialty.​coding:dhpSpecialty.​code Base required Profession specializations 📍0.5.0 этот IG

Ограничения

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 PractitionerRole.implicitRules, PractitionerRole.modifierExtension, PractitionerRole.identifier, PractitionerRole.identifier.use, PractitionerRole.identifier.type, PractitionerRole.active, PractitionerRole.practitioner, PractitionerRole.organization, PractitionerRole.code, PractitionerRole.code.coding, PractitionerRole.code.coding:role, PractitionerRole.code.coding:role.system, PractitionerRole.code.coding:role.code, PractitionerRole.specialty, PractitionerRole.specialty.coding, PractitionerRole.specialty.coding:dhpSpecialty, PractitionerRole.specialty.coding:dhpSpecialty.system, PractitionerRole.specialty.coding:dhpSpecialty.code, PractitionerRole.location, PractitionerRole.healthcareService All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error PractitionerRole.modifierExtension Must have either extensions or value[x], not both extension.exists() != value.exists()

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole(5.0.0) Roles/organizations the practitioner is associated with
... identifier S 0..* Identifier Identifiers for a role/location
.... use 0..1 code usual | official | temp | secondary | old (If known)
Привязка: IdentifierUseVS (0.5.0) (required)
.... type 0..1 CodeableConcept Description of identifier
Привязка: IdentifierTypeVS (0.5.0) (required)
... active S 0..1 boolean Whether this practitioner role record is in active use
... practitioner S 0..1 Reference(Practitioner) Practitioner that provides services for the organization
... code S 0..* CodeableConcept Roles which this practitioner may perform
.... Разрезы для coding 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:role S 0..1 Coding Code defined by a terminology system
...... system S 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs
...... code S 1..1 code Symbol in syntax defined by the system
Привязка: PractitionerRoleVS (0.5.0) (required)
... specialty S 0..* CodeableConcept Specific specialty of the practitioner
.... Разрезы для coding 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:dhpSpecialty S 0..1 Coding Code defined by a terminology system
...... system S 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs
...... code S 1..1 code Symbol in syntax defined by the system
Привязка: ProfessionSpecializationVS (0.5.0) (required)
... location S 0..* Reference(Location) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(HealthcareService) Healthcare services provided for this role's Organization/Location(s)

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

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

Путь Статус Использование ValueSet Версия Источник
PractitionerRole.identifier.​use Base required Types of possible identifier uses 📍0.5.0 этот IG
PractitionerRole.identifier.​type Base required Types of possible identifiers 📍0.5.0 этот IG
PractitionerRole.code.​coding:role.code Base required Practitioner roles 📍0.5.0 этот IG
PractitionerRole.specialty.​coding:dhpSpecialty.​code Base required Profession specializations 📍0.5.0 этот IG
НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole(5.0.0) Roles/organizations the practitioner is associated with
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
... identifier SΣ 0..* Identifier Identifiers for a role/location
.... id 0..1 id Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Разрез: Не упорядочено, Открыто от value:url
Constraints: ext-1
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Привязка: IdentifierUseVS (0.5.0) (required)
.... type Σ 0..1 CodeableConcept Description of identifier
Привязка: IdentifierTypeVS (0.5.0) (required)
.... system Σ 0..1 uri The namespace for the identifier value
Пример General: http://www.acme.com/identifiers/patient
.... value ΣC 0..1 string The value that is unique
Пример General: 123456
.... period Σ 0..1 Period Time period when id is/was valid for use
.... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... active SΣ 0..1 boolean Whether this practitioner role record is in active use
... period Σ 0..1 Period The period during which the practitioner is authorized to perform in these role(s)
... practitioner SΣ 0..1 Reference(Practitioner) Practitioner that provides services for the organization
... organization SΣ 0..1 Reference(Organization) Organization where the roles are available
... code SΣ 0..* CodeableConcept Roles which this practitioner may perform
Привязка: PractitionerRole (example): The role a person plays representing an organization.
.... id 0..1 id Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Разрез: Не упорядочено, Открыто от value:url
Constraints: ext-1
.... Разрезы для coding Σ 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:role SΣ 0..1 Coding Code defined by a terminology system
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Разрез: Не упорядочено, Открыто от value:url
Constraints: ext-1
...... system SΣ 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs
...... version Σ 0..1 string Version of the system - if relevant
...... code SΣC 1..1 code Symbol in syntax defined by the system
Привязка: PractitionerRoleVS (0.5.0) (required)
...... display ΣC 0..1 string Representation defined by the system
...... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
.... text Σ 0..1 string Plain text representation of the concept
... specialty SΣ 0..* CodeableConcept Specific specialty of the practitioner
Привязка: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
.... id 0..1 id Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Разрез: Не упорядочено, Открыто от value:url
Constraints: ext-1
.... Разрезы для coding Σ 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:dhpSpecialty SΣ 0..1 Coding Code defined by a terminology system
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Разрез: Не упорядочено, Открыто от value:url
Constraints: ext-1
...... system SΣ 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs
...... version Σ 0..1 string Version of the system - if relevant
...... code SΣC 1..1 code Symbol in syntax defined by the system
Привязка: ProfessionSpecializationVS (0.5.0) (required)
...... display ΣC 0..1 string Representation defined by the system
...... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
.... text Σ 0..1 string Plain text representation of the concept
... location SΣ 0..* Reference(Location) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(HealthcareService) Healthcare services provided for this role's Organization/Location(s)
... contact 0..* ExtendedContactDetail Official contact details relating to this PractitionerRole
... characteristic 0..* CodeableConcept Collection of characteristics (attributes)
Привязка: ServiceMode (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibility).
... communication 0..* CodeableConcept A language the practitioner (in this role) can use in patient communication
Привязка: AllLanguages (required): IETF language tag for a human language
Дополнительные привязкиЦель
CommonLanguages Старт

... availability 0..* Availability Times the Practitioner is available at this location and/or healthcare service (including exceptions)
... endpoint 0..* Reference(Endpoint) Endpoints for interacting with the practitioner in this role

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

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

Путь Статус Использование ValueSet Версия Источник
PractitionerRole.language Base required All Languages 📍5.0.0 Стандарт FHIR
PractitionerRole.identifier.​use Base required Types of possible identifier uses 📍0.5.0 этот IG
PractitionerRole.identifier.​type Base required Types of possible identifiers 📍0.5.0 этот IG
PractitionerRole.code Base example Practitioner Role 📍5.0.0 Стандарт FHIR
PractitionerRole.code.​coding:role.code Base required Practitioner roles 📍0.5.0 этот IG
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📍5.0.0 Стандарт FHIR
PractitionerRole.specialty.​coding:dhpSpecialty.​code Base required Profession specializations 📍0.5.0 этот IG
PractitionerRole.characteristic Base example Service Mode 📍5.0.0 Стандарт FHIR
PractitionerRole.communication Base required All Languages 📍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 PractitionerRole.meta, PractitionerRole.implicitRules, PractitionerRole.language, PractitionerRole.text, PractitionerRole.extension, PractitionerRole.modifierExtension, PractitionerRole.identifier, PractitionerRole.identifier.extension, PractitionerRole.identifier.use, PractitionerRole.identifier.type, PractitionerRole.identifier.system, PractitionerRole.identifier.value, PractitionerRole.identifier.period, PractitionerRole.identifier.assigner, PractitionerRole.active, PractitionerRole.period, PractitionerRole.practitioner, PractitionerRole.organization, PractitionerRole.code, PractitionerRole.code.extension, PractitionerRole.code.coding, PractitionerRole.code.coding:role, PractitionerRole.code.coding:role.extension, PractitionerRole.code.coding:role.system, PractitionerRole.code.coding:role.version, PractitionerRole.code.coding:role.code, PractitionerRole.code.coding:role.display, PractitionerRole.code.coding:role.userSelected, PractitionerRole.code.text, PractitionerRole.specialty, PractitionerRole.specialty.extension, PractitionerRole.specialty.coding, PractitionerRole.specialty.coding:dhpSpecialty, PractitionerRole.specialty.coding:dhpSpecialty.extension, PractitionerRole.specialty.coding:dhpSpecialty.system, PractitionerRole.specialty.coding:dhpSpecialty.version, PractitionerRole.specialty.coding:dhpSpecialty.code, PractitionerRole.specialty.coding:dhpSpecialty.display, PractitionerRole.specialty.coding:dhpSpecialty.userSelected, PractitionerRole.specialty.text, PractitionerRole.location, PractitionerRole.healthcareService, PractitionerRole.contact, PractitionerRole.characteristic, PractitionerRole.communication, PractitionerRole.availability, PractitionerRole.endpoint All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error PractitionerRole.extension, PractitionerRole.modifierExtension, PractitionerRole.identifier.extension, PractitionerRole.code.extension, PractitionerRole.code.coding:role.extension, PractitionerRole.specialty.extension, PractitionerRole.specialty.coding:dhpSpecialty.extension Must have either extensions or value[x], not both extension.exists() != value.exists()

Summary

Обязательный: 0 элемент(4 вложенные обязательны элементs)
Обязательная поддержка: 14 элементs

Разрезы

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

  • Элемент 1 разрешен в зависимости от значения PractitionerRole.code.coding
  • Элемент 1 разрешен в зависимости от значения PractitionerRole.specialty.coding

Просмотр ключевых элементов

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole(5.0.0) Roles/organizations the practitioner is associated with
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... contained 0..* Resource Contained, inline Resources
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Привязка: IdentifierUseVS (0.5.0) (required)
.... type Σ 0..1 CodeableConcept Description of identifier
Привязка: IdentifierTypeVS (0.5.0) (required)
... active SΣ 0..1 boolean Whether this practitioner role record is in active use
... practitioner SΣ 0..1 Reference(Practitioner) Practitioner that provides services for the organization
... organization SΣ 0..1 Reference(Organization) Organization where the roles are available
... code SΣ 0..* CodeableConcept Roles which this practitioner may perform
Привязка: PractitionerRole (example): The role a person plays representing an organization.
.... Разрезы для coding Σ 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:role SΣ 0..1 Coding Code defined by a terminology system
...... system SΣ 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs
...... code SΣC 1..1 code Symbol in syntax defined by the system
Привязка: PractitionerRoleVS (0.5.0) (required)
... specialty SΣ 0..* CodeableConcept Specific specialty of the practitioner
Привязка: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
.... Разрезы для coding Σ 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:dhpSpecialty SΣ 0..1 Coding Code defined by a terminology system
...... system SΣ 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs
...... code SΣC 1..1 code Symbol in syntax defined by the system
Привязка: ProfessionSpecializationVS (0.5.0) (required)
... location SΣ 0..* Reference(Location) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(HealthcareService) Healthcare services provided for this role's Organization/Location(s)

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

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

Путь Статус Использование ValueSet Версия Источник
PractitionerRole.identifier.​use Base required Types of possible identifier uses 📍0.5.0 этот IG
PractitionerRole.identifier.​type Base required Types of possible identifiers 📍0.5.0 этот IG
PractitionerRole.code Base example Practitioner Role 📍5.0.0 Стандарт FHIR
PractitionerRole.code.​coding:role.code Base required Practitioner roles 📍0.5.0 этот IG
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📍5.0.0 Стандарт FHIR
PractitionerRole.specialty.​coding:dhpSpecialty.​code Base required Profession specializations 📍0.5.0 этот IG

Ограничения

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 PractitionerRole.implicitRules, PractitionerRole.modifierExtension, PractitionerRole.identifier, PractitionerRole.identifier.use, PractitionerRole.identifier.type, PractitionerRole.active, PractitionerRole.practitioner, PractitionerRole.organization, PractitionerRole.code, PractitionerRole.code.coding, PractitionerRole.code.coding:role, PractitionerRole.code.coding:role.system, PractitionerRole.code.coding:role.code, PractitionerRole.specialty, PractitionerRole.specialty.coding, PractitionerRole.specialty.coding:dhpSpecialty, PractitionerRole.specialty.coding:dhpSpecialty.system, PractitionerRole.specialty.coding:dhpSpecialty.code, PractitionerRole.location, PractitionerRole.healthcareService All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error PractitionerRole.modifierExtension Must have either extensions or value[x], not both extension.exists() != value.exists()

Дифференциальный вид

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole(5.0.0) Roles/organizations the practitioner is associated with
... identifier S 0..* Identifier Identifiers for a role/location
.... use 0..1 code usual | official | temp | secondary | old (If known)
Привязка: IdentifierUseVS (0.5.0) (required)
.... type 0..1 CodeableConcept Description of identifier
Привязка: IdentifierTypeVS (0.5.0) (required)
... active S 0..1 boolean Whether this practitioner role record is in active use
... practitioner S 0..1 Reference(Practitioner) Practitioner that provides services for the organization
... code S 0..* CodeableConcept Roles which this practitioner may perform
.... Разрезы для coding 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:role S 0..1 Coding Code defined by a terminology system
...... system S 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs
...... code S 1..1 code Symbol in syntax defined by the system
Привязка: PractitionerRoleVS (0.5.0) (required)
... specialty S 0..* CodeableConcept Specific specialty of the practitioner
.... Разрезы для coding 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:dhpSpecialty S 0..1 Coding Code defined by a terminology system
...... system S 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs
...... code S 1..1 code Symbol in syntax defined by the system
Привязка: ProfessionSpecializationVS (0.5.0) (required)
... location S 0..* Reference(Location) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(HealthcareService) Healthcare services provided for this role's Organization/Location(s)

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

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

Путь Статус Использование ValueSet Версия Источник
PractitionerRole.identifier.​use Base required Types of possible identifier uses 📍0.5.0 этот IG
PractitionerRole.identifier.​type Base required Types of possible identifiers 📍0.5.0 этот IG
PractitionerRole.code.​coding:role.code Base required Practitioner roles 📍0.5.0 этот IG
PractitionerRole.specialty.​coding:dhpSpecialty.​code Base required Profession specializations 📍0.5.0 этот IG

Обзор моментальных снимковView

НаименованиеФлагиКарта.ТипОписание и ограничения    Filter: Filtersdoco
.. PractitionerRole 0..* PractitionerRole(5.0.0) Roles/organizations the practitioner is associated with
... id Σ 0..1 id Logical id of this artifact
... meta Σ 0..1 Meta Metadata about the resource
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
Constraints: ext-1
... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored
Constraints: ext-1
... identifier SΣ 0..* Identifier Identifiers for a role/location
.... id 0..1 id Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Разрез: Не упорядочено, Открыто от value:url
Constraints: ext-1
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Привязка: IdentifierUseVS (0.5.0) (required)
.... type Σ 0..1 CodeableConcept Description of identifier
Привязка: IdentifierTypeVS (0.5.0) (required)
.... system Σ 0..1 uri The namespace for the identifier value
Пример General: http://www.acme.com/identifiers/patient
.... value ΣC 0..1 string The value that is unique
Пример General: 123456
.... period Σ 0..1 Period Time period when id is/was valid for use
.... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... active SΣ 0..1 boolean Whether this practitioner role record is in active use
... period Σ 0..1 Period The period during which the practitioner is authorized to perform in these role(s)
... practitioner SΣ 0..1 Reference(Practitioner) Practitioner that provides services for the organization
... organization SΣ 0..1 Reference(Organization) Organization where the roles are available
... code SΣ 0..* CodeableConcept Roles which this practitioner may perform
Привязка: PractitionerRole (example): The role a person plays representing an organization.
.... id 0..1 id Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Разрез: Не упорядочено, Открыто от value:url
Constraints: ext-1
.... Разрезы для coding Σ 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:role SΣ 0..1 Coding Code defined by a terminology system
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Разрез: Не упорядочено, Открыто от value:url
Constraints: ext-1
...... system SΣ 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs
...... version Σ 0..1 string Version of the system - if relevant
...... code SΣC 1..1 code Symbol in syntax defined by the system
Привязка: PractitionerRoleVS (0.5.0) (required)
...... display ΣC 0..1 string Representation defined by the system
...... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
.... text Σ 0..1 string Plain text representation of the concept
... specialty SΣ 0..* CodeableConcept Specific specialty of the practitioner
Привязка: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the agency.
.... id 0..1 id Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Разрез: Не упорядочено, Открыто от value:url
Constraints: ext-1
.... Разрезы для coding Σ 0..* Coding Code defined by a terminology system
Разрез: Не упорядочено, Открыто от value:system
..... coding:dhpSpecialty SΣ 0..1 Coding Code defined by a terminology system
...... id 0..1 id Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Разрез: Не упорядочено, Открыто от value:url
Constraints: ext-1
...... system SΣ 1..1 uri Identity of the terminology system
Требуемый шаблон: https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs
...... version Σ 0..1 string Version of the system - if relevant
...... code SΣC 1..1 code Symbol in syntax defined by the system
Привязка: ProfessionSpecializationVS (0.5.0) (required)
...... display ΣC 0..1 string Representation defined by the system
...... userSelected Σ 0..1 boolean If this coding was chosen directly by the user
.... text Σ 0..1 string Plain text representation of the concept
... location SΣ 0..* Reference(Location) Location(s) where the practitioner provides care
... healthcareService S 0..* Reference(HealthcareService) Healthcare services provided for this role's Organization/Location(s)
... contact 0..* ExtendedContactDetail Official contact details relating to this PractitionerRole
... characteristic 0..* CodeableConcept Collection of characteristics (attributes)
Привязка: ServiceMode (example): A custom attribute that could be provided at a service (e.g. Wheelchair accessibility).
... communication 0..* CodeableConcept A language the practitioner (in this role) can use in patient communication
Привязка: AllLanguages (required): IETF language tag for a human language
Дополнительные привязкиЦель
CommonLanguages Старт

... availability 0..* Availability Times the Practitioner is available at this location and/or healthcare service (including exceptions)
... endpoint 0..* Reference(Endpoint) Endpoints for interacting with the practitioner in this role

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

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

Путь Статус Использование ValueSet Версия Источник
PractitionerRole.language Base required All Languages 📍5.0.0 Стандарт FHIR
PractitionerRole.identifier.​use Base required Types of possible identifier uses 📍0.5.0 этот IG
PractitionerRole.identifier.​type Base required Types of possible identifiers 📍0.5.0 этот IG
PractitionerRole.code Base example Practitioner Role 📍5.0.0 Стандарт FHIR
PractitionerRole.code.​coding:role.code Base required Practitioner roles 📍0.5.0 этот IG
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📍5.0.0 Стандарт FHIR
PractitionerRole.specialty.​coding:dhpSpecialty.​code Base required Profession specializations 📍0.5.0 этот IG
PractitionerRole.characteristic Base example Service Mode 📍5.0.0 Стандарт FHIR
PractitionerRole.communication Base required All Languages 📍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 PractitionerRole.meta, PractitionerRole.implicitRules, PractitionerRole.language, PractitionerRole.text, PractitionerRole.extension, PractitionerRole.modifierExtension, PractitionerRole.identifier, PractitionerRole.identifier.extension, PractitionerRole.identifier.use, PractitionerRole.identifier.type, PractitionerRole.identifier.system, PractitionerRole.identifier.value, PractitionerRole.identifier.period, PractitionerRole.identifier.assigner, PractitionerRole.active, PractitionerRole.period, PractitionerRole.practitioner, PractitionerRole.organization, PractitionerRole.code, PractitionerRole.code.extension, PractitionerRole.code.coding, PractitionerRole.code.coding:role, PractitionerRole.code.coding:role.extension, PractitionerRole.code.coding:role.system, PractitionerRole.code.coding:role.version, PractitionerRole.code.coding:role.code, PractitionerRole.code.coding:role.display, PractitionerRole.code.coding:role.userSelected, PractitionerRole.code.text, PractitionerRole.specialty, PractitionerRole.specialty.extension, PractitionerRole.specialty.coding, PractitionerRole.specialty.coding:dhpSpecialty, PractitionerRole.specialty.coding:dhpSpecialty.extension, PractitionerRole.specialty.coding:dhpSpecialty.system, PractitionerRole.specialty.coding:dhpSpecialty.version, PractitionerRole.specialty.coding:dhpSpecialty.code, PractitionerRole.specialty.coding:dhpSpecialty.display, PractitionerRole.specialty.coding:dhpSpecialty.userSelected, PractitionerRole.specialty.text, PractitionerRole.location, PractitionerRole.healthcareService, PractitionerRole.contact, PractitionerRole.characteristic, PractitionerRole.communication, PractitionerRole.availability, PractitionerRole.endpoint All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error PractitionerRole.extension, PractitionerRole.modifierExtension, PractitionerRole.identifier.extension, PractitionerRole.code.extension, PractitionerRole.code.coding:role.extension, PractitionerRole.specialty.extension, PractitionerRole.specialty.coding:dhpSpecialty.extension Must have either extensions or value[x], not both extension.exists() != value.exists()

Summary

Обязательный: 0 элемент(4 вложенные обязательны элементs)
Обязательная поддержка: 14 элементs

Разрезы

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

  • Элемент 1 разрешен в зависимости от значения PractitionerRole.code.coding
  • Элемент 1 разрешен в зависимости от значения PractitionerRole.specialty.coding

 

Другие представления профиля: CSV, Excel, Schematron

Машинный перевод, требуется проверка человеком. Эта страница автоматически переведена с английского языка с помощью искусственного интеллекта и пока не проверена редактором. При любых расхождениях приоритет имеет оригинальная англоязычная версия.

Быстрый старт

Типовые варианты взаимодействия с API для данного профиля. Запросы требуют JWT-токена доступа - см. Безопасность и аутентификация. [base] - это базовый URL FHIR-сервера; | отделяет систему кодов от её значения и должен быть закодирован в URL как %7C.

Чтение роли медработника по идентификатору сервера

GET [base]/PractitionerRole/[id]

Поиск ролей, которые занимает медработник, или того, кто работает в организации

GET [base]/PractitionerRole?practitioner=Practitioner/[id]&active=true
GET [base]/PractitionerRole?organization=Organization/[id]
GET [base]/PractitionerRole?specialty=https://terminology.dhp.uz/fhir/core/CodeSystem/profession-specialization-cs|394585009
GET [base]/PractitionerRole?role=https://terminology.dhp.uz/fhir/core/CodeSystem/position-and-profession-cs|2212.14&location=Location/[id]

Создание новой роли медработника

POST [base]/PractitionerRole
{
  "resourceType": "PractitionerRole",
  "meta": {
    "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-practitioner-role" ]
  },
  ...
}

Обновление существующей роли медработника

PUT [base]/PractitionerRole/[id]
If-Match: W/"3"   # the ETag from your last read; 412 if it changed since
{
  "resourceType": "PractitionerRole",
  "id": "[id]",
  "meta": {
    "profile": [ "https://dhp.uz/fhir/core/StructureDefinition/uz-core-practitioner-role" ]
  },
  ...
}

Полный список поддерживаемых поисковых параметров см. в CapabilityStatement.

Связанные материалы