Current Build

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

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

Patient Administration Work GroupMaturity Level: 3 Trial UseCompartments: Not linked to any defined compartments

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

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

Ресурс 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, EntryDefinition, EpisodeOfCare, ExplanationOfBenefit, Flag, Goal, HealthcareService, ImagingManifest, Immunization, ImmunizationRecommendation, Linkage, Location, MeasureReport, Medication, MedicationDispense, MedicationRequest, MedicationStatement, MessageHeader, Observation, Patient, PaymentNotice, PaymentReconciliation, Person, Practitioner, PractitionerRole, Procedure, ProcessRequest, ProcessResponse, Provenance, ResearchStudy, Sequence, ServiceRequest, SupplyDelivery, SupplyRequest и Task

Структура

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

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

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

Organization (DomainResource)Идентификатор организации, используемый для идентификации организации в различных несходных системахidentifier : Identifier [0..*]Находится ли запись организации в активном использовании (this element modifies the meaning of other elements)active : boolean [0..1]The kind(s) of organization that this istype : CodeableConcept [0..*] « Используется для классификации организаций (Strength=Example)OrganizationType?? »Имя, ассоциируемое с организациейname : string [0..1]A list of alternate names that the organization is known as, or was known as in the pastalias : string [0..*]Контактная информация организацииtelecom : ContactPoint [0..*]Адрес организацииaddress : Address [0..*]Организация, частью которой является данная организацияpartOf : Reference [0..1] « Organization »Technical endpoints providing access to services operated for the organizationendpoint : Reference [0..*] « Endpoint »ContactУказывает цель, с которой можно обращаться к этому контактуpurpose : CodeableConcept [0..1] « Цель, с которой вы будете связываться с контактным лицом (Strength=Extensible)ContactEntityType+ »Имя контактного лицаname : HumanName [0..1]A contact detail (e.g. a telephone number or an email address) by which the party may be contactedtelecom : ContactPoint [0..*]Почтовый адрес или адрес для посещений для контактаaddress : Address [0..1]Контакт для организации для определенной целиcontact[0..*]

XML-шаблон

<Organization xmlns="http://hl7.org/fhir"> doco
 <!-- 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-шаблон

{doco
  "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/> .doco


[ 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

This analysis is available as XML or JSON.

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).).

Структура

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

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

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

Organization (DomainResource)Идентификатор организации, используемый для идентификации организации в различных несходных системахidentifier : Identifier [0..*]Находится ли запись организации в активном использовании (this element modifies the meaning of other elements)active : boolean [0..1]The kind(s) of organization that this istype : CodeableConcept [0..*] « Используется для классификации организаций (Strength=Example)OrganizationType?? »Имя, ассоциируемое с организациейname : string [0..1]A list of alternate names that the organization is known as, or was known as in the pastalias : string [0..*]Контактная информация организацииtelecom : ContactPoint [0..*]Адрес организацииaddress : Address [0..*]Организация, частью которой является данная организацияpartOf : Reference [0..1] « Organization »Technical endpoints providing access to services operated for the organizationendpoint : Reference [0..*] « Endpoint »ContactУказывает цель, с которой можно обращаться к этому контактуpurpose : CodeableConcept [0..1] « Цель, с которой вы будете связываться с контактным лицом (Strength=Extensible)ContactEntityType+ »Имя контактного лицаname : HumanName [0..1]A contact detail (e.g. a telephone number or an email address) by which the party may be contactedtelecom : ContactPoint [0..*]Почтовый адрес или адрес для посещений для контактаaddress : Address [0..1]Контакт для организации для определенной целиcontact[0..*]

XML-шаблон

<Organization xmlns="http://hl7.org/fhir"> doco
 <!-- 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-шаблон

{doco
  "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/> .doco


[ 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

This analysis is available as XML or JSON.

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 + JSON Schema, ShEx (for Turtle)

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

  • 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())
  • Контактная информация встречается в двух местах: в самом ресурсе Organization и ноль или больше использований конструкции ContactEntity. Первое должно использоваться для общей, публичной точки организации контакта. ContactEntity должно использоваться для доступа к человеку или стороне, которые были обозначены этой организацией в качестве контактного лица для конкретных целей или задач.

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

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

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

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

ИмяТипОписаниеВыражениеIn Common
activetokenA server defined search that may match any of the string fields in the Address, including line, city, state, country, postalCode, and/or textOrganization.active
addressstringАдрес организации или часть адресаOrganization.address
address-citystringГород, указанный в адресеOrganization.address.city
address-countrystringСтрана, указанная в адресеOrganization.address.country
address-postalcodestringПочтовый индекс, указанный в адресеOrganization.address.postalCode
address-statestringШтат, указанный в адресеOrganization.address.state
address-usetokenКод применения, указанный в адресеOrganization.address.use
endpointreferenceTechnical endpoints providing access to services operated for the organizationOrganization.endpoint
(Endpoint)
identifiertokenЛюбой идентификатор этой организации (но не идентификатор эмитента (издателя) аккредитации)Organization.identifier
namestringA portion of the organization's name or aliasOrganization.name | Organization.alias
partofreferenceAn organization of which this organization forms a partOrganization.partOf
(Organization)
phoneticstringЧасть названия организации с использованием некоторого алгоритма фонетического соответствияOrganization.name
typetokenКод типа организацииOrganization.type