コードリストとアイテムのインポート

Studioでスタディをデザインする際、CSVテンプレートをインポートして、アイテムコードリストを自動的に作成することができます。スタディにつき、1 つのケースブックバージョンをインポートすることができます。

前提条件

CDMS スタディデザイナーおよび CDMS スーパーユーザーおよびCDMS API Read Write試験ロールを持つユーザは、デフォルトで下記のアクションを実行することができます。組織がカスタム試験ロールを使用する場合、お客様のロールに以下の権限が付与されている必要があります:

タイプ 権限ラベル 制御
標準タブ Studio タブ

Studio タブへのアクセス権限

機能権限 スタディのデザイン

Studio からスタディデザイン定義とスタディスケジュールを作成する権限

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

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


項目のインポートが成功すると、項目定義項目定義 - コードリスト定義が EDC に再作成されます。項目定義を Studio で表示できます。項目定義 - コードリスト定義は、管理 > ビジネス管理内でのみアクセス可能です。コードリストのインポートが成功すると、コードリスト定義コードリスト項目定義コードリスト定義 - コードリスト項目定義が EDC に再作成されます。コードリスト定義コードリスト項目定義は Studio で表示できます。コードリスト定義 - コードリスト項目定義管理 > ビジネス管理内でのみ表示されます。

コードリストのインポート

1 つのコードリストにつき、2,000 項目までインポートできます。

コードリストをインポートするには:

  1. スタジオ の試験に移動します。
  2. 研究対象コードリストをクリックします。 選択済みスタディオブジェクトメニューコードリスト

  3. コードリストをインポートをクリックします。 コードリストメニューをインポート

  4. インポートする CSV ファイルをここにファイルをドラッグアンドドロップエリアにドラッグアンドドロップします。このエリアをクリックしてファイルをアップロードすることもできます。
  5. オプション: キャンセルをクリックすると、インポートが停止します。

CSV ファイルにエラーがある場合は、Studio の外部で修正し、再度インポートします。コードリストのインポートが成功すると、コードリストセクションには、割り当てられたアイテムを含む個別のアイテムとして、各コードリストが表示されます。各インポートされたアイテムのプロパティは、CSVで定義されたものと同じです。テンプレートで「アイテム1」のコーダーが「1」の場合、スタジオでも同じように表示されます。インポートされるコードリスト定義がすでに存在する場合、エラーが表示されます。既存のコードリストを更新するには、スタジオで直接変更を加えます。

インポートセクションと結果のプレビュー表

コードリストの CSV テンプレートのインポート

以下のテンプレートをインポートファイルとして使用します。

コードリストインポート用テンプレートのダウンロード

コードリスト 必要な列

アイテムのインポートファイルには、以下のコードリストが必要です。

データタイプ
コードリスト名 テキスト(最大128文字)
コードリスト外部 ID テキスト(最大128文字)
コードリストの説明 説明
コードリスト項目注文 数字 (0-9,999)
コードリスト項目コード テキスト(最大100文字)
コードリスト項目ラベル テキスト(最大1,500文字)
非表示 ブール値(はい/いいえ)

以下の列は任意です。

データタイプ
コードリストの説明 テキスト(最大256文字)
コードリスト項目の説明 テキスト(最大255文字)

隠された値は大文字と小文字が区別されます。コードリストを識別するために、別の行を追加する必要はありません。

アイテムをインポート

可用性: 項目のインポート機能はデフォルトで無効化されています。有効化についての詳細は Veeva のサービス担当者までお問い合わせください。

アイテムをインポートするには:

  1. スタディ対象アイテムをクリックします。 選択されたスタディ対象メニューアイテム

  2. 項目をインポートをクリックします。 コードリストメニューをインポート

  3. インポートする CSV ファイルをここにファイルをドラッグアンドドロップエリアにドラッグアンドドロップします。このエリアをクリックしてファイルをアップロードすることもできます。
  4. オプション: キャンセルをクリックすると、インポートが停止します。

アイテムが正常にインポートされると、アイテムセクションには、CSVファイルの各アイテムが個別のエントリとして表示され、プロパティはCSVで定義されたものと同じになります。例えば、アイテムのデータタイプが「時間」に設定されている場合、このプロパティはスタジオに反映されます。CSV ファイルにエラーがある場合は、Studio の外部で修正し、再度インポートします。

すでにシステム内に項目定義が存在する場合、再度インポートしようとするとエラーが発生します。既存のアイテムを更新するには、スタジオで直接変更を加えます。インデント、制御するアイテム、プログレッシブディスプレイなど、CSVに含まれていないプロパティは、インポート後にスタジオで手動で更新する必要があります。

インポート項目 CSV テンプレート

以下のテンプレートをインポートファイルとして使用します。

アイテムインポート用テンプレートのダウンロード

アイテム 必要な列

アイテムのインポートファイルには、以下の項目が必要です。

説明
項目名 テキスト
外部 ID テキスト
ラベル テキスト
項目タイプ テキスト; Veevaの価値。オプション:EDC、ステータス、ヘッダー、読み取り専用、派生
データタイプ テキスト; Veevaの価値。オプション:テキスト、日付、日時、時間、ブーリアン、URL、コードリスト、ラベル、数値、単位
コードリスト定義 テキスト.既存のコードリスト定義と一致する必要があります。

* データタイプがコードリストの場合に必要です。
単位定義 テキスト.既存のユニットコードリストの項目定義と一致する必要があります。

* データタイプが単位に等しい場合は必須です。

以下の列は任意です。

説明
説明 テキスト

CSV ファイルを選択すると、インポートページのここにドラッグアンドドロップするエリアに、ファイル名、ファイルサイズ、CSV の行数が表示されます。

このヘルプページへのリンクは、ここにドラッグアンドドロップする エリアの下にあり、両方の CSV テンプレートに素早くアクセスできます (コードリスト項目のセクションを参照し、CSV テンプレートをダウンロードしてください)。

結果のプレビュー表

少なくとも 1 つのファイルが正常に処理されると、インポートページにプレビュー結果の表が表示されます。表には、以下のものが含まれます:

  • 処理されたレコードの総数
  • 検証を通過したレコード数
  • 検証に失敗したレコード数
  • 結果テーブルのインポートステータス列
  • 各テンプレートカラムの結果カラム(カラムはソート不可)
  • ページ上の検索結果件数

エラー、警告インポート準備完了の3つのステータスに基づいてレコードをフィルタリングできます。

ページ上のナビゲーションオプションを使用すると、次の検索結果ページに進むか、前のページに戻るかを選択できます。また、特定のページ番号を入力して、その検索結果ページに直接ジャンプし、より素早くアクセスすることもできます。

フォーマット

インポート後には、シーケンシャルな注文番号と受け入れられるフィールド文字が検証されます。

コード表の場合、注文番号が連続していない場合、システムは最後の有効な番号に基づいて番号を自動的に再割り当てします。例えば、コードリストに1、10、3と番号が振られた3つのアイテムがある場合、10は3に再割り当てされ、3は2になります。

フィールドには、以下の文字のみが使用できます。

  • a-z, A-Z
  • 0-9
  • ハイフン(-)
  • 単一のアンダースコア(_)

無効な文字が連続して検出された場合、そのレコードにエラーメッセージが表示されます。

デフォルト値

テンプレートに含まれていない必須プロパティには、デフォルト値が自動的に設定されます。これらの値は、スタジオで更新できます。ブール値のデータ型を除き、すべてのアイテム定義はデフォルトで必須となります。コードリストまた単位データタイプのアイテムをインポートするには、既存のコードリストまたは単位定義を参照する必要があります。行が存在しないオブジェクトを参照している場合、エラーが発生し、ファイルをインポートできません。これを解決するには、まず不足しているコードリストまたはユニット定義をインポートするか、ファイルから参照を削除します。

バリデーションエラー

次の表は、考えられるバリデーションエラーとその説明の一覧です:

エラー 説明
インポートファイルに以下の列がありません: CSVファイルはまったく処理できません。例えば、間違ったファイルが選択されていました。
インポートファイルに以下の列の見出しが欠落しています:[カンマで区切られた欠落した列の見出しのリスト] 列が欠けています。
[カンマで区切られた欠落した列の見出しのリスト]が必要です。 必要な値が欠落しています。
カンマ区切りの超過列ヘッダーの値] が文字制限を超えています。 値がそれぞれのテキストフィールドの制限文字数を超えています。
[列名] の値 [列の値] は無効です。 それぞれの選択リスト、ブール値、数値フィールドでは、値が受け入れられません。
注文番号がアイテムに対して一意ではありません 特定のコードリストに対して、注文番号は一意ではありません。
ファイル内のエントリを複製する 2つ以上の行が同じアイテム名(アイテムのインポートの場合)またはコードリスト名コードリストアイテムラベル(コードリストのインポートの場合)を共有します。