HL7 FHIR JP Core ImplementationGuide
1.3.0-dev - ci-build Japan flag

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

Extension: JP Core Common Department Extension

項目内容
定義URL http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Common_Department
Version 1.3.0-dev
Name

JP_Common_Department

Title

JP Core Common Department Extension

Status Active ( 2025-10-28 )
Copyright

Copyright Japan FHIR Implementation Infrastructure Study Group in Japan Association of Medical Informatics (JAMI) 一般社団法人日本医療情報学会FHIR国内実装基盤研究会

診療科情報を格納するための汎用的な拡張。様々なリソースで診療科情報を表現する際に使用できる。診療科コード(CodeableConcept)または診療科組織への参照(Reference)のいずれかを指定する。

Context of Use

    This extension may be used on the following element(s)

診療科情報を格納するための汎用的な拡張。様々なリソースで診療科情報を表現する際に使用できる。

背景および想定シナリオ

本拡張は、以下のようなユースケースを想定している。

  • 処方オーダー(MedicationRequest)における依頼診療科の記録
  • 検査依頼(ServiceRequest)における依頼診療科の記録
  • その他のリソースにおける診療科情報の付加

国内の医療情報交換では診療科の情報を必要とするケースが多いが、FHIRの各リソースには診療科を格納する標準要素が用意されていない。そのため、診療科情報を一貫した方法で表現し、相互運用性を高めることを目的とする。

スコープ

本拡張は、任意のリソースに対して診療科情報を付加するための汎用的な拡張である。診療科情報は以下の2つの方法で表現できる。

  1. valueCodeableConcept: SS-MIX2診療科コードなどのコード化された診療科情報
  2. valueReference: JP_Organization_Departmentプロファイルを使用した診療科組織への参照

用途に応じて適切な表現方法を選択すること。診療科名称は医療機関ごとに異なることが多いため、コードが利用できない場合はCodeableConcept.text要素にテキストで診療科名を設定することも可能である。


プロファイル定義

Usage info

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Extension Content

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

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension 診療科情報
... extension 0..0 Extension
... url 1..1 uri "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Common_Department"
... Slices for value[x] 0..1 拡張値の値 / Value of extension
Slice: Unordered, Open by type:$this
.... valueCodeableConcept CodeableConcept
.... valueReference Reference(JP Core Organization Department Profile)
.... value[x]:valueCodeableConcept 0..1 CodeableConcept 診療科コード
Binding: JP Core Department SS-MIX ValueSet (preferred)
.... value[x]:valueReference 0..1 Reference(JP Core Organization Department Profile) 診療科組織への参照

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension 診療科情報
... id 0..1 string 要素間参照のための一意のID / Unique id for inter-element referencing
... extension 0..0 Extension
Slice: Unordered, Open by value:url
... url 1..1 uri "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Common_Department"
... Slices for value[x] 0..1 拡張値の値 / Value of extension
Slice: Unordered, Closed by type:$this
.... valueCodeableConcept CodeableConcept
.... valueReference Reference(JP Core Organization Department Profile)
.... value[x]:valueCodeableConcept 0..1 CodeableConcept 診療科コード
Binding: JP Core Department SS-MIX ValueSet (preferred)
.... value[x]:valueReference 0..1 Reference(JP Core Organization Department Profile) 診療科組織への参照

doco Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type CodeableConcept, Reference: 診療科情報を格納するための汎用的な拡張。様々なリソースで診療科情報を表現する際に使用できる。診療科コード(CodeableConcept)または診療科組織への参照(Reference)のいずれかを指定する。

Differential View

This structure is derived from Extension

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension 診療科情報
... extension 0..0 Extension
... url 1..1 uri "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Common_Department"
... Slices for value[x] 0..1 拡張値の値 / Value of extension
Slice: Unordered, Open by type:$this
.... valueCodeableConcept CodeableConcept
.... valueReference Reference(JP Core Organization Department Profile)
.... value[x]:valueCodeableConcept 0..1 CodeableConcept 診療科コード
Binding: JP Core Department SS-MIX ValueSet (preferred)
.... value[x]:valueReference 0..1 Reference(JP Core Organization Department Profile) 診療科組織への参照

doco Documentation for this format

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. Extension 0..* Extension 診療科情報
... id 0..1 string 要素間参照のための一意のID / Unique id for inter-element referencing
... extension 0..0 Extension
Slice: Unordered, Open by value:url
... url 1..1 uri "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Common_Department"
... Slices for value[x] 0..1 拡張値の値 / Value of extension
Slice: Unordered, Closed by type:$this
.... valueCodeableConcept CodeableConcept
.... valueReference Reference(JP Core Organization Department Profile)
.... value[x]:valueCodeableConcept 0..1 CodeableConcept 診療科コード
Binding: JP Core Department SS-MIX ValueSet (preferred)
.... value[x]:valueReference 0..1 Reference(JP Core Organization Department Profile) 診療科組織への参照

doco Documentation for this format

This structure is derived from Extension

Summary

Simple Extension with the type CodeableConcept, Reference: 診療科情報を格納するための汎用的な拡張。様々なリソースで診療科情報を表現する際に使用できる。診療科コード(CodeableConcept)または診療科組織への参照(Reference)のいずれかを指定する。

 

Other representations of profile: CSV, Excel, Schematron

Path Status Usage ValueSet Version Source
Extension.value[x]:valueCodeableConcept Base preferred JP Core Department SS-MIX ValueSet 📦1.1.0a jpfhir-terminology v1.4
Id Grade Path(s) Description Expression
ele-1 error **ALL** elements すべてのFHIR要素には、@valueまたは子要素が必要です / All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions 両方ではなく、拡張または値[x]が必要です / Must have either extensions or value[x], not both extension.exists() != value.exists()

値の選択

本拡張では、以下の2つの値型から選択して使用する。

値型 説明 使用場面
valueCodeableConcept 診療科コード(SS-MIX2等) 診療科コードのみで十分な場合
valueReference JP_Organization_Departmentへの参照 診療科の詳細情報(所属医療機関、連絡先等)が必要な場合

用語定義

診療科コードとしてSS-MIX2診療科コードの使用を推奨する。

分類 用語集 URI
診療科 SS-MIX2診療科コード http://jami.jp/SS-MIX2/CodeSystem/ClinicalDepartment

SS-MIX2診療科コードは2桁または3桁のコードを使用する。

  • 2桁コード例:01(内科)、16(整形外科)
  • 3桁コード例:011(消化器内科)、012(循環器内科)

診療科名称は医療機関ごとに異なることが多いため、コードが利用できない場合はCodeableConcept.text要素にテキストで診療科名を設定することも可能である。

使用例

1. SS-MIX2診療科コードを使用する場合

{
  "extension": [
    {
      "url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Common_Department",
      "valueCodeableConcept": {
        "coding": [
          {
            "system": "http://jami.jp/SS-MIX2/CodeSystem/ClinicalDepartment",
            "code": "01",
            "display": "内科"
          }
        ]
      }
    }
  ]
}

2. JP_Organization_Departmentへの参照を使用する場合

{
  "extension": [
    {
      "url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Common_Department",
      "valueReference": {
        "reference": "Organization/dept-001",
        "display": "第一内科"
      }
    }
  ]
}

3. テキストのみで診療科名を指定する場合

{
  "extension": [
    {
      "url": "http://jpfhir.jp/fhir/core/Extension/StructureDefinition/JP_Common_Department",
      "valueCodeableConcept": {
        "text": "消化器腫瘍外科"
      }
    }
  ]
}

サンプル

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

  1. SS-MIX2 標準化ストレージ 仕様書 Ver.1.2h https://www.jami.jp/jamistd/docs/SS-MIX2/h/SS-MIX2_StndrdStrgSpecVer.1.2h.pdf
本実装ガイドへのご質問・ご指摘については、GitHub IssueおよびGitHub PullRequestにて受け付けている。