コードリストの編集

「構成ハブ」からコード・リストをチェックアウトした後、そのコード・リストを編集して、変更したコード・リストをアップロードできます。コード・リストを編集する際には、これらの考慮事項に留意することをお勧めします。

コード・リスト・ファイルの構造

コード・リストは、構成ハブからコンマ区切り値 (CSV) ファイル形式でダウンロードされます。各 CSV ファイルは、コンマを使用して各値を区切る、区切り文字で区切られているテキスト・ファイルです。

各 CSV ファイルには、CLH (コンテンツ・リスト・ヘッダー) 行、1 つの CLIH (コンテンツ・リスト項目ヘッダー) 行、および 1 つ以上の CLIV (コンテンツ・リスト項目値) 行が含まれています。

CLH (R): CLH (コード・リスト・ヘッダー) 行には、コード・リストに関する参照情報が含まれています。
重要: CLH の行や値を編集したり削除したりしないでください。
クライアント: CLIH (コード・リスト項目ヘッダー) 行には、すべてのコード・リストに使用される固定ヘッダー (列名) が含まれます。
重要: CLIH の行や値を編集したり削除したりしないでください。
CLIV (R): CLIV (コード・リスト項目値) 行には、それぞれ 1 セットの項目値が含まれています。
ヒント: CLIV 行の値を更新し、必要に応じて新しい CLIV 行を追加することができます。

コード・リストの更新方法

コード・リストは、 Configuration Hubで直接変更されることはありません。コード・リストを変更するには、コード・リストをチェックアウトし、コンマ区切り値 (CSV) ファイル用のテキスト・エディターまたはスプレッドシート・ツールを使用して編集する必要があります。コード・リストをチェックアウトすると、 Configuration Hubでそのコード・リストに変更をアップロードすることができます。

重要: CSV コード・リスト・ファイルを編集する場合は、以下の考慮事項に留意してください。

スプレッドシート・ツールは、列と行にフォーマット設定された値を使用してコード・リストを表示および編集する方法を提供します。ただし、コード・リストの値に先行ゼロが含まれている場合は、スプレッドシート・ツールを使用する際に注意する必要があります。
- コード・リストに先行ゼロのある値が含まれていないことが確実な場合は、デフォルトのファイル・オープン機能を持つスプレッドシート・ツールを使用して CSV ファイルを開くことができます。
- コード・リストに先行ゼロのある値が含まれているかどうかが不明な場合は、 Configuration Hubからコード・リストをダウンロードした後、テキスト・エディターで CSV ファイルを開きます。次に、テキスト・エディターの検索機能を使用して、 ,0を検索します。その値が検索で検出された場合、コード・リストには先行ゼロが含まれます。
- コード・リストに先行ゼロのある値が含まれている場合は、スプレッドシート・ツールのインポート機能を使用して、先行ゼロを保持します。詳しくは、コード・リストの先行ゼロの保持を参照してください。あるいは、テキスト・エディターを使用して CSV ファイルを編集することもできますが、大きなコード・リストを使用する場合は、CSV 形式が維持されるように注意してください。
前後のスペースは無視されます。
CLH の行や値を編集したり削除したりしないでください。
CLIH 行または値を編集または削除しないでください。
新しい列をファイルに追加しません。
CLIV 行の値を更新し、必要に応じて新しい CLIV 行を追加することができます。ただし、既存のコード・リスト・データを変更する場合、特にコード・リストが複数のマップによって使用される場合や、複数の取引パートナーと一緒に使用される場合は注意してください。コード・リストの変更は意図しない影響を及ぼす可能性があるため、使用されるマップまたは取引パートナーごとに、変更されたコード・リストを必ずテストしてください。
コード・リスト値に含めることができるのは、拡張 ASCII 文字、非 HTML 文字、en ダッシュ、または em ダッシュのみです。
コード・リスト CSV ファイルのファイル名は変更しないでください。
編集した CSV ファイルは必ず CSV 形式で保存してください。

コード・リスト値の特殊文字

スプレッドシート・ツールを使用して CSV ファイルを編集する場合、コード・リスト値に使用する特殊文字は、スプレッドシート・ツールによって既に処理されている可能性があります。詳しくは、スプレッドシート・ツールの資料を参照して、コンマなどの特殊文字の処理方法を確認してください。

テキスト・エディターを使用して CSV ファイルを編集していて、値にコンマが含まれている場合は、その値を二重引用符で囲む必要があります。例えば、値 blue, red は、 "blue, red"のように、CSV ファイル内で二重引用符で囲む必要があります。

最大コード・リスト・サイズ

コード・リストには最大 25,000 個の項目を含めることができますが、コード・リスト CSV ファイル全体のサイズは 3 メガバイト未満でなければなりません。

重要: コード・リストがこれらのサイズ制限を超えると、コード・リストをアップロードできません。

先頭と末尾のスペースはサポートされていません

コード・リスト値では、先頭または末尾のスペースはサポートされません。先頭または末尾のスペースはすべて削除されます。したがって、スペースのみで構成される値は、値が存在しないかのように扱われます。ただし、単語の間にスペースが含まれる値 (例えば、 blue red) では、スペースは保持されます。

コード・リスト内の先行ゼロの保持

CSV ファイルをスプレッドシート・ツールで開き、値の先行ゼロが表示されない場合は、テキスト・エディターを使用して未加工のテキスト値を表示します。数値を含むテキスト・タイプ・フィールドを数値タイプ・フィールドとしてフォーマット設定するスプレッドシート・ツールを使用してコード・リストを編集すると、先行ゼロが削除される場合があります。先行ゼロが失われると、誤ったコード置換、欠落値、データ処理の失敗、および変換の失敗が発生する可能性があります。

コード・リスト・データをスプレッドシート・ツールにインポートして、先行ゼロが削除されないようにすることができます。詳しくは、スプレッドシート・ツールの資料を参照して、デフォルトでツールに先行ゼロを表示する方法を判別してください。

Microsoft™ Excel（Windows™オペレーティングシステム）を使用した先行ゼロの処理方法例

ここで説明する手順は単なる例であり、ご使用のスプレッドシート・ツールおよびオペレーティング・システムによって異なる場合があります。詳しくは、スプレッドシート・ツールの資料を参照してください。

Configuration Hubから、コード・リスト CSV ファイルをダウンロードします。
Microsoft Excel で、「インポート・ウィザード」が有効になっていることを確認します。
1. 「ファイル」メニューから「オプション」を選択します。
2. 「Excel オプション」で、「データ」を選択します。
3. 「レガシー・データ・インポート・ウィザードの表示 (Show legacy data import wizards)」セクションで、「テキストから (レガシー) (From Text (Legacy))」チェック・ボックスを選択します。
インポート・ウィザードが使用可能になったら、「ファイル」>「新規」を選択し、「ブランクのワークブック」を選択します。
「データ」メニューから、「データの取得」>「レガシー・ウィザード」>「テキストから (レガシー)」を選択します。
「テキスト・ファイルのインポート」ダイアログ・ボックスで、適切なコード・リストを選択し、「インポート」をクリックします。
「テキスト・インポート・ウィザード-ステップ 1/3」で、「区切り」オプションが選択されていることを確認し、「次へ」をクリックします。
「テキスト・インポート・ウィザード-ステップ 2/3 (Text Import Wizard-Step 2 of 3)」で、「タブ」チェック・ボックスをクリアし、「コンマ」チェック・ボックスを選択します。「次へ」をクリックします。
「テキスト・インポート・ウィザード-ステップ 3/3 (Text Import Wizard-Step 3 of 3)」の「データのプレビュー (Data preview)」セクションで、キーボードの SHIFT キーを押したまま、すべての列をクリックして選択 (強調表示) します。次に、「列データ・フォーマット」セクションで「テキスト」を選択し、「終了」をクリックします。
「データ・ファイルのインポート」ダイアログ・ボックスで、「既存のワークシート」を選択し、「OK」をクリックします。
ヒント: コード・リスト・データがインポートされ、先行ゼロが保持されていることを確認してください。先行ゼロ付きの新しい値をコード・リストに追加すると、それらの先行ゼロも保持されます。
コード・リストに必要な変更を加えます。
「ファイル」メニューから、「名前を付けて保存」を選択します。
「名前を付けて保存」ダイアログ・ボックスで、「参照」をクリックします。
1. 「タイプとして保存」で、「CSV (コンマ区切り) (*.CSV)」を選択します。
  重要: コード・リストをタイプ CSV UTF-8として保存しないでください。
2. 「ファイル名」に、元のコード・リスト CSV ファイル名を入力します。
3. 保存をクリックします。これで、変更したコード・リストを Configuration Hubにアップロードできます。

Microsoft Excel (macOS オペレーティング・システム) を使用して先行ゼロを処理する方法の例

Configuration Hubから、コード・リスト CSV ファイルをダウンロードします。
Microsoft Excel で、「ファイル」>「新規」を選択し、「ブランク・ブック」を選択します。
「ファイル」メニューから、「インポート」を選択します。
「インポート」ダイアログ・ボックスで、「CSV ファイル」オプションが選択されていることを確認します。次に、該当するコード・リストを選択して、「インポート」をクリックします。
コード・リスト CSV ファイルを選択し、「データの取得」をクリックします。
「テキスト・インポート・ウィザード-ステップ 1/3」で、「区切り」オプションが選択されていることを確認し、「次へ」をクリックします。
「テキスト・インポート・ウィザード-ステップ 2/3 (Text Import Wizard-Step 2 of 3)」で、「タブ」チェック・ボックスをクリアし、「コンマ」チェック・ボックスを選択します。「次へ」をクリックします。
「テキスト・インポート・ウィザード-ステップ 3/3 (Text Import Wizard-Step 3 of 3)」の「選択したデータのプレビュー (Preview of selected data)」セクションで、キーボード上の SHIFT キーを押しながら、すべての列をクリックして選択 (強調表示) します。次に、「列データ・フォーマット」セクションで「テキスト」を選択し、「終了」をクリックします。
「データのインポート」ダイアログ・ボックスで、「既存のシート」を選択し、「OK」をクリックします。
ヒント: コード・リスト・データがインポートされ、先行ゼロが保持されていることを確認してください。先行ゼロ付きの新しい値をコード・リストに追加すると、それらの先行ゼロも保持されます。
コード・リストに必要な変更を加えます。
「ファイル」メニューから、「名前を付けて保存」を選択します。
「名前を付けて保存」ダイアログ・ボックスで、「参照」をクリックします。
1. 「ファイル・フォーマット」から、「コンマ区切り値 (CSV)」を選択します。
  重要: コード・リストをタイプ CSV UTF-8として保存しないでください。
2. 「名前を付けて保存」で、元のコード・リスト CSV ファイル名を選択または入力します。
3. 保存をクリックします。これで、変更したコード・リストを Configuration Hubにアップロードできます。