1.0.0 - ci-build
JPCoreV1 - Local Development build (v1.0.0). See the Directory of published versions
患者のケアやその他の健康関連サービスを受けている個人または動物に関する人口統計およびその他の管理情報。
項目 | 内容 |
---|---|
定義URL | http://jpfhir.jp/fhir/core/StructureDefinition/JP_Patient |
バージョン | 1.0.0 |
名前 | JPCorePatientProfile |
タイトル | JP Core Patient Profile |
ステータス | アクティブ(2021-09-01) |
定義 | このプロファイルはPatientリソースに対して、患者のデータを送受信するための基礎となる制約と拡張を定めたものである。 |
公開者 | FHIR® Japanese implementation research working group in Japan Association of Medical Informatics (JAMI) |
Copyright | FHIR® Japanese implementation research working group in Japan Association of Medical Informatics (JAMI) |
ソースリソース | https://simplifier.net/jp-core-draftv1/jppatient |
本リソースは、以下を含む幅広い健康関連活動に関与する患者と動物に関するデータをカバーしている。
本リソースのデータは、患者個人に関する情報をカバーしている。その属性は、管理、財務、およびロジスティックな手続きをサポートするために必要な人口統計学的情報に焦点を当てている。患者の記録は、通常、患者のケアを行う各組織によって作成・維持される。従って、複数の組織で治療を受けている患者又は動物は、その情報を複数のPatientリソースに存在させることができる。
全ての概念が基本リソースに含まれているわけではないが(人種、民族、臓器提供の有無、国籍等)、特定の法域のために定義されたプロファイルや標準的な拡張機能に含まれている場合がある。このようなフィールドは、法域によって大きく異なり、似たような概念でも名前や値セットが異なることが多いのですが、マッピングや交換ができるほど似ているわけではない。
本プロファイルは、患者に関する情報の登録や検索、取得のために 、FHIR Patientリソースを使用するにあたっての、最低限の制約を記述したものである。Patientリソースに対して本プロファイルに準拠する場合に必須となる要素や、サポートすべき拡張、用語、検索パラメータを定義する。
本プロファイルは、以下のようなユースケースを想定している。
氏名などの患者情報による患者基本情報の検索
他のリソースからの患者基本情報の参照
JP Patientリソースは、以下のリソースから直接参照される。
JP Patient リソースは、以下のリソースを直接参照する。
次のデータ項目は必須(データが存在しなければならない)、あるいは、データが送信システムに存在する場合はサポートされなければならないことを意味する。(Must Support)。
Patient リソースは、次の要素を持たなければならない。
JP Patient リソースで使用される拡張は次の通りである。
Path | 定義 | バインディング強度 | バリューセット |
---|---|---|---|
Patient.gender.code Patient.contact.gender.code |
患者の性別 | required | AdministrativeGender |
Patient.marialStatus.CodeableConcept | 患者の婚姻関係の状況 | Extensible | MarialStatus |
Patient.contact.relationship.CodeableConcept | 患者の連絡先(contact)との関係性 | Extensible | Patient Contact Relationship |
Patient.link.type.code | 別の患者リソースへのリンクに関するタイプ | Required | LinkType |
Patient.identifier.use | この識別子の目的を特定する | Required | IdentifierUse |
Patient.telecom.system | コンタクトポイントの通信方法に関する情報 | Required | ContactPointSystem |
Patient.telecom.use | 家やオフィスなどコンタクトポイントのタイプに関する情報 | Required | ContactPointUse |
Patient.address.use | 家やオフィスなど住所のタイプに関する情報 | Required | AddressUse |
Patient.addresss.type | 住所の種類 | Required | AddressType |
制約はありません。
コンフォーマンス | インタラクション |
---|---|
SHALL(必須) | search-type、read |
SHOULD(推奨) | vread、history-instance |
MAY(利用可能) | create、update、patch、delete、history-type |
コンフォーマンス | パラメータ | 型 | 例 |
---|---|---|---|
SHALL | identifier | token | GET [base]/Patient?identifier=http://myhospital.com/fhir/pid|123456 |
SHOULD | name | string | GET [base]/Patient?name=山田太郎 |
SHOULD | birthdate,name | date,string | GET [base]/Patient?birthdate=eq2013-01-14&name=山田太郎 |
SHOULD | birthdate,gender | date,code | GET [base]/Patient?birthdate=eq2013-01-14&gender=male |
SHOULD | birthdate,name,gender | date,string,code | GET [base]/Patient?birthdate=eq2013-01-14&name=山田太郎&gender=male |
SHOULD | name,phone | string,token | GET [base]/Patient?name=山田太郎&phone=111-222-3333 |
SHOULD | name,address-postalcode | string,string | GET [base]/Patient?name=山田太郎&address-postalcode=1234567 |
MAY | family,given,birthdate,gender,phone,address-postalcode | string,string,date,token,token,string | GET [base]/Patient?family=山田&given=太郎&birthdate=eq2013-01-14&gender=male&phone=111-222-3333&address-postalcode=1234567 |
次の検索パラメータは必須でサポートされなければならない。
identifier 検索パラメータを使用して、患者番号/カルテ番号などの識別子によるPatientの検索をサポートしなければならない(SHALL)。
GET [base]/Patient?identifier={system|}[code]
例:
GET [base]/Patient?identifier=http://myhospital.com/fhir/pid/us-npi|123456
指定された識別子に一致するPatientリソースを含むBundleを検索する。
次の検索パラメータをサポートすることが望ましい。
name 検索パラメータを使用して、Patientの検索をサポートすることが望ましい(SHOULD)。name検索パラメータは、HumanNameの文字列フィールド(family、give、prefix、suffix、および/またはtextを含む)のいずれかに一致するPatientリソースを検索する。
GET [base]/Patient?name={string}
例:
GET [base]/Patient?name=山田太郎
birthdate, name 検索パラメータを使用して、Patientの検索をサポートすることが望ましい(SHOULD)。name検索パラメータは、HumanNameの文字列フィールド(family、give、prefix、suffix、および/またはtextを含む)のいずれかに一致するPatientリソースを検索する。
GET [base]/Patient?birthdate={date}&name={string}
例:
GET [base]/Patient?birthdate=2000-10-10&name=山田太郎
birthdate, gender 検索パラメータを使用して、Patientの検索をサポートすることが望ましい(SHOULD)。
GET [base]/Patient?birthdate={date}&gender={code}
例:
GET [base]/Patient?birthdate=2000-10-10&gender=male
birthdate, name, gender 検索パラメータを使用して、Patientの検索をサポートすることが望ましい(SHOULD)。name検索パラメータは、HumanNameの文字列フィールド(family、give、prefix、suffix、および/またはtextを含む)のいずれかに一致するPatientリソースを検索する。
GET [base]/Patient?birthdate={date}&name={string}&gender={code}
例:
GET [base]/Patient?birthdate=2000-10-10&name=山田太郎&gender=male
name, phone 検索パラメータを使用して、Patientの検索をサポートすることが望ましい(SHOULD)。name検索パラメータは、HumanNameの文字列フィールド(family、give、prefix、suffix、および/またはtextを含む)のいずれかに一致するPatientリソースを検索する。
GET [base]/Patient?name={string}&phone={token}
例:
GET [base]/Patient?name=山田太郎&phone=0123456789
name, address-postalcode 検索パラメータを使用して、Patientの検索をサポートすることが望ましい(SHOULD)。name検索パラメータは、HumanNameの文字列フィールド(family、give、prefix、suffix、および/またはtextを含む)のいずれかに一致するPatientリソースを検索する。address-postalcodeはPatient.address.postalCode要素に対する検索パラメータであり、日本の住所表記における郵便番号をキーにして検索することを想定している。
GET [base]/Patient?name={string}&address-postalcode={string}
例:
GET [base]/Patient?name=山田太郎&address-postalcode=1234567
オプションとして次の検索パラメータをサポートすることができる。
複合条件として、family,given,birthdate,gender,phone,address-postalcodename の各検索パラメータを複数指定したPatientの検索をサポートすることができる(MAY)。
GET [base]/Patient??family={string}&given={string}&birthdate={date}&gender={token}&phone={token}&address-postalcode={string}
例:
GET [base]/Patient??family=山田&given=太郎&birthdate=eq2013-01-14&gender=male&phone=111-222-3333&address-postalcode=1234567
family,given,birthdate,gender,phone,address-postalcodename の各検索パラメータに一致するPatientリソースを含むBundleを検索する。
JP Patientリソースに追加された検索パラメータはありません。
JP Patient リソースに対して使用される操作は次の通りである。
$everything:[base]/Patient/$everything , [base]/Patient/[id]/$everything
この操作は、この操作が呼び出された特定のPatientリソースに関連する全ての情報を返す。応答は “searchset” タイプのBundleリソースである。サーバは、少なくとも、識別された医療従事者のPatientコンパートメントに含まれる全てのリソースと、それらから参照されるすべてのリソースを返すことが望ましい。
この操作の公式なURLは以下である。
http://hl7.jp/fhir/OperationDefinition/Patient-everything
URL: [base]/Patient/[id]/$everything
本操作は、べき等な操作である。
名前 | 多重度 | 型 | バインディング | プロファイル | 説明 |
---|---|---|---|---|---|
start | 0..1 | date | 特定の日付範囲で提供されたケアに関連する全ての記録を意味する。開始日が指定されていない場合、終了日以前のすべてのレコードが対象に含まれる。 | ||
end | 0..1 | date | 特定の日付範囲で提供されたケアに関連する全ての記録を意味する。終了日が指定されていない場合、開始日以降のすべてのレコードが対象に含まれる。 | ||
_since | 0..1 | instant | 指定された日時以降に更新されたリソースのみが応答に含まれる。 | ||
_type | 0..* | code | 応答に含むFHIRリソース型を、カンマ区切りで指定する。指定されない場合は、サーバは全てのリソース型を対象とする。 | ||
_count | 0..1 | integer | Bundleの1ページに含まれるリソース件数を指定。 |
名前 | 多重度 | 型 | バインディング | プロファイル | 説明 |
---|---|---|---|---|---|
return | 1..1 | Bundle | バンドルのタイプは”searchset”である。この操作の結果は、リソースとして直接返される。 |
リクエスト:単一のPatientに関連する全てのリソースを取得する。
GET [base]/Patient/p001/$everything
[some headers]
レスポンス:指定されたPatientに関連する全てのリソースを返す。
HTTP/1.1 200 OK [other headers]
{
"resourceType": "Bundle",
"id": "example",
"meta": {
"lastUpdated": "2014-08-18T01:43:33Z"
},
"type": "searchset",
"entry": [
{
"fullUrl": "http://example.org/fhir/Patient/p001",
"resource": {
"resourceType": "Patient",
省略
}
}
]
}
{
"resourceType": "Patient",
"address": [
{
"postalCode": "1600023",
"text": "東京都新宿区"
}
],
"birthDate": "1970-01-01",
"gender": "male",
"identifier": [
{
"value": "1001"
}
],
"name": [
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/iso21090-EN-representation",
"valueCode": "IDE"
}
],
"use": "official",
"text": "山田 太郎",
"family": "山田",
"given": [
"太郎"
]
},
{
"extension": [
{
"url": "http://hl7.org/fhir/StructureDefinition/iso21090-EN-representation",
"valueCode": "SYL"
}
],
"use": "official",
"text": "ヤマダ タロウ",
"family": "ヤマダ",
"given": [
"タロウ"
]
}
],
"telecom": [
{
"value": "0312345678"
}
]
}
注意事項はありません。
・退院時サマリー規約 http://www.hl7.jp/library/item/HL7J-CDA-007.pdf
・診療情報提供書規格 http://www.hl7.jp/intro/std/HL7J-CDA-005.pdf
・特定健診情報ファイル仕様 https://www.mhlw.go.jp/stf/seisakunitsuite/bunya/0000165280.html
・SS-MIX2 標準化ストレージ 仕様書 Ver.1.2f http://www.jami.jp/jamistd/docs/SS-MIX2/f/SS-MIX2_StndrdStrgSpecVer.1.2f.pdf
・ICSR E2B(R3) https://www.pmda.go.jp/int-activities/int-harmony/ich/0093.html