Generated Narrative: StructureDefinition PractitionerRole-twdental Name Flags Card. Type Description & Constraints PractitionerRole 0..* TWCorePractitionerRole 牙醫師在特定機構中的角色資料 #xD; practitioner 1..1 Reference(TW Core Practitioner) 關聯的牙醫師 #xD; organization 1..1 Reference(TW Core Organization) 關聯的機構 #xD; code 1..* CodeableConceptTW 角色代碼 #xD; specialty 0..* CodeableConceptTW 專科別 #xD; location 0..* Reference(TW Core Location) 執業地點 #xD; telecom 0..* ContactPoint 聯絡方式 #xD; value 1..1 string 電話號碼/電子郵件 #xD; availableTime S 0..* BackboneElement 可看診時段 #xD; daysOfWeek S 0..* code mon | tue | wed | thu | fri | sat | sun #xD; availableStartTime S 0..1 time 每天的開放時間（如果 allDay = true，則忽略。） #xD; availableEndTime S 0..1 time 每天的關閉時間（如果 allDay = true，則忽略。） #xD; Documentation for this format
此 Profile 說明本 IG 如何進一步定義 FHIR 的 PractitionerRole Resource，以呈現牙醫師在特定機構中的角色資料。
健康照護服務提供者可能在一個機構內，一段時間內可能承擔的一系列職務角色（Roles）/工作地點（Locations）/專業領域（specialties）/所提供的服務（services）。
If the resource is contained in another resource, it SHALL NOT contain nested Resources
not(parent::f:contained and f:contained)
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()
not(exists(for $id in f:contained/*/f:id/@value return $contained[not(parent::*/descendant::f:reference/@value=concat('#', $contained/*/id/@value) or descendant::f:reference[@value='#'])]))
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()
not(exists(f:contained/*/f:meta/f:versionId)) and not(exists(f:contained/*/f:meta/f:lastUpdated))
If a resource is contained in another resource, it SHALL NOT have a security label
When a resource has no narrative, only systems that fully understand the data can display the resource to a human safely. Including a human readable representation in the resource makes for a much more robust eco-system and cheaper handling of resources by intermediary systems. Some ecosystems restrict distribution of resources to only those systems that do fully understand the resources, and as a consequence implementers may believe that the narrative is superfluous. However experience shows that such eco-systems often open up to new participants over time.
A resource should have narrative for robust management
不重複的ID用以識別儲存在特定FHIR Server中的PractitionerRole紀錄，通常又稱為邏輯性ID。
一個resource使用新增操作（create operation）提交給伺服器時，此resource沒有id，它的id在resource被創建後由伺器分配/指定。
關於resource的metadata。這是由基礎建設維護的內容。內容的更改可能並不總是與resource的版本更改相關聯。
All FHIR elements must have a @value or children
hasValue() or (children().count() > id.count())
構建resource時遵循的一系列規則的參照，在處理內容時必須理解這些規則。通常這是對IG所定義之特殊規則及其他profiles的參照。
宣告這套規則限制了內容只能被有限的交易夥伴所理解。這從本質上限制了資料的長期有用性。然而，現有的健康生態體系高度分裂，還沒有準備好以普遍可計算的方式定義、收集和交換資料。只要有可能，實作者和/或規範編寫者應該避免使用這個資料項目。通常在使用時，此URL是對IG的參照，此IG將這些特殊規則與其他profiles、value sets等一起定義為其敘述的一部分。
This element is labeled as a modifier because the implicit rules may provide additional knowledge about the resource that modifies it's meaning or interpretation
提供語言是為了支援索引和可存取性（通常，文字表述轉語音等服務使用此語言標籤）。html lanuage tag適用於此敘述。resource上的語言標籤可用於指定從resource中的資料所產成的其他表述之語言。不是所有的內容都必須使用此語言。不應該假定Resource.language自動適用於敘述。如果指定語言，它也應該被指定在html中的div資料項目（關於xml:lang和html lang屬性之間的關係，見HTML5中的規則）。
人類語言；鼓勵使用CommonLanguages代碼表中的代碼，但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
人可讀的敘述，包含resource的摘要，可用於向人表述resource的內容。敘述不需要對所有的結構化資料進行編碼，但需要包含足夠的細節使人在閱讀敘述時理解「臨床安全性」。resource定義有哪些內容應該在敘述中表示，以確保臨床安全。
內嵌（contained）的resource沒有敘述，非內嵌（contained）的resource則 **建議應該（SHOULD）** 有敘述。有時resource可能只有文字表述，很少或沒有額外的結構化資料（只要滿足所有minOccurs=1的資料項目）。這可能出現在舊系統的資料，當資訊以 「文字表述區塊（text blob） 」的形式被取得，或者文字表述是原始輸入或說明，而編碼資訊稍後再添加。
These resources do not have an independent existence apart from the resource that contains them - they cannot be identified independently, and nor can they have their own independent transaction scope.
This should never be done when the content can be identified properly, as once identification is lost, it is extremely difficult (and context dependent) to restore it again. Contained resources may have profiles and tags In their meta elements, but SHALL NOT have security labels.
Additional content defined by implementations
May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions. The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.
Must have either extensions or value[x], not both
exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
May be used to represent additional information that is not part of the basic definition of the resource and that modifies the understanding of the element that contains it and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer is allowed to define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored. This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).
Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them
通常會為代理人指派特定的身份識別
此健康照護服務提供者角色紀錄是否有效
如果此值為 false，則可以參考period資料項目來了解角色的有效時間。如果沒有指定eriod，則無法推斷角色的有效時間。
需要能夠將健康照護服務提供者角色紀錄標記為無效，因為該記錄是錯誤創建的，或已不再有效。
This resource is generally assumed to be active if no value is provided for the active element
健康照護服務提供者在這些角色裡被授權執行工作的時間範圍
健康照護服務提供者被授權在這些角色中為機構執行工作的時間範圍
即使授權被撤銷，仍需記錄該授權曾經存在的事實。
.performance[@typeCode <= 'PPRF'].ActDefinitionOrEvent.effectiveTime
(ServD maps Practitioners and Organizations via another entity, so this concept is not available)
能夠為機構提供所定義服務的健康照護服務提供者
此健康照護服務提供者履行相關角色職責的機構
此健康照護服務提供者被授權為機構執行的角色
需要了解健康照護服務提供者的權限 - 他們可以做什麽？
應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
.player.HealthCareProvider[@classCode = 'PROV'].code
唯一可識別ID，以供資料項目間相互參照。
resource中資料項目的唯一ID（用於內部參照）。這可以是任何不含空格的字串。
Extensions are always sliced by (at least) url
代碼可以在列舉清單（enumerations）或代碼清單（code lists）中非常隨意地定義，直至有非常正式的定義，例如：SNOMED CT—更多資訊見HL7 v3核心原則（Core Principles ）。編碼的排序是未定義的因而 **必須沒有（SHALL NOT）** 被用來推斷意義。一般來說，最多只有一個編碼值（coding values）會被標記為UserSelected = true。
允許代碼系統中的替代編碼，以及翻譯到其他編碼系統。
fhir:CodeableConcept.coding rdfs:subPropertyOf dt:CD.coding
resource中資料項目的唯一ID（用於內部參照），這可以是任何不含空格的字串。
可用於表示不屬於此資料項目基本定義的附加資訊。為了擴充的使用安全和可管理，對擴充的定義和使用有一套嚴格的管理。儘管任何實作者都可以定義一個擴充，但作為擴充定義的一部分，有一套要求 **必須（SHALL）** 滿足。
無論使用或定義擴充的機構或管轄區，任何應用程式、專案或標準使用擴充都不背負任何污名（stigma）。使用擴充是允許FHIR規範為每個人保留一個核心的簡易性。
定義代碼中符號意義的代碼系統識別
URI可以是一個OID（urn:oid:...）或一個UUID（urn:uuid:...）；OID和UUID **必須（SHALL）** 參照HL7 OID註冊中心；否則，URI應該來自HL7的FHIR定義的特殊URI列表，或者它應該參照一些明確建立的系统定義。
fhir:Coding.system rdfs:subPropertyOf dt:CDCoding.codeSystem
選擇此代碼時使用的代碼系統版本；請注意，一個維護良好的代碼系統不需要版本報告，因為代碼的意義在不同系統版本中是一致的；然而，不能始終保證這點，當不能保證意義一致時， **必須（SHALL）** 將版本資訊也一併作交換。
如果專門術語沒有明確定義應該使用什麼字串來識別代碼系統的版本，建議使用版本正式發布的日期（用FHIR日期格式表示）作為版本日期。
fhir:Coding.version rdfs:subPropertyOf dt:CDCoding.codeSystemVersion
系統定義的語法之符號；符號可能是一個預先定義的代碼，也可能是代碼系統定義的語法中的表達式（如後組合配對／後組合式）。
fhir:Coding.code rdfs:subPropertyOf dt:CDCoding.code
遵循系統的規則以呈現代碼含義的表示法
需要能為不了解此系統的讀者呈現可讀的代碼含義
C*E.2 - but note this is not well followed
fhir:Coding.display rdfs:subPropertyOf dt:CDCoding.displayName
表明此編碼是由使用者直接選擇，例如：從可用項目（代碼或顯示名稱）的清單中選擇。
在一系列備選方案中，直接選擇的代碼是新翻譯最合適的起點；關於「直接選擇」的確切意義，存在模糊不清之處，可能需要貿易夥伴的同意，以更完整澄清此資料項目的使用及其後果。
已被確定為一個臨床安全準則—此確切的系統／代碼對(code pair)是被明確選擇的，而不是由系統根據一些規則或是程式語言處理判斷。
fhir:Coding.userSelected fhir:mapsTo dt:CDCoding.codingRationale. fhir:Coding.userSelected fhir:hasMap fhir:Coding.userSelected.map. fhir:Coding.userSelected.map a fhir:Map; fhir:target dt:CDCoding.codingRationale. fhir:Coding.userSelected\#true a [ fhir:source "true"; fhir:target dt:CDCoding.codingRationale\#O ]
輸入資料的使用者所見／所選／所說的人類可讀文字表述，和（或）其代表使用者的預期含義。
很多時候，此文字表述與其中一個代碼的顯示名稱相同。
專門術語中的代碼並不總是能捕捉人類使用的細微差別的正確意義，或者根本就沒有合適的代碼；這些情況下，文字表述被用來捕捉來源的全部意義。
C*E.9. But note many systems use C*E.2 for this
fhir:CodeableConcept.text rdfs:subPropertyOf dt:CD.originalText
此健康照護服務提供者提供照護的地點
.performance.ActDefinitionOrEvent.ServiceDeliveryLocation[@classCode = 'SDLOC']
(ServD maps Practitioners and Organizations via another entity, so this concept is not available) However these are accessed via the Site.ServiceSite.ServiceSiteProvider record. (The Site has the location)
.player.QualifiedEntity[@classCode = 'QUAL'].code
健康照護服務提供者通常在工作的每個地點（或服務）都有專用的聯絡方式，需要能夠為每個地點（或服務）定義不同的聯絡資訊
Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.
phone | fax | email | pager | url | sms | other
聯絡方式的通訊形式－需要什麼通訊系統進行聯絡
應填入所綁定值集中的其中一個代碼。
實際的聯絡方式之細節，針對指定的通訊系統提供有意義的形式（電話號碼或是電子郵件位址）
額外的文字資料，例如電話分機號碼、或關於聯絡人的說明，有時也包括於此值。
需支援非嚴格格式控制之舊有號碼
home | work | temp | old | mobile－此聯絡方式的用途
應用程式可以假定一個聯絡方法是目前使用中，除非它明確說它是暫時的或舊的。
需要追蹤此人使用這種聯絡的方式，使用者可以選擇適合他們用途的聯絡方式。
This is labeled as "Is Modifier" because applications should not mistake a temporary or old contact etc.for a current/permanent one
具體說明偏好的使用順序（1=最高優先順序）
具體說明使用一組聯繫方式的優先順序，較小排名序位的聯絡方式比較大排名序位的聯絡方式之序位還要前面。
請注意，排名序位沒有一定要遵循聯絡方式在實例中呈現的順序。
健康照護服務提供者在該地點和/或健康照護服務以履行該角色職責的時間集合
更詳細的可用性訊息可在相關的時間表/時隙resource中提供。
Extensions that cannot be ignored even if unrecognized
May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions. Modifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).
Modifier extensions are expected to modify the meaning or interpretation of the element that contains them
此服務地點，在規定的開始和結束時間內，一週中哪些天是開放的。
此服務地點是否始終開放？（因此時間並不重要），例如 24 小時服務。
預計時區為提供該醫療保健服務的地點的時區。
由於提供的原因，在此期間無法使用。
由於所提供的原因，此健康照護服務提供者在此期間無法上班或無法履行此角色職責。
向使用者說明為什麼此期間無法使用的原因
向使用者說明為什麽沒有這個時間的原因
此服務從此日期起暫時無法提供（季節性或國定假日）
描述在特定情況下服務不可用的特例
對於服務地點可用性的所有例外情況進行描述，例如國定假日的可用性。簡要描述了所有可能影響可用性的例外情況，包括可用時間和不可用時間的細節。
提供用於此健康照護服務提供者角色運營服務的技術端點
機構在不同健康照護服務提供者角色有提供各種服務的不同系統，需要明確怎樣以及為了什麼目的來連接這些系統的技術詳情。