トランザクションマネージャー:イベント

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:5分
  • トランザクションの作成、変更、削除などのイベントを設定して、ルールグループや統合をトリガーしたり、トランザクションをあるステージから別のステージに移動したりすることができます。

    イベントは、ステージルールと統合またはルールグループをトリガーする方法です。これらのイベントは通常、レイアウト上のボタンまたは API によってアクティブ化され、ユーザーがあるステージから別のステージに移行するのに役立ちます。

    システム イベント

    システムイベントは、顧客がすぐに利用可能な、頻繁に使用される動作です。

    トランザクション (ヘッダー)

    トランザクション マネージャーが CRM に埋め込まれている場合、これらのトランザクション イベントに対応するボタンが CRM UI に表示されます。ユーザーがこれらのボタンのいずれかをクリックすると、CRM は対応する CPQ API を呼び出します。

    • トランザクションを作成:新しいトランザクションを作成するためにトリガーされるイベント。
    • トランザクションの編集:既存のトランザクションを編集して、ステージベースのルールと統合アクションを有効にします。
    • トランザクションをコピー:トランザクションとその品目をクローンするイベント。
    • 明細をアップサート:このイベントは、ユーザーがカタログを参照した後 (UI エフェクト「productSearch」)、新しい明細を追加したり、既存の明細行を再構成したりした後の、取引明細の作成/更新を管理します。ラインのアップサートは、ユーザーがカタログからの製品の選択、製品の構成、または再構成 (UI エフェクト「再構成」) を終了した後に自動的に実行されます。このイベントはトランザクションの明細で機能しますが、トランザクションレベルのトランザクション内のすべての明細で機能します。

      UI 効果の詳細については、「 トランザクションマネージャー:レイアウト:UI 効果」を参照してください。

    • トランザクションを削除:既存のトランザクションを削除するためにトリガーされるイベント。

    トランザクション明細:

    トランザクションマネージャーの行レベルのイベントは、ネイティブの CPQ トランザクションマネージャー UI でボタンとして表示されます。

    • 明細行をクローン:明細とその子をクローンしますが、トランザクションのトップレベルの明細に対してのみクローンします。ヘッダーレベルのルールは、クローン作成後にも適用されます。
    • 明細を削除:トランザクションから 1 つ以上の明細を削除します。UI は行の選択をサポートしており、ヘッドレスモードで ID を渡すことができます。

    イベント API

    イベント API は、セッション Cookie を介してのみ許可されます。

    警告:
    ユーザーが同じトランザクションでイベント API を発生させるイベントを開始するシナリオをビルドすることは避けてください。UI と API の両方が同じレコードに対して動作するため、このような実装では予期しない動作が発生する可能性があります。

    カスタムイベント

    システムイベントに加えて、アドミニストレーターはビジネス固有の要件を満たすカスタムイベントを定義できます。カスタムイベントを作成するには、次のステップを実行します。

    1. トランザクション マネージャーのアドミンで、[ イベント] をクリックし、[ + 新しいイベント] をクリックします。

      トランザクションマネージャー:イベント

    2. [新規イベント] ウィンドウで、名前を入力します。名前を入力すると、[ 変数名 ] フィールドに反映されます。デフォルトでは、変数名は入力した名前と同じですが、すべてのスペースと特殊文字が削除されたキャメルケースになっています。たとえば、「Total of Manufacturing Lines」という名前を入力すると、自動的に入力される変数名は totalOfManufacturingLines になります。カスタム変数名を作成するには、[変数名] フィールドの右側にある鉛筆アイコンをクリックし、独自の値を入力します。

      トランザクションマネージャー:イベント

    3. トランザクション明細レベルを選択し、[保存] をクリックします。

    イベントエディターが開きます。デフォルトでは、イベントのイベントアクセスは [アクセスなし] に設定されています。[ イベントアクセスの編集] をクリックし、イベントアクセスレベルを [アクティブ] に変更し、[ 完了] をクリックしてイベントエディターに戻ります。

    トランザクションマネージャー:イベント

    トランザクションマネージャー:イベント

    [アクション] 領域では、イベントがトリガーされたときに開始するルールのグループ化または統合のいずれかをアサインできます。イベントに新しいアクションを追加するには、[ + 新しいアクションを追加] をクリックし、ルールのグループ化または統合のいずれかを選択します。利用可能なルールのグループ化または統合のメニューが表示されます。イベントに適用するルールのグループ化または統合を選択します。同じイベントに複数のルールのグループ化または統合を追加できます。

    トランザクションマネージャー:イベント

    [ 移行] トグルを使用して、イベントがトランザクションをステージシーケンスで順方向に移行するか逆方向に移行するかを決定します。デフォルトでは、イベントはトランザクションを別のステージに移行しません。[ 移行] トグルをクリックすると、移行機能が有効になります。

    トランザクションマネージャー:イベント

    トランザクションマネージャー:イベント

    終了したら [保存] をクリックします。新しいイベントは、イベントの作成時に選択したレベルに応じて、トランザクションレベルイベントまたはトランザクション明細レベルのイベントとしてイベントリストに表示されます。

    トランザクションマネージャー:イベント

    イベント設定:構成済みアイテムを検証

    カスタムヘッダーイベントの [構成済みアイテムを検証 ] 設定は、イベントの実行時にトランザクション内の製品構成を検証します。検証はイベントアクションの前に行われ、イベントアクションは検証ステータスに関係なく実行されます。

    この設定には、期間内に検証された製品を除外する有効期間が含まれています。たとえば、有効期間が 15 日に設定されていて、製品が 7 日前に検証された場合、製品の構成は検証されません。製品が 20 日前に検証された場合、製品の構成が検証されます。

    この関数は、 txn.line.configuration.status (ブール) と txn.line.configuration.validatedAt (日付) の 2 つの行レベルのシステムフィールドでサポートされています。