クエリデータ
Vault CDMS は、入力されたデータ (データ項目とイベント日付) に対して、不足、範囲外、または他の疑問がある場合の問い合わせを追跡するためにクエリを使用します。CDB では、クエリの表示、項目に対してクエリを開く、コメントで既存クエリに回答する、さらにアクションを必要としないクエリの終了が可能です。
Vault EDC では、システムクエリと手動クエリの 2 種類のクエリが存在します。Vault は、ユーザが入力したデータにチェックを実行し、データがスタディデザイン時に定義された仕様を満たさない場合はクエリを作成してシステムクエリを生成します。例えば、Vault は、入力した日付が特定の範囲外にある場合にシステムクエリを作成します。手動クエリは、スタディモニター (CRA)、データマネージャ、または臨床コーダーがが作成するクエリです。CDB 内で実行したクエリ関連の操作は、Vault EDC 内でも適用されます。例えば、CDB 項目にクエリを作成すると、そのクエリが EDC 項目に表示されます。
また、サードパーティーのデータに対して手動でクエリを作成することもできますが、そのクエリは Vault CDB 内にしか存在しません。サードパーティーのデータソースにクエリを返すには、クエリをエクスポートして、サードパーティーのデータプロバイダとの連携を管理できます。CDBでサードパーティのクエリに応答する場合、サードパーティのデータプロバイダからの回答を記録してクエリの状態を回答済みにし、データポイントが修正されたら、クエリを終了できます。
可用性: 臨床データベース (CDB) は CDB ライセンスを保有するお客様のみにご利用いただけます。詳細は Veeva のサービス担当者までお問い合わせください。
前提条件
CDMS リードデータマネージャおよびCDMS データマネージャの標準スタディロールを持つユーザは、以下に説明するアクションを自動的に実行できます。組織でカスタムスタディロールを使用する場合、ロールは以下の表に示す権限を付与する必要があります。
CDB データプロバイダのスタディロール、またはそれに基づくロールを持つユーザは、管理者 > ユーザからソースによるリストにアクセス権を割り当てる必要があります。
タイプ | 権限ラベル | 制御 |
---|---|---|
標準タブ | ワークベンチタブ | ワークベンチタブからデータワークベンチアプリケーションにアクセスする権限 |
機能権限 | ||
機能権限 | オープンクエリ | クエリを回答済み状態にすることなく、新規 (開く) クエリを作成したり、クエリにコメントしたりする権限 |
機能権限 | クエリに回答する | 問い合わせに回答し、回答済みステータスに移行させる権限。この権限では、クエリを開く権限は提供されません。 |
機能権限 | サードパーティークエリに回答する | ワークベンチのサードパーティデータ項目に対するクエリに回答する権限 |
機能権限 | 選択された CDB クエリリストを表示 | 選択したクエリリスト (ワークベンチ > 管理者 > ユーザで選択) を CDB で表示する権限 |
機能権限 | すべての CDB クエリーリストを表示 | すべてのクエリリストを表示する権限 |
機能権限 | クエリを閉じる | クエリを終了する権限 |
機能権限 | ケースブックの表示 | 対象ケースブックに関する情報および対象ケースブックからの情報を表示する権限 (レポート、ダッシュボード、および CDB 用) |
機能権限 | API アクセス | Vault CDMS API にアクセスし使用する権限(この許可は CDB 使用時にも必要です)。 |
スタディに制限付きデータが含まれている場合、それを閲覧するには制限ありデータアクセス権限が必要です。
スタディロールについて詳しくご確認ください。
ワークベンチでクエリを表示する
CDB ワークベンチでクエリを表示するために、試験を選択し、試験メニューまたはナビゲーションドロワーを使用してクエリページに移動します。 コアタブのクエリページが表示されます。
デフォルトでは、ワークベンチはスタディの各ソースに対してこのクエリリストのセットを含んでいます。例えば、スタディに EDC とラボという 2 つのソースがある場合、ワークベンチは 2 組のリストを生成し、ソース名でラベル付けします。
- 終了したクエリ: このデータソースから、スタディで終了したステータスのクエリをすべてリストアップします。
- 未処理クエリ: このデータソースから、スタディでオープンまたは回答済みステータスのクエリをすべてリストアップします。
- クエリメッセージ: スタディ内のこのデータソースからのすべてのクエリをリストします
クエリリストの CQL ステートメントを編集できますが、現在のリリースではワークベンチはその変更を保存できないようになっています。このため、クエリ > 公開またはクエリ > プライベートでは、リストが表示されません。
クエリリストの並べ替え
未処理と終了の両方のサブタブで、クエリリストを並び替えできます。
クエリリストの並べ替えを行うには:
カラムにすでに並び替え順が適用されている場合、ワークベンチは並び替えアイコン (昇順または降順) を表示します。カラムヘッダーでこれらをクリックすると、並び替え順を変更または削除できます。
並び替え順をリセット (削除) するには、並び替えメニューを開き、リセットをクリックします。
セル詳細パネルでのクエリ
また、セル詳細パネルにあるリストから、個々のクエリを操作することもできます。セル詳細パネルを開くために、リストのデータシートで表示したいセルをクリックします。パネルを閉じるために、終了 () をクリックするか、セルを 2 回クリックします。
セル詳細パネルの上端をドラッグしてサイズを変更したり、ポップアウト () をクリックして新規ウィンドウで開いたりすることができます。
クエリステータス
Vault CDMS のクエリには 3 つのステータスがあります: オープン、回答済み、および終了。これらのステータスは、行なわれたアクションの内容と、クエリに行われる必要があるものを示します。
ワークベンチからクエリに回答すると、クエリはオープンステータスに移行します。
ステータス | 意味 |
---|---|
未解決 | オープンはクエリが問合せに対応されていないことを示します。これは、新規作成されたすべてのクエリに割り当てられるステータスです。 |
回答済み | 回答済みはクエリが回答・対処されたことを示します。例えば、クエリ値が範囲外である理由について施設が回答したなどです。 |
終了 | 終了は、クエリにさらなる措置や協議が不要であることを示します。CRA またはデータマネージャは、必要に応じて Vault EDC で終了したクエリを再度開くことができます。 |
クエリステータスを EDC と同期する
Vault は、ワークベンチのクエリ詳細パネルでそのクエリをクリックして表示するたびに、クエリのクエリステータスを EDC に合わせて更新します。Vault はまた、通常毎晩実行されるワークベンチエクスポートジョブとそれに続くワークベンチでのインポート中に、EDC からクエリを更新し、新規作成したクエリをインポートします。
ワークベンチで開いているクエリがあり、前回クエリ詳細パネルでそのクエリを表示した後 (ただし、次のインポート実行前) にVault EDC ユーザがそのクエリに回答した場合、ワークベンチでそのクエリの詳細を表示すると、そのクエリのステータスが回答済みに更新されます。
クエリを開く
リスト内のセル詳細パネルから新しいクエリを開き、イベントの日付とEDCアイテムに関するクエリを作成することができます。 クエリを開く方法:
リストから単一アクションで複数のクエリを開くことができます。
- リストに移動します。
- 照会したい行のチェックボックスを選択します。
- クエリメッセージを入力します。
- 提出をクリックします。
クエリに応答する
実行データに関する問い合わせにコメントで対応できます。関連データの項目またはイベント日がロックされている場合、クエリに応答できないことに注意してください。その後、クエリ詳細とセル詳細パネル、およびクエリリストの最終メッセージ列に、回答が表示されます。クエリに対する回答が 2 つ以下の場合、CDB は古いものから新しいものへと、時系列で回答を表示します。
問い合わせが回答済みステータスだった場合、ワークベンチで回答するとオープンステータスに戻ります。
クエリリストから
クエリに回答する方法:
Vault は、コメントをクエリに追加します。
クエリ詳細パネルから
クエリに回答する方法:
Vault は、コメントをクエリに追加します。
複数のクエリに回答する
クエリリストから単一アクションで複数のクエリに同じメッセージで回答できます。
- クエリリストに進みます。
- 回答したいクエリを含む行のチェックボックスを選択します。
- 保存をクリックします。
クエリを終了します
システムまたは手動クエリが解決し、さらなる措置が不要である場合、クエリを終了することができます。関連データの項目またはイベント日がロックされている場合、クエリを終了できないことに注意してください。クエリを終了すると、未処理クエリリストから終了クエリリストに移動します。この変更を確認するために、ページを更新してください。クエリを終了すると、項目またはイベント日付を参照しているリストのクエリ関連セルのハイライトも削除されます。
Vault は、ユーザが関連する編集チェックを通過する値に値を更新した場合、システムクエリを自動的に閉じます。
クエリリストから
クエリを終了する方法:
クエリ詳細パネルから
クエリを終了する方法:
複数のクエリを終了する
クエリリストとデータリストの両方から、複数のクエリを一括で終了できます。
クエリリストから複数のクエリを終了する方法:
- リストに移動します。
- 終了したいクエリを含む行のチェックボックスを選択します。
- 保存をクリックします。
データリストから複数のクエリを終了する方法:
- リストに移動します。
- 終了したいクエリを含む行のチェックボックスを選択します。
- 閉じるをクリックします。
システムクエリ
Vault CDMS は、チェックを実行し、定義された範囲外にある項目値にシステムクエリを作成します。その範囲はスタディデザイン時に定義されます。
以下のシステムクエリの種類は自動的に定義されます:
- 必須: 項目定義の作成時に、スタディデザイナはフィールドを必須としてマークすることを選択できます。フォームの送信時にこのフィールドが空白のままの場合、Vault はシステムクエリを作成します (「このフィールドは必須です」)。
- 範囲: 項目定義の作成時に、スタディデザイナはフィールド値の範囲を定義することができます。入力した値がその範囲外にある場合、Vault はシステムクエリを作成します (「値が範囲外です」)。このクエリタイプは日付ではなく数値のみが対象です。
- 将来の日付: 項目定義の作成時に、スタディデザイナは将来の日付を禁止することができます。ユーザが将来の日付を入力した場合、Vault はシステムクエリを作成します (将来の日付は許可されていません)。
- 将来の日付 (イベント日付): イベント定義の作成時に、スタディデザイナは、将来の日付が許可されていないことを示すことができます。Vault は、入力時に現在の日付よりも遅いイベント日付について、システムクエリを作成できます。
- ウィンドウ外 (イベント日付): イベント定義の作成時に、スタディデザイナは、イベントの許可日のウィンドウを作成できます。設定されている場合、Vault は、イベント日付がこのウィンドウの外にあるときはいつでもシステムクエリを作成できます。
Vault CDMS は無効化されたアイテムに対してクエリを作成しないことに注意してください。
スタディデザイナは、Studio でデータ入力規則を追加定義することができます。これらの規則に基づいて、Vault CDMS はシステム生成クエリを追加作成することができます。
クエリをエクスポートする
スタディ内のすべての未解決または終了したクエリを CSV ファイルとしてエクスポートし、ドキュメンテーションや外部レビューに利用できます。CSV ファイルには、クエリリストと同じカラムが含まれ、リストで適用したソートやフィルタは、エクスポートされたリストにも適用されます。
クエリをエクスポートする方法:
- スタディのクエリページに移動します。
- エクスポートするクエリリストのタイトルをクリックします。
- CSV が正常に生成された通知で、 生成された CSVをクリックし、CSV ファイルをダウンロードします。
外部クエリ
JReview® などの外部ベンダーは、クエリを開いたり、応答したり、その他のクエリアクションを実行する際に、クエリソース情報を指定することができます。クエリソース情報は、クエリ APIを使用して EDC から CDB に取り込まれます。このデータは、CDB の OriginSystem
および OriginID
フィールドに表示されます。
- ソースシステム名: EDC の外部からクエリを追加したシステムの名前
- CDB では発信元システム (
OriginSystem
) と呼ばれます
- CDB では発信元システム (
- ソース ID: クエリのソースからの一意の ID
- CDB では発信元 ID (
OriginID
) と呼ばれます
- CDB では発信元 ID (
OriginSystem
フィールドは CDB オープンクエリ API を介して設定される場合、100 文字に制限されます。クエリソースの変更は、CQL の CDB クエリリストおよび@QRYプロパティに表示されます。