データのエクスポート
CDB ワークベンチのエクスポート領域から、エクスポート定義として、エクスポート用にデータリストをグループ化することができます。各エクスポート定義に、複数の試験のデータリストを追加することができます。エクスポートパッケージを生成する際に、CSV または SAS (sas7bdat) フォーマットの生成を選択することができます。CDB は次に、エクスポートリストごとに 1 つのファイルセットを生成します。エクスポートパッケージを生成すると、お客様またはお客様の試験にアクセスできる他の CDB ユーザは、エクスポートパッケージ (CSV または sas7bdat のいずれかのリストファイルのコレクション、およびパッケージ内容を説明するマニフェストファイル「manifest.json」を含む ZIP ファイル) をダウンロードすることができます。次いでそれを規制当局、メディカルモニター、統計専門家などの試験ステークホルダーと共有することができます。EDC ツールの試験データ抽出ジョブから CDB にデータセットを送信することも可能です。
可用性: 臨床データベース (CDB) は CDB ライセンスを保有するお客様のみにご利用いただけます。詳細は Veeva のサービス担当者までお問い合わせください。
前提条件
システムが生成したコアリストに基づいてデータをエクスポートすることはできますが、カスタムリストフォーマットからデータのエクスポートをしたい場合は、リストを最初に作成する必要があります。
デフォルトでは、標準の CDMS リードデータマネージャおよび CDMS データマネージャのスタディロールを持つユーザは、以下に説明されているアクションを実行できます。組織がカスタムロールを使用する場合、そのロールには以下の権限を付与することが必要です:
| タイプ | 権限ラベル | 制御 |
|---|---|---|
| 標準タブ | ワークベンチタブ | ワークベンチタブからデータワークベンチアプリケーションにアクセスする権限 |
| 機能権限 | ケースブックの表示 | 対象ケースブックに関する情報および対象ケースブックからの情報を表示する権限 (レポート、ダッシュボード、および CDB 用) |
| 機能権限 | エクスポートの表示 | エクスポートページにアクセスする権限 |
| 機能権限 | エクスポート定義の作成 | エクスポート定義を作成およびコピーする権限 |
| 機能権限 | エクスポートパッケージの生成 | CSV または SAS のエクスポートパッケージを生成する権限 |
| 機能権限 | エクスポート定義の削除 | エクスポート定義を削除する権限 |
| 機能権限 | エクスポートパッケージの表示 | エクスポート > パッケージにアクセスし、生成されたエクスポートパッケージを表示する権限 |
スタディに制限付きデータが含まれている場合、それを閲覧するには制限ありデータアクセス権限が必要です。
スタディロールについて詳しくご確認ください。
エクスポートへのアクセス
CDB ワークベンチのエクスポート領域から、エクスポート定義にアクセスすることができます。エクスポート領域へは、ナビゲーションドロワーまたはスタディメニューから移動できます。
|
|
エクスポートの表示
エクスポートページには、定義およびパッケージの 2 つのタブがあります。エクスポート > 定義から、 スタディのエクスポート定義の表示、作成、および編集ができます。エクスポート > パッケージから、生成済みのすべてのエクスポートパッケージを表示し、失敗した場合にはエラーログを確認することができます。
定義
ワークベンチは、エクスポート > 定義で、スタディのすべてのエクスポート定義をリストします。以下のテーブルは、エクスポート定義のリストの各列の詳細を示します:
| 列 | 説明 |
|---|---|
| 名前 | エクスポート定義のタイトルで、作成中に定義されます。ワークベンチでは、この定義にスケジュールされたエクスポートが設定されている場合、この列に時計アイコン （） が表示されます。アイコンにカーソルを合わせると、スケジュールが表示されます。 |
| ステータス | エクスポート定義は、は、以下の 2 つのうちのいずれかである可能性があります: 下書き および公開済み。 |
| リスト | エクスポート定義内のデータリストの数。 |
| タイプ | エクスポート定義のタイプ。詳しくは、以下のエクスポートタイプを参照してください。 |
| 作成日 | エクスポート定義の作成日時および作成者の名前。 |
| 最終更新 | エクスポート定義および変更を追加したユーザの名前に対する最終更新の日付と時刻 |
| 最新パッケージ | エクスポートパッケージのステータス、およびパッケージが生成された日付と時刻。ダウンロード () をクリックして、パッケージをダウンロードします。 |
このリストは、最新パッケージ、変更者、変更日、または名前で並べ替えることができます。並べ替えメニューから、並べ替える列および順序を選択します。
並べ替えメニューにあるリセットをクリックして、デフォルトの並べ替え順に戻します (降順、変更日)。
パッケージ
ワークベンチは、エクスポート > パッケージにあるスタディに生成されたすべてのパッケージを一覧表示します。以下のテーブルは、パッケージ一覧の各列の詳細を一覧表示します:
| 列 | 説明 |
|---|---|
| 名前 | この列には、パッケージの生成に使用されたエクスポート定義のタイトル、パッケージが作成された日付と時刻、およびパッケージに含まれるリストの数が表示されます。ワークベンチでは、このパッケージにスケジュールされたエクスポートが設定されている場合、この列に時計アイコン （） が表示されます。アイコンにカーソルを合わせると、実行したスケジュールが表示されます。 |
| タイプ | この列には、パッケージの生成に使用されたエクスポート定義のタイプが一覧表示されます。 |
| 処理者 | パッケージの生成を開始したユーザの名前、およびその生成が開始された日付と時刻。 |
| ステータス | この列には、パッケージのステータス (進行中、完了、またはエラー) が一覧表示されます。完了したら、ダウンロード () をクリックして、パッケージをダウンロードします。 |
パッケージの並べ替え
このリストは、名前、処理者、処理日、処理ステータスによって並べ替えることができます。並べ替えメニューから、並べ替える列および順序を選択します。
並べ替えメニューにあるリセットをクリックして、デフォルトの並べ替え順に戻します (降順、処理日)。
エラー
パッケージの生成に失敗した場合、エクスポート > パッケージからエラーを一覧表示することができます。
エラーを表示するには:
- スタディのエクスポート > パッケージに進みます。
- リスト内で失敗したパッケージを特定します。
-
問題ログ表示 () をクリックします。
- ワークベンチで問題パネルが表示されます。パッケージ生成中に発生した各エラーが一覧表示されます。
- オプション: ダウンロード () をクリックすると、問題ログがダウンロードできます。
- 閉じる () をクリックして問題パネルを閉じます。
エクスポートタイプ
ワークベンチは以下の 3 つのタイプのエクスポートをサポートします: None、Raw、および SDTM です。デフォルトは None で、Raw および SDTM タイプに含まれる定義された規約なしに、独自のエクスポート定義を作成することができます。
Raw
エクスポート定義を作成する際に、Raw 形式を選択することができます (タイプで Raw を選択することにより)。Raw エクスポートパッケージには、次のような特徴があります:
- パッケージには、フォームにデータがない場合でも、スタディ内の各コアリストのエクスポートリストが含まれます。
- 日付および日時の項目には、デフォルトと RawDate() 形式の両方が表示されます。
RawDate()形式の日付の例については、以下のテーブルを参照してください。 - 単位のある項目には、翻訳された名前および単位値の列が含まれる。単位列の例については、以下のテーブルを参照してください。
- パッケージには、コンテキストに応じたヘッダー情報のための追加のシステムリストが含まれています。以下の詳細なリストを参照してください。
フォームのエクスポートリスト
Raw エクスポートにおける各フォームのリストには、フォーム上の各項目の列に加えて、以下の列が含まれます:
- Study.Name
- Site.Number
- Subject.Name
- EventGroup.Name
- EventGroup.SeqNbr
- Event.Name
- Event.Date
- Event.Status
- Form.Name
- Form.DataSource
- Form.SeqNbr
- Form.LastModifiedDate
- ItemGroup.SeqNbr
システムリスト
Raw エクスポートタイプはデフォルトで以下の System Listings を含みます。これらのリストは、スタディ用の運用メタデータを提供します。「なし」エクスポートタイプについては、 System Listings はデフォルトでは含まれませんが、必要に応じて追加できます。
以下のテーブルは、各システムリストに含まれる列の一覧です。
| システムリスト | CQL | 列 |
|---|---|---|
| Sys_Sites | CALL Sys_Sites |
|
| Sys_Subjects | CALL Sys_Subjects |
|
| Sys_Events | CALL Sys_Events |
|
| Sys_Forms | CALL Sys_Forms |
|
| Sys_ILB | CALL Sys_ILB |
|
| Sys_Links | CALL Sys_Links |
|
Raw 日付フォーマット
日付および日時の項目に対して、ワークベンチにはデフォルトの日付フォーマットと RawDate() フォーマットが含まれています。RawDate() フォーマットでは、日付と時刻の一部が変更なしで表示されます。
| 記録された日付または日時 | 未加工フォーマット | |
|---|---|---|
| 1 | 27-Oct-2020 | 27-Oct-2020 |
| 2 | ?-Oct-2020 | UN-Oct-2020 |
| 3 | ?-?-2020 | UN-UNK-2020 |
| 4 | 27-Oct-2020 10:40 | 27-Oct-2020 10:40 |
| 5 | 27-Oct-2020 ? | 27-Oct-2020 UN:UN |
| 6 | ?-Oct-2020 ? | UN-Oct-2020 UN:UN |
| 7 | ?-?-2020 ? | UN-UNK-2020 UN:UN |
単位の列を持つ項目
ユニットタイプの項目では、ワークベンチは翻訳された名前と単位値のための追加の列を含めます。以下のテーブルは、キログラム単位で収集される「体重」項目に対して、含まれる列を示しています。
| 体重 | Weight_UOM | Weight_TRANSLATED | Weight_UOM_TRANSLATED |
|---|---|---|---|
| 65 | kgs | 143.3 | lbs |
コードリストのデコード
Raw エクスポートの定義には、コードリスト項目のデコード値が含まれます。これらの値は、元の項目列の後に、項目名に _DECODE が付加された新しい列で表示されます。列の見出しが重複している場合は、名前の後に2、3、4といった数字が続きます。
例: 「signed_consent_form_DECODE_2」:
DECODE は、新しい輸出定義と変更された既存の定義にのみ追加されます。DECODE 列はitemtype属性と一緒にマニフェストファイルに含まれます。
重複列の処理
CQL は重複した列を許容し、それらを UI に表示します。
例えば、「_RAW」や「_UOM」が付加された列など、システムが生成した列には、特定のシナリオで重複列の衝突を防ぐために、自動的に「_2」が付加されます。これは、エクスポートリストが CSV または SAS にエクスポートされる前の、CQL トランスフォーメーション時に発生します。
ユーザ定義の項目名に対して、CDB は項目グループの名前を前に付けて元の名前を保持しようとするためです。これは、 CSV または SAS ファイルが生成されるときに発生します。
SDTM
エクスポート定義を作成する際に、SDTM 形式を選択することができます (タイプで SDTM を選択することにより)。SDTM エクスポートパッケージには、次のような特徴があります:
- すべてのリスト CSV には、ドメイン (リストの短いタイトル) の列があります。
- リスト CSV ファイルには、短いタイトル (「short_title.csv」) を使用して名前が付けられます。
- 日付、日時、および時刻の項目には、すべて ISO8601 形式が使用されます。
- 不明な日時は以下のテーブルに示すような書式になります。
- データ項目の列には、エクスポート定義作成時の選択に基づいて、その EDC 定義の SDTM 名または外部 ID が使用されます。
| 記録された日付または日時 | 不確実性の範囲 | 公称日付/時刻 (--DTC) | |
|---|---|---|---|
| 1 | 2020年3月15日 13:14:17 | 完全な日付け | 2020-03-14T13:14:17 |
| 2 | 2020年3月15日 13:14 | 秒が不明 | 2020-03-15T13:14 |
| 3 | March 15, 2020 13 | 分が不明 | 2020-03-15T13 |
| 4 | 2020 年 3 月 15 日 | 時刻が不明 | 2020-03-15 |
| 5 | March, 2020 | 日が不明 | 2020-03 |
| 6 | 2020 | 月が不明 | 2020 |
エクスポートパッケージにおける制限付き (盲検化) データ
CDB は、エクスポート定義の盲検化されたプロパティに基づいて、エクスポートパッケージに制限された (盲検化された) データを含めるかどうかを決定します。
盲検化解除チェックボックスが選択され、1 つまたは複数のエクスポートリストが制限付きデータを含む場合、ワークベンチは制限付きデータアクセス権限を持つユーザにのみ、結果のエクスポートパッケージをダウンロードすることを許可します。
エクスポートリストに制限付き (盲検化) データが含まれる場合、スタディロールが制限付きデータアクセス権限を付与している場合にのみ、ワークベンチは制限付きデータをエクスポートします。デフォルトでは、この権限は標準的な CDMS リードデータマネージャのスタディロールを持つユーザに割り当てられています。
以下のリストでは、非盲検化エクスポート定義のパッケージを生成する際に、ワークベンチが制限付きデータをどのように扱うかが説明されています:
- ソースレベルの制限: ソース全体に制限がある場合 (サードパーティデータにのみ可能)、盲検化済みのエクスポートパッケージにはこのソースからのデータが含まれません。リストが制限付きソースからのデータのみを持つ場合、ワークベンチはそのリストをエクスポートパッケージに含めません。
- フォームレベルの制限: フォームが制限付きの場合、盲検化済みのエクスポートパッケージには、そのフォームからのデータは含められません。リストが制限付きフォームからのデータのみを持つ場合、ワークベンチはそのリストをエクスポートパッケージに含めません。ワークベンチはそのフォームの @HDR、@Form、および @ItemGroup の情報を含めず、フォームのすべての項目もエクスポートから除外されます。
- 項目レベルの制限: 項目が制限付きの場合、盲検化済みのエクスポートパッケージはこの項目を含めません。ワークベンチは、リストにこの項目の列を含めません。リストがこの項目を CQL 文で使用して別の列の値を導き出す場合、その列も除外されます。
エクスポート定義の作成
エクスポート定義を作成するには:
- エクスポート > 定義に進みます。
-
+ 作成 … をクリックします。
- エクスポート定義にタイトルを入力します。これは、エクスポート定義リストの名前の列に表示されます。
- タイプでRaw または SDTM を選択します。それ以外の場合は、None のままに設定します。
- SDTM を選択した場合、外部名で列ラベルを自動生成を選択すると、列ラベルに外部 ID を使用することができます。それ以外の場合は、EDC SDTM 名で列ラベルを自動生成のままに設定し、SDTM 名を使用します。
- 任意の作業: 説明を入力します。
- 次へをクリックします。
- オプション: 展開または折りたたみをクリックして、リストカテゴリおよびエクスポート定義を展開、または折りたたむことができます。ワークベンチは、エクスポート定義で、カテゴリ別に利用可能なリストとエクスポート定義によりリストをグループ化します。
-
利用可能なリストから、リストまたはリストカテゴリを選択済みリストにドラッグアンドドロップします。また、エクスポート定義を選択済みリストにドラッグアンドドロップすると、その定義に含まれるすべてのリストを自動的に追加することができます。
- エクスポート定義に必要なリストがすべて含まれるようになるまで、選択済みリストにリストのドラッグアンドドロップを続けます。
-
定義からリストを削除するには、削除 () をクリックします。エクスポート定義の作成時に Raw タイプエクスポートのシステムリストを削除することはできませんが、後でリストの修正アクションで削除することができます。
- 終了したら、次へをクリックします。
- 任意の作業: エクスポートリストに短いタイトルを入力します。ワークベンチはこの短いタイトルをエクスポートパッケージ内のリストのファイル名として使用し、SDTM エクスポート のドメイン列に入力するために使用します。
- 任意の作業: エクスポートリストのタイトルを編集します。
- 保存をクリックします。
このエクスポート定義のエクスポートパッケージを生成してダウンロードすることができるようになります。
エクスポートリストの作成: エクスポート定義にリストを追加すると、そのリストのコピーがエクスポートリストとして作成されます。エクスポートリスト上で行うアクションは、そのリストのみに適用され、元のコアまたはカスタムリストには適用されません。
エクスポート定義ワークフロー
すべてのエクスポート定義は、下書きステータスで開始します。定義内の各リストも下書きで開始します。すべてのリストが準備完了としてマークされると、エクスポート定義は公開済みステータスに移行します。リストが無効になった場合、エクスポート定義は下書きステータスに移行します。公開済みに戻すには、無効なリストを削除または更新する必要があります。リストが下書きに戻った場合、エクスポート定義も下書きステータスに戻ります。
下書きまたは公開済みステータスにあるエクスポート定義に対して、エクスポートパッケージを生成することができます。
エクスポートリストまたはエクスポート定義のステータスを確認するには、ステータスバッジを参照してください。ステータスバッジは、定義リスト、定義内リストのリスト、およびリストページに表示されます。
リストを準備完了とマークする方法
エクスポートリストを準備完了とマークするには:
- ワークベンチ > エクスポート > 定義で、エクスポートリストを開きます。
- リストが準備完了の状態にあることを確認します。
- ステータストグルで、準備完了をクリックします。
ステータストグルの下書きをクリックしてリストを下書きステータスに戻すことができます。
エクスポート変更検知
エクスポート定義を作成すると、エクスポートリストで構成されます。これらのエクスポートリストは、エクスポートリストの作成元となったリストのスナップショットです。「親リスト」とは、エクスポートリストを作成するためのソースとして使用されたリストを指します。親リストの CQL 構文がアップストリームで更新されると、場合によってはエクスポートリストの CQL 文が親リストの構文と同期しなくなることがあります。これにより、エクスポートパッケージのリスト構造が古くなる場合があります。例えば、公開カスタムリストの CQL 文が更新された場合、その親リストから作成されたエクスポートリストには、エクスポートリストが作成された元の文が引き続き反映されます。
CDB は、特定のトリガーポイントで、エクスポート定義のエクスポートリストの親リストに変更がないかどうかをチェックします。ユーザが親リストを変更すると、CDB はエクスポート定義に変更のインジケータを表示します。次に、任意の作業として CQL の変更をレビューし、エクスポートリストを親と同期させるかどうかを選択できます。
エクスポートリストを親と同期させるには、エクスポート定義の所有者であるか、Vault オーナーセキュリティプロファイルを有している必要があります。
検出された変更
CDB は同じ環境内での変更のみを検出し、異なる環境間での変更は検出しません。
CDB は以下のような変更を検出します:
- カスタムリスト用の CQL 文の更新
- ビューが直接エクスポートの一部であった場合の、ビューリストの CQL 文の更新
- Raw または SDTM タイプのエクスポート定義で使用されるコアリストに適用される、新規項目または項目グループなどのスタディデザインへの変更
- 子リストがエクスポートリストとして使用される親リストの CQL 文の更新
CDB は、None タイプを使用したエクスポート定義でそのリストが使用される場合、コアリストに適用されるスタディデザインの変更を考慮しません。スタディデザインで、それらの変更を考慮するよう選択します *。
CDB は、コメント (1 行または複数行)、改行およびリターン、タブ、余分なスペース (1 行または末尾のスペースを含む) を変更として考慮しません。ただし、[変更比較] パネルでは、これらの違いが引き続き強調表示されます。
CDB は、リストの名前またはその他のプロパティの更新を変更として考慮しません。
CDBは、以下のイベントについて変更をチェックします:
- スワップ (インポートが正常に行われた後、新しいデータが利用可能になった場合): CDB はエクスポート定義全体にわたって変更をチェックします。
- 公開カスタムリストまたはビューに対する CQL 文の保存済みの変更: CDB は、変更が加えられたリストまたはビューを含むエクスポート定義に変更があるかどうかをチェックします。
- デプロイ: CDB デプロイされたリストまたはビューを含むエクスポート定義内の変更をチェックします。
CQL 変更のレビュー
変更をレビューするには:
- エクスポート > 定義に進みます。
- 影響をクリックして変更によって影響を受ける物だけを表示するようエクスポート定義のリストをフィルタリングします。
- クリックして変更を含むエクスポート定義を開きます。
-
影響をクリックしてエクスポート定義のリストで親と同期していないものだけを表示するようフィルタリングします。
-
レビューするリストの比較をクリックします。これにより、変更比較パネルが開きます。
- 変更内容の確認
- レビューの終了後、親と同期させたくない場合は、閉じる () をクリックしてパネルを閉じます。
変更をレビューしたら、リストを親と同期させることができます。
親との同期
エクスポートリストを親と同期させるには:
- 影響を受けるエクスポート定義に移動します。
- 影響をクリックしてエクスポート定義のリストで親と同期していないものだけを表示するようフィルタリングします。
- 同期するリストの比較をクリックします。
- 変更比較パネルで、親と同期をクリックします。
- 確認ダイアログで、確認をクリックします。
複数のエクスポートリストを親と同期させるには:
- 影響を受けるエクスポート定義に移動します。
- 影響をクリックしてエクスポート定義のリストで親と同期していないものだけを表示するようフィルタリングします。
- 同期させる各リストのエクスポートリストチェックボックスを選択します。
- 任意の作業: すべて選択チェックボックスを選択して、現在のページのリストのすべてを選択します。
-
親と同期をクリックします。
- 確認ダイアログで、確認をクリックします。
エクスポート定義の編集
エクスポート定義の作成後、後で戻って含めるリストの変更、定義のプロパティの編集、およびリストの名前の変更を行うことができます。
定義を保存できるのはその定義の作成者のみです。別の人のリストに変更を加えるには、そのリストのコピーを作成して、それに変更を加えることができます。
リストの名前を変更する方法
エクスポート定義では、エクスポートリストの名前を簡単に変更できます。ここでリストの名前を変更すると、エクスポートリストの名前のみが変更されます。元のデータリストの名前は変更されません。
リストの名前を変更するには:
- エクスポート > 定義に進みます。
- エクスポート定義を開きます。
-
エクスポートリストテーブルで、編集 () をクリックして編集モードに入ります。
-
テキストフィールドに新しいリスト名を入力します。
- 表示 () をクリックして表示モードに戻り、変更を保存します。
含められたリストを修正する方法
エクスポート定義からリストを追加および削除することができます。
含められたリストを修正するには:
- エクスポート > 定義に進みます。
- エクスポート定義をクリックして開きます。
-
アクションメニュー () から、リストを選択を選択します。
- オプション: 展開または折りたたみをクリックして、リストカテゴリおよびエクスポート定義を展開、または折りたたむことができます。ワークベンチは、エクスポート定義で、カテゴリ別に利用可能なリストとエクスポート定義によりリストをグループ化します。
-
利用可能なリストから、リストまたはリストカテゴリを選択済みリストにドラッグアンドドロップします。また、エクスポート定義を選択済みリストにドラッグアンドドロップすると、その定義に含まれるすべてのリストを自動的に追加することができます。
- エクスポート定義に必要なリストがすべて含まれるようになるまで、選択済みリストにリストのドラッグアンドドロップを続けます。
-
定義からリストを削除するには、削除 () をクリックします。
- 次へをクリックします。
- 任意の作業: エクスポートリストに短いタイトルを入力します。ワークベンチは、この短いタイトルをエクスポートパッケージのリストのファイル名として使用します。
- 任意の作業: エクスポートリストのタイトルを編集します。
- 保存をクリックします。
エクスポート定義プロパティを編集する方法
エクスポート定義のプロパティを編集するには:
- エクスポート > 定義に進みます。
- エクスポート定義をクリックして開きます。
-
エクスポート 定義() メニューから、プロパティを選択します。
-
プロパティダイアログで、編集をクリックします。
-
必要に応じてプロパティを編集します。
- 保存をクリックします。
エクスポート定義のコピー
名前を付けて保存を使用してエクスポート定義をコピーすることができます。
エクスポート定義をコピーするには:
- エクスポート > 定義に進みます。
- エクスポート定義をクリックして開きます。
-
エクスポート定義 () メニューから、名前を付けて保存を選択します。
![[名前を付けて保存] アクション](/ja/gr/img/workbench/export/save-as-action.png)
- 任意の作業: 新規のエクスポート定義にタイトルを入力します。デフォルトでは、タイトルは元の定義タイトルに「2」が付加されたものになります。
- 任意の作業: 説明を入力します。
- 保存をクリックします。
エクスポート定義の削除
エクスポート定義を削除できるのはその定義の作成者のみです。
エクスポート定義を削除するには:
- エクスポート > 定義に進みます。
- リストの中でエクスポート定義特定します。
- エクスポート () メニューから、削除を選択します。
エクスポートパッケージの生成およびダウンロード
既存のエクスポート定義から、CSV または SAS ファイルとマニフェストファイルのセットとしてエクスポートパッケージを生成してダウンロードすることができます。
- エクスポート > 定義に進みます。
- リストの中でエクスポート定義特定します。
-
エクスポート () メニューから、パッケージの生成を選択します。
- エクスポートの形式として、CSV または SAS を選択します。
- ワークベンチがパッケージを生成したら、ダウンロード () をクリックしてエクスポートパッケージ (ZIP) をダウンロードします。
エクスポートパッケージの失効: エクスポートパッケージのが生成後、最大で 30 日間ダウンロードすることが可能です。30 日後にパッケージは失効し、ユーザはダウンロードするためにパッケージを再度生成する必要があります。エクスポートパッケージが変更された場合、その時点から 30 日間の有効期限が再度開始されます。
マニフェストファイル例
マニフェストファイルは、システムによって生成されたリストと 1 つのコアリストで構成され、それぞれに次の内容が記載されます:
- ファイルの作成に使用された CQL の説明
- 列のリストおよびその説明
- 項目、名前、タイプ、項目タイプ、項目ラベル、ソース、フォームなどの属性の場合
- コードリスト項目、コード、およびデコードの場合
マニフェストファイル例については以下を参照してください。
制限付きデータ: エクスポートパッケージが盲検化されている場合、マニフェストファイルには、各盲検化項目の盲検化属性が示されます。
{
"study" : "Cholecap_DEV1",
"exportname" : "Raw_Export",
"exportstartdatetime" : "2024-03-11 18:05:10",
"filecount" : 6,
"data" : [ {
"filename" : "adverse_events.csv",
"dateapplied" : "2024-03-11 17:39:54",
"cql" : "SELECT\n `@HDR`.`Study`.`Name`\n, `@Form`.`DataSource`\n, `@HDR`.`Site`.`Number`\n, `@HDR`.`Subject`.`Name`\n, `@HDR`.`EventGroup`.`Name`\n, `@HDR`.`EventGroup`.`SeqNbr`\n, `@HDR`.`Event`.`Name`\n, `@HDR`.`Event`.`Date`\n, `@HDR`.`Event`.`Status`\n, `@Form`.`Name`\n, `@Form`.`SeqNbr`\n, `@ItemGroup`.`SeqNbr`\n, `@Form`.`LastModifiedDate`\n, `EDC.adverse_events`.`common_forms_ig`.`adverse_event_term` `adverse_event_term`\n, codedstatus(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`) `CodingStatus`\n, codeddictrel(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`) `DictionaryRelease`\n, codedcode(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`, 'LLTCD') `LLTCD`\n, codedterm(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`, 'LLT') `LLT`\n, codedcode(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`, 'PTCD') `PTCD`\n, codedterm(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`, 'PT') `PT`\n, codedcode(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`, 'HLTCD') `HLTCD`\n, codedterm(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`, 'HLT') `HLT`\n, codedcode(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`, 'HLGTCD') `HLGTCD`\n, codedterm(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`, 'HLGT') `HLGT`\n, codedcode(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`, 'SOCCD') `SOCCD`\n, codedterm(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`, 'SOC') `SOC`\n, codedterm(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`, 'Primary Path') `PrimaryPath`\n, codedby(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`) `LastCodedBy`\n, lastcoded(`EDC.adverse_events`.`common_forms_ig.adverse_event_term`) `LastCodedDate`\n, `EDC.adverse_events`.`common_forms_ig`.`start_date` `start_date`\n, rawdate(`EDC.adverse_events`.`common_forms_ig`.`start_date`) `start_date_RAW`\n, `EDC.adverse_events`.`common_forms_ig`.`end_date` `end_date`\n, rawdate(`EDC.adverse_events`.`common_forms_ig`.`end_date`) `end_date_RAW`\n, `EDC.adverse_events`.`common_forms_ig`.`serious` `serious`\n, `EDC.adverse_events`.`common_forms_ig`.`outcome` `outcome`\nFROM\n `EDC`.`adverse_events`\nWHERE ((`@Form`.`Status` = 'submitted__v') OR (`@HDR`.`Event`.`Status` IN ('did_not_occur__v')))\n",
"columns" : [ {
"name" : "Study.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.DataSource",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Number",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Subject.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "EventGroup.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "EventGroup.SeqNbr",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "Event.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Event.Date",
"type" : "DATE",
"source" : "EDC"
}, {
"name" : "Event.Status",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.SeqNbr",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "ItemGroup.SeqNbr",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "Form.LastModifiedDate",
"type" : "DATETIME",
"source" : "EDC"
}, {
"name" : "adverse_event_term",
"type" : "VARCHAR",
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "CodingStatus",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "DictionaryRelease",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "LLTCD",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "LLT",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "PTCD",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "PT",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "HLTCD",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "HLT",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "HLGTCD",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "HLGT",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "SOCCD",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "SOC",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "PrimaryPath",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "LastCodedBy",
"type" : "INTEGER",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "LastCodedDate",
"type" : "DATETIME",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Adverse Event Term",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "start_date",
"type" : "DATE",
"itemlabel" : "Start Date",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "start_date_RAW",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "Start Date",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "end_date",
"type" : "DATE",
"itemlabel" : "End Date",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "end_date_RAW",
"type" : "VARCHAR",
"itemtype" : [ "cdbderived" ],
"itemlabel" : "End Date",
"source" : "EDC",
"form" : "adverse_events"
}, {
"name" : "serious",
"type" : "VARCHAR",
"datatype" : "codelist",
"itemlabel" : "Serious",
"source" : "EDC",
"form" : "adverse_events",
"code_decode" : [ {
"code" : "Y",
"decode" : "Yes"
}, {
"code" : "N",
"decode" : "No"
} ]
}, {
"name" : "outcome",
"type" : "VARCHAR",
"itemlabel" : "Outcome",
"source" : "EDC",
"form" : "adverse_events"
} ]
}, {
"filename" : "Sys_Forms.csv",
"dateapplied" : "2024-03-11 17:39:54",
"cql" : "CALL SYS_FORMS",
"columns" : [ {
"name" : "Study.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Country",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Number",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.PI",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Subject.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Subject.Status",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "EventGroup.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "EventGroup.SeqNbr",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "Event.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Event.Date",
"type" : "DATE",
"source" : "EDC"
}, {
"name" : "Event.Status",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.SeqNbr",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "Form.Status",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.CreatedDate",
"type" : "DATETIME",
"source" : "EDC"
}, {
"name" : "Form.SubmissionDate",
"type" : "DATETIME",
"source" : "EDC"
}, {
"name" : "Form.SubmissionCount",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "Form.ILB",
"type" : "BOOLEAN",
"source" : "EDC"
}, {
"name" : "Form.ILBReason",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.SDV",
"type" : "BOOLEAN",
"source" : "EDC"
}, {
"name" : "Form.SDVDate",
"type" : "DATETIME",
"source" : "EDC"
}, {
"name" : "Form.DMR",
"type" : "BOOLEAN",
"source" : "EDC"
}, {
"name" : "Form.DMRDate",
"type" : "DATETIME",
"source" : "EDC"
}, {
"name" : "Form.Frozen",
"type" : "BOOLEAN",
"source" : "EDC"
}, {
"name" : "Form.FrozenDate",
"type" : "DATETIME",
"source" : "EDC"
}, {
"name" : "Form.Locked",
"type" : "BOOLEAN",
"source" : "EDC"
}, {
"name" : "Form.LockedDate",
"type" : "DATETIME",
"source" : "EDC"
}, {
"name" : "Form.Signed",
"type" : "BOOLEAN",
"source" : "EDC"
}, {
"name" : "Form.SignatureDate",
"type" : "DATETIME",
"source" : "EDC"
}, {
"name" : "Form.LastModifiedDate",
"type" : "DATETIME",
"source" : "EDC"
}, {
"name" : "Form.Version",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.ExternalID",
"type" : "VARCHAR",
"source" : "EDC"
} ]
}, {
"filename" : "Sys_ILB.csv",
"dateapplied" : "2024-03-11 17:39:54",
"cql" : "CALL SYS_ILB",
"columns" : [ {
"name" : "Study.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Number",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Subject.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "EventGroup.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "EventGroup.SeqNbr",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "Event.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.SeqNbr",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "ItemGroup.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "ItemGroup.SeqNbr",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "Item.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "ILB Reason",
"type" : "VARCHAR",
"source" : "EDC"
} ]
}, {
"filename" : "Sys_Links.csv",
"dateapplied" : "2024-03-11 17:39:54",
"cql" : "CALL SYS_LINKS",
"columns" : [ {
"name" : "Study.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Country",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Number",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Subject.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "EventGroup.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "EventGroup.SeqNbr",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "Event.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.SeqNbr",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "ItemGroup.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "ItemGroup.SeqNbr",
"type" : "INTEGER",
"source" : "EDC"
}, {
"name" : "FormLink.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Form.LinkCreatedDate",
"type" : "DATETIME",
"source" : "EDC"
}, {
"name" : "Form.LinkID",
"type" : "VARCHAR",
"source" : "EDC"
} ]
}, {
"filename" : "Sys_Sites.csv",
"dateapplied" : "2024-03-11 17:39:54",
"cql" : "CALL SYS_SITES",
"columns" : [ {
"name" : "Study.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Country",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Number",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.PI",
"type" : "VARCHAR",
"source" : "EDC"
} ]
}, {
"filename" : "Sys_Subjects.csv",
"dateapplied" : "2024-03-11 17:39:54",
"cql" : "CALL SYS_SUBJECTS",
"columns" : [ {
"name" : "Study.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Country",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Site.Number",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Subject.Name",
"type" : "VARCHAR",
"source" : "EDC"
}, {
"name" : "Subject.Status",
"type" : "VARCHAR",
"source" : "EDC"
} ]
} ]
}
CDB 内のマニフェストに関する詳細情報を見るには、サードパーティデータのインポートを参照してください。
定期的なエクスポートのスケジュール
日次、週次、または月次のエクスポートをスケジュールし、エクスポートパッケージが利用可能になったことを通知するユーザを選択することができます。スケジュールされたエクスポートがパッケージの生成の終了後、エクスポート > 定義からダウンロードするか、FTPで任意の場所に配信することができます。
定期的なエクスポートをスケジュールするには:
- エクスポート > 定義に進みます。
- エクスポート定義をクリックして開きます。
- エクスポート 定義() メニューから、プロパティを選択します。
- 編集をクリックします。
- スケジュール済みのエクスポートが既に存在する場合は、スケジュールの追加をクリックします。エクスポート定義 1 つに対して、最大 5 つまでスケジュール済みエクスポートを持つことができます。CDB は、スケジュール (日付、時間、間隔、および形式が一致する) の重複を許可しません。
- スケジュールチェックボックスを選択します。
- 日付および時刻を選択します。これが最初のエクスポートの日付です。選択したインターバル (ステップ 8) が経過した後、ワークベンチは将来のエクスポートパッケージを生成します。例えば、「Weekly」および「2021 年 12 月 7 日、午前 12:00」を選択すると、ワークベンチはその時間にエクスポートパッケージを生成し、次のエクスポートは「2021 年 12 月 14 日、午前 12:00」に実行されることになります 。
- 日次、週次、または月次をインターバルとして選択します。
- 形式として、CSV または SAS を選択します。これにより、ワークベンチがエクスポートパッケージ用に生成するファイルのタイプが決定されます。
- 任意の作業: 配信チェックボックスを選択し、FTP 配信先を選択します。配信先の作成について詳しくは、FTP 配信先を参照してください。
- 保存をクリックします。
スケジュール済みエクスポートの編集方法
スケジュール済みエクスポートを編集するには:
- エクスポート > 定義に進みます。
- エクスポート定義をクリックして開きます。
- エクスポート 定義() メニューから、プロパティを選択します。
- 編集をクリックします。
- 必要に応じて、エクスポートスケジュールと配信に変更を加えます。
- 保存をクリックします。
スケジュール済みエクスポートの停止方法
スケジュール済みのエクスポートをいつでも停止させることができます。再開するまでエクスポートは行われなくなります。
スケジュール済みエクスポートを停止させるには:
- エクスポート > 定義に進みます。
- エクスポート定義をクリックして開きます。
- エクスポート 定義() メニューから、プロパティを選択します。
- 編集をクリックします。
- スケジュールチェックボックスをクリアします。
- 保存をクリックします。
FTP 接続の作成
ワークベンチは、付属する Veeva Vault FTP サーバおよびサードパーティの FTP サーバの両方の使用をサポートしています。付属の Vault FTP サーバ以外の場所を使用する予定の場合、そのサーバを既に設定しておく必要があります。
Vault オーナーセキュリティプロファイルを有するユーザは、ツール > EDC ツール > FTPから、スケジュール済みエクスポートのデスティネーションを設定できます。
Vault がカスタムスタディロールを使用する場合、そのロールには以下の権限が必要です:
| タイプ | 権限ラベル | 権限 |
|---|---|---|
| 標準タブ | EDC ツールタブ | EDC ツールタブへにアクセスする権限. |
| 機能権限 | FTP の管理 | EDC ツールで FTP接続を作成および編集する権限. |
FTP 接続をセットアップするには:
- スタディでツール > EDC ツール > FTP に進みます。
- + New FTP をクリックします。
-
FTP 名を入力します。この名前は、CDB ワークベンチのエクスポートセクションのエクスポート定義の配信ドロップダウンメニューに表示されます。
- CDB から Veeva Vault FTP にエクスポートを送信するための接続を作成する場合でも、タイプに CDBを選択します。
- ユーザ名を入力します。これは、Veeva Vault FTP サーバの場合、Vault にログインする際に使用するユーザ名で、ドメインも含め、その前にホスト名が付加されます。例: “verteopharma.veevavault.com+cordelia.hunter@verteopharma.com”
- パスワードを入力します。
- パスワードを確認します。
- FTP スキームを選択します。CDB から Veeva Vault の FTP サーバにエクスポートを送信する場合、FTPS を選択します。
- ホストを入力します。Veeva Vault FTPサーバーの場合、これが以下のような Vault の URL となります: {DNS}.veevavault.com例: “veepharm” は veepharm.veevavault.com の DNS です。
- ポートを入力します。
- パッケージを配信する場所の配信先パスを入力します。ここに入力する前に、必要に応じて FTP サーバで配信先パスを作成することができます。Veeva Vault の FTP サーバで配信先を作成するには、ユーザは API アクセス権限を持つ必要があります。
- 保存をクリックします。
接続フィールドの詳細および FTP レコードの編集方法について詳しくは、EDC ツールから FTP サーバへの接続を参照してください。
パッケージ通知の購読
CDB は、エクスポートパッケージが所定のステータスになったときに、メールによる通知を送信することができます。組織のユーザ管理者と連携して、購読を登録してください。