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

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

前提条件

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

タイプ	権限ラベル	制御
標準タブ	Studio タブ	Studio タブへのアクセス権限
機能権限	スタディのデザイン	Studio からスタディデザイン定義とスタディスケジュールを作成する権限

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

試験ロールについて詳しくご確認ください。

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

インポートの方法

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

スタジオの試験に移動します。
研究対象でコードリストをクリックします。
コードリストをインポートをクリックします。
インポートする CSV ファイルをここにファイルをドラッグアンドドロップエリアにドラッグアンドドロップします。このエリアをクリックしてファイルをアップロードすることもできます。
オプション: キャンセルをクリックすると、インポートが停止します。

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

スタジオでコードリストを作成する方法について説明します。

フォーマット

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

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

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

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

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

デフォルト値

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

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

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

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

必須列

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

列	データタイプ
コードリスト名	テキスト（最大128文字）
コードリスト外部 ID	テキスト（最大128文字）
コードリスト項目注文	数字 (1 - 2,000)
コードリスト項目コード	テキスト（最大100文字）
コードリスト項目ラベル	テキスト（最大256文字）

以下の列は任意です。

列	データタイプ
コードリストの説明	テキスト（最大256文字）
コードリスト項目の説明	テキスト（最大255文字）
非表示	ブール値（はい/いいえ）

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

インポートページのナビゲーション

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

このヘルプページへのリンクは、ファイルをここにドラッグアンドドロップエリアの下にあり、CSV テンプレートに素早くアクセスできます。

結果のプレビュー表

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

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

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

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

エラーの管理

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

バリデーションエラー

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

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