臺灣核心實作指引(TW Core IG)
0.1.1 - Trial Use

This page is part of the 臺灣核心實作指引(TW Core IG) (v0.1.1: Releases) based on FHIR 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 Practitioner

Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Practitioner-twcore Version: 0.1.1
Active as of 2023-08-30 Computable Name: TWCorePractitioner

此臺灣核心-健康照護服務提供人員(TW Core Practitioner) Profile說明本IG如何進一步定義FHIR的Practitioner Resource以呈現健康照護服務提供人員基本資料 [FMM1]

  • 2023/8/25異動說明: identifier改為非必填,因有的實務專案可能不是必填項目。

Usage:

Formal Views of Profile Content

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

This structure is derived from Practitioner

NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner 0..*Practitioner對於所提供之健康照護或相關服務負有正式責任的人員
... id 0..1id不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄,通常又稱為邏輯性ID。
... meta 0..1Meta此PractitionerResource的metadata
... implicitRules 0..1uri創建此內容所依據的一組規則
... text S0..1NarrativePractitioner Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension 0..*Extension此擴充的資料項目可能會完全修改或改變其他資料項目的意涵,需特別留意。
... identifier S0..*Identifier此照護服務提供人員的識別碼
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... use S0..1codeusual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 識別碼的型別,用於決定特定目的所適用的識別碼;應填入IdentifierUse值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


Required Pattern: official
.... type S0..1CodeableConceptTW照護服務提供人員的識別碼(identifier)的型別說明
.... system S1..1uri照護服務提供人員識別碼(identifier)的命名空間(namespace)
.... value S1..1string唯一值。 例如:照護服務提供人員之員工編號為KP00017
.... period 0..1Period此身份識別碼(identifier)的使用效期
.... assigner 0..1Reference(TW Core Organization)簽發identifier的機構(可以只是文字表述)
... active S0..1boolean此照護服務提供人員的紀錄是否在使用中
... name SC1..*HumanName照護服務提供人員的姓名
tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... use S0..1codeusual | official | temp | nickname | anonymous | old | maiden
Binding: NameUse (required): 人名的使用情況;應填入NameUse值集中的其中一個代碼。


Required Pattern: official
.... text SC0..1string完整的中文姓名
Example General: 王依昇
.... family SC0..1string英文姓
Example General: Wang
.... given SC0..*string英文名
Example General: Yi Sheng
.... prefix 0..*string姓名前面的頭銜 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名開頭。
.... suffix 0..*string姓名後面的稱謂 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名之後。
.... period 0..1Period此姓名的使用效期
... telecom S0..*ContactPoint照護服務提供人員的詳細聯絡方式(適用於所有角色)。
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... system S1..1codephone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入ContactPointSystem值集中的其中一個代碼。

.... value S1..1string實際的聯絡方式之細節
.... use S0..1codehome | work | temp | old | mobile-此聯絡方式的用途
Binding: ContactPointUse (required): 應填入ContactPointUse值集中的其中一個代碼。

.... rank 0..1positiveInt具體說明偏好的使用順序(1=最高優先順序)
.... period S0..1Period此聯絡方式的使用效期
... address S0..*TWCoreAddress不限特定角色的照護服務提供人員的地址(通常是住家地址)
... gender S0..1codemale | female | other | unknown
Binding: AdministrativeGender (required): 性別;應填入AdministrativeGender值集中的其中一個代碼。

... birthDate S0..1date照護服務提供人員的出生日期
... photo S0..*Attachment人員的影像(照片)
... qualification 0..*BackboneElement與照護服務相關的證書、執照或培訓
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension 0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... identifier 0..*Identifier照護服務提供人員的資格證書識別碼
.... code 1..1CodeableConceptTW資格證書的編碼表示法
Binding: 臺灣醫事人員類別值集 (required): 照護服務提供人員提供服務所具有的具體資格證書;應填入臺灣醫事人員類別值集值集中的其中一個代碼。

.... period 0..1Period資格證書的有效期限
.... issuer 0..1Reference(TW Core Organization)監管和頒發資格證書的機構
... communication 0..*CodeableConceptTW健康照護服務提供人員與病人溝通時可使用的語言
Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。

Additional BindingsPurpose
AllLanguagesMax Binding

Example Value: zh-TW

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet / Code
Practitioner.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Practitioner.identifier.userequiredPattern: official
Practitioner.name.userequiredPattern: official
Practitioner.telecom.systemrequiredContactPointSystem
Practitioner.telecom.userequiredContactPointUse
Practitioner.genderrequiredAdministrativeGender
Practitioner.qualification.coderequiredTWHealthProfessional (a valid code from 臺灣醫事人員類別)
Practitioner.communicationpreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding

Constraints

IdGradePath(s)DetailsRequirements
tw-core-1errorPractitioner.namePatient.name.text or Patient.name.family or both SHALL be present
: text.exists() or family.exists()
NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner 0..*Practitioner對於所提供之健康照護或相關服務負有正式責任的人員
... id Σ0..1id不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄,通常又稱為邏輯性ID。
... meta Σ0..1Meta此PractitionerResource的metadata
... implicitRules ?!Σ0..1uri創建此內容所依據的一組規則
... text S0..1NarrativePractitioner Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension ?!0..*Extension此擴充的資料項目可能會完全修改或改變其他資料項目的意涵,需特別留意。
... identifier SΣ0..*Identifier此照護服務提供人員的識別碼
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... use ?!SΣ0..1codeusual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 識別碼的型別,用於決定特定目的所適用的識別碼;應填入IdentifierUse值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


Required Pattern: official
.... type S0..1CodeableConceptTW照護服務提供人員的識別碼(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Σ1..1uri照護服務提供人員識別碼(identifier)的命名空間(namespace)
Example General: http://www.acme.com/identifiers/patient
.... value SΣ1..1string唯一值。 例如:照護服務提供人員之員工編號為KP00017
Example General: 123456
.... period Σ0..1Period此身份識別碼(identifier)的使用效期
.... assigner Σ0..1Reference(TW Core Organization)簽發identifier的機構(可以只是文字表述)
... active SΣ0..1boolean此照護服務提供人員的紀錄是否在使用中
... name SΣC1..*HumanName照護服務提供人員的姓名
tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... use ?!SΣ0..1codeusual | official | temp | nickname | anonymous | old | maiden
Binding: NameUse (required): 人名的使用情況;應填入NameUse值集中的其中一個代碼。


Required Pattern: official
.... text SΣC0..1string完整的中文姓名
Example General: 王依昇
.... family SΣC0..1string英文姓
Example General: Wang
.... given SΣC0..*string英文名
This repeating element order: Given Names appear in the correct order for presenting the name
Example General: Yi Sheng
.... prefix Σ0..*string姓名前面的頭銜 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名開頭。
This repeating element order: Prefixes appear in the correct order for presenting the name
.... suffix Σ0..*string姓名後面的稱謂 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名之後。
This repeating element order: Suffixes appear in the correct order for presenting the name
.... period Σ0..1Period此姓名的使用效期
... telecom SΣ0..*ContactPoint照護服務提供人員的詳細聯絡方式(適用於所有角色)。
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... system SΣC1..1codephone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入ContactPointSystem值集中的其中一個代碼。

.... value SΣ1..1string實際的聯絡方式之細節
.... use ?!SΣ0..1codehome | work | temp | old | mobile-此聯絡方式的用途
Binding: ContactPointUse (required): 應填入ContactPointUse值集中的其中一個代碼。

.... rank Σ0..1positiveInt具體說明偏好的使用順序(1=最高優先順序)
.... period SΣ0..1Period此聯絡方式的使用效期
... address S0..*TWCoreAddress不限特定角色的照護服務提供人員的地址(通常是住家地址)
... gender SΣ0..1codemale | female | other | unknown
Binding: AdministrativeGender (required): 性別;應填入AdministrativeGender值集中的其中一個代碼。

... birthDate SΣ0..1date照護服務提供人員的出生日期
... photo S0..*Attachment人員的影像(照片)
... qualification 0..*BackboneElement與照護服務相關的證書、執照或培訓
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... identifier 0..*Identifier照護服務提供人員的資格證書識別碼
.... code 1..1CodeableConceptTW資格證書的編碼表示法
Binding: 臺灣醫事人員類別值集 (required): 照護服務提供人員提供服務所具有的具體資格證書;應填入臺灣醫事人員類別值集值集中的其中一個代碼。

.... period 0..1Period資格證書的有效期限
.... issuer 0..1Reference(TW Core Organization)監管和頒發資格證書的機構
... communication 0..*CodeableConceptTW健康照護服務提供人員與病人溝通時可使用的語言
Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。

Additional BindingsPurpose
AllLanguagesMax Binding


Example Value: zh-TW

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Practitioner.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Practitioner.identifier.userequiredPattern: official
Practitioner.identifier.typeextensibleIdentifier Type Codes
Practitioner.name.userequiredPattern: official
Practitioner.telecom.systemrequiredContactPointSystem
Practitioner.telecom.userequiredContactPointUse
Practitioner.genderrequiredAdministrativeGender
Practitioner.qualification.coderequiredTWHealthProfessional (a valid code from 臺灣醫事人員類別)
Practitioner.communicationpreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorPractitionerIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorPractitionerIf 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-4errorPractitionerIf 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-5errorPractitionerIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practicePractitionerA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
tw-core-1errorPractitioner.namePatient.name.text or Patient.name.family or both SHALL be present
: text.exists() or family.exists()
NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner 0..*Practitioner對於所提供之健康照護或相關服務負有正式責任的人員
... id Σ0..1id不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄,通常又稱為邏輯性ID。
... meta Σ0..1Meta此PractitionerResource的metadata
... implicitRules ?!Σ0..1uri創建此內容所依據的一組規則
... text S0..1NarrativePractitioner Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension ?!0..*Extension此擴充的資料項目可能會完全修改或改變其他資料項目的意涵,需特別留意。
... identifier SΣ0..*Identifier此照護服務提供人員的識別碼
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... use ?!SΣ0..1codeusual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 識別碼的型別,用於決定特定目的所適用的識別碼;應填入IdentifierUse值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


Required Pattern: official
.... type S0..1CodeableConceptTW照護服務提供人員的識別碼(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Σ1..1uri照護服務提供人員識別碼(identifier)的命名空間(namespace)
Example General: http://www.acme.com/identifiers/patient
.... value SΣ1..1string唯一值。 例如:照護服務提供人員之員工編號為KP00017
Example General: 123456
.... period Σ0..1Period此身份識別碼(identifier)的使用效期
.... assigner Σ0..1Reference(TW Core Organization)簽發identifier的機構(可以只是文字表述)
... active SΣ0..1boolean此照護服務提供人員的紀錄是否在使用中
... name SΣC1..*HumanName照護服務提供人員的姓名
tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... use ?!SΣ0..1codeusual | official | temp | nickname | anonymous | old | maiden
Binding: NameUse (required): 人名的使用情況;應填入NameUse值集中的其中一個代碼。


Required Pattern: official
.... text SΣC0..1string完整的中文姓名
Example General: 王依昇
.... family SΣC0..1string英文姓
Example General: Wang
.... given SΣC0..*string英文名
This repeating element order: Given Names appear in the correct order for presenting the name
Example General: Yi Sheng
.... prefix Σ0..*string姓名前面的頭銜 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名開頭。
This repeating element order: Prefixes appear in the correct order for presenting the name
.... suffix Σ0..*string姓名後面的稱謂 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名之後。
This repeating element order: Suffixes appear in the correct order for presenting the name
.... period Σ0..1Period此姓名的使用效期
... telecom SΣ0..*ContactPoint照護服務提供人員的詳細聯絡方式(適用於所有角色)。
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... system SΣC1..1codephone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入ContactPointSystem值集中的其中一個代碼。

.... value SΣ1..1string實際的聯絡方式之細節
.... use ?!SΣ0..1codehome | work | temp | old | mobile-此聯絡方式的用途
Binding: ContactPointUse (required): 應填入ContactPointUse值集中的其中一個代碼。

.... rank Σ0..1positiveInt具體說明偏好的使用順序(1=最高優先順序)
.... period SΣ0..1Period此聯絡方式的使用效期
... address S0..*TWCoreAddress不限特定角色的照護服務提供人員的地址(通常是住家地址)
... gender SΣ0..1codemale | female | other | unknown
Binding: AdministrativeGender (required): 性別;應填入AdministrativeGender值集中的其中一個代碼。

... birthDate SΣ0..1date照護服務提供人員的出生日期
... photo S0..*Attachment人員的影像(照片)
... qualification 0..*BackboneElement與照護服務相關的證書、執照或培訓
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... identifier 0..*Identifier照護服務提供人員的資格證書識別碼
.... code 1..1CodeableConceptTW資格證書的編碼表示法
Binding: 臺灣醫事人員類別值集 (required): 照護服務提供人員提供服務所具有的具體資格證書;應填入臺灣醫事人員類別值集值集中的其中一個代碼。

.... period 0..1Period資格證書的有效期限
.... issuer 0..1Reference(TW Core Organization)監管和頒發資格證書的機構
... communication 0..*CodeableConceptTW健康照護服務提供人員與病人溝通時可使用的語言
Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。

Additional BindingsPurpose
AllLanguagesMax Binding


Example Value: zh-TW

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Practitioner.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Practitioner.identifier.userequiredPattern: official
Practitioner.identifier.typeextensibleIdentifier Type Codes
Practitioner.name.userequiredPattern: official
Practitioner.telecom.systemrequiredContactPointSystem
Practitioner.telecom.userequiredContactPointUse
Practitioner.genderrequiredAdministrativeGender
Practitioner.qualification.coderequiredTWHealthProfessional (a valid code from 臺灣醫事人員類別)
Practitioner.communicationpreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorPractitionerIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorPractitionerIf 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-4errorPractitionerIf 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-5errorPractitionerIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practicePractitionerA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
tw-core-1errorPractitioner.namePatient.name.text or Patient.name.family or both SHALL be present
: text.exists() or family.exists()

Differential View

This structure is derived from Practitioner

NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner 0..*Practitioner對於所提供之健康照護或相關服務負有正式責任的人員
... id 0..1id不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄,通常又稱為邏輯性ID。
... meta 0..1Meta此PractitionerResource的metadata
... implicitRules 0..1uri創建此內容所依據的一組規則
... text S0..1NarrativePractitioner Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension 0..*Extension此擴充的資料項目可能會完全修改或改變其他資料項目的意涵,需特別留意。
... identifier S0..*Identifier此照護服務提供人員的識別碼
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... use S0..1codeusual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 識別碼的型別,用於決定特定目的所適用的識別碼;應填入IdentifierUse值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


Required Pattern: official
.... type S0..1CodeableConceptTW照護服務提供人員的識別碼(identifier)的型別說明
.... system S1..1uri照護服務提供人員識別碼(identifier)的命名空間(namespace)
.... value S1..1string唯一值。 例如:照護服務提供人員之員工編號為KP00017
.... period 0..1Period此身份識別碼(identifier)的使用效期
.... assigner 0..1Reference(TW Core Organization)簽發identifier的機構(可以只是文字表述)
... active S0..1boolean此照護服務提供人員的紀錄是否在使用中
... name SC1..*HumanName照護服務提供人員的姓名
tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... use S0..1codeusual | official | temp | nickname | anonymous | old | maiden
Binding: NameUse (required): 人名的使用情況;應填入NameUse值集中的其中一個代碼。


Required Pattern: official
.... text SC0..1string完整的中文姓名
Example General: 王依昇
.... family SC0..1string英文姓
Example General: Wang
.... given SC0..*string英文名
Example General: Yi Sheng
.... prefix 0..*string姓名前面的頭銜 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名開頭。
.... suffix 0..*string姓名後面的稱謂 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名之後。
.... period 0..1Period此姓名的使用效期
... telecom S0..*ContactPoint照護服務提供人員的詳細聯絡方式(適用於所有角色)。
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... system S1..1codephone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入ContactPointSystem值集中的其中一個代碼。

.... value S1..1string實際的聯絡方式之細節
.... use S0..1codehome | work | temp | old | mobile-此聯絡方式的用途
Binding: ContactPointUse (required): 應填入ContactPointUse值集中的其中一個代碼。

.... rank 0..1positiveInt具體說明偏好的使用順序(1=最高優先順序)
.... period S0..1Period此聯絡方式的使用效期
... address S0..*TWCoreAddress不限特定角色的照護服務提供人員的地址(通常是住家地址)
... gender S0..1codemale | female | other | unknown
Binding: AdministrativeGender (required): 性別;應填入AdministrativeGender值集中的其中一個代碼。

... birthDate S0..1date照護服務提供人員的出生日期
... photo S0..*Attachment人員的影像(照片)
... qualification 0..*BackboneElement與照護服務相關的證書、執照或培訓
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension 0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... identifier 0..*Identifier照護服務提供人員的資格證書識別碼
.... code 1..1CodeableConceptTW資格證書的編碼表示法
Binding: 臺灣醫事人員類別值集 (required): 照護服務提供人員提供服務所具有的具體資格證書;應填入臺灣醫事人員類別值集值集中的其中一個代碼。

.... period 0..1Period資格證書的有效期限
.... issuer 0..1Reference(TW Core Organization)監管和頒發資格證書的機構
... communication 0..*CodeableConceptTW健康照護服務提供人員與病人溝通時可使用的語言
Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。

Additional BindingsPurpose
AllLanguagesMax Binding

Example Value: zh-TW

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet / Code
Practitioner.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Practitioner.identifier.userequiredPattern: official
Practitioner.name.userequiredPattern: official
Practitioner.telecom.systemrequiredContactPointSystem
Practitioner.telecom.userequiredContactPointUse
Practitioner.genderrequiredAdministrativeGender
Practitioner.qualification.coderequiredTWHealthProfessional (a valid code from 臺灣醫事人員類別)
Practitioner.communicationpreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding

Constraints

IdGradePath(s)DetailsRequirements
tw-core-1errorPractitioner.namePatient.name.text or Patient.name.family or both SHALL be present
: text.exists() or family.exists()

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner 0..*Practitioner對於所提供之健康照護或相關服務負有正式責任的人員
... id Σ0..1id不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄,通常又稱為邏輯性ID。
... meta Σ0..1Meta此PractitionerResource的metadata
... implicitRules ?!Σ0..1uri創建此內容所依據的一組規則
... text S0..1NarrativePractitioner Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension ?!0..*Extension此擴充的資料項目可能會完全修改或改變其他資料項目的意涵,需特別留意。
... identifier SΣ0..*Identifier此照護服務提供人員的識別碼
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... use ?!SΣ0..1codeusual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 識別碼的型別,用於決定特定目的所適用的識別碼;應填入IdentifierUse值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


Required Pattern: official
.... type S0..1CodeableConceptTW照護服務提供人員的識別碼(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Σ1..1uri照護服務提供人員識別碼(identifier)的命名空間(namespace)
Example General: http://www.acme.com/identifiers/patient
.... value SΣ1..1string唯一值。 例如:照護服務提供人員之員工編號為KP00017
Example General: 123456
.... period Σ0..1Period此身份識別碼(identifier)的使用效期
.... assigner Σ0..1Reference(TW Core Organization)簽發identifier的機構(可以只是文字表述)
... active SΣ0..1boolean此照護服務提供人員的紀錄是否在使用中
... name SΣC1..*HumanName照護服務提供人員的姓名
tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... use ?!SΣ0..1codeusual | official | temp | nickname | anonymous | old | maiden
Binding: NameUse (required): 人名的使用情況;應填入NameUse值集中的其中一個代碼。


Required Pattern: official
.... text SΣC0..1string完整的中文姓名
Example General: 王依昇
.... family SΣC0..1string英文姓
Example General: Wang
.... given SΣC0..*string英文名
This repeating element order: Given Names appear in the correct order for presenting the name
Example General: Yi Sheng
.... prefix Σ0..*string姓名前面的頭銜 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名開頭。
This repeating element order: Prefixes appear in the correct order for presenting the name
.... suffix Σ0..*string姓名後面的稱謂 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名之後。
This repeating element order: Suffixes appear in the correct order for presenting the name
.... period Σ0..1Period此姓名的使用效期
... telecom SΣ0..*ContactPoint照護服務提供人員的詳細聯絡方式(適用於所有角色)。
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... system SΣC1..1codephone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入ContactPointSystem值集中的其中一個代碼。

.... value SΣ1..1string實際的聯絡方式之細節
.... use ?!SΣ0..1codehome | work | temp | old | mobile-此聯絡方式的用途
Binding: ContactPointUse (required): 應填入ContactPointUse值集中的其中一個代碼。

.... rank Σ0..1positiveInt具體說明偏好的使用順序(1=最高優先順序)
.... period SΣ0..1Period此聯絡方式的使用效期
... address S0..*TWCoreAddress不限特定角色的照護服務提供人員的地址(通常是住家地址)
... gender SΣ0..1codemale | female | other | unknown
Binding: AdministrativeGender (required): 性別;應填入AdministrativeGender值集中的其中一個代碼。

... birthDate SΣ0..1date照護服務提供人員的出生日期
... photo S0..*Attachment人員的影像(照片)
... qualification 0..*BackboneElement與照護服務相關的證書、執照或培訓
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... identifier 0..*Identifier照護服務提供人員的資格證書識別碼
.... code 1..1CodeableConceptTW資格證書的編碼表示法
Binding: 臺灣醫事人員類別值集 (required): 照護服務提供人員提供服務所具有的具體資格證書;應填入臺灣醫事人員類別值集值集中的其中一個代碼。

.... period 0..1Period資格證書的有效期限
.... issuer 0..1Reference(TW Core Organization)監管和頒發資格證書的機構
... communication 0..*CodeableConceptTW健康照護服務提供人員與病人溝通時可使用的語言
Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。

Additional BindingsPurpose
AllLanguagesMax Binding


Example Value: zh-TW

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Practitioner.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Practitioner.identifier.userequiredPattern: official
Practitioner.identifier.typeextensibleIdentifier Type Codes
Practitioner.name.userequiredPattern: official
Practitioner.telecom.systemrequiredContactPointSystem
Practitioner.telecom.userequiredContactPointUse
Practitioner.genderrequiredAdministrativeGender
Practitioner.qualification.coderequiredTWHealthProfessional (a valid code from 臺灣醫事人員類別)
Practitioner.communicationpreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorPractitionerIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorPractitionerIf 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-4errorPractitionerIf 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-5errorPractitionerIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practicePractitionerA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
tw-core-1errorPractitioner.namePatient.name.text or Patient.name.family or both SHALL be present
: text.exists() or family.exists()

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Practitioner 0..*Practitioner對於所提供之健康照護或相關服務負有正式責任的人員
... id Σ0..1id不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄,通常又稱為邏輯性ID。
... meta Σ0..1Meta此PractitionerResource的metadata
... implicitRules ?!Σ0..1uri創建此內容所依據的一組規則
... text S0..1NarrativePractitioner Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension ?!0..*Extension此擴充的資料項目可能會完全修改或改變其他資料項目的意涵,需特別留意。
... identifier SΣ0..*Identifier此照護服務提供人員的識別碼
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... use ?!SΣ0..1codeusual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 識別碼的型別,用於決定特定目的所適用的識別碼;應填入IdentifierUse值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


Required Pattern: official
.... type S0..1CodeableConceptTW照護服務提供人員的識別碼(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Σ1..1uri照護服務提供人員識別碼(identifier)的命名空間(namespace)
Example General: http://www.acme.com/identifiers/patient
.... value SΣ1..1string唯一值。 例如:照護服務提供人員之員工編號為KP00017
Example General: 123456
.... period Σ0..1Period此身份識別碼(identifier)的使用效期
.... assigner Σ0..1Reference(TW Core Organization)簽發identifier的機構(可以只是文字表述)
... active SΣ0..1boolean此照護服務提供人員的紀錄是否在使用中
... name SΣC1..*HumanName照護服務提供人員的姓名
tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... use ?!SΣ0..1codeusual | official | temp | nickname | anonymous | old | maiden
Binding: NameUse (required): 人名的使用情況;應填入NameUse值集中的其中一個代碼。


Required Pattern: official
.... text SΣC0..1string完整的中文姓名
Example General: 王依昇
.... family SΣC0..1string英文姓
Example General: Wang
.... given SΣC0..*string英文名
This repeating element order: Given Names appear in the correct order for presenting the name
Example General: Yi Sheng
.... prefix Σ0..*string姓名前面的頭銜 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名開頭。
This repeating element order: Prefixes appear in the correct order for presenting the name
.... suffix Σ0..*string姓名後面的稱謂 由於學術,法律,職業或貴族身份等原因而獲得頭銜,出現在姓名之後。
This repeating element order: Suffixes appear in the correct order for presenting the name
.... period Σ0..1Period此姓名的使用效期
... telecom SΣ0..*ContactPoint照護服務提供人員的詳細聯絡方式(適用於所有角色)。
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... system SΣC1..1codephone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入ContactPointSystem值集中的其中一個代碼。

.... value SΣ1..1string實際的聯絡方式之細節
.... use ?!SΣ0..1codehome | work | temp | old | mobile-此聯絡方式的用途
Binding: ContactPointUse (required): 應填入ContactPointUse值集中的其中一個代碼。

.... rank Σ0..1positiveInt具體說明偏好的使用順序(1=最高優先順序)
.... period SΣ0..1Period此聯絡方式的使用效期
... address S0..*TWCoreAddress不限特定角色的照護服務提供人員的地址(通常是住家地址)
... gender SΣ0..1codemale | female | other | unknown
Binding: AdministrativeGender (required): 性別;應填入AdministrativeGender值集中的其中一個代碼。

... birthDate SΣ0..1date照護服務提供人員的出生日期
... photo S0..*Attachment人員的影像(照片)
... qualification 0..*BackboneElement與照護服務相關的證書、執照或培訓
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... identifier 0..*Identifier照護服務提供人員的資格證書識別碼
.... code 1..1CodeableConceptTW資格證書的編碼表示法
Binding: 臺灣醫事人員類別值集 (required): 照護服務提供人員提供服務所具有的具體資格證書;應填入臺灣醫事人員類別值集值集中的其中一個代碼。

.... period 0..1Period資格證書的有效期限
.... issuer 0..1Reference(TW Core Organization)監管和頒發資格證書的機構
... communication 0..*CodeableConceptTW健康照護服務提供人員與病人溝通時可使用的語言
Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。

Additional BindingsPurpose
AllLanguagesMax Binding


Example Value: zh-TW

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / Code
Practitioner.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Practitioner.identifier.userequiredPattern: official
Practitioner.identifier.typeextensibleIdentifier Type Codes
Practitioner.name.userequiredPattern: official
Practitioner.telecom.systemrequiredContactPointSystem
Practitioner.telecom.userequiredContactPointUse
Practitioner.genderrequiredAdministrativeGender
Practitioner.qualification.coderequiredTWHealthProfessional (a valid code from 臺灣醫事人員類別)
Practitioner.communicationpreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorPractitionerIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorPractitionerIf 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-4errorPractitionerIf 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-5errorPractitionerIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practicePractitionerA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
tw-core-1errorPractitioner.namePatient.name.text or Patient.name.family or both SHALL be present
: text.exists() or family.exists()

 

Other representations of profile: CSV, Excel, Schematron

Notes:

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

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

  1. 建議應該(SHOULD) 支援透過查詢參數 _id 查詢所有Practitioner:
    (如何透過token查詢)
    GET [base]/Practitioner?_id=[id]
    GET [base]/Practitioner/[id]

    例子:
    (1) GET [base]/Practitioner?_id=1350
    (2) GET [base]/Practitioner/1350

  2. 建議應該(SHOULD) 支援透過查詢參數 identifier 查詢所有Practitioner:
    (如何透過token查詢)
    GET [base]/Practitioner?identifier={system|}[code]

    例子:
    (1) GET [base]/Practitioner?identifier=https://www.tph.mohw.gov.tw/|KP00017

  3. 建議應該(SHOULD) 支援透過查詢參數 name 查詢所有Practitioner,該查詢可能與 HumanName 中的任何字串匹配,包括完整的中文姓名(text)、英文姓(family)、英文名(given)、姓名前面的頭銜(prefix)、姓名後面的稱謂(suffix):
    (如何透過string查詢)
    GET [base]/Practitioner?name=[name]

    例子::
    (1) GET [base]/Practitioner?name=王依昇