マトリクスローダーの CSV フィールドとフィールドオプションのアップロードとエクスポート

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：9分

    • マトリクスローダーを使用して、 CPQのフィールド、フィールドオプション、および製品ピッカーを一括作成、編集、およびエクスポートします。サポートされている列と形式を使用して CSV ファイルでデータを定義し、アップロードまたはダウンロードすると、構成管理と環境移行が迅速化されます。

    CSV フィールドのアップロード

    すべてのフィールドタイプは、マトリクスローダーを使用して追加および編集できます。このセクションでは、リーダーがスプレッドシートファイル(Google Sheets、Microsoft Excelなど)で作業し、結果をCSVファイルにエクスポートしてマトリクスローダーにアップロードすることを前提としています。このトピックでは、マトリクスローダーがフィールドアップロードで受け入れる列とデータの概要を説明します。

    表 : 1. CSV ファイル列
    列名 説明 有効な値 メモ
    field_type フィールドのデータ型を定義します テキスト |textField ブール値 |booleanField 数値 |numberField ピックリスト |ピックリストフィールド 必須
    name アドミンのフィールドリストに表示される名前 管理ページ 有効な文字列は、文字、数字、スペース、および特殊文字 {}[]()|\~'_^@?<=>;:/.-,+*ʼ&%$#"! 必須
    variableName フィールドを参照するために使用される個別の文字列 有効なフィールド変数名は、最大 128 文字の英字、数字、アンダースコアで構成されます。最初と最後の文字は文字または数字である必要があります。 必須;一意である必要があります
    required 現在、アプリケーションで使用されていません

    TRUE |誤り

    <空>

    		 オプション。現在アプリケーションで使用されていません
    defaultValue 構成エクスペリエンスの開始時にフィールドに初期値を指定します [注を参照]

    オプション。textField、booleanField、numberField、および単一の pickListField にのみ関連します。複数の pickListFields は、fieldOptions アップロードファイルのデフォルトを設定します。
    minLength 受け入れられる最小文字数 <番号> オプション。textField にのみ関連
    maxLength 受け入れられる最大文字数 <番号> オプション。textField にのみ関連
    精度 小数点以下の右側に精度の桁を定義します <番号> オプション。numberField にのみ関連
    最小値 受け入れられる最小数値 <番号> オプション。numberField にのみ関連
    maxValue 許容される最大数値 <番号> オプション。numberField にのみ関連
    selectType pickListField が単一選択か複数選択かを定義します

    単一 複数

    <空>

    		 オプション。PickListField にのみ関連します。<empty> の場合、単一と見なされます
    注:
    フィールドに定義済みの値がある場合、デフォルト値は定義済みの値のいずれかに準拠する必要があります。例：
    • 有効なブールフィールドのデフォルト値は TRUE と FALSE です。
    • 数値フィールドに minValue または maxValue が定義されている場合、指定されたデフォルト値は定義に準拠している必要があります。
    • 単一の pickListField のデフォルト値は、フィールドに定義されているオプション値と一致する必要があります。このオプション値は、フィールド CSV ファイルと同じバッチでマトリクスローダーによって処理されるフィールドオプション CSV ファイルで定義できます。
    • テキストフィールドの値は 2,000 文字に制限されています。

    列の順序は固定されていません。利便性を高めるために、アドミンはスプレッドシート内の列と結果の CSV ファイルを並べ替えることができます。

    フィールドアップロードの説明ファイルには、マトリクスローダーによって受け入れられるさまざまなフィールドとフィールドパラメーターが表示されます。背景がグレーのセルは、セルが行のコンテキストに関連していないことを示します。説明ファイルをダウンロードするには、マトリクスローダーで、[サンプルファイル]セクションの[フィールド]リンクをクリックします。

    注:
    このファイルのコンテンツは、環境にそのままアップロードされることを意図したものではありません。代わりに、形式の例を使用して、現在のプロジェクトの要件を満たすアップロードファイルを作成し、CSV 形式にエクスポートして、マトリクスローダーを使用して環境にアップロードします。

    管理 UI を介して追加されたフィールドを 1 つ以上の詳細計画に関連付ける必要があるのと同様に、マトリクスローダーを介して一括で追加されるフィールドも関連付ける必要があります。手順については、「フィールドを詳細計画に関連付ける」を参照してください。

    CSV フィールドのエクスポート

    利便性を高めるために、アドミンは次の手順を使用して、環境で定義されているフィールドとフィールドオプションの CSV ファイルをエクスポートできます。

    1. アドミンナビゲーションペインで、[ フィールド] をクリックします。

      定義されているすべてのフィールドのリストが表示されます。

    2. (オプション)検索文字列を入力して <Enter> を押して、フィールドのリストを絞り込みます。
    3. [エクスポート] をクリックします。ページの下部に一時的にメッセージが表示されます。
    4. 左下隅の通知センターをクリックします。

      CSV フィールドのエクスポート

    5. [ ダウンロード ] をクリックして CSV ファイルをダウンロードします。

      [通知] 画面

    結果の ZIP ファイルには、フィールドの CSV ファイルとフィールドオプションの CSV ファイルが含まれています。

    CSV フィールドオプションのアップロード

    フィールドオプションのアップロードでは、pickListField オプションと属性を定義します。このセクションでは、リーダーがスプレッドシートファイル(Google Sheets、Microsoft Excelなど)で作業し、結果をCSVファイルにダウンロード/エクスポートしてマトリクスローダーにアップロードすることを前提としています。以下は、マトリクスローダーがフィールドオプションのアップロードで受け入れる列とデータの概要です。

    表 : 2. CSV ファイル列
    列名 説明 有効な値 メモ
    variableName この行のオプションが追加されるフィールドの変数名 <field variableName> 必須
    name エンドユーザーに表示されるオプション名 有効な文字列は、文字、数字、スペース、および特殊文字 {}[]()|\~'_^@?<=>;:/.-,+*ʼ&%$#"! 必須
    value フィールドオプションを参照するために使用する個別の文字列 有効なフィールドオプション変数名は、最大 128 文字の文字、数字、アンダースコアで構成されます。最初と最後の文字は文字または数字である必要があります。フィールドオプション変数名は、同じフィールドのスコープ内で一意である必要があります。 必須
    defaultValue 構成エクスペリエンスの開始時にフィールドに初期値を指定します

    TRUE FALSE

    <空>

    		 オプション。マルチ pickListFields にのみ関連
    extendedDescri トピック アドミン参照のコンテキストの説明 有効な文字列は、文字、数字、スペース、および特殊文字 {}[]()|\~'_^@?<=>;:/.-,+*ʼ&%$#"! オプション
    画像 URL 画像にはこの pickListField オプションのエンドユーザーが表示されます <URL>

    オプション。pickListField とともに使用します。

    表示タイプは VisualPicker または MultiSelectとして定義されています レイアウトで lPicker に表示されます

    フィールドアップロードの説明ファイルには、マトリクスローダーで受け入れられるさまざまなフィールドオプションとフィールドオプションパラメーターが表示されます。背景がグレーのセルは、セルが行のコンテキストに関連していないことを示します。説明ファイルをダウンロードするには、マトリクスローダーで、[サンプルファイル]セクションの[フィールド]リンクをクリックします。

    注:
    このファイルのコンテンツは、環境にそのままアップロードされることを意図したものではありません。代わりに、形式の例を使用して、現在のプロジェクトの要件を満たすアップロードファイルを作成し、CSV 形式にエクスポートして、マトリクスローダーを使用して環境にアップロードします。

    フィールドオプション CSV エクスポート

    フィールドオプションは、 CPQからフィールドをエクスポートするために使用されるのと同じモーションでエクスポートされます。手順については、上記の「CSV フィールドのエクスポート」セクションを参照してください。

    CSV アップロード:製品ピッカー

    このセクションでは、「My product picker」という名前の製品ピッカーを作成する手順の概要を説明します。これには次の製品/オプションが含まれます。

    • オプション 1/製品 1:製品 1
    • オプション 2/製品 2:製品 2
    • オプション 3/製品 3:製品 3

    製品ピッカーを作成するには、次の手順に従います。

    1. マトリクスローダーからフィールドのサンプル CSV ファイルを抽出します。

      この CSV ファイルには、製品ピッカーの作成に必要なフィールド情報が含まれている必要があります。サンプルファイルの先頭に、フィールドタイプを製品ピッカーとして指定する行を追加してください (このフィールドタイプはサンプルファイルに存在しない可能性があります)。

      CSV ファイル

    2. マトリクスローダーからフィールドオプションのサンプル CSV ファイルを抽出します。

      この CSV ファイルには、前のステップで作成したフィールドのエンドユーザー UI に表示される製品名が含まれている必要があります。

      CSV ファイル

    3. 新しい .yaml ファイルを作成します。

      このファイルには、ステップ 1 の CSV ファイルで定義されているように、製品ピッカーに含まれるフィールドが含まれている必要があります。.yaml ファイルは、マトリクスローダーでのアップロードプロセス中に 2 つの CSV ファイルをリンクするために使用されます。これがないと、製品ピッカーは作成されません。

      .yaml 構文の例: 
      ---
- variableName: myProductPicker
	fields:
	- variableName: myProductPicker.value
		target: ProductId
	- variableName: myProductPicker.select
	- variableName: myProductPicker.quantity
		target: ProductQuantity
    4. マトリクスローダーへのファイルのアップロード:前の手順の 2 つの .csv ファイルと .yaml ファイルを zip フォルダーに圧縮します。次に、マトリクスローダーに移動し、圧縮されたフォルダーをアップロードし、[ インポート]をクリックして、[ 続行]をクリックします。

      マトリクスローダー

    5. UI での検証:新しく作成された製品ピッカーは、次に示すように CPQ アドミンフィールドで使用可能になります。

      製品ピッカー

    CSV エクスポート:製品ピッカー

    製品ピッカーをエクスポートするには、アドミン CPQ フィールドをクリックします。[ 製品ピッカー] をクリックし、エクスポートする製品ピッカーを選択して、[ エクスポート] をクリックします。