臺灣社政領域基礎實作指引
0.0.1 - ci-build

臺灣社政領域基礎實作指引, published by 衛生福利部社會及家庭署. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/sfaassn2025-source/base/ and changes regularly. See the Directory of published versions

Resource Profile: 機構關係-OrganizationAffiliation TWSS Base

Official URL: https://sfaa.gov.tw/base/StructureDefinition/OrganizationAffiliation-twss-base Version: 0.0.1
Draft as of 2026-10-20 Computable Name: OrganizationAffiliationTWSSBase

表達彼此獨立機構間的會員、加盟或合作關係；同一法人內的上下屬關係應使用 Organization.partOf。因 TW Core IG 0.3.2 尚無 OrganizationAffiliation Profile，故繼承原生 OrganizationAffiliation，並補回適用的 TW Core IG 0.3.2 共通交換規則。

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraints    Filter: doco
OrganizationAffiliation 0..* OrganizationAffiliation Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship
OrganizationAffiliation.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
OrganizationAffiliation.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
OrganizationAffiliation.active This element must be supported. This element is included in summaries. 0..1 boolean 機構關係是否有效
OrganizationAffiliation.period This element must be supported. This element is included in summaries. 0..1 Period 機構關係的有效期間
OrganizationAffiliation.organization This element must be supported. This element is included in summaries. 1..1 Reference(機構資料-Organization TWSS Base) 主要機構、總會或聯盟
OrganizationAffiliation.participatingOrganization This element must be supported. This element is included in summaries. 1..1 Reference(機構資料-Organization TWSS Base) 參與關係的獨立機構
OrganizationAffiliation.network This element is included in summaries. 0..* Reference(Organization) 服務網絡；僅於確有獨立網絡概念時填寫
OrganizationAffiliation.code This element must be supported. This element is included in summaries. 1..* CodeableConcept 機構關係角色，例如會員、加盟或合作
Binding: OrganizationAffiliationRole (example): The role the participating organization providing services to the primary organization.

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
OrganizationAffiliation.​code Base example Organization Affiliation Role 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error OrganizationAffiliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error OrganizationAffiliation 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().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error OrganizationAffiliation 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 OrganizationAffiliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice OrganizationAffiliation A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

This structure is derived from OrganizationAffiliation

NameFlagsCard.TypeDescription & Constraints    Filter: doco
OrganizationAffiliation 0..* OrganizationAffiliation Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship
OrganizationAffiliation.active This element must be supported. 0..1 boolean 機構關係是否有效
OrganizationAffiliation.period This element must be supported. 0..1 Period 機構關係的有效期間
OrganizationAffiliation.organization This element must be supported. 1..1 Reference(機構資料-Organization TWSS Base) 主要機構、總會或聯盟
OrganizationAffiliation.network 0..* Reference(Organization) 服務網絡；僅於確有獨立網絡概念時填寫
OrganizationAffiliation.code This element must be supported. 1..* CodeableConcept 機構關係角色，例如會員、加盟或合作

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: doco
OrganizationAffiliation 0..* OrganizationAffiliation Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship
OrganizationAffiliation.id This element is included in summaries. 0..1 id Logical id of this artifact
OrganizationAffiliation.meta This element is included in summaries. 0..1 Meta Metadata about the resource
OrganizationAffiliation.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
OrganizationAffiliation.language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
OrganizationAffiliation.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
OrganizationAffiliation.contained 0..* Resource Contained, inline Resources
OrganizationAffiliation.extension 0..* Extension Additional content defined by implementations
OrganizationAffiliation.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
OrganizationAffiliation.identifier This element is included in summaries. 0..* Identifier Business identifiers that are specific to this role
OrganizationAffiliation.active This element must be supported. This element is included in summaries. 0..1 boolean 機構關係是否有效
OrganizationAffiliation.period This element must be supported. This element is included in summaries. 0..1 Period 機構關係的有效期間
OrganizationAffiliation.organization This element must be supported. This element is included in summaries. 1..1 Reference(機構資料-Organization TWSS Base) 主要機構、總會或聯盟
OrganizationAffiliation.participatingOrganization This element must be supported. This element is included in summaries. 1..1 Reference(機構資料-Organization TWSS Base) 參與關係的獨立機構
OrganizationAffiliation.network This element is included in summaries. 0..* Reference(Organization) 服務網絡；僅於確有獨立網絡概念時填寫
OrganizationAffiliation.code This element must be supported. This element is included in summaries. 1..* CodeableConcept 機構關係角色，例如會員、加盟或合作
Binding: OrganizationAffiliationRole (example): The role the participating organization providing services to the primary organization.
OrganizationAffiliation.specialty This element is included in summaries. 0..* CodeableConcept Specific specialty of the participatingOrganization in the context of the role
Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the participating organization.
OrganizationAffiliation.location This element is included in summaries. 0..* Reference(Location) The location(s) at which the role occurs
OrganizationAffiliation.healthcareService 0..* Reference(HealthcareService) Healthcare services provided through the role
OrganizationAffiliation.telecom This element is included in summaries. 0..* ContactPoint Contact details at the participatingOrganization relevant to this Affiliation
OrganizationAffiliation.endpoint 0..* Reference(Endpoint) Technical endpoints providing access to services operated for this role

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
OrganizationAffiliation.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
OrganizationAffiliation.​code Base example Organization Affiliation Role 📍4.0.1 FHIR Std.
OrganizationAffiliation.​specialty Base preferred Practice Setting Code Value Set 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error OrganizationAffiliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error OrganizationAffiliation 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().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error OrganizationAffiliation 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 OrganizationAffiliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice OrganizationAffiliation A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

This structure is derived from OrganizationAffiliation

Summary

Mandatory: 3 elements
Must-Support: 5 elements

Structures

This structure refers to these other structures:

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
OrganizationAffiliation 0..* OrganizationAffiliation Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship
OrganizationAffiliation.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
OrganizationAffiliation.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
OrganizationAffiliation.active This element must be supported. This element is included in summaries. 0..1 boolean 機構關係是否有效
OrganizationAffiliation.period This element must be supported. This element is included in summaries. 0..1 Period 機構關係的有效期間
OrganizationAffiliation.organization This element must be supported. This element is included in summaries. 1..1 Reference(機構資料-Organization TWSS Base) 主要機構、總會或聯盟
OrganizationAffiliation.participatingOrganization This element must be supported. This element is included in summaries. 1..1 Reference(機構資料-Organization TWSS Base) 參與關係的獨立機構
OrganizationAffiliation.network This element is included in summaries. 0..* Reference(Organization) 服務網絡；僅於確有獨立網絡概念時填寫
OrganizationAffiliation.code This element must be supported. This element is included in summaries. 1..* CodeableConcept 機構關係角色，例如會員、加盟或合作
Binding: OrganizationAffiliationRole (example): The role the participating organization providing services to the primary organization.

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
OrganizationAffiliation.​code Base example Organization Affiliation Role 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error OrganizationAffiliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error OrganizationAffiliation 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().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error OrganizationAffiliation 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 OrganizationAffiliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice OrganizationAffiliation A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

Differential View

This structure is derived from OrganizationAffiliation

NameFlagsCard.TypeDescription & Constraints    Filter: doco
OrganizationAffiliation 0..* OrganizationAffiliation Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship
OrganizationAffiliation.active This element must be supported. 0..1 boolean 機構關係是否有效
OrganizationAffiliation.period This element must be supported. 0..1 Period 機構關係的有效期間
OrganizationAffiliation.organization This element must be supported. 1..1 Reference(機構資料-Organization TWSS Base) 主要機構、總會或聯盟
OrganizationAffiliation.participatingOrganization This element must be supported. 1..1 Reference(機構資料-Organization TWSS Base) 參與關係的獨立機構
OrganizationAffiliation.network 0..* Reference(Organization) 服務網絡；僅於確有獨立網絡概念時填寫
OrganizationAffiliation.code This element must be supported. 1..* CodeableConcept 機構關係角色，例如會員、加盟或合作

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
OrganizationAffiliation 0..* OrganizationAffiliation Defines an affiliation/assotiation/relationship between 2 distinct oganizations, that is not a part-of relationship/sub-division relationship
OrganizationAffiliation.id This element is included in summaries. 0..1 id Logical id of this artifact
OrganizationAffiliation.meta This element is included in summaries. 0..1 Meta Metadata about the resource
OrganizationAffiliation.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created
OrganizationAffiliation.language 0..1 code Language of the resource content
Binding: CommonLanguages (preferred): A human language.
Additional BindingsPurpose
AllLanguages Max Binding
OrganizationAffiliation.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
OrganizationAffiliation.contained 0..* Resource Contained, inline Resources
OrganizationAffiliation.extension 0..* Extension Additional content defined by implementations
OrganizationAffiliation.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
OrganizationAffiliation.identifier This element is included in summaries. 0..* Identifier Business identifiers that are specific to this role
OrganizationAffiliation.active This element must be supported. This element is included in summaries. 0..1 boolean 機構關係是否有效
OrganizationAffiliation.period This element must be supported. This element is included in summaries. 0..1 Period 機構關係的有效期間
OrganizationAffiliation.organization This element must be supported. This element is included in summaries. 1..1 Reference(機構資料-Organization TWSS Base) 主要機構、總會或聯盟
OrganizationAffiliation.participatingOrganization This element must be supported. This element is included in summaries. 1..1 Reference(機構資料-Organization TWSS Base) 參與關係的獨立機構
OrganizationAffiliation.network This element is included in summaries. 0..* Reference(Organization) 服務網絡；僅於確有獨立網絡概念時填寫
OrganizationAffiliation.code This element must be supported. This element is included in summaries. 1..* CodeableConcept 機構關係角色，例如會員、加盟或合作
Binding: OrganizationAffiliationRole (example): The role the participating organization providing services to the primary organization.
OrganizationAffiliation.specialty This element is included in summaries. 0..* CodeableConcept Specific specialty of the participatingOrganization in the context of the role
Binding: PracticeSettingCodeValueSet (preferred): Specific specialty associated with the participating organization.
OrganizationAffiliation.location This element is included in summaries. 0..* Reference(Location) The location(s) at which the role occurs
OrganizationAffiliation.healthcareService 0..* Reference(HealthcareService) Healthcare services provided through the role
OrganizationAffiliation.telecom This element is included in summaries. 0..* ContactPoint Contact details at the participatingOrganization relevant to this Affiliation
OrganizationAffiliation.endpoint 0..* Reference(Endpoint) Technical endpoints providing access to services operated for this role

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
OrganizationAffiliation.​language Base preferred Common Languages 📍4.0.1 FHIR Std.
OrganizationAffiliation.​code Base example Organization Affiliation Role 📍4.0.1 FHIR Std.
OrganizationAffiliation.​specialty Base preferred Practice Setting Code Value Set 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error OrganizationAffiliation If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error OrganizationAffiliation 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().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4 error OrganizationAffiliation 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 OrganizationAffiliation If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice OrganizationAffiliation A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()

This structure is derived from OrganizationAffiliation

Summary

Mandatory: 3 elements
Must-Support: 5 elements

Structures

This structure refers to these other structures:

 

Other representations of profile: CSV, Excel, Schematron

Notes:

建議應該支援以下查詢參數：

此 Profile 使用 FHIR R4 OrganizationAffiliation Resource；伺服端建議（SHOULD）支援以下 FHIR 原生查詢參數： 完整定義請參考 FHIR R4 OrganizationAffiliation 原生查詢參數。

查詢參數 類型 說明
active token 依機構關係是否有效查詢。
identifier token 依機構關係識別碼查詢。
participating-organization reference 依參與關係的機構查詢。
primary-organization reference 依主要機構、總會或聯盟查詢。
role token 依機構關係角色查詢。