8.31 组织隶属关系-简介

工作组:Patient Administration

成熟度: 0

Trial Use

Security Category: Business

Compartments: Not linked to any defined compartments

定义两个不同组织之间的隶属/关联/关系，这不是指整体与部分的关系，也不是指主从部门关系。

8.31.1 Scope and Usage

两个组织在一段时间内的关系，其中组织实体是独立的业务实体。关系资源可以选择性的描述相关组织的地址、服务内容等详细信息。

OrganizationAffiliation 资源可用于定义组织机构之间的非层级关系，例如：

一个组织可能向另一个组织提供服务
例如：提供人力资源外包服务、放射服务、诊断实验室、餐饮服务、社区护理服务等。
两个或两个以上的组织可以组成合作伙伴或合资企业
一个组织可能是一个协会的成员，但并不隶属于协会
例如：某医院是美国医院协会的成员，某医院是四川省卫生健康信息学会的成员

8.31.2 Boundaries and Relationships

Organization.partOf（组织资源的partOf节点）用于在组织内形成层级关系，最终会指各到某个具体的组织资源。树中的每个子节点都是父节点的一个子节点。
OrganizationAffiliation资源用于描述两个不同组织之间的关系，并不要求它们之间存在级联关系。资源实例用于两个组织之间的单一链接（它不包含所有成员）。如果要存在多组织间的多个关系，要为这些关系创建多个OrganizationAffiliation资源实例。
每个实例都包含一个表示关系存系期的时段，还可以指向相关的健康服务资源和位置资源的（可选）。这些引用的位置（Location）/服务（HealthcareService）应与参与组织（OrganizationAffiliation.participatingOrganization）关联，并可供主要组织（OrganizationAffiliation.organization）使用。

当附属机构是单个组织的一部分时，不应使用此资源。

Structure

Name	Flags	Card.	Type	Description & Constraints
OrganizationAffiliation	TU		DomainResource	Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
identifier	Σ	0..*	Identifier	Business identifiers that are specific to this role
active	Σ	0..1	boolean	Whether this organization affiliation record is in active use
period	Σ	0..1	Period	The period during which the participatingOrganization is affiliated with the primary organization
organization	Σ	0..1	Reference(Organization)	主要机构，它接收来自从参与机构提供的服务。可通过多条实例来定义主要机构的多个成员。其成员（参与机构）作为此机构的某种角色存在。
participatingOrganization	Σ	0..1	Reference(Organization)	参与机构，它向作为主要机构的某种角色提供服务，其角色的通过OrganizationAffiliation.code定义（比如作为成员或作为供应商）
network	Σ	0..*	Reference(Organization)	Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
code	Σ	0..*	CodeableConcept	定义参与组织在组织关系中扮演的角色 Organization Affiliation Role (Example)
specialty	Σ	0..*	CodeableConcept	Specific specialty of the participatingOrganization in the context of the role Practice Setting Code Value Set (Preferred)
location	Σ	0..*	Reference(Location)	The location(s) at which the role occurs
healthcareService		0..*	Reference(HealthcareService)	Healthcare services provided through the role
telecom	Σ	0..*	ContactPoint	Contact details at the participatingOrganization relevant to this Affiliation
endpoint		0..*	Reference(Endpoint)	Technical endpoints providing access to services operated for this role
Documentation for this format

XML Template

<OrganizationAffiliation xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Business identifiers that are specific to this role --></identifier>
 <active value="[boolean]"/><!-- 0..1 Whether this organization affiliation record is in active use -->
 <period><!-- 0..1 Period The period during which the participatingOrganization is affiliated with the primary organization --></period>
 <organization><!-- 0..1 Reference(Organization) Organization where the role is available --></organization>
 <participatingOrganization><!-- 0..1 Reference(Organization) Organization that provides/performs the role (e.g. providing services or is a member of) --></participatingOrganization>
 <network><!-- 0..* Reference(Organization) Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined) --></network>
 <code><!-- 0..* CodeableConcept Definition of the role the participatingOrganization plays --></code>
 <specialty><!-- 0..* CodeableConcept Specific specialty of the participatingOrganization in the context of the role --></specialty>
 <location><!-- 0..* Reference(Location) The location(s) at which the role occurs --></location>
 <healthcareService><!-- 0..* Reference(HealthcareService) Healthcare services provided through the role --></healthcareService>
 <telecom><!-- 0..* ContactPoint Contact details at the participatingOrganization relevant to this Affiliation --></telecom>
 <endpoint><!-- 0..* Reference(Endpoint) Technical endpoints providing access to services operated for this role --></endpoint>
</OrganizationAffiliation>

JSON Template

{
  "resourceType" : "OrganizationAffiliation",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Business identifiers that are specific to this role
  "active" : <boolean>, // Whether this organization affiliation record is in active use
  "period" : { Period }, // The period during which the participatingOrganization is affiliated with the primary organization
  "organization" : { Reference(Organization) }, // Organization where the role is available
  "participatingOrganization" : { Reference(Organization) }, // Organization that provides/performs the role (e.g. providing services or is a member of)
  "network" : [{ Reference(Organization) }], // Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
  "code" : [{ CodeableConcept }], // Definition of the role the participatingOrganization plays
  "specialty" : [{ CodeableConcept }], // Specific specialty of the participatingOrganization in the context of the role
  "location" : [{ Reference(Location) }], // The location(s) at which the role occurs
  "healthcareService" : [{ Reference(HealthcareService) }], // Healthcare services provided through the role
  "telecom" : [{ ContactPoint }], // Contact details at the participatingOrganization relevant to this Affiliation
  "endpoint" : [{ Reference(Endpoint) }] // Technical endpoints providing access to services operated for this role
}

Turtle Template

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


[ a fhir:OrganizationAffiliation;
  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:OrganizationAffiliation.identifier [ Identifier ], ... ; # 0..* Business identifiers that are specific to this role
  fhir:OrganizationAffiliation.active [ boolean ]; # 0..1 Whether this organization affiliation record is in active use
  fhir:OrganizationAffiliation.period [ Period ]; # 0..1 The period during which the participatingOrganization is affiliated with the primary organization
  fhir:OrganizationAffiliation.organization [ Reference(Organization) ]; # 0..1 Organization where the role is available
  fhir:OrganizationAffiliation.participatingOrganization [ Reference(Organization) ]; # 0..1 Organization that provides/performs the role (e.g. providing services or is a member of)
  fhir:OrganizationAffiliation.network [ Reference(Organization) ], ... ; # 0..* Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
  fhir:OrganizationAffiliation.code [ CodeableConcept ], ... ; # 0..* Definition of the role the participatingOrganization plays
  fhir:OrganizationAffiliation.specialty [ CodeableConcept ], ... ; # 0..* Specific specialty of the participatingOrganization in the context of the role
  fhir:OrganizationAffiliation.location [ Reference(Location) ], ... ; # 0..* The location(s) at which the role occurs
  fhir:OrganizationAffiliation.healthcareService [ Reference(HealthcareService) ], ... ; # 0..* Healthcare services provided through the role
  fhir:OrganizationAffiliation.telecom [ ContactPoint ], ... ; # 0..* Contact details at the participatingOrganization relevant to this Affiliation
  fhir:OrganizationAffiliation.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to services operated for this role
]

Changes since R3

This resource did not exist in Release 2

This analysis is available as XML or JSON.

Structure

Name	Flags	Card.	Type	Description & Constraints
OrganizationAffiliation	TU		DomainResource	Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship Elements defined in Ancestors: id, meta, implicitRules, language, text, contained, extension, modifierExtension
identifier	Σ	0..*	Identifier	Business identifiers that are specific to this role
active	Σ	0..1	boolean	Whether this organization affiliation record is in active use
period	Σ	0..1	Period	The period during which the participatingOrganization is affiliated with the primary organization
organization	Σ	0..1	Reference(Organization)	Organization where the role is available
participatingOrganization	Σ	0..1	Reference(Organization)	Organization that provides/performs the role (e.g. providing services or is a member of)
network	Σ	0..*	Reference(Organization)	Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
code	Σ	0..*	CodeableConcept	Definition of the role the participatingOrganization plays Organization Affiliation Role (Example)
specialty	Σ	0..*	CodeableConcept	Specific specialty of the participatingOrganization in the context of the role Practice Setting Code Value Set (Preferred)
location	Σ	0..*	Reference(Location)	The location(s) at which the role occurs
healthcareService		0..*	Reference(HealthcareService)	Healthcare services provided through the role
telecom	Σ	0..*	ContactPoint	Contact details at the participatingOrganization relevant to this Affiliation
endpoint		0..*	Reference(Endpoint)	Technical endpoints providing access to services operated for this role
Documentation for this format

XML Template

<OrganizationAffiliation xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Business identifiers that are specific to this role --></identifier>
 <active value="[boolean]"/><!-- 0..1 Whether this organization affiliation record is in active use -->
 <period><!-- 0..1 Period The period during which the participatingOrganization is affiliated with the primary organization --></period>
 <organization><!-- 0..1 Reference(Organization) Organization where the role is available --></organization>
 <participatingOrganization><!-- 0..1 Reference(Organization) Organization that provides/performs the role (e.g. providing services or is a member of) --></participatingOrganization>
 <network><!-- 0..* Reference(Organization) Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined) --></network>
 <code><!-- 0..* CodeableConcept Definition of the role the participatingOrganization plays --></code>
 <specialty><!-- 0..* CodeableConcept Specific specialty of the participatingOrganization in the context of the role --></specialty>
 <location><!-- 0..* Reference(Location) The location(s) at which the role occurs --></location>
 <healthcareService><!-- 0..* Reference(HealthcareService) Healthcare services provided through the role --></healthcareService>
 <telecom><!-- 0..* ContactPoint Contact details at the participatingOrganization relevant to this Affiliation --></telecom>
 <endpoint><!-- 0..* Reference(Endpoint) Technical endpoints providing access to services operated for this role --></endpoint>
</OrganizationAffiliation>

JSON Template

{
  "resourceType" : "OrganizationAffiliation",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Business identifiers that are specific to this role
  "active" : <boolean>, // Whether this organization affiliation record is in active use
  "period" : { Period }, // The period during which the participatingOrganization is affiliated with the primary organization
  "organization" : { Reference(Organization) }, // Organization where the role is available
  "participatingOrganization" : { Reference(Organization) }, // Organization that provides/performs the role (e.g. providing services or is a member of)
  "network" : [{ Reference(Organization) }], // Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
  "code" : [{ CodeableConcept }], // Definition of the role the participatingOrganization plays
  "specialty" : [{ CodeableConcept }], // Specific specialty of the participatingOrganization in the context of the role
  "location" : [{ Reference(Location) }], // The location(s) at which the role occurs
  "healthcareService" : [{ Reference(HealthcareService) }], // Healthcare services provided through the role
  "telecom" : [{ ContactPoint }], // Contact details at the participatingOrganization relevant to this Affiliation
  "endpoint" : [{ Reference(Endpoint) }] // Technical endpoints providing access to services operated for this role
}

Turtle Template

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


[ a fhir:OrganizationAffiliation;
  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:OrganizationAffiliation.identifier [ Identifier ], ... ; # 0..* Business identifiers that are specific to this role
  fhir:OrganizationAffiliation.active [ boolean ]; # 0..1 Whether this organization affiliation record is in active use
  fhir:OrganizationAffiliation.period [ Period ]; # 0..1 The period during which the participatingOrganization is affiliated with the primary organization
  fhir:OrganizationAffiliation.organization [ Reference(Organization) ]; # 0..1 Organization where the role is available
  fhir:OrganizationAffiliation.participatingOrganization [ Reference(Organization) ]; # 0..1 Organization that provides/performs the role (e.g. providing services or is a member of)
  fhir:OrganizationAffiliation.network [ Reference(Organization) ], ... ; # 0..* Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)
  fhir:OrganizationAffiliation.code [ CodeableConcept ], ... ; # 0..* Definition of the role the participatingOrganization plays
  fhir:OrganizationAffiliation.specialty [ CodeableConcept ], ... ; # 0..* Specific specialty of the participatingOrganization in the context of the role
  fhir:OrganizationAffiliation.location [ Reference(Location) ], ... ; # 0..* The location(s) at which the role occurs
  fhir:OrganizationAffiliation.healthcareService [ Reference(HealthcareService) ], ... ; # 0..* Healthcare services provided through the role
  fhir:OrganizationAffiliation.telecom [ ContactPoint ], ... ; # 0..* Contact details at the participatingOrganization relevant to this Affiliation
  fhir:OrganizationAffiliation.endpoint [ Reference(Endpoint) ], ... ; # 0..* Technical endpoints providing access to services operated for this role
]

Changes since Release 3

This resource did not exist in Release 2

This analysis is available as XML or JSON.

See the Profiles & Extensions and the alternate definitions: Master Definition XML + JSON, XML Schema/Schematron + JSON Schema, ShEx (for Turtle) + see the extensions & the dependency analysis

8.31.3.1 Terminology Bindings

Path	Definition	Type	Reference
OrganizationAffiliation.code	The role the participating organization providing services to the primary organization.	Example	OrganizationAffiliationRole
OrganizationAffiliation.specialty	Specific specialty associated with the participating organization.	Preferred	PracticeSettingCodeValueSet

Path

Definition

Type

Reference

OrganizationAffiliation.code

The role the participating organization providing services to the primary organization.

Example

OrganizationAffiliationRole

OrganizationAffiliation.specialty

Specific specialty associated with the participating organization.

Preferred

PracticeSettingCodeValueSet

8.31.4 备注:

当存在其他相关属性的特定组合，或具有不同的关系存续期时，相同的两个组织之间可能存在多个OrganizationAssociation实例。
一些系统记录单个位置的服务值集合，另一些系统记录单个服务及其可用位置列表。这两种都是表示此数据的可接受选项。对于不同位置提供多项健康服务的记录方式有两种：一是分别记录每个位置可提供的服务值集合，二是分别记录每个服务的其可用位置列表。
如果HealthcareService的可用位置比机构隶属关系覆盖范围更广（即OrganizationAffiliation.healthcareService.location的数量多于OrganizationAffiliation.location的数量），那么机构以此隶属关系的身份只能在OrganizationAffiliation.location的位置提供此健康服务。不能在机构隶属关系资源中引入HealthcareService未涵盖的新位置（即OrganizationAffiliation.location的集合必须是OrganizationAffiliation.healthcareService.location的子集）。
相反，如果没有指定位置（即即OrganizationAffiliation.location元素为空），则可以假定所有位置都可用。
某些构隶属关系的实例中可能不会指定健康服务（即OrganizationAffiliation.healthcareService元素为空），而仅包含位置（即OrganizationAffiliation.location元素）。

8.31.5 联营/合资/医共体

多个机构合办的联营/合资企业或医共体，将创建一个独立的机构（Organization资源实例）来代表该医共体。组成医共体的每个机构都要创建一个单独的OrganizationAffiliation资源与医共体关联，每个机构在医共体中的详细联系方式都定义在OrganizationAffiliation.telecom中，以支持在医共体中的隶属关系进行查询。

8.31.6 Search Parameters

Search parameters for this resource. The common parameters also apply. See Searching for more information about searching in REST, messaging, and services.

Name	Type	Description	Expression	In Common
active	token	Whether this organization affiliation record is in active use	OrganizationAffiliation.active
date	date	The period during which the participatingOrganization is affiliated with the primary organization	OrganizationAffiliation.period
email	token	A value in an email contact	OrganizationAffiliation.telecom.where(system='email')
endpoint	reference	Technical endpoints providing access to services operated for this role	OrganizationAffiliation.endpoint (Endpoint)
identifier	token	An organization affiliation's Identifier	OrganizationAffiliation.identifier
location	reference	The location(s) at which the role occurs	OrganizationAffiliation.location (Location)
network	reference	Health insurance provider network in which the participatingOrganization provides the role's services (if defined) at the indicated locations (if defined)	OrganizationAffiliation.network (Organization)
participating-organization	reference	The organization that provides services to the primary organization	OrganizationAffiliation.participatingOrganization (Organization)
phone	token	A value in a phone contact	OrganizationAffiliation.telecom.where(system='phone')
primary-organization	reference	主要机构，它接收来自从参与机构提供的服务	OrganizationAffiliation.organization (Organization)
role	token	参与机构相对于主要机构所扮演的角色定义	OrganizationAffiliation.code
service	reference	Healthcare services provided through the role	OrganizationAffiliation.healthcareService (HealthcareService)
specialty	token	Specific specialty of the participatingOrganization in the context of the role	OrganizationAffiliation.specialty
telecom	token	The value in any kind of contact	OrganizationAffiliation.telecom