クエリの管理

Vault EDC には次の 2 種類のクエリがあります: システムおよび手動クエリ。Vault は、データにチェックを実行し、データがスタディデザイン時に定義された仕様を満たさない場合はクエリを作成してシステムクエリを生成します。例えば、Vault は、入力した日付が特定の範囲外にある場合にシステムクエリを作成します。手動クエリは、スタディモニター (CRA) またはデータマネージャが作成するクエリです。

スタディコーディネーター (CRC) およびスタディ責任医師に固有のクエリ情報については、クエリの回答をご確認ください。

前提条件

必須権限

標準的なCDMS スタディモニター、CDMS データマネージャ、CDMS リードデータマネージャのスタディロールを持つユーザは、デフォルトで上記のアクションを実行できます。Vault がカスタムスタディロールを使用する場合、ロールに以下の権限が付与されている必要があります:

タイプ	権限ラベル	制御
標準タブ	レビュータブ	レビュータブへのアクセス権限
機能権限	オープンクエリ	クエリを回答済み状態にすることなく、新規 (開く) クエリを作成したり、クエリにコメントしたりする権限
機能権限	クエリを閉じる	クエリを終了する権限

スタディに制限付きデータが含まれている場合、それを閲覧するには制限ありデータアクセス権限が必要です。

スタディロールについて詳しくご確認ください。

回答済みクエリ: クエリを開く権限がある場合、クエリにコメントをつけても回答済みステータスに移行しません。

クエリの表示

レビュー > マイスタディ > クエリから、アクセス権限のある施設からのイベント日クエリを含むすべてのクエリのリストを見ることができます。Vault は、サイトおよび被験者レベルのステータス別のクエリの合計を、クエリを開くおよび回答済みクエリの列に表示します。それらのステータスの詳細については、以下を参照してください。

クリックするとクエリが開きます。Vault は、クエリの対象となるフォームまたはイベントを自動的に開きます。ここから、クエリにコメントを付けたり、クエリを閉じたりできます。

データ入力で未解決クエリがある項目を非表示にした場合、レビューユーザはクエリを閉じることだけができ、コメントはできないことに注意してください。

3 つ以上のコメントを含む終了したクエリを、クエリのフォームから表示することができます。終了したクエリは、クエリが開かれたイベント日 (イベント日クエリの場合) または項目 (項目クエリの場合) の隣に表示されます。

クエリチーム

各クエリには、どのチームが作成したかを示すバッジが付けられています。Studio で [チームクエリ制限] で試験が有効になっている場合にのみ、クエリの [クエリチーム] が表示されます。

チームでクエリ制限機能を使用している場合、クエリ作成者と同じチームのメンバーだけがクエリを閉じることができます。ただし、すべてのクエリを閉じる権限を持っている場合は、クエリチームを問わずすべてのクエリを閉じることができます。クエリがあるチーム、例えば臨床チームによって作成された場合、そのチームのメンバーのみがクエリを終了できます。この例では、データ管理チームのメンバーがクエリにコメントできますが、そのユーザはクエリを終了できません。他のチームが作成したクエリを閲覧したり、コメントすることは可能です。選択した [クエリチーム] が UI に表示され、[クエリ詳細リスト] および [試験データ抽出 ]のSYS_Q データセットに表示されます。

ユーザが複数の試験ロールを持っている場合、そのユーザはクエリーチームフィールドのドロップダウンメニューを使用して、クエリに応答するロールを選択できます。

[チームクエリ制限] が有効になっている場合、ユーザは試験レベルの設定でシステムクエリに割り当てる [クエリチーム] を選択できます。試験設定について詳しくご確認ください。

チームクエリ制限とクエリ詳細リストの有効化: [チームクエリ制限] 試験設定が有効になっていない場合、[クエリ詳細リスト] の [ロール] 列には、ジョブ生成時のユーザの現在のロールが設定されます。この情報はクエリレコードには記録されません。進行中の試験で [チームクエリ制限] 設定が有効になっている場合、ユーザのロールとチームは、今後のクエリのクエリ処理時にクエリレコードに保存され、[クエリ詳細リスト] の [ロール] 列と [チーム] 列に設定されます。[チームクエリ制限] 設定が有効化される前に作成されたクエリには、クエリチームは割り当てられません。[クエリ詳細リスト] の既存のクエリの現在のロールを保持したい場合は、進行中の試験でクエリチームを有効にしないことをお勧めします。

システムクエリ

Vault は、チェックを実行し、定義された範囲外にある項目値にシステムクエリを作成します。その範囲はスタディデザイン時に定義されます。

プログレッシブ表示で非表示になっているアイテムのクエリ: Vault は非表示または無効化されているアイテムに対して編集チェッククエリを作成しませんが、制御するアイテムに応じて、プログレッシブ表示によって非表示または無効化されているアイテムに対してルールベースのクエリが開かれる場合があります。

以下のシステムクエリの種類は自動的に定義されます:

必須: 項目定義の作成時に、スタディデザイナはフィールドを必須としてマークすることを選択できます。フォームの送信時にこのフィールドが空白のままの場合、Vault はシステムクエリを作成します (「このフィールドは必須です」)。
範囲: 項目定義の作成時に、スタディデザイナはフィールド値の範囲を定義することができます。入力した値がその範囲外にある場合、Vault はシステムクエリを作成します (値が範囲外です)。このクエリタイプは日付ではなく数値のみが対象です。
将来の日付: 項目定義の作成時に、スタディデザイナは将来の日付を禁止することができます。ユーザが将来の日付を入力した場合、Vault はシステムクエリを作成します (将来の日付は許可されていません)。
将来の日付 (イベント日付): イベント定義の作成時に、スタディデザイナは、将来の日付が許可されていないことを示すことができます。Vault は、入力時に現在の日付よりも遅いイベント日付について、システムクエリを作成できます。
ウィンドウ外 (イベント日付): イベント定義の作成時に、スタディデザイナは、イベントの許可日のウィンドウを作成できます。設定されている場合、Vault は、イベント日付がこのウィンドウの外にあるときはいつでもシステムクエリを作成できます。

スタディデザイナは、Studio でデータ入力規則を追加定義することができます。これらの規則に基づいて、Vault EDC はシステム生成クエリを追加作成することができます。

システムクエリを手動で閉じた場合、フォームを再送信しても、同じシステムクエリが再稼働することはありません。

クエリルールの表示権限があり、EDC ツール領域にアクセスできる場合、EDC ツール＞クエリルールでクエリに関するすべてのデータバリデーションルールのリストを表示できます。

手動クエリを開く

フォームからのクエリは、レビュータブで開くことができます。レビュータブでクエリを開く方法:

レビュータブで、クエリを開きたいフォームまたはアイテムに移動します。
アイテムクエリの場合、アイテムのクエリを開くアイコンをクリックします。
イベント日クエリの場合、イベント日のクエリを開くアイコンをクリックします。
テキスト入力フィールドにコメントを入力します。なお、クエリメッセージには 500 文字の文字数制限があります。特殊文字は、エクスポートファイルで正しく表示されない可能性があるため、使用は避けてください。
保存をクリックします。Vault はクエリを作成します。

新規クエリは、データ入力ユーザに、回答が必要なオープンクエリとして表示されます。このクエリは、レビュータブのクエリリストにも表示されます。

読み取り専用項目およびフォーム間派生項目のクエリ: Vault は、読み取り専用項目またはフォーム間派生項目に対する手動クエリを開くことを許可しません。.

クエリに対するコメント

クエリに対してコメントできます。

オープンクエリがある事象、フォームまたは品目に進みます。
クエリを開く アイコンをクリックします。
返信 (手動クエリの場合) またはコメント (システムクエリの場合) をクリックします。
コメントを入力します。
保存をクリックします。

クエリにコメントすることで、クエリに回答する権限がある場合のみ、クエリを回答済みステータスに移動できます。

読み取り専用アイテムに対するクエリのコメント: Vaultでは、読み取り専用アイテムに対してシステムで生成されたクエリについてコメントすることは許可されていません。

クエリの終了

システムまたは手動クエリが解決し、さらなる措置が不要である場合、クエリを終了することができます。ユーザがクエリに回答することなく、作成したクエリをすぐに終了することができます。

Vault は、ユーザが関連する編集チェックを通過する値に値を更新した場合、システムクエリを自動的に閉じます。

オープンクエリに移動します。回答済みクエリアイコンは、クエリが回答されたことを示します。
オプション: コメントを入力します。
クエリを閉じるをクリックします。

クエリの再オープン

追加のアクションや議論が必要な場合、手動クエリを再度開くことができます。コメント数が 3 つ以上のクエリのみ再オープンできることに注意してください。

クエリを再オープンする方法:

終了したクエリに移動します。
再オープンをクリックします。
コメントを入力します。

Vault は、クエリをオープンステータスに戻します。

外部クエリ

クエリ API を使用して、外部ソースからのクエリを EDC にプッシュできます。クエリ API を使用すると、クエリを開いたり、回答したり、その他のクエリアクションを実行する際に、ソース情報を定義できます。

以下のソース情報の一部またはすべてをプッシュすることができます:

ソースシステム名: EDC の外部から問合せを追加したシステムの名前
ソースユーザ: EDC の外部から問合せを追加したユーザーの名前
ソースタイプ: クエリのソースタイプ
ソース ID: クエリのソースからの一意の ID

ソースシステム名の文字数制限は 100 文字です。例えば、"JReview"です。ソースユーザの文字数制限も 100 文字です。ソースタイプの制限は 30 文字、ソース ID の制限は 64 文字です。

ソースタイプが "external_v" の場合、ソース情報はデータ入力 UI およびイベントとアイテムのクエリのレビュー UI に表示されます。

データの取得

クエリソース情報は、クエリ詳細リストジョブ CSV ファイル、試験データ抽出ファイルのシステムデータセット (SYS_Q および SYS_QT)、および Query API から取得できます。

それぞれの場所に表示される情報は以下の通りです:

場所	ソース情報
クエリ詳細リスト CSV	ソースユーザ、ソースタイプ、ソースシステム名、ソース ID
SYS_Q データセット	ソースユーザ、ソースタイプ、ソースシステム名、ソース ID
SYS_QT データセット	メッセージソースユーザ、メッセージソースタイプ、メッセージソースシステム名、メッセージソース ID
クエリ API	CDMS 開発者ポータルのクエリソースシステム情報チャートを確認してください。

クエリステータスとアイコン

Vault のクエリには 3 つのステータスがあります: オープン、回答済み、および終了。これらのステータスは、行なわれたアクションの内容と、クエリに行われる必要があるものを示します。

Vault は、バッジアイコンを事象またはフォームのステータスアイコンの上に表示します。次に、Vault は、クエリのフルステータスアイコンをクエリ自体に表示します。

バッジ	名前	ステータス
	未解決	オープンはクエリが回答されていないことを示します。クエリを開くバッジは、ケースブックのスケジュールで、クエリ対象のイベントまたはフォームの既存ステータスアイコンに表示され、クエリを開くアイコンは、クエリ自体に表示されます。Vault はタスクバーにオープンクエリを一覧表示します。
	回答済み	回答済みはクエリが回答・対処されたことを示します。例えば、クエリ値の理由について施設が回答したなどです。回答済みクエリバッジは、ケースブックのスケジュールで、クエリ対象のイベントまたはフォームの既存ステータスアイコンに表示され、回答済みクエリアイコンは、クエリ自体に表示されます。
該当なし	終了	終了は、クエリにさらなる措置や協議が不要であることを示します。CRA またはデータマネージャは、必要に応じて終了したクエリを再度開くことができます。

EDC ツールのルール

リードデータ管理者および EDC ツール領域にアクセスできる他のユーザは、そこでルールの追加アクションを実行できます:

EDC ツール > ルールで、その表現を含むルールに関する詳細を表示できます。
EDC ツール > ジョブ履歴では、実行されたすべての実行ルールのジョブ履歴を表示できます。

詳しくは、ルールの管理を参照してください。