セット
セットが繰り返し可能なフィールドグループを整理し、複雑な構成を簡素化し、 CPQ内の繰り返し要素間でデータ集計を可能にする方法について説明します。
セットは、アドミニストレーターが単一の詳細計画で、類似した構成データ (複数の製品、コンポーネント、オプションなど) の複数のインスタンスを定義できるようにする、再利用可能で繰り返し可能なフィールドのコレクションです。
セット内の各行は、繰り返されるフィールドグループの 1 つのインスタンスを表し、その行内の各フィールドは独立して動作します。セットは構成設計を簡素化し、重複を減らし、表形式またはリストベースの入力を必要とする高度なユースケースをサポートします。
アドミニストレーターは、セットを使用して構成オプションを構造化されたテーブルのようなレイアウトで表示し、顧客がエンドユーザーインターフェイスで簡単に編集できるようにします。
セットは次のように設計されています。
- 繰り返し可能な構成を簡素化します。繰り返すたびに複数のフィールドとルールを作成するのではなく、一度定義して何度も再利用します。
- 直感的な表形式のデータ入力を提供します。エンドユーザーは、構造化されたグリッドで複数の製品インスタンスを追加、削除、または編集できます。
- 動的ルールをサポートします。ルールは、同じ行の値を参照することも、すべての行のデータをアグリゲートすることもできます。
- 高度なレポートとサマリーを有効にします。集計では、行全体のフィールド値 (合計数量や合計ラックユニットなど) が集計されます。
セットの仕組み
セットは複数の構成フィールドをグループ化し、リスト内のアイテムごとにそのグループを繰り返します。
各セット行は完全に独立しています。
- 同じ行のフィールドは、その行の他のフィールドに影響を与える可能性があります。
- ある行のフィールドが別の行のフィールドに直接影響を与えることはありません。
- セット外のフィールドはセット内のフィールドに影響を与える可能性がありますが、その逆はできません。
セット外のフィールドに影響を与えるには、次を使用します。
- 集計:すべての行の合計値、カウント値、平均値、最大値、または最小値。
- 製品ルール:設定されたデータに基づいて外部フィールド値を設定するロジックを定義します。
セットには最大 2,000 行を含めることができます。
オプションを表示
セットは、ユーザーエクスペリエンスの要件に応じて、いくつかの形式で UI に表示できます。
| 表示タイプ | 説明 | ユースケースの例 |
|---|---|---|
| テーブル | ヘッダー付きの行、列、セル。詳細な比較に最適です。 | 複数のネットワークデバイスの構成。 |
| リスト | 各行はカードとして表示されます。単一選択または複数選択をサポートできます。 | 配送スロットまたはサービスパッケージを選択します。 |
| リピーター | ナビゲーションコントロールを使用して、一度に 1 つのレコードを表示します。 | 小さなレイアウトで構成を 1 つずつ編集します。 |
アドミニストレーターは、レイアウトエディターでレイアウト、配置、およびスクロールを制御します。
フィールドの関係
| 関係 | 動作 |
|---|---|
| 内部 → 内部 | 同じ行のフィールドは、ルールを介して相互にトリガーできます。 |
| 内部→外部 | 直接許可されていません。集計または積ルールを使用します。 |
| 外部 → 内部 | 許可されました。セット外のルールまたはフィールドアクションによって、セットフィールド値を変更できます。 |
主なプロパティ
セットには、ユーザーがテーブルまたはリストを操作する方法を形作るいくつかの構成カテゴリが含まれています。
- 全般設定:向き、最大高さ、配置、インデックスラベル。
- 表示タイプ:テーブルビューとリストビューから選択します。
- インライン設定:「行を追加」インジケーター、ドロップダウンコントロール、またはホバーアクションを表示します。
- サイズ設定:ユーザーがセット行 (数値またはスライダー フィールド) を増減する方法を管理します。
- 選択設定:ブール選択フィールドを使用して単一または複数の行の選択を追加します。
- 検索設定:ユーザーがセット内の値を検索できるようにします (たとえば、利用可能な日付でフィルタリングします)。
- メッセージ設定:特定のセルに検証メッセージまたはインジケーターを表示します。
セットデータの管理
セットは、CSV 形式でのデータのインポートとエクスポートをサポートします。
- ダウンロードセットデータ:UI に適用されたフィルターに基づいて、表示されている列のみをエクスポートします。
- セットデータをアップロード:構造化された CSV ファイルを使用して、セット内の行を追加または更新します。
- ルールはアップロード時に自動的に実行されます。
- 新しい行が追加されます。一致する行が更新されます。
- システムによって強制された制限が適用されます (25 列の表示列を推奨)。
セットの生の値に JSON プロパティを追加して、アップロード/ダウンロードを有効にします。
{
"uploadDetails": {
"uploadButton": { "label": "Upload CSV", "visible": true },
"downloadButton": { "label": "Download CSV", "visible": true }
}
}
セットを使用したスクリプティング
ルールまたはスクリプトでセットを参照するには、次の構文を使用します。
| ユースケース | 構文例 |
|---|---|
| セットへのアクセス | set.<setVarName> |
| アグリゲートフィールドへのアクセス | set.<setVarName>.<aggregateVarName> |
例:
if (set.networkDevices.totalRackUnits > 50) {
field.requiresAdditionalCooling = true;
}