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

25R1 以降

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

インポートの方法

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

1. スタジオ の試験に移動します。
2. 研究対象でアイテムをクリックします。
3. アイテムのインポートを選択します。
4. インポートする CSV ファイルをここにファイルをドラッグアンドドロップエリアにドラッグアンドドロップします。このエリアをクリックしてファイルをアップロードすることもできます。
5. インポートアイテムのプレビューページが表示されます。

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

1. 研究対象 の下にある コードリスト をクリックし、コードリストのインポート を選択します。
2. インポートする CSV ファイルをここにファイルをドラッグアンドドロップエリアにドラッグアンドドロップします。このエリアをクリックしてファイルをアップロードすることもできます。
3. インポートコードリストのプレビューページが表示されます。

キャンセルをクリックすると、インポートが停止します。

セクションをインポート

インポートセクションには以下の内容が記載されています:

• ファイル名
• ファイルサイズ
• 行数

CSVテンプレートに素早くアクセスできるように、インポートセクションの下にこのヘルプページへのリンクを用意しています（CSVテンプレートのダウンロードは、コードリストとアイテムセクションを参照してください）。

結果のプレビュー表

ファイルが選択されると、自動的に処理および検証が行われます。少なくとも1つのファイルが正常に処理された場合、プレビュー結果の表が表示されます。この表には、以下のものが含まれます。

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

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

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

アイテムをインポート

インポートが成功すると、itemdefsとitem_def_codelist_defsがCDMSで再作成されます。スタジオでitemdefsを表示できます。Item_def_codelist_defsは、管理 > ビジネス管理でのみアクセスできます。

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

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

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

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

アイテム 必要な列

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

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

以下の列は任意です。

列	説明
説明	テキスト

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

インポートが成功すると、codelistdefs、codelistitemdefs、およびcodelist_def_codelist_item_defsがCDMSに再作成されます。スタジオでは、codelistdefsとcodelistitemdefsを表示できます。Codelist_def_codelist_item_defsは、管理 > ビジネス管理でのみ表示されます。

codelistdefs CSVファイルにはエラーがないはずです。スタジオ外のテンプレートで修正できる問題は、再インポートできます。コードリストのインポートが成功すると、コードリストセクションには、割り当てられたアイテムを含む個別のアイテムとして、各コードリストが表示されます。各インポートされたアイテムのプロパティは、CSVで定義されたものと同じです。テンプレートで「アイテム1」のコーダーが「1」の場合、スタジオでも同じように表示されます。

インポートされるコードリストがすでに存在する場合、エラーが表示されます。既存のコードリストを更新するには、スタジオで直接変更を加えます。

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

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

コードリスト 必要な列

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

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

以下の列は任意です。

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

隠された値は大文字と小文字が区別されます。

コードリストを識別するために、別の行を追加する必要はありません。

フォーマット

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

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

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

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

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

デフォルト値

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

バリデーションエラー

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

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