トランザクションマネージャー:フィールド

トランザクションマネージャーでは、アドミニストレーターはテキスト、数値、ブーリアン、ピックリスト、および日付/時刻フィールドを作成できます。アドミニストレーターは、トランザクションレベルまたはトランザクション明細行レベルでフィールドを作成することもできます。

トランザクションレベルで作成されたフィールドは、トランザクションライングリッドの外側に配置されます。これらのフィールドには通常、すべての品目のアカウント、住所、表示価格合計、割引合計、正味合計に関する情報が含まれています。

トランザクション明細レベルで作成されたフィールドは、トランザクション明細グリッドに配置されます。これらは、列フィールドとして、またはライン詳細、モデル、およびスライドアウト UI エフェクトのフィールドとして表示できます。

選択したレベルは、最終的にルールのフィールドの可用性に影響します。ルールにはトランザクションレベルとトランザクションラインレベルもあります。

下の買い側のスクリーンショットでは、1 とマークされたセクションはトランザクションレベルのフィールドです。2 とマークされたセクションのフィールドは、トランザクション明細レベルのフィールドです。

トランザクション画面

フィールドタイプ

トランザクションマネージャーには、次のフィールドタイプがあります。

テキスト
番号
ブーリアン
ピックリスト
日付/時刻

これらのタイプのオプションについては、以下のセクションで説明します。

システム提供のフィールド

トランザクションマネージャーは、トランザクション処理でよく使用される一連のシステム提供のフィールドをアドミニストレーターに提供します。トランザクションレベルとトランザクション明細レベルの両方にシステム提供のフィールドがあります。

システム指定のフィールドには、次のカテゴリのフィールドがあります。

トランザクションレベル:

価格情報
オポチュニティ情報
トランザクション情報
アカウント情報

トランザクションレベルのフィールドの完全なリストについては、「トランザクションマネージャー:トランザクションレベルのシステムフィールド」を参照してください。

トランザクション明細レベル:

価格情報
取引明細情報
構成情報
製品情報
注文情報

行レベルのフィールドの完全なリストについては、「トランザクションマネージャー:明細行レベルのシステムフィールド」を参照してください。

トランザクションマネージャーの詳細計画にカスタムフィールドを追加することもできます。トランザクションマネージャーの管理 UI を介して追加されたカスタムフィールドは、詳細計画に自動的に関連付けられます。ただし、マトリクスローダーを使用してアップロードされたカスタムフィールドは、blueprint.yaml ファイルを使用して詳細計画に関連付ける必要があります。これを行うには、詳細計画に関連付けるフィールド変数名の詳細を示すリストを blueprint.yaml ファイルに追加します。

次のサンプル blueprint.yaml ファイルは、relatedFields セクションのフィールドの関連付けを示しています。

---
blueprints:
- variableName: default
  relatedFields:
  - txn.custom.transactionNumber
  - txn.custom.quoteName
  - txn.custom.quoteValidUntil
  - txn.custom.paymentTerm
  - txn.custom.accountSpecificDiscount
  - txn.custom.agreementDiscount
  - txn.line.custom.agreementLineDiscount
  - txn.line.custom.customerLineDiscount
 lastModifiedBy: mark@logik.io.sfdcdev
  name: Transaction Manager Default
  stages: /blueprints/default/stages/stage.yaml
  description: Transaction Manager Default blueprint
  layouts: null
  events: /blueprints/default/events/events.csv
  views: /blueprints/default/views/views.yaml
fieldOptions: /fields/fieldOptions.csv
rules: null
fields: /fields/fields.csv

アドミン UI を使用した新しいフィールドの作成

トランザクションマネージャーの詳細計画に新しいフィールドを追加するには、次の手順に従います。

トランザクションマネージャー管理 UI に移動します。
[ 関連フィールド] をクリックします。
[ フィールドを作成] をクリックして、新しいフィールドを作成します。
[ 新しいフィールド] ダイアログボックスが開きます。
[名前] フィールドに名前を入力します。
名前を入力すると、[ 変数名 ] フィールドに反映されます。デフォルトでは、変数名は入力した名前と同じですが、すべてのスペースと特殊文字が削除されたキャメルケースになっています。たとえば、「顧客請求先住所」という名前を入力すると、自動的に入力される変数名は customerBillingAddress になります。カスタム変数名を作成するには、[変数名] フィールドの右側にある鉛筆アイコンをクリックし、独自の値を入力します。
レベルを選択して、フィールドがトランザクションレベルフィールドであるか、トランザクションラインレベルのフィールドであるかを選択します。
利用可能な 5 つのフィールドタイプから作成するフィールドのタイプを選択します。
[保存] をクリックします。

フィールドエディターページが開きます。目的のオプションを選択します。

テキストフィールドオプション

名前と変数名は、フィールドエディターページの左上に表示されます。名前は変更できますが、変数名はロックされており、フィールドを削除して詳細計画に再度追加することによってのみ変更できます。必要に応じて、ここにフィールドの説明を追加できます。購入側レイアウトでフィールドを必須にする場合は、[ 必須] スイッチを切り替えます。

見積もり名

[ デフォルトアクセス] フィールドは、デフォルトビューでのこのフィールドへのアクセスを制御します。編集可能の場合、このフィールドは読み取り/書き込みアクセス可能になります。[ アクセスなし] を選択すると、フィールドは購入側レイアウトで非表示になり、API 経由でアクセスできなくなります。

関係アクセス画面

[ デフォルト値 ] フィールドにテキストフィールドのデフォルト値を入力できます。

フィールドの説明

[ 最小フィールド長 ] と [最大フィールド長 ] の値では、入力できる文字の最小数と最大数を設定できます。

ルール

数値フィールドオプション

名前と変数名は、フィールドエディターページの左上に表示されます。名前は変更できますが、変数名はロックされており、フィールドを削除して詳細計画に再度追加することによってのみ変更できます。必要に応じて、ここにフィールドの説明を追加できます。購入側レイアウトでフィールドを必須にする場合は、[ 必須] スイッチを切り替えます。

数値フィールドオプション

[ デフォルトアクセス] フィールドは、デフォルトビューでのこのフィールドへのアクセスを制御します。編集可能の場合、このフィールドは読み取り/書き込みアクセス可能になります。[ アクセスなし] を選択すると、フィールドは購入側レイアウトで非表示になり、API 経由でアクセスできなくなります。

関係アクセス画面

数値フィールドは、数値、通貨、パーセンテージの 3 つの形式のいずれかをとることができます。フィールドの形式を選択します。

[単位ラベル] フィールドでは、数値フィールドの単位ラベルを指定できます。フィールドが通貨用の場合、単位ラベルは CPQ サイトのデフォルトの通貨記号になります。フィールドがパーセンテージの場合、単位ラベルはパーセント記号 (%) です。

[ 最小値] フィールドと [最大値 ] フィールドでは、フィールドの許容できる最小値と最大値を設定できます。

数値フィールドオプション

[ デフォルト値 ] フィールドの数値フィールドにデフォルト値を入力できます。

ブールフィールドオプション

名前と変数名は、フィールドエディターページの左上に表示されます。名前は変更できますが、変数名はロックされており、フィールドを削除して詳細計画に再度追加することによってのみ変更できます。必要に応じて、ここにフィールドの説明を追加できます。購入側レイアウトでフィールドを必須にする場合は、[ 必須] スイッチを切り替えます。

ブールフィールドオプション

[ デフォルトアクセス] フィールドは、デフォルトビューでのこのフィールドへのアクセスを制御します。編集可能の場合、このフィールドは読み取り/書き込みアクセス可能になります。[ アクセスなし] を選択すると、フィールドは購入側レイアウトで非表示になり、API 経由でアクセスできなくなります。

関係アクセス画面

[ デフォルトでオン] トグルを設定することで、ブールフィールドをデフォルトで True にするかどうかを設定できます。切り替えが設定されていない場合、フィールドのデフォルトは False です。

[ True ラベル ] フィールドで、ブール値が True の場合のフィールドのテキスト値を設定できます。たとえば、値が True の場合に表示される値を「はい」に設定できます。同様に、[ False ラベル ] フィールドでは、フィールド値が False の場合にテキストを設定できます。

ブールフィールドオプション

フィールドラベル

[選択リスト] フィールドのオプション

名前と変数名は、フィールドエディターページの左上に表示されます。名前は変更できますが、変数名はロックされており、フィールドを削除して詳細計画に再度追加することによってのみ変更できます。必要に応じて、ここにフィールドの説明を追加できます。購入側レイアウトでフィールドを必須にする場合は、[ 必須] スイッチを切り替えます。

フィールドサマリー

[ デフォルトアクセス] フィールドは、デフォルトビューでのこのフィールドへのアクセスを制御します。編集可能の場合、このフィールドは読み取り/書き込みアクセス可能になります。[ アクセスなし] を選択すると、フィールドは購入側レイアウトで非表示になり、API 経由でアクセスできなくなります。

関係性編集可能画面

[選択タイプ] では、選択リストを単一選択メニューまたは複数選択のいずれかとして定義します。

比較タイプを使用すると、メニューオプションの値を比較で使用する場合に、テキスト値または数値のどちらかをどのように処理するかを決定できます。

[+ 選択リストオプションを追加] リンクを使用すると、この選択リストメニューフィールドに最初のメニューオプションを追加できます。

選択タイプ画面

選択リストオプションを追加するときは、次のフィールド値を考慮してください。

選択タイプ画面

順序: このフィールドを使用して、メニューのメニューオプションの順序を決定します。数値が小さいほど、メニュー内の位置が高くなります。一般的なガイドラインとして、メニューオプションに 1 から 5 までの番号を付けるのではなく、10、20、30、40、および 50 の番号を付けます。これにより、新しいアイテムを後で挿入する必要がある場合に、シーケンスに余裕が残ります。
オプションのラベル: トランザクションマネージャーレイアウトでユーザーに表示されるオプション名。
オプション値: このメニューオプションを識別するために CPQ が使用する値。
選択済み: メニューオプションがデフォルトのメニュー値かどうかを決定します。
説明: メニューオプションの説明。
画像 URL: テキストの代わりに表示できるグラフィック画像の URL。

[ オプションを保存 ] をクリックして、選択リストフィールドのオプションのリストにオプションを追加します。メニューオプションを追加するには、[ + オプションを追加] をクリックします。

日付/時刻フィールドオプション

名前と変数名は、フィールドエディターページの左上に表示されます。名前は変更できますが、変数名はロックされており、フィールドを削除して詳細計画に再度追加することによってのみ変更できます。必要に応じて、ここにフィールドの説明を追加できます。購入側レイアウトでフィールドを必須にする場合は、[ 必須] スイッチを切り替えます。

フィールドサマリー画面

[ デフォルトアクセス] フィールドは、デフォルトビューでのこのフィールドへのアクセスを制御します。編集可能の場合、このフィールドは読み取り/書き込みアクセス可能になります。[ アクセスなし] を選択すると、フィールドは購入側レイアウトで非表示になり、API 経由でアクセスできなくなります。

関係アクセス画面

[ デフォルト値 ] フィールドでは、フィールドのデフォルトの日時設定を設定できます。値は、YYYY-MM-DDTHH:MM:SSZ 形式で UTC に変換されます。

日時フィールドオプション

[ 前以外] および [後以外 ] フィールドでは、フィールドの日付と時刻の最小値と最大値を設定できます。

ユーザーインターフェイス

[日付/時刻] フィールドタイプの詳細については、「トランザクションマネージャー:日付/時刻のフィールド」を参照してください。