データローダーのデータインポートの設定
血液や DNA などの検体を診断目的で処理する医療技術企業や、標的治療を開発する製薬会社では、大量のサンプルを受け付ける機械を使用して、1 つ以上の検査結果を含むファイルを作成します。Vault EDC は、ユーザが手動で入力する代わりに、これらのファイルからデータをインポートして自動的に設定済みのフォームとそのデータ収集項目に入力することができます。
データローダがこのデータを Vault EDC にインポートするには、事前に治験デザイナーがデータインポート設定を作成する必要があります。データインポート設定では、インポート先のフォームを指定し、CSV ファイルの列をインポート先の被験者 ID やサイトなどの識別子、フォームのデータコレクション項目と紐付けます。CSV のインポート時に、インポート中のデータの処理内容を記述したデータインポート設定を選択します。
データを読み込むフォームごとに、データインポート設定を作成する必要があります。そのため、機械またはデバイスのデータを複数のフォームに読み込む場合、Studioでフォームごとに個別のデータインポート設定を作成する必要があります。
前提条件
お使いの Vault でこの機能を有効にするには、Veeva サポートにご連絡ください。
この機能を Vault で有効にすると、治験でも有効にすることができます。
治験のデータローダを有効にするには:
- 開発環境に移動します。
- Studio > 治験 > 設定に移動します。
- 編集をクリックします。
- データローダを有効にするに対してはいを選択します。
- 保存をクリックします。
これで、開発環境でデータローダが使用できるようになります。他の環境でデプロイすると、そこでもこの機能が有効になります。
標準の CDMS 治験設計者治験ロールを持つユーザは、下記のアクションを実行することができます。組織がカスタムロールを使用する場合、そのロールには以下の権限を付与することが必要です:
タイプ | 権限ラベル | 制御 |
---|---|---|
標準タブ | Studio タブ | Studio タブへのアクセス権限 |
機能権限 | 治験のデザイン | Studio から治験デザイン定義と治験スケジュールを作成する権限 |
新規データインポート設定の作成
- 治験のStudio > 治験 > データローダに移動します。
- + 新規をクリックします。
- データインポート設定の名前を入力します。この名前には、ダッシュ (-) とアンダースコア (_) を除き、スペースや特殊文字を含めることはできません。
- データインポート設定のラベルを入力します。
- 任意の作業: 説明を入力します。
- 宛先フォームを選択します。これは、インポートされたデータが読み込まれるフォームです。
- 列ヘッダー作成方法を選択します。詳しくは以下を参照してください。
- ファイルをアップロード: CSV ファイルをアップロードします。CSV 内の各列ヘッダーをもとにマッピングテーブルに行が作成されます。次に、これらの各列をフォームの項目に紐づけることができます。
- 手動作成: マッピングテーブルと CSV の列ヘッダーをマッピングします。CSV のすべての列をマッピングする必要があります。
- ファイルをアップロードを選択した場合、ドラッグアンドドロップエリアにファイルをドラッグアンドドロップするか、エリア内の任意の場所をクリックしてファイルをアップロードします。
- 手動で作成を選択した場合、列ヘッダーを入力し、+ 追加をクリックします。列ごとにこれを繰り返します。最大 100 列まで追加することができます。
- マッピングを作成します。
- 保存または保存して閉じるをクリックして保存してエディターを閉じます。
列の見出し
データインポート設定の主な目的は、CSV 列の値を、インポート先フォームの項目、またはインポート先フォームを識別に必要なメタデータと紐づけることです。
次の列は必須です:
- サイト番号: 被験者のサイトのサイト番号 (名称)。
- 被験者 ID: 被験者の被験者 ID (名前)
- イベントグループ: イベントを含むイベントグループの名前。
- イベント: 宛先フォームを含むイベント (訪問) の名前。
- イベント日付: イベント (訪問) の日付。
- データ項目: 宛先フォームに入力する各データ項目の列が必要です。
列ヘッダーの作成には 2 つの方法があります。
ファイルをアップロードを選択して既存の CSV ファイルをアップロードすると、すべての列ヘッダーがマッピングされているグリッドに追加されます。
手動で作成を選択することもできます。この方法では、各列ヘッダーを手動で入力します。ヘッダーの値を入力して+ 追加をクリックします。ヘッダーごとにこの作業を繰り返します。ヘッダーを削除するにはクリックします。
マッピングの作成
マッピングは、インポート先フォームの項目にインポートされる値のソース、値、書式を識別します。次の項目がマッピングテーブルに追加されます。これらの項目を CSV の列 (インポートファイル) にマッピングしたり、インポート中にプロンプトとして値を収集したり、項目の値として使用する静的な値を定義することができます。
インポート元
インポート元で値の取得元を定義します。次の 3 つから選択することができます。
- インポートファイル: インポートファイルにこの値を含む列がある場合。インポート値でその列を選択します。
- プロンプト: インポートファイルにこの値を含む列がない場合。データのインポート時に、データローダにこの値の入力を求めるプロンプトが表示されます。
- 静的値: インポートファイルにこの値を含む列がない場合。インポート値フィールドに静的値を指定すると、インポート時にその値がフィールドに入力されます。
インポート値
インポート値に、インポート時にフィールドに埋める値を定義します。
インポート元でインポートファイルを選択した場合、CSV ファイルでこの値を含む列を選択します。
インポート元で静的値を選択した場合、インポート値フィールドで使用する値を選択します。
インポート元でプロンプトを選択した場合、インポートの開始時にデータローダによってプロンプトに値が表示されるため、このフィールドで選択することはできません。
インポート形式
インポート元でインポートファイルを選択した場合、インポート形式フィールドでイベント日付、日付、時間、日時項目の日時の形式を選択することができます。
値を翻訳
インポート元でインポートファイルを選択した場合、コードリストタイプの項目に、コードリスト値をインポート値にマッピングすることができます。ファイルからの値は、「Yes」と「Y」のように値が異なる場合のために、EDC コードリストの選択項目にマッピングすることができます。
値を変換するには:
- 変換値フィールドのバーをクリックします。
- 各コードリスト値のインポート値を入力します。
- 保存をクリックします。
使用可能なマッピング
次の表に、使用可能なマッピングを示します。すべてのマッピングは必須です。
項目名 | マッピング列 | メモ |
---|---|---|
施設番号 |
|
被験者のサイトのサイト番号 (名称)。 |
被験者 ID |
|
被験者の被験者 ID (名前) |
事象グループ |
|
イベントを含むイベントグループの名前。 |
イベント |
|
宛先フォームを含むイベント (訪問) の名前。 |
イベント日付 |
|
イベント (訪問) の日付。 |
データ項目 |
|
宛先フォーム上のデータコレクション項目ごとに、マッピンググリッドに行が作成されます。 |
別の治験からデータインポート設定をコピー
アクセス可能な別の治験からデータインポート設定をコピーすることができます。これは、複数の治験で同じフォームを使用している場合のインポートに便利です。
別の治験からデータインポート設定をコピーするには:
- 治験のStudio > 治験 > データローダに移動します。
- 治験からコピーをクリックします。
- コピーを作成または既存のものを使用して重複を処理を選択します。詳細はこちらをご覧ください。
- 治験からコピーの場合、コピー元を選択します (他の治験からまたはライブラリから。)
- コピー元となる治験環境を選択します。
- 検索またはスクロールして、コピーしたいデータインポート設定を探します。
- コピーしたいイベントグループを選択します。
- 任意の作業: すべてを選択チェックボックスを選択すると、すべてのデータインポート設定を選択してコピーすることができます。
- 設定をコピーをクリックします。治験へのデータインポート設定のコピーが開始されます。
- 任意の作業: 治験からコピーダイアログで以下を行います:
- サマリーを表示をクリックして、コピー済みのフォームおよびコピーのステータスを確認します。
- ログを表示をクリックしてコピー済みの各オブジェクトレコードについての詳細なステータス情報を確認します。
- 終わったら、閉じるをクリックします。閉じるをクリックすると、サマリーまたはログファイルにアクセスできなくなります。
データインポート設定の編集方法
データインポート設定を編集するには:
- 治験のStudio > 治験 > データローダに移動します。
- リストの中から、編集したいデータインポート設定を探します。
- 定義の名前にカーソルを合わせると、アクションメニューが表示されます。
- アクションメニューから、編集を選択します。
- 変更を実行します。
- 保存して閉じるをクリックします。
データインポート設定の削除方法
データインポート設定を削除するには:
- 治験のStudio > 治験 > データローダに移動します。
- リストの中から、編集したいデータインポート設定を探します。
- 定義の名前にカーソルを合わせると、アクションメニューが表示されます。
- アクションメニューから、削除を選択します。
- 確認ダイアログで、削除をクリックします。
他の環境への展開
データローダの有効化設定は治験展開パッケージの一部であるため、この設定の変更は展開のたびに反映されます。
このパッケージにはデータインポート設定も含まれています。ただし、これらはバージョンなしの変更と見なされます。そのため、データインポート設定への変更は、展開後に自動的に適用されるため、修正の必要はありません。データインポート設定を変更する場合、この点に留意してください。