JASPEHR Implementation Guide
0.5.5 - draft
JASPEHR Implementation Guide - Local Development build (v0.5.5). See the Directory of published versions
ベースとなる Questionnaire Response resource を SDC Questionnaire Responseに近づけていくことを前提とし、それぞれの Profile に含まれる Extension や MustSupport、Cardinality について JASPEHR プロジェクトとしての採用可否を検討していった。ここでは、各項目についての判断根拠や運用想定等を記載する。ベース SDC Questionnaire に対して変更を行った点は赤字で記載する。
| 項目 | 判断 | 詳細 | SDC Profile での指定（差異がある場合は青字） |
|---|---|---|---|
| QuestionnaireResponse.identifier | Cardinality: 1..1 MustSupport |
収集側がデータのキーとして利用する。 【JASPEHR】 医療機関コード-事業を識別するコード-発行年（4桁）-施設内において発行年内で一意となる番号（8桁） （補足）医療機関コード=処方箋発行医療機関コード |
SDC Questionnaire Response: Cardinality: 0..1 MustSupport |
| QuestionnaireResponse.basedOn | Cardinality: 0..* | オーダ情報への参照。 【JASPEHR】 現時点では利用する予定なし。 |
SDC Questionnaire Response: Cardinality: 0..* |
| QuestionnaireResponse.partOf | Cardinality: 0..* | Questionnaireが一部として実行された処置または検査への参照。例えば、チェックリストが一部として実行された手術。 【JASPEHR】 現時点では利用する予定なし。 |
SDC Questionnaire Response: Cardinality: 0..* |
| QuestionnaireResponse.questionnaire | Cardinality: 1..1 MustSupport |
Questionnaireの定義。 【JASPEHR】 この回答のベースとなったQuestionnaireを特定するためにQuestionnaire.nameとQuestionnaire.versionを記載する。 “QuestionnaireJaspehr URL/”＋{name}＋”|”＋{version}” 例：”http://www.hosp.ncgm.go.jp/JASPEHR/fhir/StructureDefinition/jaspehr-questionnaire/Jaspehr1|6” |
SDC Questionnaire Response: Cardinality: 1..1 MustSupport |
| QuestionnaireResponse.status | Cardinality: 1..1 MustSupport |
回答のステータス。 【JASPEHR】 新規：”completed”、更新：”amended”、削除：”stopped” ※Value set の制限を行う。4.2に記載。 |
SDC Questionnaire Response: Cardinality: 1..1 MustSupport |
| QuestionnaireResponse.subject | Cardinality: 1..1 MustSupport |
回答の対象となる患者。 【JASPEHR】 現時点では、以下の文字列での表記も可能とする。 “Patient/”＋{患者ID} |
SDC Questionnaire Response: Cardinality: 1..1 MustSupport |
| QuestionnaireResponse.encounter | Cardinality: 0..1 | 回答が発行された際の Encounter 【JASPEHR】 現時点では利用する予定なし。 |
SDC Questionnaire Response: Cardinality: 0..1 |
| QuestionnaireResponse.authored | Cardinality: 1..1 MustSupport |
【JASPEHR】 QuestionnaireResponse の最終回答日（ISO8601形式） |
SDC Questionnaire Response: Cardinality: 1..1 MustSupport |
| QuestionnaireResponse.author | Cardinality: 1..1 MustSupport |
回答の入力者。 【JASPEHR】 現時点では、以下の文字列での表記も可能とする。 “Practitioner/”＋{職員ID} |
SDC Questionnaire Response: Cardinality: 0..1 MustSupport |
| QuestionnaireResponse.source | Cardinality: 0..1 | 質問の回答者 【JASPEHR】 現時点では利用する予定なし。 |
SDC Questionnaire Response: Cardinality: 0..1</span> |
| QuestionnaireResponse.item | Cardinality: 0..* MustSupport |
Questionnaire Response の回答項目定義部分。 | SDC Questionnaire Response: Cardinality: 0..* MustSupport |
| QuestionnaireResponse.item.linkId | Cardinality: 1..1 MustSupport |
Questionnaire の質問と、Questionnaire Response の回答を紐づける項目。 【JAPSHER】 想定運用においては、Questionnaire は一度各社電子カルテのテンプレートを経由し Questionnaire Response に変換されるため、各社はこの間 linkId が失われないように注意する必要がある。 ※Constraints を追加する。4.2に記載。 |
SDC Questionnaire Response: Cardinality: 1..1 MustSupport |
| QuestionnaireResponse.item.definition | Cardinality: 0..1 | URI で ElementDefinition を指定する。 【JASPEHR】 definition-based extraction でデータを抽出する場合に使用する。今後検討が必要。 |
SDC Questionnaire Response: Cardinality: 0..1 |
| QuestionnaireResponse.item.text | Cardinality: 0..1 MustSupport |
質問項目に表示する文言。 | SDC Questionnaire Response: Cardinality: 0..1 MustSupport |
| QuestionnaireResponse.item.answer | Cardinallity: 0..* MustSupport |
質問への回答項目。 | SDC Questionnaire Response: Cardinality: 0..* MustSupport |
| QuestionnaireResponse.item.answer.value[x] | Cardinallity: 0..1 MustSupport |
各質問への単一の回答。 ※Data type の制限を行う。4.2に記載。 |
SDC Questionnaire Response: Cardinality: 0..1 MustSupport |
| QuestionnaireResponse.item.answer.item | Cardinallity: 0..* MustSupport |
item.answer を入れ子にする場合は本項目を使用する。 |
SDC Questionnaire Response: Cardinality: 0..* MustSupport |
| QuestionnaireResponse.item.item | Cardinality: 0..* MustSupport |
item を入れ子にする場合は本項目を使用する。 | SDC Questionnaire Response: Cardinality: 0..* MustSupport |
| 項目 | 判断 | 詳細 |
|---|---|---|
| QuestionnaireResponse.extension:questionnaireresponse-signature | 採用しない | フォーム全体、または関連付けられている質問またはアイテムの手書き署名または電子署名を表す。 【JASPEHR】 署名の収集は不要なため、採用しない。 |
| QuestionnaireResponse.questionnaire.extension:display | 採用しない | 正規 URL でリソースを参照するときに表示するタイトルまたはその他の名前。 【JASPEHR】 不要なため採用しない。 |
| QuestionnaireResponse.item.extension:questionnaireresponse-signature | 採用しない | フォーム全体、または関連付けられている質問またはアイテムの手書き署名または電子署名を表す。 【JASPEHR】 署名の収集は不要なため、採用しない。 |
| StructureDefinition-jaspehr-questionnaireresponse.html | 採用しない | 概念の比較 (より小さい、より大きい) またはその他の数値操作 (スコアのコンポーネントの合計など) を可能にする数値。 【JASPEHR】 不要なため採用しない。 |
| 項目 | 判断 | 詳細 |
|---|---|---|
| QuestionnaireResponse.status | Value set の制限を行う | 回答のステータス。 【JASPEHR】電子カルテシステム等で現状対応ができない項目（＝JASPEHR での運用を想定しない項目）が含まれるため、制限を行う。運用では記述の統一のため、新規：”completed”、更新：”amended”、削除：”stopped” のみ使用可とする。 |
| QuestionnaireResponse.author | Reference の制限を行う | 【JASPEHR】Practitionerのみ(要相談) |
| QuestionnaireResponse.item.linkId | Constraints の追加を行う（jsr-1） | Questionnaire の質問と、QuestionnaireResponse の回答を紐づける項目。 【JASPEHR】Questionnaireと同様に、「半角英数字記号（一部を除く）からなる、1~255 文字の文字列」という制約を行う。 |
| QuestionnaireResponse.item.answer.value[x] | Data type の制限を行う | 【JASPEHR】Questionnaire.item.type で設定可能とする型であり、かつ decimal | integer | date | dateTime | time | string | Coding のみ許可する。 |
| Id | Path | Details |
|---|---|---|
| jsr-1 | QuestionnaireResponse.item | Link id should consist of half-width English numbers, letters, and several symbolic-characters, or either of them : linkId.matches(‘([A-Za-z0-9!#%/:;?@_~]{1,255})’) |
特に注意が必要な内容について、下記に記載した。
本 Profile においては、回答の入力者は author、質問の回答者は source を利用する。
なお、今回はシステム側で回答の入力者のみを取得する想定のため、基本的にはauthorのみ利用する。
回答者の情報が必要な場合は、Questionnaire.itemへの追加を検討する必要がある。
item.answer/item.item の両方を同時に保持することは許可しない。(qrs-1)
したがって、Questionnaire.item.type = “group” の時、item.item、Questionnaire.item.enableWhen.exists()の時 item.answerを利用する。
また、status が “stopped” の際は、QuestionnaireResponse.item 以下は不要であるため、保持しないこととする。
本 Implementation guide に特に記載のない項目については、SDC、ないしはベースの Questionnaire Response リソースに記載されている内容に従うこととする。