HL7 FHIR JP Core ImplementationGuide
1.1.2-url - ci-build Japan

HL7 FHIR JP Core ImplementationGuide - Local Development build (v1.1.2-url) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Resource Profile: JP Core PractitionerRole Profile

項目内容
定義URL http://jpfhir.jp/fhir/core/StructureDefinition/JP_PractitionerRole
Version 1.1.2-url
Name

JP_PractitionerRole

Title

JP Core PractitionerRole Profile

Status Active ( 2023-06-26 )
Copyright

Copyright FHIR Japanese implementation research working group in Japan Association of Medical Informatics (JAMI) 一般社団法人日本医療情報学会NeXEHRS課題研究会FHIR日本実装検討WG

このプロファイルはPractitionerRoleリソースに対して、医療従事者役割のデータを送受信するための基礎となる制約と拡張を定めたものである。



電子カルテ情報共有サービス対応 V1.1.2-url 版について

このV1.1.2-url 版は、CodeSystemのシステムURIをOID形式からhttp:で始まるURL形式に変更したバージョンです。 例)OID形式:urn:oid:1.2.392.10495.x.y.z
 →  http:で始まるURL形式: http://jpfhir/fhire/core/CodeSystem/…..
電子カルテ情報共有サービスの実装ガイドではこのJP-Core v1.1.2-url版を参照しています。 通常版はこちらを参照ください。


医療者が組織で一定期間担当する可能性のある特定の役割/場所/専門分野/サービスのセット。
本プロファイルは、PractitionerRoleリソースが医療者の役割を記録、検索、および取得するための最小の期待値を設定する。 これは、本プロファイルを使用するときにPractitionerRoleリソースに存在する必要がある必須のコア要素、拡張機能、語彙、および値セットを識別する。

背景および想定シナリオ

本プロファイルは、以下のようなユースケースを想定している。

  • 医療者の臨床専門分野による医療者役割の検索

  • 他のリソースからの医療者役割の参照(例:Encounterリソースのparticipantで参照される患者の関係者の医療者役割)

スコープ

医療者役割は、医療者が組織に提供できるサービスの場所と種類の記録をカバーする。

医療者役割の他のインスタンスで必要に応じて、ロール、スペシャリティ、ロケーションテレコム、およびHealthcareServiceプロパティを繰り返すことができる。 単一の場所のサービス値のコレクションを記録するシステムもあれば、単一のサービスとそれが利用可能な場所のリストを記録するシステムもある。 どちらも、このデータを表すための許容可能なオプションである。可用性、通信、またはその他の詳細がすべてのヘルスケアサービス間で同じではない場合、または場所ごとに個別の医療者役割インスタンスを作成する必要がある。

プロファイル定義

Usage:

プロファイル詳細

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

NameFlagsCard.TypeDescription & Constraintsdoco
.. PractitionerRole 0..* PractitionerRole 医療従事者が関連付けられている役割/組織
... identifier 0..* Identifier 役割/場所に固有のビジネス識別子
... active 0..1 boolean このPractitionerRoleレコードがアクティブに使用されているかどうか
... period 0..1 Period その人が、これらの役割(複数可)の医療従事者として行動することを許可されている期間
... practitioner 0..1 Reference(JP Core Practitioner Profile) 組織に定義されたサービスを提供できる医療従事者
... organization 0..1 Reference(JP Core Organization Profile) 役割が可能な組織
... code 0..* CodeableConcept この医療従事者が果たす役割【詳細参照】
Binding: JP Core PractitionerRole ValueSet (preferred)
... specialty 0..* CodeableConcept 開業医の特定の専門 / Specific specialty of the practitioner
... location 0..* Reference(JP Core Location Profile) この医療従事者がケアを提供している場所
... healthcareService 0..* Reference(HealthcareService) この対象者がこの役割の組織/場所に対して提供するヘルスケアサービスのリスト
... telecom 0..* ContactPoint 役割/場所/サービスに固有の連絡先の詳細
... availableTime 0..* BackboneElement サービスサイトが利用可能です / Times the Service Site is available
.... daysOfWeek 0..* code 月|火|水|木|金|土|太陽 / mon | tue | wed | thu | fri | sat | sun
.... allDay 0..1 boolean いつでも利用できますか?例えば24時間のサービス / Always available? e.g. 24 hour service
.... availableStartTime 0..1 time 営業時間の時間(allday = trueの場合無視) / Opening time of day (ignored if allDay = true)
.... availableEndTime 0..1 time 閉店時間の時間(Allday = Trueの場合無視) / Closing time of day (ignored if allDay = true)
... notAvailable 0..* BackboneElement この期間中は利用できない理由と期間
.... description 1..1 string ユーザーに提示された理由は、なぜ時間が利用できないのかを説明しています / Reason presented to the user explaining why time not available
.... during 0..1 Period この日付から利用できません / Service not available from this date
... availabilityExceptions 0..1 string 可用性の例外の説明 / Description of availability exceptions
... endpoint 0..* Reference(Endpoint) この役割で開業医のために運営されているサービスへのアクセスを提供する技術エンドポイント / Technical endpoints providing access to services operated for the practitioner with this role

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. PractitionerRole 0..* PractitionerRole 医療従事者が関連付けられている役割/組織
... id Σ 0..1 id このアーティファクトの論理ID / Logical id of this artifact
... meta Σ 0..1 Meta リソースに関するメタデータ / Metadata about the resource
... implicitRules ?!Σ 0..1 uri このコンテンツが作成されたルールのセット / A set of rules under which this content was created
... language 0..1 code リソースコンテンツの言語 / Language of the resource content
Binding: CommonLanguages (preferred): 人間の言語。 / A human language.

Additional BindingsPurpose
AllLanguages Max Binding
... text 0..1 Narrative 人間の解釈のためのリソースのテキスト概要 / Text summary of the resource, for human interpretation
... contained 0..* Resource インラインリソースが含まれています / Contained, inline Resources
... extension 0..* Extension 実装で定義された追加のコンテンツ / Additional content defined by implementations
... modifierExtension ?! 0..* Extension 無視できない拡張機能 / Extensions that cannot be ignored
... identifier Σ 0..* Identifier 役割/場所に固有のビジネス識別子
... active Σ 0..1 boolean このPractitionerRoleレコードがアクティブに使用されているかどうか
... period Σ 0..1 Period その人が、これらの役割(複数可)の医療従事者として行動することを許可されている期間
... practitioner Σ 0..1 Reference(JP Core Practitioner Profile) 組織に定義されたサービスを提供できる医療従事者
... organization Σ 0..1 Reference(JP Core Organization Profile) 役割が可能な組織
... code Σ 0..* CodeableConcept この医療従事者が果たす役割【詳細参照】
Binding: JP Core PractitionerRole ValueSet (preferred)
... specialty Σ 0..* CodeableConcept 開業医の特定の専門 / Specific specialty of the practitioner
Binding: PracticeSettingCodeValueSet (preferred): 代理店に関連する特定の専門分野。 / Specific specialty associated with the agency.


... location Σ 0..* Reference(JP Core Location Profile) この医療従事者がケアを提供している場所
... healthcareService 0..* Reference(HealthcareService) この対象者がこの役割の組織/場所に対して提供するヘルスケアサービスのリスト
... telecom Σ 0..* ContactPoint 役割/場所/サービスに固有の連絡先の詳細
... availableTime 0..* BackboneElement サービスサイトが利用可能です / Times the Service Site is available
.... id 0..1 string 要素間参照のための一意のID / Unique id for inter-element referencing
.... extension 0..* Extension 実装で定義された追加のコンテンツ / Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension 認識されていなくても無視できない拡張機能 / Extensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..* code 月|火|水|木|金|土|太陽 / mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 曜日。 / The days of the week.


.... allDay 0..1 boolean いつでも利用できますか?例えば24時間のサービス / Always available? e.g. 24 hour service
.... availableStartTime 0..1 time 営業時間の時間(allday = trueの場合無視) / Opening time of day (ignored if allDay = true)
.... availableEndTime 0..1 time 閉店時間の時間(Allday = Trueの場合無視) / Closing time of day (ignored if allDay = true)
... notAvailable 0..* BackboneElement この期間中は利用できない理由と期間
.... id 0..1 string 要素間参照のための一意のID / Unique id for inter-element referencing
.... extension 0..* Extension 実装で定義された追加のコンテンツ / Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension 認識されていなくても無視できない拡張機能 / Extensions that cannot be ignored even if unrecognized
.... description 1..1 string ユーザーに提示された理由は、なぜ時間が利用できないのかを説明しています / Reason presented to the user explaining why time not available
.... during 0..1 Period この日付から利用できません / Service not available from this date
... availabilityExceptions 0..1 string 可用性の例外の説明 / Description of availability exceptions
... endpoint 0..* Reference(Endpoint) この役割で開業医のために運営されているサービスへのアクセスを提供する技術エンドポイント / Technical endpoints providing access to services operated for the practitioner with this role

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
PractitionerRole.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
PractitionerRole.codepreferredJP_PractitionerRole_VS
http://jpfhir.jp/fhir/core/ValueSet/JP_PractitionerRole_VS
PractitionerRole.specialtypreferredPracticeSettingCodeValueSet
http://hl7.org/fhir/ValueSet/c80-practice-codes
from the FHIR Standard
PractitionerRole.availableTime.daysOfWeekrequiredDaysOfWeek
http://hl7.org/fhir/ValueSet/days-of-week|4.0.1
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorPractitionerRoleリソースが別のリソースに含まれている場合、ネストされたリソースを含めてはなりません / If the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorPractitionerRoleリソースが別のリソースに含まれている場合、それはリソースの他の場所から参照されるか、含有リソースを参照するものとします / 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-4errorPractitionerRoleリソースが別のリソースに含まれている場合、meta.versionidまたはmeta.lastupdatedを持たないものとします / 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-5errorPractitionerRole別のリソースにリソースが含まれている場合、セキュリティラベルはありません / If a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practicePractitionerRoleリソースには、堅牢な管理のための叙述(Narative)が必要です / A resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsすべてのFHIR要素には、@valueまたは子供が必要です / All FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensions両方ではなく、拡張または値[x]が必要です / Must have either extensions or value[x], not both
: extension.exists() != value.exists()

Differential View

NameFlagsCard.TypeDescription & Constraintsdoco
.. PractitionerRole 0..* PractitionerRole 医療従事者が関連付けられている役割/組織
... identifier 0..* Identifier 役割/場所に固有のビジネス識別子
... active 0..1 boolean このPractitionerRoleレコードがアクティブに使用されているかどうか
... period 0..1 Period その人が、これらの役割(複数可)の医療従事者として行動することを許可されている期間
... practitioner 0..1 Reference(JP Core Practitioner Profile) 組織に定義されたサービスを提供できる医療従事者
... organization 0..1 Reference(JP Core Organization Profile) 役割が可能な組織
... code 0..* CodeableConcept この医療従事者が果たす役割【詳細参照】
Binding: JP Core PractitionerRole ValueSet (preferred)
... specialty 0..* CodeableConcept 開業医の特定の専門 / Specific specialty of the practitioner
... location 0..* Reference(JP Core Location Profile) この医療従事者がケアを提供している場所
... healthcareService 0..* Reference(HealthcareService) この対象者がこの役割の組織/場所に対して提供するヘルスケアサービスのリスト
... telecom 0..* ContactPoint 役割/場所/サービスに固有の連絡先の詳細
... availableTime 0..* BackboneElement サービスサイトが利用可能です / Times the Service Site is available
.... daysOfWeek 0..* code 月|火|水|木|金|土|太陽 / mon | tue | wed | thu | fri | sat | sun
.... allDay 0..1 boolean いつでも利用できますか?例えば24時間のサービス / Always available? e.g. 24 hour service
.... availableStartTime 0..1 time 営業時間の時間(allday = trueの場合無視) / Opening time of day (ignored if allDay = true)
.... availableEndTime 0..1 time 閉店時間の時間(Allday = Trueの場合無視) / Closing time of day (ignored if allDay = true)
... notAvailable 0..* BackboneElement この期間中は利用できない理由と期間
.... description 1..1 string ユーザーに提示された理由は、なぜ時間が利用できないのかを説明しています / Reason presented to the user explaining why time not available
.... during 0..1 Period この日付から利用できません / Service not available from this date
... availabilityExceptions 0..1 string 可用性の例外の説明 / Description of availability exceptions
... endpoint 0..* Reference(Endpoint) この役割で開業医のために運営されているサービスへのアクセスを提供する技術エンドポイント / Technical endpoints providing access to services operated for the practitioner with this role

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. PractitionerRole 0..* PractitionerRole 医療従事者が関連付けられている役割/組織
... id Σ 0..1 id このアーティファクトの論理ID / Logical id of this artifact
... meta Σ 0..1 Meta リソースに関するメタデータ / Metadata about the resource
... implicitRules ?!Σ 0..1 uri このコンテンツが作成されたルールのセット / A set of rules under which this content was created
... language 0..1 code リソースコンテンツの言語 / Language of the resource content
Binding: CommonLanguages (preferred): 人間の言語。 / A human language.

Additional BindingsPurpose
AllLanguages Max Binding
... text 0..1 Narrative 人間の解釈のためのリソースのテキスト概要 / Text summary of the resource, for human interpretation
... contained 0..* Resource インラインリソースが含まれています / Contained, inline Resources
... extension 0..* Extension 実装で定義された追加のコンテンツ / Additional content defined by implementations
... modifierExtension ?! 0..* Extension 無視できない拡張機能 / Extensions that cannot be ignored
... identifier Σ 0..* Identifier 役割/場所に固有のビジネス識別子
... active Σ 0..1 boolean このPractitionerRoleレコードがアクティブに使用されているかどうか
... period Σ 0..1 Period その人が、これらの役割(複数可)の医療従事者として行動することを許可されている期間
... practitioner Σ 0..1 Reference(JP Core Practitioner Profile) 組織に定義されたサービスを提供できる医療従事者
... organization Σ 0..1 Reference(JP Core Organization Profile) 役割が可能な組織
... code Σ 0..* CodeableConcept この医療従事者が果たす役割【詳細参照】
Binding: JP Core PractitionerRole ValueSet (preferred)
... specialty Σ 0..* CodeableConcept 開業医の特定の専門 / Specific specialty of the practitioner
Binding: PracticeSettingCodeValueSet (preferred): 代理店に関連する特定の専門分野。 / Specific specialty associated with the agency.


... location Σ 0..* Reference(JP Core Location Profile) この医療従事者がケアを提供している場所
... healthcareService 0..* Reference(HealthcareService) この対象者がこの役割の組織/場所に対して提供するヘルスケアサービスのリスト
... telecom Σ 0..* ContactPoint 役割/場所/サービスに固有の連絡先の詳細
... availableTime 0..* BackboneElement サービスサイトが利用可能です / Times the Service Site is available
.... id 0..1 string 要素間参照のための一意のID / Unique id for inter-element referencing
.... extension 0..* Extension 実装で定義された追加のコンテンツ / Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension 認識されていなくても無視できない拡張機能 / Extensions that cannot be ignored even if unrecognized
.... daysOfWeek 0..* code 月|火|水|木|金|土|太陽 / mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 曜日。 / The days of the week.


.... allDay 0..1 boolean いつでも利用できますか?例えば24時間のサービス / Always available? e.g. 24 hour service
.... availableStartTime 0..1 time 営業時間の時間(allday = trueの場合無視) / Opening time of day (ignored if allDay = true)
.... availableEndTime 0..1 time 閉店時間の時間(Allday = Trueの場合無視) / Closing time of day (ignored if allDay = true)
... notAvailable 0..* BackboneElement この期間中は利用できない理由と期間
.... id 0..1 string 要素間参照のための一意のID / Unique id for inter-element referencing
.... extension 0..* Extension 実装で定義された追加のコンテンツ / Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension 認識されていなくても無視できない拡張機能 / Extensions that cannot be ignored even if unrecognized
.... description 1..1 string ユーザーに提示された理由は、なぜ時間が利用できないのかを説明しています / Reason presented to the user explaining why time not available
.... during 0..1 Period この日付から利用できません / Service not available from this date
... availabilityExceptions 0..1 string 可用性の例外の説明 / Description of availability exceptions
... endpoint 0..* Reference(Endpoint) この役割で開業医のために運営されているサービスへのアクセスを提供する技術エンドポイント / Technical endpoints providing access to services operated for the practitioner with this role

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
PractitionerRole.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
PractitionerRole.codepreferredJP_PractitionerRole_VS
http://jpfhir.jp/fhir/core/ValueSet/JP_PractitionerRole_VS
PractitionerRole.specialtypreferredPracticeSettingCodeValueSet
http://hl7.org/fhir/ValueSet/c80-practice-codes
from the FHIR Standard
PractitionerRole.availableTime.daysOfWeekrequiredDaysOfWeek
http://hl7.org/fhir/ValueSet/days-of-week|4.0.1
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorPractitionerRoleリソースが別のリソースに含まれている場合、ネストされたリソースを含めてはなりません / If the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorPractitionerRoleリソースが別のリソースに含まれている場合、それはリソースの他の場所から参照されるか、含有リソースを参照するものとします / 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-4errorPractitionerRoleリソースが別のリソースに含まれている場合、meta.versionidまたはmeta.lastupdatedを持たないものとします / 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-5errorPractitionerRole別のリソースにリソースが含まれている場合、セキュリティラベルはありません / If a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practicePractitionerRoleリソースには、堅牢な管理のための叙述(Narative)が必要です / A resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsすべてのFHIR要素には、@valueまたは子供が必要です / All FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensions両方ではなく、拡張または値[x]が必要です / Must have either extensions or value[x], not both
: extension.exists() != value.exists()

 

Other representations of profile: CSV, Excel, Schematron

必須要素

本プロファイルで定義された必須項目はない。

Extensions定義

本プロファイルで追加定義された拡張はない。

利用方法

OperationおよびSearch Parameter 一覧

Search Parameter一覧

コンフォーマンス パラメータ
SHALL identifier token GET [base]/PractitionerRole?identifier=http://myhospital.com/fhir/PractitionerRoleid|1234
SHOULD specialty token GET [base]/PractitionerRole?specialty=http://nucc.org/provider-taxonomy|208D0000X
SHOULD practitioner token GET [base]/PractitionerRole?practitioner.identifier=http://myhospital.com/fhir/Practitionerid|97860456
必須検索パラメータ

次の検索パラメータは必須でサポートされなければならない。

  1. identifier 検索パラメータを使用して、職種IDなどの識別子によるPractitionerRoleの検索をサポートしなければならない(SHALL

    GET [base]/PractitionerRole?identifier={system|}[code]
    
    

    例:

    GET [base]/PractitionerRole?identifier=http://myhospital.com/fhir/PractitionerRoleid|1234
    
    

    指定された識別子に一致するPractitionerRoleリソースを含むBundleを検索する。

推奨検索パラメータ

次の検索パラメータをサポートすることが望ましい。

  1. specialty 検索パラメータを使用して、医療者の特定の専門性によるPractitionerRoleの検索をサポートすることが望ましい(SHOULD

    GET [base]/PractitionerRole?specialty={system|}[code]
    
    

    例:

    GET [base]/PractitionerRole?specialty=http://nucc.org/provider-taxonomy|208D0000X
    
    

    指定された医療者の特定の専門性に一致するPractitionerRoleリソースを含むBundleを検索する。

  2. practitioner 検索パラメータを使用して、医療者の名前と識別子によるPractitionerRoleの検索をサポートすることが望ましい(SHOULD

    GET [base]/PractitionerRole?practitioner={Type/}[id]
    
    

    例:

    1.GET [base]/PractitionerRole?practitioner.identifier=http://myhospital.com/fhir/Practitionerid|97860456&_include=PractitionerRole:practitioner&_include=PractitionerRole?endpoint
    
    2.GET [base]/PractitionerRole?practitioner.name=山田&_include=PractitionerRole:practitioner&_include=PractitionerRole?endpoint
    
    

    practitioner.nameまたはpractitioner.identifierの連結パラメータに一致するPractitionerRoleリソースを含むBundleを検索する。PractitionerRole.practitionerとPractitionerRole.endpointの_include検索をサポートすることが望ましい。(SHOULD

追加検索パラメータ

追加検索パラメータは定義しない。

サンプル

注意事項

PractitionerRoleには、ここで定義されているlocationに住所が含まれているため、addressは存在しない。 これにより、複数のリソースにaddressの値を重複させる必要がなくなる。

その他、参考文献・リンク等

  1. 退院時サマリー規約 http://www.hl7.jp/library/item/HL7J-CDA-007.pdf
  2. 診療情報提供書規格 http://www.hl7.jp/intro/std/HL7J-CDA-005.pdf
  3. 特定健診情報ファイル仕様 https://www.mhlw.go.jp/stf/seisakunitsuite/bunya/0000165280.html
  4. SS-MIX2 標準化ストレージ 仕様書 Ver.1.2h https://www.jami.jp/jamistd/docs/SS-MIX2/h/SS-MIX2_StndrdStrgSpecVer.1.2h.pdf
  5. ICSR E2B(R3) https://www.pmda.go.jp/int-activities/int-harmony/ich/0093.html