臺灣核心實作指引(TW Core IG)
0.2.0 - Trial Use
臺灣核心實作指引(TW Core IG)
0.2.0 - Trial Use
This page is part of the 臺灣核心實作指引(TW Core IG) (v0.2.0: Releases) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions
| Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Practitioner-twcore | Version: 0.2.0 | |||
| Active as of 2024-03-21 | Computable Name: TWCorePractitioner | |||
此臺灣核心-健康照護服務提供者(TW Core Practitioner) Profile說明本IG如何進一步定義FHIR的Practitioner Resource以呈現健康照護服務提供者基本資料。
直接或間接地參與健康照護服務提供的人員
Practitioner 涵蓋了所有參與健康照護過程和與健康照護相關的服務的人員，作為他們正式職責的一部分，而這個 Resource 被用來對這些人員進行的活動和責任進行歸屬。Practitioners 包括（但不限於）：
這個 Resource 必須不用（SHALL NOT） 於那些沒有正式責任的參與者，比如照顧朋友、親戚或鄰居的個人。這些人可以登記為病人的聯絡人。如果正在執行某些動作或被另一個 resource 參照，請使用 RelatedPerson resource。
Practitioner 和 RelatedPerson 之間的主要區別基於：
一個標準的擴充資料項目動物的物種 （animalSpecies）可以用來指出服務動物的物種。
PractitionerRole resource 提供了健康照護服務提供者被批准執行的角色的細節，這些角色對於哪些機構（在哪些位置，以及可選的是什麼服務）。
practitioner也經常根據角色獨立地被分組進入照護團隊（CareTeams），在這裡，CareTeam 定義了他們在團隊內履行的具體角色，並且可能會或可能不會為 practitioner 創建實際的PractitionerRole resources （並且在care team的情境下，還涉及practitioner代表的機構）。
Practitioner 在同一個或甚至不同的機構中擔任不同的角色。根據不同的行政區域和習慣，可能需要針對每個這樣的角色維持一個專門的 Practitioner Resource，或者有一個單獨的 Practitioner 同時具備多個角色。這個角色可能只限於一定的時間範圍，在這段時間之後，對這個角色的授權就會結束。值得注意的是，代表的機構不必然是 Practitioner 的（直接）雇主。
Practitioner resource 被以下 resources 所參照：註釋（Annotation）、簽章（Signature）、帳戶（Account）、醫療不良事件（AdverseEvent）、過敏或不耐症（AllergyIntolerance）、預約（Appointment）、預約回應（AppointmentResponse）、稽核事件（AuditEvent）、基本（Basic）、生物衍生產品（BiologicallyDerivedProduct）、照護計畫（CarePlan）、照護團隊（CareTeam）、目錄內的條目（CatalogEntry）、費用項目（ChargeItem）、理賠申請（Claim）、理賠申請回應（ClaimResponse）、臨床臆斷（ClinicalImpression）、通訊（Communication）、通訊請求（CommunicationRequest）、臨床文件架構（Composition）、病情、問題或診斷（Condition）、同意書（Consent）、合約（Contract）、給付資格請求（CoverageEligibilityRequest）、給付資格回應（CoverageEligibilityResponse）、檢測到的問題（DetectedIssue）、設備請求（DeviceRequest）、設備使用聲明（DeviceUseStatement）、診斷報告（DiagnosticReport）、文件清單（DocumentManifest）、文件參照（DocumentReference）、就醫事件（Encounter）、加入或退出保險計畫請求（EnrollmentRequest）、加入或退出保險計畫回應（EnrollmentResponse）、照護事件（EpisodeOfCare）、利益說明（ExplanationOfBenefit）、標記（Flag）、目的（Goal）、群體（Group）、影像檢查（ImagingStudy）、疫苗接種（Immunization）、發票或費用清單（Invoice）、連結（Linkage）、清單（List）、測量報告（MeasureReport）、多媒體（Media）、給藥（MedicationAdministration）、配藥或調劑藥品（MedicationDispense）、藥品請求（MedicationRequest）、用藥聲明（MedicationStatement）、訊息表頭（MessageHeader）、營養醫令（NutritionOrder）、檢驗檢查（Observation）、病人（Patient）、付款通知（PaymentNotice）、付款對帳（PaymentReconciliation）、人（Person）、 健康照護服務提供者角色 （PractitionerRole）、 處置（Procedure）、出處（Provenance）、問卷題目回覆（QuestionnaireResponse）、一組請求（RequestGroup）、研究（ResearchStudy）、風險評估（RiskAssessment）、時間表（Schedule）、服務請求（ServiceRequest）、檢體（Specimen）、供應品遞交（SupplyDelivery）、供應品請求（SupplyRequest）、任務（Task）、驗證結果（VerificationResult）及視力處方（VisionPrescription）
Usage:
Description of Profiles, Differentials, Snapshots and how the different presentations work.
This structure is derived from Practitioner
| Name | Flags | Card. | Type | Description & Constraints | ||||
|---|---|---|---|---|---|---|---|---|
  Practitioner | 0..* | Practitioner | 對於所提供之健康照護或相關服務負有正式責任的人員 | |||||
  id | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄，通常又稱為邏輯性ID。 | |||||
| meta | 0..1 | Meta | 此Practitioner Resource的metadata | |||||
| implicitRules | 0..1 | uri | 創建此內容所依據的一組規則 | |||||
| language | 0..1 | code | 用以表述Practitioner Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用CommonLanguages代碼表中的代碼，但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| text | 0..1 | Narrative | Practitioner Resource之內容摘要以供人閱讀 | |||||
| contained | 0..* | Resource | 內嵌的（contained）、行內的Resources | |||||
 extension | 0..* | Extension | 擴充的資料項目 | |||||
 modifierExtension | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | |||||
 identifier | S | 0..* | Identifier | 此照護服務提供人員的識別碼 | ||||
 id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| use | S | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 Required Pattern: official | ||||
 type | S | 0..1 | CodeableConceptTW | 照護服務提供人員的識別碼（identifier）的型別說明 Binding: Identifier Type Codes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
| system | S | 1..1 | uri | 照護服務提供人員識別碼（identifier）的命名空間（namespace） | ||||
| value | S | 1..1 | string | 唯一值。 例如：照護服務提供人員之員工編號為KP00017 | ||||
| period | 0..1 | Period | 此身份識別碼（identifier）的使用效期 | |||||
  assigner | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述） | |||||
| active | S | 0..1 | boolean | 此照護服務提供人員的紀錄是否在使用中 | ||||
| name | SC | 1..* | HumanName | 照護服務提供人員的姓名 tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| use | S | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。 Required Pattern: official | ||||
| text | SC | 0..1 | string | 完整的中文姓名 Example General: 王依昇 | ||||
| family | SC | 0..1 | string | 英文姓 Example General: Wang | ||||
| given | SC | 0..* | string | 英文名 Example General: Yi Sheng | ||||
| prefix | 0..* | string | 姓名前面的頭銜 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名開頭。 | |||||
| suffix | 0..* | string | 姓名後面的稱謂 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名之後。 | |||||
| period | 0..1 | Period | 此姓名的使用效期 | |||||
| telecom | S | 0..* | ContactPoint | 照護服務提供人員的詳細聯絡方式（適用於所有角色）。 | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| system | S | 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 | 此聯絡方式的使用效期 | ||||
| address | S | 0..* | TWCoreAddress | 不限特定角色的照護服務提供人員的地址（通常是住家地址） | ||||
| gender | S | 0..1 | code | male ｜ female ｜ other ｜ unknown Binding: AdministrativeGender (required): 性別；應填入所綁定值集中的其中一個代碼。 | ||||
| birthDate | S | 0..1 | date | 照護服務提供人員的出生日期 | ||||
| photo | S | 0..* | Attachment | 人員的影像（照片） | ||||
| qualification | 0..* | BackboneElement | 與照護服務相關的證書、執照或培訓 | |||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| modifierExtension | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | |||||
| identifier | 0..* | Identifier | 照護服務提供人員的資格證書識別碼 | |||||
| code | 1..1 | CodeableConceptTW | 資格證書的編碼表示法 Binding: SNOMED CT + 臺灣醫事司醫事人員類別值集 (extensible): 照護服務提供人員提供服務所具有的具體資格證書；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
| period | 0..1 | Period | 資格證書的有效期限 | |||||
| issuer | 0..1 | Reference(TW Core Organization) | 監管和頒發資格證書的機構 | |||||
| communication | 0..* | CodeableConceptTW | 健康照護服務提供者與病人溝通時可使用的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | URI | |||
| Practitioner.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard | ||||
| Practitioner.identifier.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/identifier-use|4.0.1from the FHIR Standard | ||||
| Practitioner.identifier.type | extensible | Identifier Type Codeshttp://hl7.org/fhir/ValueSet/identifier-typefrom the FHIR Standard | ||||
| Practitioner.name.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/name-use|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.system | required | ContactPointSystemhttp://hl7.org/fhir/ValueSet/contact-point-system|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.use | required | ContactPointUsehttp://hl7.org/fhir/ValueSet/contact-point-use|4.0.1from the FHIR Standard | ||||
| Practitioner.gender | required | AdministrativeGenderhttp://hl7.org/fhir/ValueSet/administrative-gender|4.0.1from the FHIR Standard | ||||
| Practitioner.qualification.code | extensible | TWHealthProfessionalSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/health-professional-sct-twfrom this IG | ||||
| Practitioner.communication | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard |
| Id | Grade | Path(s) | Details | Requirements |
| tw-core-1 | error | Practitioner.name | Patient.name.text or Patient.name.family or both SHALL be present : text.exists() or family.exists() |
| Name | Flags | Card. | Type | Description & Constraints | ||||
|---|---|---|---|---|---|---|---|---|
| Practitioner | 0..* | Practitioner | 對於所提供之健康照護或相關服務負有正式責任的人員 | |||||
 id | Σ | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄，通常又稱為邏輯性ID。 | ||||
| meta | Σ | 0..1 | Meta | 此Practitioner Resource的metadata | ||||
| implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則 | ||||
| language | 0..1 | code | 用以表述Practitioner Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用CommonLanguages代碼表中的代碼，但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| text | 0..1 | Narrative | Practitioner Resource之內容摘要以供人閱讀 | |||||
| contained | 0..* | Resource | 內嵌的（contained）、行內的Resources | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| modifierExtension | ?! | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | ||||
| identifier | SΣ | 0..* | Identifier | 此照護服務提供人員的識別碼 | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
| use | ?!SΣ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 Required Pattern: official | ||||
| type | S | 0..1 | CodeableConceptTW | 照護服務提供人員的識別碼（identifier）的型別說明 Binding: Identifier Type Codes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
| system | SΣ | 1..1 | uri | 照護服務提供人員識別碼（identifier）的命名空間（namespace） Example General: http://www.acme.com/identifiers/patient | ||||
| value | SΣ | 1..1 | string | 唯一值。
例如：照護服務提供人員之員工編號為KP00017 Example General: 123456 | ||||
| period | Σ | 0..1 | Period | 此身份識別碼（identifier）的使用效期 | ||||
| assigner | Σ | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述） | ||||
| active | SΣ | 0..1 | boolean | 此照護服務提供人員的紀錄是否在使用中 | ||||
| name | SΣC | 1..* | HumanName | 照護服務提供人員的姓名 tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
| use | ?!SΣ | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。 Required Pattern: official | ||||
| text | SΣC | 0..1 | string | 完整的中文姓名 Example General: 王依昇 | ||||
| family | SΣC | 0..1 | string | 英文姓 Example General: Wang | ||||
| given | SΣC | 0..* | 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..1 | Period | 此姓名的使用效期 | ||||
| telecom | SΣ | 0..* | ContactPoint | 照護服務提供人員的詳細聯絡方式（適用於所有角色）。 | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 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 | 此聯絡方式的使用效期 | ||||
| address | S | 0..* | TWCoreAddress | 不限特定角色的照護服務提供人員的地址（通常是住家地址） | ||||
| gender | SΣ | 0..1 | code | male ｜ female ｜ other ｜ unknown Binding: AdministrativeGender (required): 性別；應填入所綁定值集中的其中一個代碼。 | ||||
| birthDate | SΣ | 0..1 | date | 照護服務提供人員的出生日期 | ||||
| photo | S | 0..* | Attachment | 人員的影像（照片） | ||||
| qualification | 0..* | BackboneElement | 與照護服務相關的證書、執照或培訓 | |||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| modifierExtension | ?!Σ | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | ||||
| identifier | 0..* | Identifier | 照護服務提供人員的資格證書識別碼 | |||||
| code | 1..1 | CodeableConceptTW | 資格證書的編碼表示法 Binding: SNOMED CT + 臺灣醫事司醫事人員類別值集 (extensible): 照護服務提供人員提供服務所具有的具體資格證書；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
| period | 0..1 | Period | 資格證書的有效期限 | |||||
| issuer | 0..1 | Reference(TW Core Organization) | 監管和頒發資格證書的機構 | |||||
| communication | 0..* | CodeableConceptTW | 健康照護服務提供者與病人溝通時可使用的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | URI | |||
| Practitioner.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard | ||||
| Practitioner.identifier.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/identifier-use|4.0.1from the FHIR Standard | ||||
| Practitioner.identifier.type | extensible | Identifier Type Codeshttp://hl7.org/fhir/ValueSet/identifier-typefrom the FHIR Standard | ||||
| Practitioner.name.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/name-use|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.system | required | ContactPointSystemhttp://hl7.org/fhir/ValueSet/contact-point-system|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.use | required | ContactPointUsehttp://hl7.org/fhir/ValueSet/contact-point-use|4.0.1from the FHIR Standard | ||||
| Practitioner.gender | required | AdministrativeGenderhttp://hl7.org/fhir/ValueSet/administrative-gender|4.0.1from the FHIR Standard | ||||
| Practitioner.qualification.code | extensible | TWHealthProfessionalSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/health-professional-sct-twfrom this IG | ||||
| Practitioner.communication | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard |
| Id | Grade | Path(s) | Details | Requirements |
| dom-2 | error | Practitioner | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
| dom-3 | error | Practitioner | 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 | Practitioner | 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 | Practitioner | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
| dom-6 | best practice | Practitioner | 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() | |
| tw-core-1 | error | Practitioner.name | Patient.name.text or Patient.name.family or both SHALL be present : text.exists() or family.exists() |
| Name | Flags | Card. | Type | Description & Constraints | ||||
|---|---|---|---|---|---|---|---|---|
| Practitioner | 0..* | Practitioner | 對於所提供之健康照護或相關服務負有正式責任的人員 | |||||
| id | Σ | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄，通常又稱為邏輯性ID。 | ||||
| meta | Σ | 0..1 | Meta | 此Practitioner Resource的metadata | ||||
| implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則 | ||||
| language | 0..1 | code | 用以表述Practitioner Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用CommonLanguages代碼表中的代碼，但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| text | 0..1 | Narrative | Practitioner Resource之內容摘要以供人閱讀 | |||||
| contained | 0..* | Resource | 內嵌的（contained）、行內的Resources | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| modifierExtension | ?! | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | ||||
| identifier | SΣ | 0..* | Identifier | 此照護服務提供人員的識別碼 | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
| use | ?!SΣ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 Required Pattern: official | ||||
| type | S | 0..1 | CodeableConceptTW | 照護服務提供人員的識別碼（identifier）的型別說明 Binding: Identifier Type Codes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
| system | SΣ | 1..1 | uri | 照護服務提供人員識別碼（identifier）的命名空間（namespace） Example General: http://www.acme.com/identifiers/patient | ||||
| value | SΣ | 1..1 | string | 唯一值。
例如：照護服務提供人員之員工編號為KP00017 Example General: 123456 | ||||
| period | Σ | 0..1 | Period | 此身份識別碼（identifier）的使用效期 | ||||
| assigner | Σ | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述） | ||||
| active | SΣ | 0..1 | boolean | 此照護服務提供人員的紀錄是否在使用中 | ||||
| name | SΣC | 1..* | HumanName | 照護服務提供人員的姓名 tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
| use | ?!SΣ | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。 Required Pattern: official | ||||
| text | SΣC | 0..1 | string | 完整的中文姓名 Example General: 王依昇 | ||||
| family | SΣC | 0..1 | string | 英文姓 Example General: Wang | ||||
| given | SΣC | 0..* | 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..1 | Period | 此姓名的使用效期 | ||||
| telecom | SΣ | 0..* | ContactPoint | 照護服務提供人員的詳細聯絡方式（適用於所有角色）。 | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 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 | 此聯絡方式的使用效期 | ||||
| address | S | 0..* | TWCoreAddress | 不限特定角色的照護服務提供人員的地址（通常是住家地址） | ||||
| gender | SΣ | 0..1 | code | male ｜ female ｜ other ｜ unknown Binding: AdministrativeGender (required): 性別；應填入所綁定值集中的其中一個代碼。 | ||||
| birthDate | SΣ | 0..1 | date | 照護服務提供人員的出生日期 | ||||
| photo | S | 0..* | Attachment | 人員的影像（照片） | ||||
| qualification | 0..* | BackboneElement | 與照護服務相關的證書、執照或培訓 | |||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| modifierExtension | ?!Σ | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | ||||
| identifier | 0..* | Identifier | 照護服務提供人員的資格證書識別碼 | |||||
| code | 1..1 | CodeableConceptTW | 資格證書的編碼表示法 Binding: SNOMED CT + 臺灣醫事司醫事人員類別值集 (extensible): 照護服務提供人員提供服務所具有的具體資格證書；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
| period | 0..1 | Period | 資格證書的有效期限 | |||||
| issuer | 0..1 | Reference(TW Core Organization) | 監管和頒發資格證書的機構 | |||||
| communication | 0..* | CodeableConceptTW | 健康照護服務提供者與病人溝通時可使用的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | URI | |||
| Practitioner.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard | ||||
| Practitioner.identifier.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/identifier-use|4.0.1from the FHIR Standard | ||||
| Practitioner.identifier.type | extensible | Identifier Type Codeshttp://hl7.org/fhir/ValueSet/identifier-typefrom the FHIR Standard | ||||
| Practitioner.name.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/name-use|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.system | required | ContactPointSystemhttp://hl7.org/fhir/ValueSet/contact-point-system|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.use | required | ContactPointUsehttp://hl7.org/fhir/ValueSet/contact-point-use|4.0.1from the FHIR Standard | ||||
| Practitioner.gender | required | AdministrativeGenderhttp://hl7.org/fhir/ValueSet/administrative-gender|4.0.1from the FHIR Standard | ||||
| Practitioner.qualification.code | extensible | TWHealthProfessionalSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/health-professional-sct-twfrom this IG | ||||
| Practitioner.communication | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard |
| Id | Grade | Path(s) | Details | Requirements |
| dom-2 | error | Practitioner | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
| dom-3 | error | Practitioner | 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 | Practitioner | 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 | Practitioner | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
| dom-6 | best practice | Practitioner | 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() | |
| tw-core-1 | error | Practitioner.name | Patient.name.text or Patient.name.family or both SHALL be present : text.exists() or family.exists() |
This structure is derived from Practitioner
Differential View
This structure is derived from Practitioner
| Name | Flags | Card. | Type | Description & Constraints | ||||
|---|---|---|---|---|---|---|---|---|
| Practitioner | 0..* | Practitioner | 對於所提供之健康照護或相關服務負有正式責任的人員 | |||||
| id | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄，通常又稱為邏輯性ID。 | |||||
| meta | 0..1 | Meta | 此Practitioner Resource的metadata | |||||
| implicitRules | 0..1 | uri | 創建此內容所依據的一組規則 | |||||
| language | 0..1 | code | 用以表述Practitioner Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用CommonLanguages代碼表中的代碼，但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| text | 0..1 | Narrative | Practitioner Resource之內容摘要以供人閱讀 | |||||
| contained | 0..* | Resource | 內嵌的（contained）、行內的Resources | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| modifierExtension | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | |||||
| identifier | S | 0..* | Identifier | 此照護服務提供人員的識別碼 | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| use | S | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 Required Pattern: official | ||||
| type | S | 0..1 | CodeableConceptTW | 照護服務提供人員的識別碼（identifier）的型別說明 Binding: Identifier Type Codes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
| system | S | 1..1 | uri | 照護服務提供人員識別碼（identifier）的命名空間（namespace） | ||||
| value | S | 1..1 | string | 唯一值。 例如：照護服務提供人員之員工編號為KP00017 | ||||
| period | 0..1 | Period | 此身份識別碼（identifier）的使用效期 | |||||
| assigner | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述） | |||||
| active | S | 0..1 | boolean | 此照護服務提供人員的紀錄是否在使用中 | ||||
| name | SC | 1..* | HumanName | 照護服務提供人員的姓名 tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| use | S | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。 Required Pattern: official | ||||
| text | SC | 0..1 | string | 完整的中文姓名 Example General: 王依昇 | ||||
| family | SC | 0..1 | string | 英文姓 Example General: Wang | ||||
| given | SC | 0..* | string | 英文名 Example General: Yi Sheng | ||||
| prefix | 0..* | string | 姓名前面的頭銜 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名開頭。 | |||||
| suffix | 0..* | string | 姓名後面的稱謂 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名之後。 | |||||
| period | 0..1 | Period | 此姓名的使用效期 | |||||
| telecom | S | 0..* | ContactPoint | 照護服務提供人員的詳細聯絡方式（適用於所有角色）。 | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| system | S | 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 | 此聯絡方式的使用效期 | ||||
| address | S | 0..* | TWCoreAddress | 不限特定角色的照護服務提供人員的地址（通常是住家地址） | ||||
| gender | S | 0..1 | code | male ｜ female ｜ other ｜ unknown Binding: AdministrativeGender (required): 性別；應填入所綁定值集中的其中一個代碼。 | ||||
| birthDate | S | 0..1 | date | 照護服務提供人員的出生日期 | ||||
| photo | S | 0..* | Attachment | 人員的影像（照片） | ||||
| qualification | 0..* | BackboneElement | 與照護服務相關的證書、執照或培訓 | |||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| modifierExtension | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | |||||
| identifier | 0..* | Identifier | 照護服務提供人員的資格證書識別碼 | |||||
| code | 1..1 | CodeableConceptTW | 資格證書的編碼表示法 Binding: SNOMED CT + 臺灣醫事司醫事人員類別值集 (extensible): 照護服務提供人員提供服務所具有的具體資格證書；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
| period | 0..1 | Period | 資格證書的有效期限 | |||||
| issuer | 0..1 | Reference(TW Core Organization) | 監管和頒發資格證書的機構 | |||||
| communication | 0..* | CodeableConceptTW | 健康照護服務提供者與病人溝通時可使用的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | URI | |||
| Practitioner.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard | ||||
| Practitioner.identifier.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/identifier-use|4.0.1from the FHIR Standard | ||||
| Practitioner.identifier.type | extensible | Identifier Type Codeshttp://hl7.org/fhir/ValueSet/identifier-typefrom the FHIR Standard | ||||
| Practitioner.name.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/name-use|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.system | required | ContactPointSystemhttp://hl7.org/fhir/ValueSet/contact-point-system|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.use | required | ContactPointUsehttp://hl7.org/fhir/ValueSet/contact-point-use|4.0.1from the FHIR Standard | ||||
| Practitioner.gender | required | AdministrativeGenderhttp://hl7.org/fhir/ValueSet/administrative-gender|4.0.1from the FHIR Standard | ||||
| Practitioner.qualification.code | extensible | TWHealthProfessionalSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/health-professional-sct-twfrom this IG | ||||
| Practitioner.communication | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard |
| Id | Grade | Path(s) | Details | Requirements |
| tw-core-1 | error | Practitioner.name | Patient.name.text or Patient.name.family or both SHALL be present : text.exists() or family.exists() |
Key Elements View
| Name | Flags | Card. | Type | Description & Constraints | ||||
|---|---|---|---|---|---|---|---|---|
| Practitioner | 0..* | Practitioner | 對於所提供之健康照護或相關服務負有正式責任的人員 | |||||
| id | Σ | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄，通常又稱為邏輯性ID。 | ||||
| meta | Σ | 0..1 | Meta | 此Practitioner Resource的metadata | ||||
| implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則 | ||||
| language | 0..1 | code | 用以表述Practitioner Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用CommonLanguages代碼表中的代碼，但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| text | 0..1 | Narrative | Practitioner Resource之內容摘要以供人閱讀 | |||||
| contained | 0..* | Resource | 內嵌的（contained）、行內的Resources | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| modifierExtension | ?! | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | ||||
| identifier | SΣ | 0..* | Identifier | 此照護服務提供人員的識別碼 | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
| use | ?!SΣ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 Required Pattern: official | ||||
| type | S | 0..1 | CodeableConceptTW | 照護服務提供人員的識別碼（identifier）的型別說明 Binding: Identifier Type Codes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
| system | SΣ | 1..1 | uri | 照護服務提供人員識別碼（identifier）的命名空間（namespace） Example General: http://www.acme.com/identifiers/patient | ||||
| value | SΣ | 1..1 | string | 唯一值。
例如：照護服務提供人員之員工編號為KP00017 Example General: 123456 | ||||
| period | Σ | 0..1 | Period | 此身份識別碼（identifier）的使用效期 | ||||
| assigner | Σ | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述） | ||||
| active | SΣ | 0..1 | boolean | 此照護服務提供人員的紀錄是否在使用中 | ||||
| name | SΣC | 1..* | HumanName | 照護服務提供人員的姓名 tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
| use | ?!SΣ | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。 Required Pattern: official | ||||
| text | SΣC | 0..1 | string | 完整的中文姓名 Example General: 王依昇 | ||||
| family | SΣC | 0..1 | string | 英文姓 Example General: Wang | ||||
| given | SΣC | 0..* | 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..1 | Period | 此姓名的使用效期 | ||||
| telecom | SΣ | 0..* | ContactPoint | 照護服務提供人員的詳細聯絡方式（適用於所有角色）。 | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 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 | 此聯絡方式的使用效期 | ||||
| address | S | 0..* | TWCoreAddress | 不限特定角色的照護服務提供人員的地址（通常是住家地址） | ||||
| gender | SΣ | 0..1 | code | male ｜ female ｜ other ｜ unknown Binding: AdministrativeGender (required): 性別；應填入所綁定值集中的其中一個代碼。 | ||||
| birthDate | SΣ | 0..1 | date | 照護服務提供人員的出生日期 | ||||
| photo | S | 0..* | Attachment | 人員的影像（照片） | ||||
| qualification | 0..* | BackboneElement | 與照護服務相關的證書、執照或培訓 | |||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| modifierExtension | ?!Σ | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | ||||
| identifier | 0..* | Identifier | 照護服務提供人員的資格證書識別碼 | |||||
| code | 1..1 | CodeableConceptTW | 資格證書的編碼表示法 Binding: SNOMED CT + 臺灣醫事司醫事人員類別值集 (extensible): 照護服務提供人員提供服務所具有的具體資格證書；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
| period | 0..1 | Period | 資格證書的有效期限 | |||||
| issuer | 0..1 | Reference(TW Core Organization) | 監管和頒發資格證書的機構 | |||||
| communication | 0..* | CodeableConceptTW | 健康照護服務提供者與病人溝通時可使用的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | URI | |||
| Practitioner.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard | ||||
| Practitioner.identifier.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/identifier-use|4.0.1from the FHIR Standard | ||||
| Practitioner.identifier.type | extensible | Identifier Type Codeshttp://hl7.org/fhir/ValueSet/identifier-typefrom the FHIR Standard | ||||
| Practitioner.name.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/name-use|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.system | required | ContactPointSystemhttp://hl7.org/fhir/ValueSet/contact-point-system|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.use | required | ContactPointUsehttp://hl7.org/fhir/ValueSet/contact-point-use|4.0.1from the FHIR Standard | ||||
| Practitioner.gender | required | AdministrativeGenderhttp://hl7.org/fhir/ValueSet/administrative-gender|4.0.1from the FHIR Standard | ||||
| Practitioner.qualification.code | extensible | TWHealthProfessionalSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/health-professional-sct-twfrom this IG | ||||
| Practitioner.communication | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard |
| Id | Grade | Path(s) | Details | Requirements |
| dom-2 | error | Practitioner | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
| dom-3 | error | Practitioner | 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 | Practitioner | 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 | Practitioner | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
| dom-6 | best practice | Practitioner | 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() | |
| tw-core-1 | error | Practitioner.name | Patient.name.text or Patient.name.family or both SHALL be present : text.exists() or family.exists() |
Snapshot View
| Name | Flags | Card. | Type | Description & Constraints | ||||
|---|---|---|---|---|---|---|---|---|
| Practitioner | 0..* | Practitioner | 對於所提供之健康照護或相關服務負有正式責任的人員 | |||||
| id | Σ | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的Practitioner紀錄，通常又稱為邏輯性ID。 | ||||
| meta | Σ | 0..1 | Meta | 此Practitioner Resource的metadata | ||||
| implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則 | ||||
| language | 0..1 | code | 用以表述Practitioner Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用CommonLanguages代碼表中的代碼，但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| text | 0..1 | Narrative | Practitioner Resource之內容摘要以供人閱讀 | |||||
| contained | 0..* | Resource | 內嵌的（contained）、行內的Resources | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| modifierExtension | ?! | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | ||||
| identifier | SΣ | 0..* | Identifier | 此照護服務提供人員的識別碼 | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
| use | ?!SΣ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 Required Pattern: official | ||||
| type | S | 0..1 | CodeableConceptTW | 照護服務提供人員的識別碼（identifier）的型別說明 Binding: Identifier Type Codes (extensible): 應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | ||||
| system | SΣ | 1..1 | uri | 照護服務提供人員識別碼（identifier）的命名空間（namespace） Example General: http://www.acme.com/identifiers/patient | ||||
| value | SΣ | 1..1 | string | 唯一值。
例如：照護服務提供人員之員工編號為KP00017 Example General: 123456 | ||||
| period | Σ | 0..1 | Period | 此身份識別碼（identifier）的使用效期 | ||||
| assigner | Σ | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述） | ||||
| active | SΣ | 0..1 | boolean | 此照護服務提供人員的紀錄是否在使用中 | ||||
| name | SΣC | 1..* | HumanName | 照護服務提供人員的姓名 tw-core-1: Patient.name.text or Patient.name.family or both SHALL be present | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 Slice: Unordered, Open by value:url | |||||
| use | ?!SΣ | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。 Required Pattern: official | ||||
| text | SΣC | 0..1 | string | 完整的中文姓名 Example General: 王依昇 | ||||
| family | SΣC | 0..1 | string | 英文姓 Example General: Wang | ||||
| given | SΣC | 0..* | 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..1 | Period | 此姓名的使用效期 | ||||
| telecom | SΣ | 0..* | ContactPoint | 照護服務提供人員的詳細聯絡方式（適用於所有角色）。 | ||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 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 | 此聯絡方式的使用效期 | ||||
| address | S | 0..* | TWCoreAddress | 不限特定角色的照護服務提供人員的地址（通常是住家地址） | ||||
| gender | SΣ | 0..1 | code | male ｜ female ｜ other ｜ unknown Binding: AdministrativeGender (required): 性別；應填入所綁定值集中的其中一個代碼。 | ||||
| birthDate | SΣ | 0..1 | date | 照護服務提供人員的出生日期 | ||||
| photo | S | 0..* | Attachment | 人員的影像（照片） | ||||
| qualification | 0..* | BackboneElement | 與照護服務相關的證書、執照或培訓 | |||||
| id | 0..1 | string | 唯一可識別ID，以供資料項目間相互參照。 | |||||
| extension | 0..* | Extension | 擴充的資料項目 | |||||
| modifierExtension | ?!Σ | 0..* | Extension | 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。 | ||||
| identifier | 0..* | Identifier | 照護服務提供人員的資格證書識別碼 | |||||
| code | 1..1 | CodeableConceptTW | 資格證書的編碼表示法 Binding: SNOMED CT + 臺灣醫事司醫事人員類別值集 (extensible): 照護服務提供人員提供服務所具有的具體資格證書；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。 | |||||
| period | 0..1 | Period | 資格證書的有效期限 | |||||
| issuer | 0..1 | Reference(TW Core Organization) | 監管和頒發資格證書的機構 | |||||
| communication | 0..* | CodeableConceptTW | 健康照護服務提供者與病人溝通時可使用的語言 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。
Example Value: zh-TW | |||||
| Documentation for this format | ||||||||
| Path | Conformance | ValueSet / Code | URI | |||
| Practitioner.language | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard | ||||
| Practitioner.identifier.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/identifier-use|4.0.1from the FHIR Standard | ||||
| Practitioner.identifier.type | extensible | Identifier Type Codeshttp://hl7.org/fhir/ValueSet/identifier-typefrom the FHIR Standard | ||||
| Practitioner.name.use | required | Pattern: officialhttp://hl7.org/fhir/ValueSet/name-use|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.system | required | ContactPointSystemhttp://hl7.org/fhir/ValueSet/contact-point-system|4.0.1from the FHIR Standard | ||||
| Practitioner.telecom.use | required | ContactPointUsehttp://hl7.org/fhir/ValueSet/contact-point-use|4.0.1from the FHIR Standard | ||||
| Practitioner.gender | required | AdministrativeGenderhttp://hl7.org/fhir/ValueSet/administrative-gender|4.0.1from the FHIR Standard | ||||
| Practitioner.qualification.code | extensible | TWHealthProfessionalSCThttps://twcore.mohw.gov.tw/ig/twcore/ValueSet/health-professional-sct-twfrom this IG | ||||
| Practitioner.communication | preferred | CommonLanguages
http://hl7.org/fhir/ValueSet/languagesfrom the FHIR Standard |
| Id | Grade | Path(s) | Details | Requirements |
| dom-2 | error | Practitioner | If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty() | |
| dom-3 | error | Practitioner | 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 | Practitioner | 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 | Practitioner | If a resource is contained in another resource, it SHALL NOT have a security label : contained.meta.security.empty() | |
| dom-6 | best practice | Practitioner | 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() | |
| tw-core-1 | error | Practitioner.name | Patient.name.text or Patient.name.family or both SHALL be present : text.exists() or family.exists() |
This structure is derived from Practitioner
Other representations of profile: CSV, Excel, Schematron
以下概述了此Profile所需的RESTful FHIR互動功能。有關TW Core IG支援的RESTful互動功能的完整清單，請參閱TW Core Server能力聲明。
建議應該(SHOULD) 支援透過查詢參數 _id 查詢所有Practitioner：
(如何透過token查詢)
GET [base]/Practitioner?_id=[id]
GET [base]/Practitioner/[id]
例子：
(1) GET [base]/Practitioner?_id=pra-dr-example
(2) GET [base]/Practitioner/pra-dr-example
建議應該(SHOULD) 支援透過查詢參數 identifier 查詢所有Practitioner：
(如何透過token查詢)
GET [base]/Practitioner?identifier={system|}[code]
例子：
(1) GET [base]/Practitioner?identifier=https://www.tph.mohw.gov.tw/|KP00017
建議應該(SHOULD) 支援透過查詢參數 name 查詢所有Practitioner，該查詢可能與 HumanName 中的任何字串匹配，包括完整的中文姓名(text)、英文姓(family)、英文名(given)、姓名前面的頭銜(prefix)、姓名後面的稱謂(suffix)：
(如何透過string查詢)
GET [base]/Practitioner?name=[name]
例子：:
(1) GET [base]/Practitioner?name=王依昇