臺灣核心實作指引(TW Core IG)
1.0.0 - STU 1.0.0 Taiwan flag

This page is part of the 臺灣核心實作指引(TW Core IG) (v1.0.0: Releases) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Resource Profile: TW Core CareTeam

Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/CareTeam-twcore Version: 1.0.0
Active as of 2025-12-10 Computable Name: TWCoreCareTeam

此臺灣核心-照護團隊(TW Core CareTeam) Profile 說明本 IG 如何進一步定義 FHIR 的 CareTeam Resource 以呈現照護團隊資料。

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: Filtersdoco
.. CareTeam 0..* CareTeam 在健康照護過程中提供服務的照護團隊
... id Σ 0..1 id 不重複的 ID 用以識別儲存在特定 FHIR Server 中的 CareTeam 紀錄，通常又稱為邏輯性 ID。
... meta Σ 0..1 Meta 此 CareTeam Resource 的 metadata
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!SΣ 0..1 code proposed | active | suspended | inactive | entered-in-error
Binding: CareTeamStatus (required): 代表照護團隊狀態的代碼；應填入所綁定值集中的其中一個代碼。
... subject SΣ 1..1 Reference(TW Core Patient S | Group) 照護團隊所照護的對象是誰？
... encounter Σ 0..1 Reference(TW Core Encounter) 與此 CareTeam 相關的就醫事件
... participant SC 1..* BackboneElement 照護團隊中的成員
Constraints: ctm-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... role SΣ 1..1 CodeableConcept 照護團隊成員的角色
Binding: ParticipantRoles (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
.... member SΣ 1..1 Reference(TW Core Practitioner S | TW Core Organization | TW Core Patient | TW Core PractitionerRole S | TW Core CareTeam | TW Core RelatedPerson S) 團隊成員是誰
.... onBehalfOf Σ 0..1 Reference(TW Core Organization) 組織成員代表誰
... reasonReference 0..* Reference(TW Core Condition) 為何需要此照護團隊
... managingOrganization Σ 0..* Reference(TW Core Organization) 照護團隊所屬的組織

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.language Base preferred Common Languages 📦4.0.1 FHIR Std.
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base extensible Participant Roles 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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 CareTeam

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* CareTeam 在健康照護過程中提供服務的照護團隊
... id 0..1 id 不重複的 ID 用以識別儲存在特定 FHIR Server 中的 CareTeam 紀錄，通常又稱為邏輯性 ID。
... meta 0..1 Meta 此 CareTeam Resource 的 metadata
... language 0..1 code 用以表述 CareTeam Resource 內容的語言。
Binding: CommonLanguages (preferred): 人類語言；鼓勵使用 CommonLanguages 代碼表中的代碼，但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Additional BindingsPurpose
AllLanguages Max Binding
... subject S 1..1 Reference(TW Core Patient S | Group) 照護團隊所照護的對象是誰？
... encounter 0..1 Reference(TW Core Encounter) 與此 CareTeam 相關的就醫事件
... participant S 1..* BackboneElement 照護團隊中的成員
.... role S 1..1 CodeableConcept 照護團隊成員的角色
Binding: ParticipantRoles (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
.... member S 1..1 Reference(TW Core Practitioner S | TW Core Organization | TW Core Patient | TW Core PractitionerRole S | TW Core CareTeam | TW Core RelatedPerson S) 團隊成員是誰
.... onBehalfOf 0..1 Reference(TW Core Organization) 組織成員代表誰
... reasonReference 0..* Reference(TW Core Condition) 為何需要此照護團隊
... managingOrganization 0..* Reference(TW Core Organization) 照護團隊所屬的組織

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
CareTeam.language Base preferred Common Languages 📦4.0.1 FHIR Std.
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base extensible Participant Roles 📦4.0.1 FHIR Std.
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* CareTeam 在健康照護過程中提供服務的照護團隊
... id Σ 0..1 id 不重複的 ID 用以識別儲存在特定 FHIR Server 中的 CareTeam 紀錄，通常又稱為邏輯性 ID。
... meta Σ 0..1 Meta 此 CareTeam Resource 的 metadata
... 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
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier External Ids for this team
... status ?!SΣ 0..1 code proposed | active | suspended | inactive | entered-in-error
Binding: CareTeamStatus (required): 代表照護團隊狀態的代碼；應填入所綁定值集中的其中一個代碼。
... category Σ 0..* CodeableConcept Type of team
Binding: CareTeamCategory (example): Indicates the type of care team.
... name Σ 0..1 string Name of the team, such as crisis assessment team
... subject SΣ 1..1 Reference(TW Core Patient S | Group) 照護團隊所照護的對象是誰？
... encounter Σ 0..1 Reference(TW Core Encounter) 與此 CareTeam 相關的就醫事件
... period Σ 0..1 Period Time period team covers
... participant SC 1..* BackboneElement 照護團隊中的成員
Constraints: ctm-1
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... role SΣ 1..1 CodeableConcept 照護團隊成員的角色
Binding: ParticipantRoles (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
.... member SΣ 1..1 Reference(TW Core Practitioner S | TW Core Organization | TW Core Patient | TW Core PractitionerRole S | TW Core CareTeam | TW Core RelatedPerson S) 團隊成員是誰
.... onBehalfOf Σ 0..1 Reference(TW Core Organization) 組織成員代表誰
.... period 0..1 Period Time period of participant
... reasonCode 0..* CodeableConcept Why the care team exists
Binding: SNOMEDCTClinicalFindings (example): Indicates the reason for the care team.
... reasonReference 0..* Reference(TW Core Condition) 為何需要此照護團隊
... managingOrganization Σ 0..* Reference(TW Core Organization) 照護團隊所屬的組織
... telecom 0..* ContactPoint A contact detail for the care team (that applies to all members)
... note 0..* Annotation Comments made about the CareTeam

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.language Base preferred Common Languages 📦4.0.1 FHIR Std.
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.category Base example Care Team category 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base extensible Participant Roles 📦4.0.1 FHIR Std.
CareTeam.reasonCode Base example SNOMED CT Clinical Findings 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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()

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* CareTeam 在健康照護過程中提供服務的照護團隊
... id Σ 0..1 id 不重複的 ID 用以識別儲存在特定 FHIR Server 中的 CareTeam 紀錄，通常又稱為邏輯性 ID。
... meta Σ 0..1 Meta 此 CareTeam Resource 的 metadata
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... status ?!SΣ 0..1 code proposed | active | suspended | inactive | entered-in-error
Binding: CareTeamStatus (required): 代表照護團隊狀態的代碼；應填入所綁定值集中的其中一個代碼。
... subject SΣ 1..1 Reference(TW Core Patient S | Group) 照護團隊所照護的對象是誰？
... encounter Σ 0..1 Reference(TW Core Encounter) 與此 CareTeam 相關的就醫事件
... participant SC 1..* BackboneElement 照護團隊中的成員
Constraints: ctm-1
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... role SΣ 1..1 CodeableConcept 照護團隊成員的角色
Binding: ParticipantRoles (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
.... member SΣ 1..1 Reference(TW Core Practitioner S | TW Core Organization | TW Core Patient | TW Core PractitionerRole S | TW Core CareTeam | TW Core RelatedPerson S) 團隊成員是誰
.... onBehalfOf Σ 0..1 Reference(TW Core Organization) 組織成員代表誰
... reasonReference 0..* Reference(TW Core Condition) 為何需要此照護團隊
... managingOrganization Σ 0..* Reference(TW Core Organization) 照護團隊所屬的組織

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.language Base preferred Common Languages 📦4.0.1 FHIR Std.
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base extensible Participant Roles 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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 CareTeam

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* CareTeam 在健康照護過程中提供服務的照護團隊
... id 0..1 id 不重複的 ID 用以識別儲存在特定 FHIR Server 中的 CareTeam 紀錄，通常又稱為邏輯性 ID。
... meta 0..1 Meta 此 CareTeam Resource 的 metadata
... language 0..1 code 用以表述 CareTeam Resource 內容的語言。
Binding: CommonLanguages (preferred): 人類語言；鼓勵使用 CommonLanguages 代碼表中的代碼，但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Additional BindingsPurpose
AllLanguages Max Binding
... subject S 1..1 Reference(TW Core Patient S | Group) 照護團隊所照護的對象是誰？
... encounter 0..1 Reference(TW Core Encounter) 與此 CareTeam 相關的就醫事件
... participant S 1..* BackboneElement 照護團隊中的成員
.... role S 1..1 CodeableConcept 照護團隊成員的角色
Binding: ParticipantRoles (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
.... member S 1..1 Reference(TW Core Practitioner S | TW Core Organization | TW Core Patient | TW Core PractitionerRole S | TW Core CareTeam | TW Core RelatedPerson S) 團隊成員是誰
.... onBehalfOf 0..1 Reference(TW Core Organization) 組織成員代表誰
... reasonReference 0..* Reference(TW Core Condition) 為何需要此照護團隊
... managingOrganization 0..* Reference(TW Core Organization) 照護團隊所屬的組織

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
CareTeam.language Base preferred Common Languages 📦4.0.1 FHIR Std.
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base extensible Participant Roles 📦4.0.1 FHIR Std.

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. CareTeam 0..* CareTeam 在健康照護過程中提供服務的照護團隊
... id Σ 0..1 id 不重複的 ID 用以識別儲存在特定 FHIR Server 中的 CareTeam 紀錄，通常又稱為邏輯性 ID。
... meta Σ 0..1 Meta 此 CareTeam Resource 的 metadata
... 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
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier Σ 0..* Identifier External Ids for this team
... status ?!SΣ 0..1 code proposed | active | suspended | inactive | entered-in-error
Binding: CareTeamStatus (required): 代表照護團隊狀態的代碼；應填入所綁定值集中的其中一個代碼。
... category Σ 0..* CodeableConcept Type of team
Binding: CareTeamCategory (example): Indicates the type of care team.
... name Σ 0..1 string Name of the team, such as crisis assessment team
... subject SΣ 1..1 Reference(TW Core Patient S | Group) 照護團隊所照護的對象是誰？
... encounter Σ 0..1 Reference(TW Core Encounter) 與此 CareTeam 相關的就醫事件
... period Σ 0..1 Period Time period team covers
... participant SC 1..* BackboneElement 照護團隊中的成員
Constraints: ctm-1
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... role SΣ 1..1 CodeableConcept 照護團隊成員的角色
Binding: ParticipantRoles (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
.... member SΣ 1..1 Reference(TW Core Practitioner S | TW Core Organization | TW Core Patient | TW Core PractitionerRole S | TW Core CareTeam | TW Core RelatedPerson S) 團隊成員是誰
.... onBehalfOf Σ 0..1 Reference(TW Core Organization) 組織成員代表誰
.... period 0..1 Period Time period of participant
... reasonCode 0..* CodeableConcept Why the care team exists
Binding: SNOMEDCTClinicalFindings (example): Indicates the reason for the care team.
... reasonReference 0..* Reference(TW Core Condition) 為何需要此照護團隊
... managingOrganization Σ 0..* Reference(TW Core Organization) 照護團隊所屬的組織
... telecom 0..* ContactPoint A contact detail for the care team (that applies to all members)
... note 0..* Annotation Comments made about the CareTeam

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
CareTeam.language Base preferred Common Languages 📦4.0.1 FHIR Std.
CareTeam.status Base required CareTeamStatus 📍4.0.1 FHIR Std.
CareTeam.category Base example Care Team category 📍4.0.1 FHIR Std.
CareTeam.participant.​role Base extensible Participant Roles 📦4.0.1 FHIR Std.
CareTeam.reasonCode Base example SNOMED CT Clinical Findings 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
ctm-1 error CareTeam.participant CareTeam.participant.onBehalfOf can only be populated when CareTeam.participant.member is a Practitioner onBehalfOf.exists() implies (member.resolve().iif(empty(), true, ofType(Practitioner).exists()))
dom-2 error CareTeam If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error CareTeam 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 CareTeam 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 CareTeam If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice CareTeam 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()

 

Other representations of profile: CSV, Excel, Schematron

Notes:

以下概述了此Profile所需的RESTful FHIR互動功能。有關TW Core IG支援的RESTful互動功能的完整清單，請參閱TW Core Server能力聲明。

必須支援以下查詢參數：

  1. 必須（SHALL） 支援透過查詢參數 patient 及 status 查詢所有CareTeam：
    • 包含支援透過以下_include參數：CareTeam:participant:PractitionerRole,CareTeam:participant:Practitioner,CareTeam:participant:Patient,CareTeam:participant:RelatedPerson
      (如何透過reference查詢)
      (如何透過token查詢)
      GET [base]/CareTeam?patient={Type/}[id]&status={system|}[code]{,{system|}[code],...}

    例子：
    (1) GET [base]/CareTeam?patient=Patient/pat-example&status=active
    (1) GET [base]/CareTeam?patient=Patient/pat-example&status=active&_include=CareTeam:participant:RelatedPerson&_include=CareTeam:participant:Patient&_include=CareTeam:participant:Practitioner&_include=CareTeam:participant:PractitionerRole

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

  1. 建議應該（SHOULD） 支援透過查詢參數 patient 及 role 查詢所有CareTeam：
    • 包含支援透過以下_include參數：CareTeam:participant:PractitionerRole,CareTeam:participant:Practitioner,CareTeam:participant:Patient,CareTeam:participant:RelatedPerson
      (如何透過reference查詢)
      (如何透過token查詢)
      GET [base]/CareTeam?patient={Type/}[id]&role={system|}[code]{,{system|}[code],...}

    例子：
    (1) GET [base]/CareTeam?patient=Patient/pat-example&role=http://snomed.info/sct|17561000