Vault EDC にサードパーティデータを読み込む
血液や DNA などの検体を診断目的で処理する医療技術企業や、標的治療を開発する製薬会社では、大量のサンプルを受け付ける機械を使用して、1 つ以上の検査結果を含むファイルを作成します。Vault EDC は、ユーザが手動で入力する代わりに、これらのファイルからデータをインポートして自動的に設定済みのフォームとそのデータ収集項目に入力することができます。
このデータは、データローダータブからインポートすることができます。設定が完了したら、ヘッダー付きの列を含むインポートファイルをアップロードし、 EDC にインポートすることができます。インポート中、Vault はデータを適切なフォームに入力します。
前提条件
Vault および試験でスポンサーデータローダ機能を有効にする必要があります。お使いの Vault でこの機能を有効にするには、Veeva サポートにご連絡ください。その後、スタディデザイナーがお使いの試験で有効にします。
データをインポートする前に、スタディデザイナーはデータをインポートする各フォーム定義に対するデータインポート設定を作成する必要があります。
標準の CDMS データローダ試験ロールを持つユーザは、下記のアクションを実行することができます。組織がカスタムロールを使用する場合、そのロールには以下の権限を付与することが必要です:
タイプ | 権限ラベル | 制御 |
---|---|---|
標準タブ | データローダタブ | データローダタブへのアクセス権限 |
機能権限 | データを読み込む | データローダタブ内のインポートサブタブへのアクセス権限。インポートページのフィールドの編集、編集結果のプレビュー、インポートジョブを実行する権限。 |
機能権限 | インポート履歴を表示 | データローダタブ内のインポート履歴サブタブへのアクセス権限 |
データローダへのアクセス
データローダには、データローダタブからアクセスします。アクセスすると既定でページが開き、データのインポート処理を進めることができます。左側のナビゲーションパネルからインポート履歴ページにアクセスします。インポート履歴には、プレビューとインポートジョブの履歴が表示されます。
CSV ファイルの準備
CSV インポートファイルには、データインポート設定でデータポイントにマッピングされた各列ヘッダーと一致する列が必要です。列ヘッダーの識別についてはスタディデザイナーへ問い合わせてください。
インポートファイルには次のルールが適用されます:
- インポートファイルは CSV 形式を使用する必要があります。
- インポートファイルはカンマ区切りになっている必要があります。
- インポートファイルは UTF-8 でエンコードされている必要があります。
- ファイルサイズは 100MB を超えることはできません。
- データローダーがフォームにデータをロードするには、CSV ファイルに少なくとも 1 行のデータが必要です。
日付形式: 2 桁の西暦を使用する日付または日時形式を使用する場合、データローダは 2000 年代の西暦を挿入します。例えば、dd-MMM-yy 形式で 08-Jun-25 を挿入すると、データローダは 2025 年 6 月 8 日を挿入します。2000 年代以外の日付をロードしたい場合は、4 桁の年号を持つ形式を使用します。
データのインポート
データをインポートするには:
- データローダ > インポートへ移動します。
- 試験を選択します。
- データローダ設定を選択します。
- 任意の作業: インポートの理由を入力します。
- 任意の作業: 変更理由 (該当する場合)を入力します。Vault は、インポートジョブによって編集される既存のデータについて、これを変更理由として使用します。
- インポートする CSV ファイルをここにファイルをドラッグアンドドロップエリアにドラッグアンドドロップします。このエリアをクリックしてファイルをアップロードすることもできます。
- 値の入力を求めるようにインポートが設定されている場合、値を指定します。
- 任意の作業: リセットをクリックしてページをリセットします。
- 任意の作業: プレビューをクリックしてインポートジョブの結果をプレビューします。
- インポートをクリックします。
データのインポートジョブが開始されます。ジョブ完了後にメール通知が送信されます。ジョブの進行状況は、インポート履歴から監視できます。
繰り返しフォームのプレビュー: 入力ファイルに複数のフォームのインスタンスを作成している場合、現在存在しているシーケンスよりも 1 つ大きいシーケンス番号のフォームは失敗と表示されます。これはこれらの記録のインポートには影響しません。これは、プレビュージョブがファイル全体ではなく、個々の行を見ていることを示すためです。
インポート履歴を表示
Vault は、インポート履歴サブタブに、インポートジョブの履歴を表示します。
ジョブタイプ
インポート履歴には、2 種類のジョブタイプの履歴が表示されます。
ジョブ | 説明 | 開始日時 |
---|---|---|
データローダインポートのプレビュー | 選択されたデータローダ設定に従って CSV ファイルからデータをインポートした場合のプレビューが実行されます。 | データローダで、データローダ > インポートのプレビューをクリックします。 |
データローダインポート | 選択されたデータローダ設定に従って、CSV ファイルからデータをインポートします。 | データローダで、データローダ > インポートのインポートをクリックします。 |
ジョブステータス
以下のジョブステータスが適用されます:
ステータス | 意味 |
---|---|
キュー処理済み | 同じタイプの別のジョブが現在実行中です。Vault は、前のジョブが完了した時点でこのジョブを実行します。 |
進行中 | 現在、Vault がジョブを実行しています。 |
失敗 | データに関連しない 1 つ以上のエラーにより、ジョブインスタンスを完了できませんでした。 |
完了 | データにエラーなくジョブインスタンスが完了しました。 |
完了しましたがエラーがありました | ジョブインスタンスはデータにエラーがある状態で完了しました。 |
インポート履歴をリフレッシュする
ページを更新しなくても、インポート履歴を更新することで、最新のジョブステータスや利用可能なログや出力ファイルを確認できます。
リフレッシュ () をクリックして、インポート履歴をリフレッシュします。
データローダーエラー
以下の表は、データのロード中に発生する可能性のあるエラーの一覧です: これらのエラーは、インポート履歴からダウンロードできるジョブログファイルに記載されています。
エラーメッセージ | 説明 |
---|---|
ファイル | |
列ヘッダ |
インポートファイルに、データローダ設定マッピングテーブルグリッドの行のインポート値列に指定されている列ヘッダーが含まれていません。 |
列ヘッダ |
インポートファイルに、データローダ設定マッピングテーブルグリッドの必須の行のインポート値列に指定されている列ヘッダーが含まれていません。 |
試験 | |
スタディがロックされています |
ジョブはスタディで実行されており、現在はロックされています。 |
研究実施施設 | |
サイト |
|
サイト |
このジョブは、現在ロックされているサイトの被験者のデータを読み込もうとしています。 |
症例 | |
被験者 |
|
事象グループ | |
事象グループ定義 |
|
事象グループ定義 |
インポートファイル、プロンプトフィールド、または静的値フィールドで指定された事象グループが、ケースブックに作成されていません。 |
事象グループ |
指定された事象グループは、事象グループ の繰り返し (サイクル) です。 |
イベント | |
イベントグループ |
|
イベント |
インポートジョブは、削除マーク済みのイベントのイベント日付に日付を読み込もうとしています。 |
イベント |
インポートファイル、プロンプトフィールド、または静的値フィールドで指定されたイベントが、ケースブックに作成されていません。 |
イベント |
|
イベン |
インポートジョブが、イベント日付をイベントに読み込もうとしており (初めてのイベントで、そのイベントにはまだイベント日付が存在しない)、イベントはフリーズしています。このエラーは、イベント日付自体がフリーズしているかどうかに関係なく、イベントがフリーズしたときに発生します。 |
イベント |
インポートジョブが、イベント日付をイベントに読み込もうとしており (初めてのイベントで、そのイベントにはまだイベント日付が存在しない)、イベントはフリーズしています。このエラーは、イベント日付自体がフリーズしているかどうかに関係なく、イベントがロックされているときに発生します。 |
イベント |
インポートジョブが、フリーズしたイベント内にある繰り返しフォームの新しいインスタンスを作成しようとしています。 |
イベント |
インポートジョブが、ロック済みのイベント内にある繰り返しフォームの新しいインスタンスを作成しようとしています。 |
イベント日付 | |
イベント |
このジョブは、現在ロックされているイベント日付に日付値を読み込もうとしています。 |
イベント |
このジョブは、現在フリーズしているイベント日付に日付値を読み込もうとしています。 |
イベント |
このジョブは、訪問方法の値を必要とするイベントのイベント日付に日付値を読み込もうとしています。 |
フォーマットがデータローダ設定で指定されたインポート形式 |
インポートジョブが、データローダ設定のイベント日付行のインポート形式列で指定された形式と一致しない日付値をイベント日付に読み込もうとしています。これには以下のシナリオが含まれます:
|
フォーム | |
フォーム |
|
フォーム |
ジョブは、ロック済みのフォームにデータを読み込もうとしています。 |
フォーム |
ジョブは、フリーズしている送信済みフォームにデータを読み込もうとしているため、フォームを編集することはできません。注: フォームがフリーズ、空白、進行中、または送信後の処理中である場合、項目のフリーズを解除できるため、ジョブによるデータの読み込みが妨げられることはありません。ジョブはこれらの項目にデータを挿入することはできますが、フォームを送信することはできません。 |
フォーム {form definition name} は削除にマーク済みです |
ジョブが削除にマーク済みのフォームにデータを読み込もうとしています。 |
フォームインスタンス |
インポートファイルまたはプロンプトフィールドで指定されたフォームインスタンスは、その前に来るフォームインスタンスが存在しないため、存在できません。 |
宛先フォームは繰り返しですが、フォームシーケンス番号が指定されていません |
対象のフォームは繰り返しに設定されていますが、インポートファイルまたはプロンプトフィールドに、シーケンス番号 (フォームインスタンス) が指定されていません。 |
項目 | |
項目 |
ジョブがフリーズした項目にデータを読み込もうとしています。 |
項目 |
ジョブが項目定義で許可されている最大文字数を超える値を (テキストタイプ項目に) 読み込もうとしています。 |
項目 |
項目定義の許容精度を超える数値を (数値タイプ項目に) 読み込もうとしています。 |
項目 |
ジョブが項目定義の許容精度を超える数値を (数値タイプ項目に) 読み込もうとしています。 |
項目 |
ジョブが、数値型項目に数値以外の値を読み込もうとしています。 |
フォーマットがデータローダ設定で指定されたインポート形式 {import format} と一致しません |
このジョブは、データローダ設定のインポート形式列で指定された形式と一致しない値を日付、日時、または時間項目に読み込もうとしています。これには、日付、日時、または項目値が設定でインポート形式として指定された形式と異なる形式である場合、正しいデータ型ではない値 (例: ジョブが数値を日付項目に読み込もうとしている場合)、データローダインポートジョブで未知のデータとしてサポートされていない文字列 (例: 「UNKN」という文字列が値として存在する場合など) が含まれます。 |
項目 |
ジョブが、不明な値をサポートしていない項目に、不明な日付または日時値を読み込もうとしています。 |
項目 |
ジョブが、項目または EDC がサポートしていない未知の数値の組み合わせで値を読み込もうとしています。 |
項目 |
|
項目 |
|
項目 |
|
項目 |
|
値は単位項目 |
値 (数) には値が指定されていますが、項目の単位部分には値が指定されていません。 |
値は単位項目 |
単位には値が指定されていますが、値 (番号) の部分項目には値が指定されていません。 |
ブーリアン項目には、「true」または「false」を指定する必要があります。 |
ブーリアン項目には、Vault は値として "true "か "false "のみを受け入れます。 |
不明 | |
不明なエラーが発生しました (エラー ID: |
ジョブで未定義のエラーが発生しました。 |