FHIR JP Core CI/CD実験
1.0.0 - ci-build
FHIR JP Core CI/CD実験 - Local Development build (v1.0.0). See the Directory of published versions
| 項目 | 内容 |
|---|---|
| 定義URL | http://jpfhir.jp/fhir/core/StructureDefinition/JP_Observation_LabResult |
| バージョン | 1.0.0 |
| 名前 | JPObservationLabResult |
| タイトル | JP Core Observation Lab Result Profile |
| ステータス | アクティブ（2021-11-03） |
| 定義 | このプロファイルはObservationリソースに対して、[検体検査結果]のデータを送受信するための制約と拡張を定めたものであり、Observation（共通）プロファイルと共に使用される。 |
| 公開者 | 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/jpobservationlabresult |
本プロファイル説明は、患者に関連付けられた検体検査結果を記録、検索、および取得のために、FHIR Observationリソースを使用するにあたっての、最低限の制約を記述したものである。
Observationリソースに対して本プロファイルに準拠する場合に必須となる要素や、サポートすべき拡張、用語、検索パラメータを定義する。
なお、検査結果は、Observationリソースを参照するDiagnosticReportリソースを使用してグループ化および要約されたものである。各Observationリソースは、個々の検体検査と結果値、他の観察結果を参照する。
本プロファイルは、以下のようなユースケースを想定している。
Patientリソースからの指定された（患者の）検体採取日、検査項目、検査オーダの依頼科での検体検査情報の参照Patientリソースからの指定された（患者の）検体採取日、検査項目、検査結果値（範囲、または範囲外）検査オーダの依頼科での検体検査情報の参照Patientリソースからの指定された（患者の）検体採取日、検査項目、検査結果値（特定のコード）検査オーダの依頼科での検体検査情報の参照Patientリソースからの指定された（患者の）検体採取日、検査項目、検査結果値（特定の文字列）検査オーダの依頼科での検体検査情報の参照Observationリソースや、Patientリソース等）の参照。Observtionはヘルスケアの中心的な要素であり、診断の支援、進捗状況の監視、ベースラインやパターンの決定、さらには人口統計学的特性の把握に使用されます。ほとんどのObservationは、いくつかのメタデータを持つ単純な名前/値のペアのアサーションであるが、いくつかのObservationは、他の Observationを論理的にグループ化したり、あるいはマルチコンポーネントのObservationであったりする。
このプロファイルでは上記想定シナリオにて用いられるObservationの用途がスコープであり、患者基本情報の中でも特に検体検査に該当する情報項目の１つを取り扱う際に、必要な要件を定義している。
このプロファイルは、以下のリソースに対して定義された各プロファイルから直接参照される可能性がある。
AdverseEventAppointmentCarePlanChargeItemClinicalImpressionCommunicationCommunicationRequestConditionContractDeviceRequestDeviceUseStatementDiagnosticReportEncounterFamilyMemberHistoryGoalGuidanceResponseImagingStudyImmunizationMedicationAdministrationMedicationRequestMedicationStatementMolecularSequenceObservationProcedureQuestionnaireResponseRequestGroupRiskAssessmentServiceRequestSupplyRequest次のデータ項目はデータが存在しなければならない（必須）であるか、あるいは、データが送信システムに存在する場合はサポートされなければならない（Must Support）要素である。
本プロファイルでは、次の要素を持たなければならない。
status︓検体検査情報項目の状態は必須である。category︓このリソースが示す検体検査情報項目を分類するための区分であり、このプロファイルでは必須とする。code︓このリソースは何の検体検査情報項目であるかを示すため必須である。subject︓このリソースが示す検体検査情報項目が、どの患者のものかを示すため、このプロファイルでは参照するpatientリソースの定義を必須とする。effective[x]：このリソースが示す検体検査情報項目が、いつ発生したかを示すためこのプロファイルでは必須とする。検体採取日時。specimen：このリソースが示す検体検査情報項目が、どの検体で検査されるのかを示すため、このプロファイルでは参照するspecimenリソースの定義を必須とする。本プロファイルでは、次の要素はMustSupportである。
value[x]：このリソースが示す検体検査情報項目の結果である。このプロファイルでは拡張定義は行っていない。
| Path | 定義 | バインディング強度 | バリューセット |
| ——————————- | ———————————- | —————— | ————– |
| Observation.category | 「laboratoy」固定 | Preferred | ObservationCategoryCodes |
| Observation.code | JLAC10 | Preferred | LabResultCode |
| id | レベル | 位置 | 説明 | 式 |
|---|---|---|---|---|
| jp-core-1 | Warning | Observation.effective[x] |
一日を含む細かな検体採取日時を必要がある。（年月のみでは不足） | Observation.effectiveDateTime.exists() implies Observation.effectiveDateTime.toString().length() >= 8 |
| jp-core-2 | Warning | Observation |
component または、hasMember が存在しない場合、valueが存在する必要がある。 |
component.empty() and hasMember.empty()) implies value.exists() |
| obs-3 | Guideline | Observation.referenceRange |
可能な限りlow、highに構造化すべき。構造化できない場合、あるいはlow、highに該当しない場合はtextを使用 |
low.exists() or high.exists() or text.exists() |
Observationリソースのインタラクション一覧の定義はユースケースに依存せず共通であるため、共通情報プロファイルに記載されている。
Observation共通情報プロファイル#インタラクション一覧
検体検査結果ユースケースのSearch Parameter一覧は共通情報プロファイルとは異なり以下の通りである。
| コンフォーマンス | パラメータ | 型 | 例 |
|---|---|---|---|
| SHOULD | subject,code,date,based-on |
reference,token,date,reference |
GET [base]/Observation?subject=Patient/123&code=http://loinc.org|8867-4&date=le2020-12-31&based-on=ServiceRequest/456 |
| SHOULD | subject,code,date,value-quantity,based-on |
reference,token,date,quantity,reference |
GET [base]/Observation?subject=Patient/123&code=http://loinc.org|8867-4&date=le2020-12-31&value-quantity=gt40&based-on=ServiceRequest/456 |
| SHOULD | subject,code,date,value-concept,based-on |
reference,token,date,code,reference |
GET [base]/Observation?subject=Patient/123&code=http://loinc.org|8867-4&date=le2020-12-31&value-concept=http://snomed.info/sct|1082004&based-on=ServiceRequest/456 |
| SHOULD | subject,code,date,value-string,based-on |
reference,token,date,string,reference |
GET [base]/Observation?subject=Patient/123&code=http://loinc.org|8867-4&date=le2020-12-31&value-string=positive&based-on=ServiceRequest/456 |
| SHOULD | code,value-quantity,subject |
token,quantity,reference |
GET [base]/Observation?code=http://loinc.org|8867-4&value-quantity=gt40&subject=Patient/123 |
| SHOULD | code,value-concept,subject |
token,code,reference |
GET [base]/Observation?code=http://loinc.org|8867-4&value-concept=http://snomed.info/sct|1082004&subject=Patient/123 |
| SHOULD | code,value-string,subject |
token,string,reference |
GET [base]/Observation?code=http://loinc.org|8867-4&value-string=positive&subject=Patient/123 |
このプロファイルでは必須（SHALL）としての検索項目は定義していない。
次の検索パラメータはサポートすることが推奨される。（SHOULD）
basedOn = ServiceRequest（検査オーダの依頼科）を指定した検索をサポートすることが望ましい。（SHOULD）subject,code,date,based-on の各検索パラメータに一致するObservationリソースを含むBundleを取得することができる。
GET [base]/Observation?subject={reference}&code={code}}&date={date}}&based-on={reference}
例：
GET [base]/Observation?subject=Patient/123&code=http://loinc.org|8867-4&date=le2020-12-31&based-on=ServiceRequest/456
subject = Patient（対象患者）、検査項目、検査値（数値、条件：基準値から外れている、等）、basedOn = ServiceRequest（検査オーダの依頼科）を指定した検索をサポートすることが望ましい。(SHOULD)subject,code,date,value-quantity,based-on の各検索パラメータに一致するObservationリソースを含むBundleを取得することができる。
GET [base]/Observation?subject={reference}&code={code}}&date={date}}&value-quantity={quantity}&based-on={reference}
例：
GET [base]/Observation?subject=Patient/123&code=http://loinc.org\|8867-4&date=le2020-12-31&value-quantity=gt40&based-on=ServiceRequest/456
subject = Patient（対象患者）、検査項目、検査値（コード）、basedOn = ServiceRequest（検査オーダの依頼科）を指定した検索をサポートすることが望ましい。(SHOULD)subject,code,date,value-concept,based-on の各検索パラメータに一致するObservationリソースを含むBundleを取得することができる。
GET [base]/Observation?subject={reference}&code={code}}&date={date}}&value-concept={code}&based-on={reference}
例：
GET [base]/Observation?subject=Patient/123&code=http://loinc.org|8867-4&date=le2020-12-31&value-concept=http://snomed.info/sct|1082004&based-on=ServiceRequest/456
basedOn = ServiceRequest（検査オーダの依頼科）を指定した検索をサポートすることが望ましい。(SHOULD)subject,code,date,value-string,based-on の各検索パラメータに一致するObservationリソースを含むBundleを取得することができる。
GET [base]/Observation?subject={reference}&code={code}}&date={date}}&value-string={string}&based-on={reference}
例：
GET [base]/Observation?subject=Patient/123&code=http://loinc.org|8867-4&date=le2020-12-31&value-string=positive&based-on=ServiceRequest/456
subject = Patient（対象患者で絞る場合あり）を指定した検索をサポートすることが望ましい。(SHOULD)code,value-quantity,subject の各検索パラメータに一致するObservationリソースを含むBundleを取得することができる。
GET [base]/Observation?code={code}}&value-quantity={quantity}&subject={reference}&
例：
GET [base]/Observation?code=http://loinc.org|8867-4&value-quantity=gt40&subject=Patient/123
subject = Patient（対象患者で絞る場合あり）を指定した検索をサポートすることが望ましい。(SHOULD)code,value-concept,subject の各検索パラメータに一致するObservationリソースを含むBundleを取得することができる。
GET [base]/Observation?code={code}}&value-concept={code}&subject={reference}
例：
GET [base]/Observation?code=http://loinc.org|8867-4&value-concept=http://snomed.info/sct|1082004&subject=Patient/123
subject = Patient（対象患者で絞る場合あり）を指定した検索をサポートすることが望ましい。(SHOULD)code,value-string,subject の各検索パラメータに一致するObservationリソースを含むBundleを取得することができる。
GET [base]/Observation?code={code}}&value-string={string}&subject={reference}
例：
GET [base]/Observation?code=http://loinc.org|8867-4&value-string=positive&subject=Patient/123
このプロファイルでは、オプション検索パラメータ(MAY)は定義していない。
ObservationリソースのOperation一覧の定義はユースケースに依存せず共通であるため、共通情報プロファイルに記載されている。