Generated Narrative: StructureDefinition TWCorePractitioner Name Flags Card. Type Description & Constraints<img src="[binary]" alt="doco" style="background-color: inherit"/> Practitioner TWCorePractitioner identifier 1..* Identifier 此照護服務提供人員的識別碼 name 1..1 HumanName 照護服務提供人員的姓名 <img src="[binary]" alt="doco" style="background-color: inherit"/> Documentation for this format
對於所提供之健康照護或相關服務負有正式責任的人員
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中的Practitioner紀錄，通常又稱為邏輯性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） 」的形式被取得，或者文字表述是原始輸入或說明，而編碼資訊稍後再添加。
當內容可以從任何FHIR伺服器找到時，不應該以內嵌（contained）resource的方式呈現，因為一旦失去識別，再次恢復它是非常困難的（並且取決於情境）。內嵌（contained）的resource可在它們的meta資料項目中表述profiles和tag，但不應該有安全標號（security labels）。
可用於表示不屬於此resource基本定義的額外資訊。為了擴充的使用安全和可管理，對擴充的定義和使用有一套嚴格的管理。儘管任何實作者都可以定義一個擴充，但作為擴充定義的一部分，**必須（SHALL）** 滿足一系列要求。
任何應用程式、專案或標準使用擴充時，都不應該帶有任何負面的聯想。使用擴充是允許FHIR規範為每個人保留一個核心的簡易性。
Must have either extensions or value[x], not both
exists(f:extension)!=exists(f:*[starts-with(local-name(.), "value")])
此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
可以用來表示不屬於此resource的基本定義的額外資訊，並修改包含它所內嵌（contained）的資料項目的理解和/或對包含資料項目之後續使用的理解。通常修飾用的資料項目提供否定或限定的資訊。為了使擴充的使用安全和可管理，對擴充的定義和使用有一套嚴格的管理。雖然任何實作者都可以定義一個擴充，但在定義擴充時 **必須（SHALL）** 滿足一組要求。處理resource的應用程式需要檢查修飾用的擴充資料項目。 修飾用的擴充資料項目 **必須沒有（SHALL NOT）** 改變resource或DomainResource上任何資料項目的含義（包括不能改變modifierExtension本身的含義）。
修飾用的資料項目擴充允許將不能安全地忽略的擴充，與絕大多數可以安全地忽略的擴充明確區分開來。這樣做有助於促進可互操作性，因為無需禁止實作者使用擴充，想要瞭解更多資訊，請參見[修飾用的資料項目擴充之定義]（http://hl7.org/fhir/R4/extensibility.html#modifierExtension）。
Modifier extensions are expected to modify the meaning or interpretation of the resource that contains them
通常此人員總是被指定一個特定的數值型的唯一識別碼（identifier）
Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.
Extensions are always sliced by (at least) url
Additional content defined by implementations
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.
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.
usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道）
應用程式可以假定一個識別碼是永久的，除非它明確說它是暫時的。
允許從一組識別碼中為特定的使用情境選擇適當的識別碼
This is labeled as "Is Modifier" because applications should not mistake a temporary id for a permanent one.
如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。
識別碼的代碼型別，用於決定特定目適用的識別碼。
這個資料項目只涉及識別碼的一般類別。它 **必須沒有（SHALL NOT）** 被用於與Identifier.system 1..1對應的代碼。一些識別碼可能由於常見的用法而屬於多個類別。在系統是已知的情況下，型別是不必要的，因為型別總是系統定義的一部分。然而，系統經常需要處理系統不為人知的識別碼。型別和系統之間不是1:1的關係，因為許多不同的系統有相同的型別。
允許使用者在不知道識別碼系統的情況下利用識別碼
識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
fhir:CodeableConcept rdfs:subClassOf dt:CD
唯一可識別ID，以供資料項目間相互參照。
resource中資料項目的唯一ID（用於內部參照）。這可以是任何不含空格的字串。
代碼可以在列舉清單（enumerations）或代碼清單（code lists）中非常隨意地定義，直至有非常正式的定義，例如：SNOMED CT—更多資訊見HL7 v3核心原則（Core Principles）。編碼的排序是未定義的因而 **必須沒有（SHALL NOT）** 被用來推斷意義。一般來說，最多只有一個編碼值（coding values）會被標記為UserSelected = true。
允許代碼系統中的替代編碼，以及翻譯到其他編碼系統。
CE/CNE/CWE subset one of the sets of component 1-3 or 4-6
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
unique id for the element within a resource (for internal references)
exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])
- 增加Practitioner.identifier.type.coding.code欄位也可使用此Extension，以利實務專案使用 識別碼後綴詞
遵循系統的規則以呈現代碼含義的表示法
需要能為不了解此系統的讀者呈現可讀的代碼含義
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
身份識別碼（identifier）的命名空間（namespace） 例如：身分證字號='http://www.moi.gov.tw'
建立值的命名空間－即一個描述一組值的唯一URL
有許多識別碼的集合。為了進行兩個識別碼的對應，我們需要知道我們處理的是哪一組。系統指明了一個特定的唯一識別碼集。
識別碼中通常與使用者有關的部分，在系統情境內是唯一的。
如果此值是一個完整的URI，那麼此系統 **必須（SHALL）** 是urn:ietf:rfc:3986。此值的主要目的是為了可運算的對應。因此，為了比較的目的，它可能會被正規化（例如：去除不重要的空白、破折號等）。一個為人顯示的格式化的值可以使用[Rendered Value](http://hl7.org/fhir/R4/extension-rendered-value.html)擴充來傳達。除非對Identifier.system的了解使處理者確信不區分大小寫的處理是安全的，否則Identifier.value應被視為區分大小寫。
II.extension or II.root if system indicates OID or GUID (Or Role.id.extension or root)
識別碼有效／曾經有效使用的時段或期間
Role.effectiveTime or implied by context
II.assigningAuthorityName but note that this is an improper use by the definition of the field. Also Role.scoper
身份識別碼（identifier）的命名空間（namespace） 例如：護照號碼='http://www.boca.gov.tw。
身份識別碼（identifier）的命名空間（namespace） 例如：居留證號='http://www.immigration.gov.tw'。
身份識別碼（identifier）的命名空間（namespace），可至 [twTerminology](https://twcore.mohw.gov.tw/ts/namingsystem.jsp?status=active&type=0) 申請或查詢命名系統。
此照護服務提供人員的紀錄是否在使用中
如果機構未使用此照護服務提供人員紀錄，那麼應該在PractitonerRole上標註結束日期（即使他們是使用中的），因為他們可能以另一種角色存在。
由於照護服務提供人員的紀錄被錯誤建立，需能將其紀錄標註為非使用中。
This resource is generally assumed to be active if no value is provided for the active element
使用屬性的選擇應確保有一個指定的常用名稱，其他名稱應根據需要使用暱稱（別名）、舊名或其他值。 一般來說，根據以下條件決定要在ResourceReference.display中使用的值： 1. 有一個以上的名字 2. Use=usual 3. Period（使用期間）是目前日期至使用截止日期 4. Use=official 5. 其他順序則由內部業務規則決定
Practitioner所使用的名稱。如果有多個名字，則應使用此健康照護服務提供者常用的名字來顯示。
Patient.name.text or Patient.name.family or both SHALL be present
./PreferredName (GivenNames, FamilyName, TitleCode)
usual | official | temp | nickname | anonymous | old | maiden
應用程式可以假定一個姓名是永久的，除非它明確說它是暫時或舊的。
允許從一組姓名中為特定的使用情境選擇適當的姓名
This is labeled as "Is Modifier" because applications should not mistake a temporary or old name etc.for a current/permanent one
人名的使用情況；應填入所綁定值集中的其中一個代碼。
XPN.7, but often indicated by which field contains the name
完整姓名的文字表述。由於世界各地的文化差異，取得資料的系統可能不知道如何正確地呈現姓名；此外，不是所有的名字部分都呈現予姓或名。因此，我們強烈建議創建者透過這個資料項目提供姓名的顯示文字。
可以同時提供文字表述（text）和部分（part）。更新姓名的應用程式 **必須（SHALL）** 確保當test和lpart都存在時，text中不包含part中沒有的內容。
姓名中與族譜相關的部分。在一些文化中（如厄立特里亞），兒子的姓氏是其父親的名字。
姓氏可以使用擴充名（de、nl、es相關文化）分解成具體的部分（part）
如果只記錄首字母，可以用它們來代替完整姓名。首字母可以分為多個名，但由於實際情況的限制，通常不會這樣做。這個資料項目不被稱為 「first name」，因為「given name」並不總是排在前面。
Given Names appear in the correct order for presenting the name
姓名前面的頭銜 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名開頭。
由於學術、法規、就業或貴族身份等原因而獲得的名，並出現在姓名的開頭。
Prefixes appear in the correct order for presenting the name
姓名後面的稱謂 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名之後。
Suffixes appear in the correct order for presenting the name
表明這個姓名對此病人有效的時間區間或期間
允許多個姓名按其歷史情境（效期）儲存
照護服務提供人員的詳細聯絡方式（適用於所有角色）。
照護服務提供人員的詳細聯絡方式，例如：電話號碼或電子郵件信箱。
個人可能有多種聯繫方式，有不同的用途或適用期。可能需要有與該人緊急聯繫的選項，並幫助識別。這些通常會有家用電話號碼，或沒有特定角色的手機號碼。
不論照護服務提供人員的角色是什麼，需要知道如何與照護服務提供人員取得聯繫。
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=最高優先順序）
具體說明使用一組聯絡方式的優先順序，較小排名序位的聯絡方式比較大排名序位的聯絡方式之序位還要前面。
請注意，排名序位沒有一定要遵循聯絡方式在實例中呈現的順序。
不限特定角色的照護服務提供人員的地址（通常是住家地址）
不限特定角色的健康照護服務提供者的地址（通常是住家地址），工作地址通常不在此屬性中輸入，因為它們通常取決於此人員的角色。
Administrative Gender為行政管理的及保存紀錄目的之健康照護服務提供者性別
用以正確稱呼健康照護服務提供者
性別；應填入所綁定值集中的其中一個代碼。
許多EHR系統有能力取得健康照護服務提供者的影像（照片），這也符合較新的社群媒體的使用。
./ImageURI (only supports the URI reference)
與照護服務相關的證書、執照或培訓
授權或其他與照護服務提供人員提供照護有關的官方證書、執照和培訓。例如：由衛生福利部頒發的醫師證書。
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 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 element that contains them
照護服務提供人員的資格證書識別碼
此人在此角色的資格證書之識別碼
通常此資格證書會被指定特定識別碼
Not all terminology uses fit this general pattern. In some cases, models should not use CodeableConcept and use Coding directly and provide their own structure for managing text, codings, translations and the relationship between elements and pre- and post-coordination.
照護服務提供人員提供服務所具有的具體資格證書；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
資格證書通常是有期限的，並且可以被撤銷。
./Qualifications.StartDate and ./Qualifications.EndDate
健康照護服務提供者與病人溝通時可使用的語言
帶有這種精確字母大小寫的aa-BB結構是最廣泛使用的地方性符號之一。但並不是所有的系統都對其進行編碼，而是將其作為純文字表述。因此，data type為CodeableConcept而不是code。
知道照護服務提供人員講哪種語言有助於促進與病人的溝通
人類語言；鼓勵使用所綁定值集中的代碼，但不強制一定要使用此值集，你也可使用其他值集的代碼或單純以文字表示。