FHIR Release 3 (STU)

Переводит компания Health Samurai . Приглашаем поучаствовать в русификации стандарта FHIR: GitHub , Email.

Открыть в оригинале FHIR 3.0.1

8.6 Ресурс Organization - Назначение

Patient Administration

Work Group

Maturity Level: 3

Trial Use

Compartments: Not linked to any defined compartments

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

8.6.1 Область применения и использование

Данный ресурс может использоваться в совместном реестре контактной и другой информации для различных организаций или использоваться просто как поддержка для других ресурсов, которым требуется ссылаться на организации, возможно в качестве document, message или как вложенный ресурс. При использовании подхода с реестром вполне возможно существование нескольких реестров, каждый из которых имеет дело с различными типами или уровнями организации.

8.6.2 Границы и связи

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

Ресурс Organization часто входит в состав иерархии ресурсов Organization, используя свойство part-of для указания связи между родительской и дочерней организациями.
Подобная иерархия организаций способствует передаче концептуальной структуры, тогда как ресурс Location обеспечивает физическое расположение такой иерархии.
Связь между организацией и местоположением указывается в каждой точке в иерархии местоположений и ведет на соответствующий уровень в иерархии организаций. Не все эти ссылки должны вести на организацию верхнего уровня.
При составлении иерархии организаций и местоположений зачастую между ними нет четкого различия, однако, для помощи в принятии решения, местоположения всегда используются для записи того, где именно происходит оказание услуг, и, следовательно, с которыми связаны случаи обслуживания и наблюдения. Свойство Organization на этих ресурсах может не быть местоположением, где была оказана услуга.

На этот ресурс ссылаются Account, AuditEvent, CarePlan, CareTeam, ChargeItem, Claim, ClaimResponse, Communication, CommunicationRequest, Composition, Consent, Contract, Coverage, Device, DeviceRequest, DiagnosticReport, DocumentManifest, DocumentReference, EligibilityRequest, EligibilityResponse, Encounter, Endpoint, EnrollmentRequest, EnrollmentResponse, EpisodeOfCare, ExplanationOfBenefit, Flag, Goal, HealthcareService, ImagingManifest, Immunization, ImmunizationRecommendation, Linkage, Location, MeasureReport, Medication, MedicationAdministration, MedicationDispense, MedicationRequest, MedicationStatement, MessageHeader, Observation, Patient, PaymentNotice, PaymentReconciliation, Person, Practitioner, PractitionerRole, Procedure, ProcedureRequest, ProcessRequest, ProcessResponse, Provenance, ReferralRequest, ResearchStudy, Sequence, SupplyDelivery, SupplyRequest и Task

Структура

Имя	Флаги	Кард.	Тип	Описание и ограничения
Organization	I		DomainResource	Объединение в группу людей или организаций с общей целью + Организация ДОЛЖНА иметь по крайней мере название (элемент name) или идентификатор (элемент identifier), и, возможно, больше чем один Элементы, определённые в прародителе: id, meta, implicitRules, language, text, contained, extension, modifierExtension
identifier	ΣI	0..*	Identifier	Идентифицирует эту организацию в различных системах
active	?!Σ	0..1	boolean	Находится ли запись организации в активном использовании
type	Σ	0..*	CodeableConcept	Вид организации OrganizationType (Example)
name	ΣI	0..1	string	Имя организации
alias		0..*	string	A list of alternate names that the organization is known as, or was known as in the past
telecom	I	0..*	ContactPoint	Контактная информация организации + У элемента telecom организации никогда не используется тип применения 'home'
address	I	0..*	Address	Адрес организации + У элемента address организации никогда не используется тип применения 'home'
partOf	Σ	0..1	Reference(Organization)	Организация, частью которой является данная организация
contact		0..*	BackboneElement	Контакт для организации для определенной цели
purpose		0..1	CodeableConcept	Тип контакта ContactEntityType (Extensible)
name		0..1	HumanName	Имя контактного лица
telecom		0..*	ContactPoint	Контактная информация (телефон, электронная почта и т. п.) для связи
address		0..1	Address	Почтовый адрес или адрес для посещений для контакта
endpoint		0..*	Reference(Endpoint)	Technical endpoints providing access to services operated for the organization
Документация по этому формату

UML-диаграмма (Legend)

XML-шаблон

<Organization xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!--  0..* Identifier Идентифицирует эту организацию в различных системах --></identifier>
 <active value="[boolean]"/><!-- 0..1 Находится ли запись организации в активном использовании -->
 <type><!-- 0..* CodeableConcept Вид организации --></type>
 <name value="[string]"/><!--  0..1 Имя организации -->
 <alias value="[string]"/><!-- 0..* A list of alternate names that the organization is known as, or was known as in the past -->
 <telecom><!--  0..* ContactPoint Контактная информация организации --></telecom>
 <address><!--  0..* Address Адрес организации --></address>
 <partOf><!-- 0..1 Reference(Organization) Организация, частью которой является данная организация --></partOf>
 <contact>  <!-- 0..* Контакт для организации для определенной цели -->
  <purpose><!-- 0..1 CodeableConcept Тип контакта --></purpose>
  <name><!-- 0..1 HumanName Имя контактного лица --></name>
  <telecom><!-- 0..* ContactPoint Контактная информация (телефон, электронная почта и т. п.) для связи --></telecom>
  <address><!-- 0..1 Address Почтовый адрес или адрес для посещений для контакта --></address>
 </contact>
 <endpoint><!-- 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the organization --></endpoint>
</Organization>

JSON-шаблон

{
  "resourceType" : "Organization",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // C? Идентифицирует эту организацию в различных системах
  "active" : <boolean>, // Находится ли запись организации в активном использовании
  "type" : [{ CodeableConcept }], // Вид организации
  "name" : "<string>", // C? Имя организации
  "alias" : ["<string>"], // A list of alternate names that the organization is known as, or was known as in the past
  "telecom" : [{ ContactPoint }], // C? Контактная информация организации
  "address" : [{ Address }], // C? Адрес организации
  "partOf" : { Reference(Organization) }, // Организация, частью которой является данная организация
  "contact" : [{ // Контакт для организации для определенной цели
    "purpose" : { CodeableConcept }, // Тип контакта
    "name" : { HumanName }, // Имя контактного лица
    "telecom" : [{ ContactPoint }], // Контактная информация (телефон, электронная почта и т. п.) для связи
    "address" : { Address } // Почтовый адрес или адрес для посещений для контакта
  }],
  "endpoint" : [{ Reference(Endpoint) }] // Technical endpoints providing access to services operated for the organization
}

Turtle-шаблон

@prefix fhir: <http://hl7.org/fhir/> .


[ a fhir:Organization;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:Organization.identifier [ Identifier ], ... ; # 0..* Идентифицирует эту организацию в различных системах
  fhir:Organization.active [ boolean ]; # 0..1 Находится ли запись организации в активном использовании
  fhir:Organization.type [ CodeableConcept ], ... ; # 0..* Вид организации
  fhir:Organization.name [ string ]; # 0..1 Имя организации
  fhir:Organization.alias [ string ], ... ; # 0..* A list of alternate names that the organization is known as, or was known as in the past
  fhir:Organization.telecom [ ContactPoint ], ... ; # 0..* Контактная информация организации
  fhir:Organization.address [ Address ], ... ; # 0..* Адрес организации
  fhir:Organization.partOf [ Reference(Organization) ]; # 0..1 Организация, частью которой является данная организация
  fhir:Organization.contact [ # 0..* Контакт для организации для определенной цели
    fhir:Organization.contact.purpose [ CodeableConcept ]; # 0..1 Тип контакта
    fhir:Organization.contact.name [ HumanName ]; # 0..1 Имя контактного лица
    fhir:Organization.contact.telecom [ ContactPoint ], ... ; # 0..* Контактная информация (телефон, электронная почта и т. п.) для связи
    fhir:Organization.contact.address [ Address ]; # 0..1 Почтовый адрес или адрес для посещений для контакта
  ], ...;
  fhir:Organization.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to services operated for the organization
]

Changes since DSTU2

Organization

Organization.type

Max Cardinality changed from 1 to *

Organization.alias

added Element

Organization.endpoint

added Element

See the Full Difference for further information

See R2 <--> R3 Conversion Maps (status = 14 tests that all execute ok. All tests pass round-trip testing and 2 r3 resources are invalid (2 errors).).

Структура

Имя	Флаги	Кард.	Тип	Описание и ограничения
Organization	I		DomainResource	Объединение в группу людей или организаций с общей целью + Организация ДОЛЖНА иметь по крайней мере название (элемент name) или идентификатор (элемент identifier), и, возможно, больше чем один Элементы, определённые в прародителе: id, meta, implicitRules, language, text, contained, extension, modifierExtension
identifier	ΣI	0..*	Identifier	Идентифицирует эту организацию в различных системах
active	?!Σ	0..1	boolean	Находится ли запись организации в активном использовании
type	Σ	0..*	CodeableConcept	Вид организации OrganizationType (Example)
name	ΣI	0..1	string	Имя организации
alias		0..*	string	A list of alternate names that the organization is known as, or was known as in the past
telecom	I	0..*	ContactPoint	Контактная информация организации + У элемента telecom организации никогда не используется тип применения 'home'
address	I	0..*	Address	Адрес организации + У элемента address организации никогда не используется тип применения 'home'
partOf	Σ	0..1	Reference(Organization)	Организация, частью которой является данная организация
contact		0..*	BackboneElement	Контакт для организации для определенной цели
purpose		0..1	CodeableConcept	Тип контакта ContactEntityType (Extensible)
name		0..1	HumanName	Имя контактного лица
telecom		0..*	ContactPoint	Контактная информация (телефон, электронная почта и т. п.) для связи
address		0..1	Address	Почтовый адрес или адрес для посещений для контакта
endpoint		0..*	Reference(Endpoint)	Technical endpoints providing access to services operated for the organization
Документация по этому формату

UML-диаграмма (Legend)

XML-шаблон

<Organization xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!--  0..* Identifier Идентифицирует эту организацию в различных системах --></identifier>
 <active value="[boolean]"/><!-- 0..1 Находится ли запись организации в активном использовании -->
 <type><!-- 0..* CodeableConcept Вид организации --></type>
 <name value="[string]"/><!--  0..1 Имя организации -->
 <alias value="[string]"/><!-- 0..* A list of alternate names that the organization is known as, or was known as in the past -->
 <telecom><!--  0..* ContactPoint Контактная информация организации --></telecom>
 <address><!--  0..* Address Адрес организации --></address>
 <partOf><!-- 0..1 Reference(Organization) Организация, частью которой является данная организация --></partOf>
 <contact>  <!-- 0..* Контакт для организации для определенной цели -->
  <purpose><!-- 0..1 CodeableConcept Тип контакта --></purpose>
  <name><!-- 0..1 HumanName Имя контактного лица --></name>
  <telecom><!-- 0..* ContactPoint Контактная информация (телефон, электронная почта и т. п.) для связи --></telecom>
  <address><!-- 0..1 Address Почтовый адрес или адрес для посещений для контакта --></address>
 </contact>
 <endpoint><!-- 0..* Reference(Endpoint) Technical endpoints providing access to services operated for the organization --></endpoint>
</Organization>

JSON-шаблон

{
  "resourceType" : "Organization",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // C? Идентифицирует эту организацию в различных системах
  "active" : <boolean>, // Находится ли запись организации в активном использовании
  "type" : [{ CodeableConcept }], // Вид организации
  "name" : "<string>", // C? Имя организации
  "alias" : ["<string>"], // A list of alternate names that the organization is known as, or was known as in the past
  "telecom" : [{ ContactPoint }], // C? Контактная информация организации
  "address" : [{ Address }], // C? Адрес организации
  "partOf" : { Reference(Organization) }, // Организация, частью которой является данная организация
  "contact" : [{ // Контакт для организации для определенной цели
    "purpose" : { CodeableConcept }, // Тип контакта
    "name" : { HumanName }, // Имя контактного лица
    "telecom" : [{ ContactPoint }], // Контактная информация (телефон, электронная почта и т. п.) для связи
    "address" : { Address } // Почтовый адрес или адрес для посещений для контакта
  }],
  "endpoint" : [{ Reference(Endpoint) }] // Technical endpoints providing access to services operated for the organization
}

Turtle-шаблон

@prefix fhir: <http://hl7.org/fhir/> .


[ a fhir:Organization;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:Organization.identifier [ Identifier ], ... ; # 0..* Идентифицирует эту организацию в различных системах
  fhir:Organization.active [ boolean ]; # 0..1 Находится ли запись организации в активном использовании
  fhir:Organization.type [ CodeableConcept ], ... ; # 0..* Вид организации
  fhir:Organization.name [ string ]; # 0..1 Имя организации
  fhir:Organization.alias [ string ], ... ; # 0..* A list of alternate names that the organization is known as, or was known as in the past
  fhir:Organization.telecom [ ContactPoint ], ... ; # 0..* Контактная информация организации
  fhir:Organization.address [ Address ], ... ; # 0..* Адрес организации
  fhir:Organization.partOf [ Reference(Organization) ]; # 0..1 Организация, частью которой является данная организация
  fhir:Organization.contact [ # 0..* Контакт для организации для определенной цели
    fhir:Organization.contact.purpose [ CodeableConcept ]; # 0..1 Тип контакта
    fhir:Organization.contact.name [ HumanName ]; # 0..1 Имя контактного лица
    fhir:Organization.contact.telecom [ ContactPoint ], ... ; # 0..* Контактная информация (телефон, электронная почта и т. п.) для связи
    fhir:Organization.contact.address [ Address ]; # 0..1 Почтовый адрес или адрес для посещений для контакта
  ], ...;
  fhir:Organization.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to services operated for the organization
]

Changes since DSTU2

Organization

Organization.type

Max Cardinality changed from 1 to *

Organization.alias

added Element

Organization.endpoint

added Element

See the Full Difference for further information

See R2 <--> R3 Conversion Maps (status = 14 tests that all execute ok. All tests pass round-trip testing and 2 r3 resources are invalid (2 errors).).

Альтернативные определения: Основное определение (XML, JSON), XML Schema/Schematron (for ) + JSON Schema, ShEx (for Turtle)

8.6.3.1 Терминологические привязки

Путь	Описание	Тип	Ссылка
Organization.type	Используется для классификации организаций	Example	OrganizationType
Organization.contact.purpose	Цель, с которой вы будете связываться с контактным лицом	Extensible	ContactEntityType

Путь

Описание

Тип

Ссылка

Organization.type

Используется для классификации организаций

Example

OrganizationType

Organization.contact.purpose

Цель, с которой вы будете связываться с контактным лицом

Extensible

ContactEntityType

8.6.3.2 Constraints

org-1: Организация ДОЛЖНА иметь по крайней мере название (элемент name) или идентификатор (элемент identifier), и, возможно, больше чем один (expression : (identifier.count() + name.count()) > 0)
org-2: On Organization.address: У элемента address организации никогда не используется тип применения 'home' (expression on Organization.address: where(use = 'home').empty())
org-3: On Organization.telecom: У элемента telecom организации никогда не используется тип применения 'home' (expression on Organization.telecom: where(use = 'home').empty())

8.6.4 Примечания:

Контактная информация встречается в двух местах: в самом ресурсе Organization и ноль или больше использований конструкции ContactEntity. Первое должно использоваться для общей, публичной точки организации контакта. ContactEntity должно использоваться для доступа к человеку или стороне, которые были обозначены этой организацией в качестве контактного лица для конкретных целей или задач.

8.6.5 Пример иерархии организаций

Пример иерархии организаций приведён в качестве руководства, как может выглядеть иерархия местоположений в вымышленной медицинской организации.
(Уровень вложенности здесь соответствует структуре "part-of" ресурса Organization)

Медицинский центр при университете Бюргерс
    Eastern Services (prov)
        Отделение скорой помощи
        Онкологическое отделение
             Радиологический медицинский научно-исследовательский центр (обучение)
        Материнская палата
        Детская палата
        Отделение дневных процедур
    Мобильные услуги (скорая помощь)
    Научно-исследовательский центр (обучение)
        Медицинская радиология (обучение)
    Университет Бюргерс (обучение)
        Факультет медицинской радиологии (обучение)
        Бакалавриат (обучение)
        ...

Отметьте, что физические структуры в этой иерархии не присутствуют - они задаются с помощью иерархии мест (ресурсы Location).

8.6.6 Параметры поиска

Параметры поиска для этого ресурса. Также к нему применяются общие параметры. Более подробную информацию о поиске в REST, обмене сообщениями и сервисах см. в разделе Поиск.

Имя	Тип	Описание	Выражение	In Common
active	token	A server defined search that may match any of the string fields in the Address, including line, city, state, country, postalCode, and/or text	Organization.active
address	string	Адрес организации или часть адреса	Organization.address
address-city	string	Город, указанный в адресе	Organization.address.city
address-country	string	Страна, указанная в адресе	Organization.address.country
address-postalcode	string	Почтовый индекс, указанный в адресе	Organization.address.postalCode
address-state	string	Штат, указанный в адресе	Organization.address.state
address-use	token	Код применения, указанный в адресе	Organization.address.use
endpoint	reference	Technical endpoints providing access to services operated for the organization	Organization.endpoint (Endpoint)
identifier	token	Любой идентификатор этой организации (но не идентификатор эмитента (издателя) аккредитации)	Organization.identifier
name	string	A portion of the organization's name or alias	Organization.name \| Organization.alias
partof	reference	An organization of which this organization forms a part	Organization.partOf (Organization)
phonetic	string	Часть названия организации с использованием некоторого алгоритма фонетического соответствия	Organization.name
type	token	Код типа организации	Organization.type