臺灣社政領域基礎實作指引
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: 人員角色-PractitionerRole TWSS Base

Official URL: https://sfaa.gov.tw/base/StructureDefinition/PractitionerRole-twss-base Version: 0.0.1
Draft as of 2026-08-10 Computable Name: PractitionerRoleTWSSBase

人員角色-PractitionerRole TWSS Base Profile 表達社家署業務中的人員角色資料。

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
.. PractitionerRole 0..* TWCorePractitionerRole 健康照護服務提供者所關聯的角色/機構
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier 人員角色識別碼，例如任職紀錄編號、派案人員編號或來源系統角色識別碼。
.... use ?!SΣ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
.... type SΣ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
.... system SΣ 0..1 uri The namespace for the identifier value
Example General: http://www.acme.com/identifiers/patient
.... value SΣ 0..1 string The value that is unique
Example General: 123456
... period SΣ 0..1 Period 人員到職日、離職日、派任起訖日或角色有效期間。
.... start SΣC 0..1 dateTime Starting time with inclusive boundary
.... end SΣC 0..1 dateTime End time with inclusive boundary, if not ongoing
... practitioner SΣ 0..1 Reference(人員資料-Practitioner TWSS Base) 擔任此角色的人員。
... organization SΣ 0..1 Reference(機構資料-Organization TWSS Base) 人員任職、派任或服務所屬機構。
... code S 0..* CodeableConceptTW 職稱、角色或職務類型。
Binding: TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 (extensible): 優先使用 TW Core 0.3.2 的 SNOMED CT + 臺灣醫事司醫事人員類別值集；若無法表達社家署社福業務角色，優先使用 SNOMED CT 既有標準碼。
... specialty S 0..* CodeableConceptTW 專長、服務類別或業務領域。
Binding: PracticeSettingCodeValueSet (preferred): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
.... Slices for coding S 0..* CodingTW 由專門術語系統（terminology system）定義的代碼
Slice: Unordered, Open by pattern:system
..... coding:TWMedicalDepartmentSCT S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 對應至 SNOMED CT之就醫科別 + 診療科別值集 (required)
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: http://snomed.info/sct
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
..... coding:TWMedicalConsultationDepartment S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 無法對應至SNOMED CT之臺灣健保署就醫科別值集 (required)
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/medical-consultation-department-tw
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
..... coding:TWMedicalTreatmentDepartment S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 無法對應至SNOMED CT之臺灣健保署診療科別值集 (required)
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/medical-treatment-department-tw
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
.... text SΣ 0..1 string 概念的文字表示法
... location SΣ 0..* Reference(服務地點及托育地址-Location TWSS Base) 人員提供服務的地點；托育人員可 reference 托育地址。
... healthcareService S 0..* Reference(HealthcareService) 此工作者為此角色的機構（Organizatoin）/地點（Location）提供的健康照護服務清單
... telecom SΣ 0..* ContactPoint 此角色使用的聯絡方式，例如辦公電話或職務聯絡信箱。
.... system SΣC 1..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
.... value SΣ 1..1 string 實際的聯絡方式之細節
.... use ?!SΣ 0..1 code home | work | temp | old | mobile－此聯絡方式的用途
Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
.... period SΣ 0..1 Period 此聯絡方式的使用效期
... availableTime S 0..* BackboneElement 服務地點可用的時間
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
... notAvailable S 0..* BackboneElement 由於提供的原因，在此期間無法使用。
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... description 1..1 string 向使用者說明為什麼此期間無法使用的原因
... availabilityExceptions S 0..1 string 描述在特定情況下服務不可用的特例

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.identifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
PractitionerRole.identifier.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
PractitionerRole.code Base extensible TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 📦0.0.1 This IG
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📦4.0.1 FHIR Std.
PractitionerRole.specialty.​coding:TWMedicalDepartmentSCT Base required 對應至 SNOMED CT之就醫科別 + 診療科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.specialty.​coding:TWMedicalConsultationDepartment Base required 無法對應至SNOMED CT之臺灣健保署就醫科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.specialty.​coding:TWMedicalTreatmentDepartment Base required 無法對應至SNOMED CT之臺灣健保署診療科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.telecom.​system Base required ContactPointSystem 📍4.0.1 FHIR Std.
PractitionerRole.telecom.​use Base required ContactPointUse 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole 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 PractitionerRole 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 PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole 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 TWCorePractitionerRole

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* TWCorePractitionerRole 健康照護服務提供者所關聯的角色/機構
... identifier 0..* Identifier 人員角色識別碼，例如任職紀錄編號、派案人員編號或來源系統角色識別碼。
.... use S 0..1 code usual | official | temp | secondary | old (If known)
.... type S 0..1 CodeableConcept Description of identifier
.... system S 0..1 uri The namespace for the identifier value
.... value S 0..1 string The value that is unique
... period S 0..1 Period 人員到職日、離職日、派任起訖日或角色有效期間。
.... start S 0..1 dateTime Starting time with inclusive boundary
.... end S 0..1 dateTime End time with inclusive boundary, if not ongoing
... practitioner 0..1 Reference(人員資料-Practitioner TWSS Base) 擔任此角色的人員。
... code 0..* CodeableConceptTW 職稱、角色或職務類型。
Binding: TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 (extensible): 優先使用 TW Core 0.3.2 的 SNOMED CT + 臺灣醫事司醫事人員類別值集；若無法表達社家署社福業務角色，優先使用 SNOMED CT 既有標準碼。
... specialty 0..* CodeableConceptTW 專長、服務類別或業務領域。
... location 0..* Reference(服務地點及托育地址-Location TWSS Base) 人員提供服務的地點；托育人員可 reference 托育地址。
... healthcareService S 0..* Reference(HealthcareService) 此工作者為此角色的機構（Organizatoin）/地點（Location）提供的健康照護服務清單
... telecom 0..* ContactPoint 此角色使用的聯絡方式，例如辦公電話或職務聯絡信箱。
... availableTime S 0..* BackboneElement 服務地點可用的時間
... notAvailable S 0..* BackboneElement 由於提供的原因，在此期間無法使用。
... availabilityExceptions S 0..1 string 描述在特定情況下服務不可用的特例

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
PractitionerRole.code Base extensible TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 📦0.0.1 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* TWCorePractitionerRole 健康照護服務提供者所關聯的角色/機構
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的PractitionerRole紀錄，通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此PractitionerRole Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative PractitionerRole Resource之內容摘要以供人閱讀
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 SΣ 0..* Identifier 人員角色識別碼，例如任職紀錄編號、派案人員編號或來源系統角色識別碼。
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!SΣ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
.... type SΣ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
.... system SΣ 0..1 uri The namespace for the identifier value
Example General: http://www.acme.com/identifiers/patient
.... value SΣ 0..1 string The value that is unique
Example General: 123456
.... period Σ 0..1 Period Time period when id is/was valid for use
.... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... active SΣ 0..1 boolean 此健康照護服務提供者角色紀錄是否有效
... period SΣ 0..1 Period 人員到職日、離職日、派任起訖日或角色有效期間。
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... start SΣC 0..1 dateTime Starting time with inclusive boundary
.... end SΣC 0..1 dateTime End time with inclusive boundary, if not ongoing
... practitioner SΣ 0..1 Reference(人員資料-Practitioner TWSS Base) 擔任此角色的人員。
... organization SΣ 0..1 Reference(機構資料-Organization TWSS Base) 人員任職、派任或服務所屬機構。
... code S 0..* CodeableConceptTW 職稱、角色或職務類型。
Binding: TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 (extensible): 優先使用 TW Core 0.3.2 的 SNOMED CT + 臺灣醫事司醫事人員類別值集；若無法表達社家署社福業務角色，優先使用 SNOMED CT 既有標準碼。
... specialty S 0..* CodeableConceptTW 專長、服務類別或業務領域。
Binding: PracticeSettingCodeValueSet (preferred): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
.... id 0..1 string 唯一可識別ID，以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
.... Slices for coding S 0..* CodingTW 由專門術語系統（terminology system）定義的代碼
Slice: Unordered, Open by pattern:system
..... coding:TWMedicalDepartmentSCT S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 對應至 SNOMED CT之就醫科別 + 診療科別值集 (required)
...... id 0..1 string 唯一可識別ID，以供資料項目間相互參照。
...... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: http://snomed.info/sct
...... version Σ 0..1 string 系統的版本—如果相關的話
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
...... userSelected Σ 0..1 boolean 此編碼是否由使用者直接選擇？
..... coding:TWMedicalConsultationDepartment S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 無法對應至SNOMED CT之臺灣健保署就醫科別值集 (required)
...... id 0..1 string 唯一可識別ID，以供資料項目間相互參照。
...... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/medical-consultation-department-tw
...... version Σ 0..1 string 系統的版本—如果相關的話
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
...... userSelected Σ 0..1 boolean 此編碼是否由使用者直接選擇？
..... coding:TWMedicalTreatmentDepartment S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 無法對應至SNOMED CT之臺灣健保署診療科別值集 (required)
...... id 0..1 string 唯一可識別ID，以供資料項目間相互參照。
...... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/medical-treatment-department-tw
...... version Σ 0..1 string 系統的版本—如果相關的話
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
...... userSelected Σ 0..1 boolean 此編碼是否由使用者直接選擇？
.... text SΣ 0..1 string 概念的文字表示法
... location SΣ 0..* Reference(服務地點及托育地址-Location TWSS Base) 人員提供服務的地點；托育人員可 reference 托育地址。
... healthcareService S 0..* Reference(HealthcareService) 此工作者為此角色的機構（Organizatoin）/地點（Location）提供的健康照護服務清單
... telecom SΣ 0..* ContactPoint 此角色使用的聯絡方式，例如辦公電話或職務聯絡信箱。
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... system SΣC 1..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
.... value SΣ 1..1 string 實際的聯絡方式之細節
.... use ?!SΣ 0..1 code home | work | temp | old | mobile－此聯絡方式的用途
Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
.... rank Σ 0..1 positiveInt 具體說明偏好的使用順序（1=最高優先順序）
.... period SΣ 0..1 Period 此聯絡方式的使用效期
... availableTime S 0..* BackboneElement 服務地點可用的時間
.... 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
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入所綁定值集中的其中一個代碼。
.... allDay 0..1 boolean 隨時可用？ 例如：24 小時服務。
.... availableStartTime 0..1 time 每天的開放時間（如果 allDay = true，則忽略。）
.... availableEndTime 0..1 time 每天的關閉時間（如果 allDay = true，則忽略。）
... notAvailable S 0..* BackboneElement 由於提供的原因，在此期間無法使用。
.... 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
.... description 1..1 string 向使用者說明為什麼此期間無法使用的原因
.... during 0..1 Period 從這個日期起，服務將不再提供。
... availabilityExceptions S 0..1 string 描述在特定情況下服務不可用的特例
... endpoint 0..* Reference(Endpoint) 提供用於此健康照護服務提供者角色運營服務的技術端點

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.language Base preferred Common Languages 📦4.0.1 FHIR Std.
PractitionerRole.identifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
PractitionerRole.identifier.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
PractitionerRole.code Base extensible TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 📦0.0.1 This IG
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📦4.0.1 FHIR Std.
PractitionerRole.specialty.​coding:TWMedicalDepartmentSCT Base required 對應至 SNOMED CT之就醫科別 + 診療科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.specialty.​coding:TWMedicalConsultationDepartment Base required 無法對應至SNOMED CT之臺灣健保署就醫科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.specialty.​coding:TWMedicalTreatmentDepartment Base required 無法對應至SNOMED CT之臺灣健保署診療科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.telecom.​system Base required ContactPointSystem 📍4.0.1 FHIR Std.
PractitionerRole.telecom.​use Base required ContactPointUse 📍4.0.1 FHIR Std.
PractitionerRole.availableTime.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole 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 PractitionerRole 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 PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole 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
.. PractitionerRole 0..* TWCorePractitionerRole 健康照護服務提供者所關聯的角色/機構
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier 人員角色識別碼，例如任職紀錄編號、派案人員編號或來源系統角色識別碼。
.... use ?!SΣ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
.... type SΣ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
.... system SΣ 0..1 uri The namespace for the identifier value
Example General: http://www.acme.com/identifiers/patient
.... value SΣ 0..1 string The value that is unique
Example General: 123456
... period SΣ 0..1 Period 人員到職日、離職日、派任起訖日或角色有效期間。
.... start SΣC 0..1 dateTime Starting time with inclusive boundary
.... end SΣC 0..1 dateTime End time with inclusive boundary, if not ongoing
... practitioner SΣ 0..1 Reference(人員資料-Practitioner TWSS Base) 擔任此角色的人員。
... organization SΣ 0..1 Reference(機構資料-Organization TWSS Base) 人員任職、派任或服務所屬機構。
... code S 0..* CodeableConceptTW 職稱、角色或職務類型。
Binding: TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 (extensible): 優先使用 TW Core 0.3.2 的 SNOMED CT + 臺灣醫事司醫事人員類別值集；若無法表達社家署社福業務角色，優先使用 SNOMED CT 既有標準碼。
... specialty S 0..* CodeableConceptTW 專長、服務類別或業務領域。
Binding: PracticeSettingCodeValueSet (preferred): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
.... Slices for coding S 0..* CodingTW 由專門術語系統（terminology system）定義的代碼
Slice: Unordered, Open by pattern:system
..... coding:TWMedicalDepartmentSCT S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 對應至 SNOMED CT之就醫科別 + 診療科別值集 (required)
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: http://snomed.info/sct
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
..... coding:TWMedicalConsultationDepartment S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 無法對應至SNOMED CT之臺灣健保署就醫科別值集 (required)
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/medical-consultation-department-tw
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
..... coding:TWMedicalTreatmentDepartment S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 無法對應至SNOMED CT之臺灣健保署診療科別值集 (required)
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/medical-treatment-department-tw
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
.... text SΣ 0..1 string 概念的文字表示法
... location SΣ 0..* Reference(服務地點及托育地址-Location TWSS Base) 人員提供服務的地點；托育人員可 reference 托育地址。
... healthcareService S 0..* Reference(HealthcareService) 此工作者為此角色的機構（Organizatoin）/地點（Location）提供的健康照護服務清單
... telecom SΣ 0..* ContactPoint 此角色使用的聯絡方式，例如辦公電話或職務聯絡信箱。
.... system SΣC 1..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
.... value SΣ 1..1 string 實際的聯絡方式之細節
.... use ?!SΣ 0..1 code home | work | temp | old | mobile－此聯絡方式的用途
Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
.... period SΣ 0..1 Period 此聯絡方式的使用效期
... availableTime S 0..* BackboneElement 服務地點可用的時間
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
... notAvailable S 0..* BackboneElement 由於提供的原因，在此期間無法使用。
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... description 1..1 string 向使用者說明為什麼此期間無法使用的原因
... availabilityExceptions S 0..1 string 描述在特定情況下服務不可用的特例

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.identifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
PractitionerRole.identifier.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
PractitionerRole.code Base extensible TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 📦0.0.1 This IG
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📦4.0.1 FHIR Std.
PractitionerRole.specialty.​coding:TWMedicalDepartmentSCT Base required 對應至 SNOMED CT之就醫科別 + 診療科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.specialty.​coding:TWMedicalConsultationDepartment Base required 無法對應至SNOMED CT之臺灣健保署就醫科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.specialty.​coding:TWMedicalTreatmentDepartment Base required 無法對應至SNOMED CT之臺灣健保署診療科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.telecom.​system Base required ContactPointSystem 📍4.0.1 FHIR Std.
PractitionerRole.telecom.​use Base required ContactPointUse 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole 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 PractitionerRole 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 PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole 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 TWCorePractitionerRole

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* TWCorePractitionerRole 健康照護服務提供者所關聯的角色/機構
... identifier 0..* Identifier 人員角色識別碼，例如任職紀錄編號、派案人員編號或來源系統角色識別碼。
.... use S 0..1 code usual | official | temp | secondary | old (If known)
.... type S 0..1 CodeableConcept Description of identifier
.... system S 0..1 uri The namespace for the identifier value
.... value S 0..1 string The value that is unique
... period S 0..1 Period 人員到職日、離職日、派任起訖日或角色有效期間。
.... start S 0..1 dateTime Starting time with inclusive boundary
.... end S 0..1 dateTime End time with inclusive boundary, if not ongoing
... practitioner 0..1 Reference(人員資料-Practitioner TWSS Base) 擔任此角色的人員。
... code 0..* CodeableConceptTW 職稱、角色或職務類型。
Binding: TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 (extensible): 優先使用 TW Core 0.3.2 的 SNOMED CT + 臺灣醫事司醫事人員類別值集；若無法表達社家署社福業務角色，優先使用 SNOMED CT 既有標準碼。
... specialty 0..* CodeableConceptTW 專長、服務類別或業務領域。
... location 0..* Reference(服務地點及托育地址-Location TWSS Base) 人員提供服務的地點；托育人員可 reference 托育地址。
... healthcareService S 0..* Reference(HealthcareService) 此工作者為此角色的機構（Organizatoin）/地點（Location）提供的健康照護服務清單
... telecom 0..* ContactPoint 此角色使用的聯絡方式，例如辦公電話或職務聯絡信箱。
... availableTime S 0..* BackboneElement 服務地點可用的時間
... notAvailable S 0..* BackboneElement 由於提供的原因，在此期間無法使用。
... availabilityExceptions S 0..1 string 描述在特定情況下服務不可用的特例

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
PractitionerRole.code Base extensible TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 📦0.0.1 This IG

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. PractitionerRole 0..* TWCorePractitionerRole 健康照護服務提供者所關聯的角色/機構
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的PractitionerRole紀錄，通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此PractitionerRole Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative PractitionerRole Resource之內容摘要以供人閱讀
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 SΣ 0..* Identifier 人員角色識別碼，例如任職紀錄編號、派案人員編號或來源系統角色識別碼。
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... use ?!SΣ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
.... type SΣ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
.... system SΣ 0..1 uri The namespace for the identifier value
Example General: http://www.acme.com/identifiers/patient
.... value SΣ 0..1 string The value that is unique
Example General: 123456
.... period Σ 0..1 Period Time period when id is/was valid for use
.... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... active SΣ 0..1 boolean 此健康照護服務提供者角色紀錄是否有效
... period SΣ 0..1 Period 人員到職日、離職日、派任起訖日或角色有效期間。
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... start SΣC 0..1 dateTime Starting time with inclusive boundary
.... end SΣC 0..1 dateTime End time with inclusive boundary, if not ongoing
... practitioner SΣ 0..1 Reference(人員資料-Practitioner TWSS Base) 擔任此角色的人員。
... organization SΣ 0..1 Reference(機構資料-Organization TWSS Base) 人員任職、派任或服務所屬機構。
... code S 0..* CodeableConceptTW 職稱、角色或職務類型。
Binding: TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 (extensible): 優先使用 TW Core 0.3.2 的 SNOMED CT + 臺灣醫事司醫事人員類別值集；若無法表達社家署社福業務角色，優先使用 SNOMED CT 既有標準碼。
... specialty S 0..* CodeableConceptTW 專長、服務類別或業務領域。
Binding: PracticeSettingCodeValueSet (preferred): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
.... id 0..1 string 唯一可識別ID，以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
.... Slices for coding S 0..* CodingTW 由專門術語系統（terminology system）定義的代碼
Slice: Unordered, Open by pattern:system
..... coding:TWMedicalDepartmentSCT S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 對應至 SNOMED CT之就醫科別 + 診療科別值集 (required)
...... id 0..1 string 唯一可識別ID，以供資料項目間相互參照。
...... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: http://snomed.info/sct
...... version Σ 0..1 string 系統的版本—如果相關的話
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
...... userSelected Σ 0..1 boolean 此編碼是否由使用者直接選擇？
..... coding:TWMedicalConsultationDepartment S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 無法對應至SNOMED CT之臺灣健保署就醫科別值集 (required)
...... id 0..1 string 唯一可識別ID，以供資料項目間相互參照。
...... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/medical-consultation-department-tw
...... version Σ 0..1 string 系統的版本—如果相關的話
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
...... userSelected Σ 0..1 boolean 此編碼是否由使用者直接選擇？
..... coding:TWMedicalTreatmentDepartment S 0..1 CodingTW 由專門術語系統（terminology system）定義的代碼
Binding: 無法對應至SNOMED CT之臺灣健保署診療科別值集 (required)
...... id 0..1 string 唯一可識別ID，以供資料項目間相互參照。
...... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
...... system SΣ 1..1 uri 專門術語系統（terminology system）的識別
Required Pattern: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/medical-treatment-department-tw
...... version Σ 0..1 string 系統的版本—如果相關的話
...... code SΣ 0..1 code 系統定義的語法之符號
...... display SΣ 0..1 string 由系統定義的表示法
...... userSelected Σ 0..1 boolean 此編碼是否由使用者直接選擇？
.... text SΣ 0..1 string 概念的文字表示法
... location SΣ 0..* Reference(服務地點及托育地址-Location TWSS Base) 人員提供服務的地點；托育人員可 reference 托育地址。
... healthcareService S 0..* Reference(HealthcareService) 此工作者為此角色的機構（Organizatoin）/地點（Location）提供的健康照護服務清單
... telecom SΣ 0..* ContactPoint 此角色使用的聯絡方式，例如辦公電話或職務聯絡信箱。
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... system SΣC 1..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
.... value SΣ 1..1 string 實際的聯絡方式之細節
.... use ?!SΣ 0..1 code home | work | temp | old | mobile－此聯絡方式的用途
Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
.... rank Σ 0..1 positiveInt 具體說明偏好的使用順序（1=最高優先順序）
.... period SΣ 0..1 Period 此聯絡方式的使用效期
... availableTime S 0..* BackboneElement 服務地點可用的時間
.... 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
.... daysOfWeek 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入所綁定值集中的其中一個代碼。
.... allDay 0..1 boolean 隨時可用？ 例如：24 小時服務。
.... availableStartTime 0..1 time 每天的開放時間（如果 allDay = true，則忽略。）
.... availableEndTime 0..1 time 每天的關閉時間（如果 allDay = true，則忽略。）
... notAvailable S 0..* BackboneElement 由於提供的原因，在此期間無法使用。
.... 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
.... description 1..1 string 向使用者說明為什麼此期間無法使用的原因
.... during 0..1 Period 從這個日期起，服務將不再提供。
... availabilityExceptions S 0..1 string 描述在特定情況下服務不可用的特例
... endpoint 0..* Reference(Endpoint) 提供用於此健康照護服務提供者角色運營服務的技術端點

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
PractitionerRole.language Base preferred Common Languages 📦4.0.1 FHIR Std.
PractitionerRole.identifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
PractitionerRole.identifier.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
PractitionerRole.code Base extensible TWSS-SNOMED CT與臺灣醫事司醫事人員類別及人員角色值集 📦0.0.1 This IG
PractitionerRole.specialty Base preferred Practice Setting Code Value Set 📦4.0.1 FHIR Std.
PractitionerRole.specialty.​coding:TWMedicalDepartmentSCT Base required 對應至 SNOMED CT之就醫科別 + 診療科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.specialty.​coding:TWMedicalConsultationDepartment Base required 無法對應至SNOMED CT之臺灣健保署就醫科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.specialty.​coding:TWMedicalTreatmentDepartment Base required 無法對應至SNOMED CT之臺灣健保署診療科別值集 📦0.3.0 臺灣核心實作指引 v0.3
PractitionerRole.telecom.​system Base required ContactPointSystem 📍4.0.1 FHIR Std.
PractitionerRole.telecom.​use Base required ContactPointUse 📍4.0.1 FHIR Std.
PractitionerRole.availableTime.​daysOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error PractitionerRole If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error PractitionerRole 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 PractitionerRole 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 PractitionerRole If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice PractitionerRole 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:

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

  1. 建議（SHOULD） 支援透過查詢參數 _id 查詢所有 PractitionerRole： (如何透過 token 查詢)
    GET [base]/PractitionerRole?_id=[id]
    GET [base]/PractitionerRole/[id]

  2. 建議（SHOULD） 支援透過查詢參數 practitioner 查詢所有 PractitionerRole： (如何透過 reference 查詢)
    GET [base]/PractitionerRole?practitioner={Type/}[id]

  3. 建議（SHOULD） 支援透過查詢參數 organization 查詢所有 PractitionerRole： (如何透過 reference 查詢)
    GET [base]/PractitionerRole?organization={Type/}[id]

  4. 建議（SHOULD） 支援透過查詢參數 role 查詢所有 PractitionerRole： (如何透過 token 查詢)
    GET [base]/PractitionerRole?role=[system]|[code]