ステップバイステップガイド

この記事は、CDS 構成を追加する方法を決定するのに役立ちます。

1. CPQコンフィギュレーターでレイアウトエディターを開きます。
2. CSV レイアウトファイルをダウンロードします。
3. CSV レイアウトファイルを開き、CDS レイアウト要素のフィールドを追加します (以下で詳しく説明)。
4. CSV レイアウトファイルを CPQ に再アップロードします。これで、CDS レイアウト要素がレイアウトに存在するはずです。
5. CDS レイアウト要素の構成オプションを開き、必要な JSON データ行を追加します。

技術的な構成オプション

CPQと CDS の統合は、詳細計画レイアウト定義で行われます。次のレイアウト CSV ファイルは、CDS 可視化を UI のどこにレンダリングするかをアドミニストレーターが定義する方法を示しています。また、CDS 環境と送信する CPQ フィールドデータも指定します。

レイアウトは、レイアウトエディターで直接更新できます。レイアウトエディターで、下の赤で強調表示されたフィールドを使用して CSV ファイルに CDS という名前の新しいセクションを作成し、新しいファイルをレイアウトにアップロードします。

ここから、このレイアウト要素の設定を開き、CDS プロパティ JSON エディターを使用して次のフィールドを構成できます。

これらのプロパティは、この要素で構成できます。次の表に、各要素の名前と説明を示します。

setVariableName: [
{
field1: 'value',
field2: 'value'
}
{
field1: 'value',
field2: 'value'
}
]

{
   "eventProductPickers": [
      "productPicker1",
      "productPicker2"
   ]
}

{
  "eventProductPickers": {
     "logikProductPicker1": "cdsProductPickerName1",
     "logikProductPicker2": "cdsProductPickerName2"    }
}

JSON 文字列の書式設定

最終的な JSON 文字列の書式設定は次のようになります。

{

"domain": "exampleDomain", "env": "qa"

"eventFields": ["field1", "field2", "field3"]

}

メモ

• レイアウト定義のサンプルでは、CDS レンダリングは右上にある BasicContainer サイドバーに表示されます。
  • CDS は、JSON オブジェクト CPQ テキストフィールドに渡すことができます。
  • CDS からの JSON 応答を解析するには、高度なルールを使用します。

• CDS 要素行の「値」列 (列 I) で指定された JSON には、次の構文が含まれています。

  {
  "eventFields": [ "FIELD1",
  "FIELD2", "FIELD3"
  ],
  "domain": "CDS_DOMAIN", "env": "CDS_ENV_SECTOR"
  }

  domain:CDS によって提供される、プロジェクトに対応するドメインの名前。

  env:CDS によって提供される、プロジェクトの環境サービスの名前。例:「qa」。

  eventFields 配列には、CDS に渡される CPQ フィールドの変数名が含まれています。以前は、CDS が変数を CPQ 変数名に一致させることが標準でした。CDS を使用した実装に当てはまることを確認してください。

  eventFields には、 CPQ と CDS の間で通信されるすべてのフィールド (つまり、CDS ビジュアルを制御する CPQ フィールドと、CDS ビジュアル化に加えられた変更に基づいて CPQ に返されるフィールドの両方) が含まれている必要があります。

• セットを CDS に渡すこともできますが、送信できるのは最初の 25 個のインデックスのみです。これは、プロパティ名が eventFields ではなく eventSets である点を除いて、上記のプロセスを反映しています。
• CDS に送信するセットのアレイまたはオブジェクト:
  • 配列は、含まれている文字列が CPQ 変数名と CDS 変数名の両方であると想定します。
  • オブジェクトにはキー:値のペアがあります。キーは CPQ 変数名で、値は CDS 変数名です。

  • これは、次の構文を使用して、最大 25 個のインデックス長で全体として送信されます。

    setVariableName: [
    {
    field1: 'value', field2: 'value'
    },
    {
    field1: 'value', field2: 'value'
    },
    ]

• 製品ピッカーは、最初の 25 個のインデックスのみを送信できるという制限付きで CDS に渡すこともできます。これは、プロパティ名が eventFields または setFields ではなく eventProductPickers であることを除いて、上記のプロセスを反映しています。次の 2 つの構文が機能します。

  {
    "eventProductPickers": ["productPicker1", "productPicker2"]
  }

  {
    "eventProductPickers": {
      "logikProductPicker1": "cdsProductPickerName1",
      "logikProductPicker2": "cdsProductPickerName2"
    }
  }

• CDS は双方向通信用にセットアップできます。ユーザーが関連する CPQ フィールドを更新すると、一方向通信によって CDS グラフィックが更新されます。2番目のモードでは、ユーザーはCDSグラフィックを操作でき、CDSは関連する CPQ フィールド入力を更新します。標準フィールドの場合、CDS はマッピングされた CPQ フィールドに書き戻します。CPQセットが双方向通信セットアップで使用されている場合、CPQアドミニストレーターとCDSアドミニストレーターは、次のセットアップを調整する必要があります。
  • CPQ 管理者は、CDS からセットデータが書き込まれる個別のイベントフィールドを定義します。
  • CDS アドミンは、このフィールドをセットデータの宛先として指定します。
  • CPQ アドミンは、フィールドを解析してセットに入力する決定ルールを定義します。