必須条件

このガイドでは、 CPQ 環境が Salesforce 組織と統合されており、トランザクションマネージャーが有効になっていることを前提としています。Salesforce 組織に CPQ パッケージがインストールされていない場合は、バージョン 2.7 以降の CPQ 管理パッケージをインストールします。手順については、「Salesforce 組織にリンクされた環境のインストールおよびセットアップガイド」を参照してください。

CPQ環境でトランザクションマネージャーを有効にするように要求するサポートチケットを送信します。

CPQ Transaction Manager 拡張機能について

CPQ Transaction Manager 拡張機能は、Salesforce と CPQ Transaction Manager 間の統合を容易にするために、Salesforce アドミニストレーターが Salesforce 環境にインストールするコンポーネントのパッケージです。

最新バージョンとインストール用の管理パッケージへのアクセス方法については、ServiceNow カスタマーサポートにお問い合わせください。

アドミニストレーターは、アドミン専用、すべてのユーザー用、または特定のプロファイル用にパッケージをインストールできます。パッケージには、個人に割り当てたり、プロファイルに複製したりできるトランザクションマネージャーの権限セットが含まれています。アクセス許可セットを表示するには、[セットアップ] で [ユーザー] に移動し、[アクセス許可セット]Logik.ai [フルアクセス] オプションを確認します。

インストール後、Salesforce セットアップの [ インストール済みパッケージ ] セクションでパッケージのバージョンを表示できます。

Salesforce:カスタムアドレスフィールドを有効にする

Salesforce 環境では、カスタムアドレスフィールドが有効になっている必要があります。この機能が有効になっていない場合は、次の記事で詳細を参照してください: カスタムアドレスフィールドを有効にする

Salesforce:次のセキュリティ例外を許可 CPQ

信頼できる URL を追加します。

1. Salesforce セットアップホームから、 設定 > セキュリティ > 信頼できる URL. 新しい信頼できる URL を作成します。
2. API 名を指定します。
3. 次に示すように、 CPQ 環境の URL を入力します。

   

4. [CSP ディレクティブ] で、少なくとも frame-src (iframe コンテンツ) が有効になっていることを確認し、[ 保存] をクリックします。

   

リモートサイト設定の構成:

1. Salesforce セットアップホームから、 設定 > セキュリティ > リモートサイト設定. 新しいリモートサイトを作成します。
2. 名前を入力します。
3. 下の画像のように CPQ 環境のURLを入力し、[ 保存]をクリックします。

   

オプションで、Cosmo Converse(現在ベータ版)のマイクアクセスを許可します。Cosmo Converseを使用すると、ユーザーはトランザクションマネージャーと音声で通信できます。デフォルトでは、この機能は有効になっていません。Cosmo Converse を使用するには、ユース ケースを説明するサポート チケットを送信します。Cosmo Converse に備えるには、Salesforce の設定を更新してマイクへのアクセスを許可します。

1. [セットアップホーム] から、 設定 > セキュリティ > セッション設定.
2. [ ブラウザー機能の権限 (Browser Feature Permissions)] で、[ 権限ポリシー HTTP ヘッダーを含める (Include Permissions-Policy HTTP header )] のチェックボックスが無効になっていることを確認します。
3. 必要に応じて、[ 保存] をクリックします。

CPQ:ランタイムクライアントトークンを設定します

CPQ ランタイムクライアントトークンを使用すると、Salesforce から CPQ への通信の認証が容易になります。CPQ でランタイムクライアントトークンを作成する手順については、「ランタイムクライアントの設定」を参照してください。このトランザクションマネージャーのユースケースでは、このランタイムクライアントでトランザクションの権限を有効にし、対応する Salesforce 環境で認識される有効なユーザー ID を追加してください。

CPQ Admin では、ランタイムクライアントトークンを更新して、その権限に TRANSACTION を含め、それ自体をオリジンとして含める必要があることに注意してください。(たとえば、 https://test-txn.test02.logik.io のランタイムクライアントトークンのオリジンは https://test-txn.test02.logik.io である必要があります)。また、ランタイム・クライアント・トークンにTRANSACTIONが含まれている場合は、ユーザーを含める必要があります。ユーザーにトランザクションの作成イベントを実行する権限があることを確認します。

ランタイムクライアントトークンを設定したら、次の手順で使用するためにローカルクリップボードにコピーします。

Salesforce に CPQ トランザクションランタイムトークンをインストールする

1. Salesforce アプリランチャーから、[ アドミンカスタム設定] を検索して開 Logik.io。
2. [ランタイムクライアントトークン] フィールドの横にある [設定] ボタンを押して有効にします。
3. CPQのトークンを編集可能なフィールドに貼り付け、[保存] をクリックします。

Salesforce:機会レイアウトを更新してトランザクションマネージャーを開く

1. Salesforce で、右上隅の歯車アイコンをクリックします。
2. 移動先 セットアップ > オブジェクトマネージャー > 機会 > ページレイアウト.
3. 編集するページレイアウトを選択します。(複数のレイアウトがある場合は、関連するレコードタイプまたはユーザープロファイルに関連付けられたレイアウトを選択します)。

   

4. [ 関連リスト ] セクションが表示されるまで、レイアウトエディターを下にスクロールします。

   

5. 上部パレットの利用可能な関連リストのリストから [ 関連リスト ] セクションの目的の位置に [トランザクション] オブジェクトをドラッグします。

   

6. トランザクションオブジェクトのレンチアイコンをクリックして、関連リストのプロパティを開きます。

   

7. [選択したフィールド] セクションで、[利用可能なフィールド] 列から [トランザクションを編集] フィールドを選択します。[ 追加 ] をクリックして [ 選択したフィールド] 列に移動します。必要に応じてフィールドを並べ替え、[ OK ] をクリックして変更を保存します。変更を行った後、左上隅の [保存] をクリックします。

   

8. 更新されたレイアウトをテストします。

   • エンドユーザー (Salesforce のバイサイド) として、機会レコードに移動します。

   • トランザクション関連リストがページに表示され、[ トランザクションの編集 ] リンクが表示されて機能していることを確認します。

トラブルシューティング:[トランザクション] ボタンが表示されない場合

購入側の機会の詳細ページに取引ボタンがない場合は、次の手順に従います。

1. ページの右上隅にある歯車アイコンをクリックし、[ ページの編集] をクリックします。これにより、機会レコードページの Lightning アプリビルダーが開きます。

   

2. ページの関連リストコンポーネントを選択します。[ ページレイアウトのアサイン ] セクションで、現在アサインされているページレイアウトの名前を見つけます。(画像では「(プレビュー済み)」という文字で正しいレイアウトが表示されています)

   

3. プレビューされたレイアウトをクリックし、「Salesforce:トランザクションマネージャーを開くように機会レイアウトを更新する」セクション (上記) の手順 4 から 7 を繰り返します。次に、バイサイドで、機会レコードに移動します。[ 関連リスト ] セクションをチェックして、トランザクションオブジェクトが表示されていることを確認します。矢印をクリックし、新しいトランザクションを作成し、[ トランザクションの編集 (EditLink__c)] フィールドが使用可能であることを検証します。

   

   

Salesforce:カスタムフィールドマッピングの設定

新しい CPQ トランザクションレコードが CPQ で開始された場合は、Salesforce トランザクションレコードから重要なデータを転送すると便利です。このセクションでは、トランザクション作成フロー中に、Salesforce のフィールドから CPQ のフィールドに、またはその逆に情報をコピーするフィールドマッピング (または「ツイン」) を設定します。たとえば、アドミニストレーターは、 LGK__OpportunityId__c に保持されている値を、対応する CPQ トランザクションフィールド txn.opportunity.id とツインするのが一般的です。

1. Salesforce で、[設定] に移動します。
2. [クイック検索] バーで、「 カスタムメタデータタイプ」を検索します。
3. 検索結果の [カスタムコード] で、[ カスタムメタデータ] をクリックします。

   

4. 既存のフィールドマッピングにアクセスするには、カスタムメタデータタイプのリストで Logik.io トランザクションフィールドマッピング を見つけ、その横にある [レコードの管理 ] リンクをクリックします。

   

5. [ 新規] をクリックし、必要な詳細を入力して、[ 保存] をクリックします。

   ソースフィールド:

   • 環境:フィールド値のソースを選択します。

     • Salesforce に由来するフィールドには Salesforce を選択します。

     • CPQ に由来するフィールドの [ロジック] を選択します。

   • オブジェクト: トランザクションを入力します。
   • フィールド:フィールド名を指定します。

     • Salesforce フィールドには、 __c サフィックス ( CustomField__c など) を含めます。からの正確なフィールド名の確認 Salesforce > セットアップ > オブジェクトマネージャー > トランザクション > フィールド そして関係。

       

     • CPQフィールドには、txn. や txn.line などのプリフィックスを含めてフィールドを示します (例:txn.TotalAmount)。の正確なフィールド変数名を必ず使用してください アドミン > トランザクション > 関連付けられたフィールド.

       

   ターゲットフィールド:

   • 環境:フィールド値を更新する場所 (Salesforce または CPQ) を示します。
   • フィールド:ターゲットのフィールド名を同じ形式で入力します (たとえば、__c 付きの Salesforce フィールドや txn. プリフィックス付きの CPQ フィールドなど)。

     

Salesforce:トランザクション品目から営業案件品目への同期と資産フローの有効化

1. Salesforce セットアップホームから、「フロー」を検索します。Click プロセス自動化 > フロー.

2. 以下を検索します。それぞれについてステップ 3 を実行します。

   • Logik.io 営業案件品目の同期 (アップサート)
   • Logik.io 営業案件品目の同期 (削除)
   • プライマリトランザクション変更 Logik.io
3. ステップ 2 で特定した 3 つのフローのそれぞれについて、次のいずれかのオプションを有効にします。
   • オプション 1: ドロップダウンメニューの使用:
     • フロー名の右側にある矢印をクリックします。

       

     • [ 詳細とバージョンを表示] を選択します。
     • フローの最新バージョンの [ アクティブ化] をクリックします。

       

   • オプション 2:フローを開きます。
     • フロー名をクリックしてフロービルダーで開きます。

       

     • フロービルダーの右上にある [アクティブ化 ] をクリックします。

       

すべてのフローがアクティブステータスであることを確認します。

エンドユーザーフロー:Salesforce からの CPQ トランザクションの起動

• Salesforce でのトランザクションレコードの作成

  エンドユーザーが Salesforce で CPQ トランザクションを開始する方法はいくつかあります。最も一般的なフローは機会レコードから開始されます。

  1. 機会レコードから、トランザクションの関連リストの矢印をクリックし、[ 新規] をクリックします。

     

  2. [ オポチュニティ] フィールドに値が入力された状態で新しいトランザクションが開きます。[アカウント]、[主要連絡先]、および任意のオプションフィールドに入力します。[保存] をクリックします。

     

  3. 管理パッケージ内のレコードによってトリガーされるフローは、 CPQで新しいトランザクションを作成します。Salesforce で更新される新しい CPQ トランザクションレコードの UUID (LGK__TransactionUUID__c)。トランザクション ID がすぐに表示されない場合は、通常、ブラウザーを更新すると異常が修正されます。

     

     ブラウザーを更新した後も [トランザクション ID] フィールドに値が入力されていない場合は、以下の「トラブルシューティング」セクションを参照してください。

• トランザクションを編集

  Salesforce トランザクション (またはトランザクション関連リスト) から、トランザクションの詳細ページの [トランザクションを編集 ] ボタンまたは [トランザクションを編集 ] フィールドから利用可能なリンクを使用して、トランザクションマネージャーを起動できます。これにより、Salesforce レコードの [トランザクション ID] フィールドに基づいてCPQトランザクションがロードされます。

  トランザクションマネージャーは iFrame にロードされ、Salesforce の現在のサブタブを置き換えます。

  注:

  Salesforce の従来の UI はサポートされていません。
• トランザクションをコピー

  ユーザーは、Salesforce トランザクションレコードの [ クローン ] ボタンをクリックすることで、 CPQ コピーイベントを呼び出して、トランザクションマネージャーでトランザクションと明細を再作成できます。このアクションは Salesforce のヘッダーレコードのトランザクション ID に基づいて行われ、トランザクションレコードがクローンされます。

  注:

  Salesforce からトランザクションをクローンしても、新しいトランザクションに関連付けられた明細レコードのコピーは自動的に作成されません。明細を新しいトランザクションにクローンするには、トランザクションマネージャーで新しい (クローンされた) トランザクションレコードを起動し、Salesforce 同期を開始します。

トラブルシューティング:「ID が「null」のトランザクションが見つかりませんでした」というエラーで CPQ 起動に失敗する

このエラーは、Salesforce からの API 呼び出しを介して新しい CPQ トランザクションレコードの作成が開始され、失敗した場合に発生します。このエラーは通常、次の 2 つの理由のいずれかが原因で発生します。

• トランザクションランタイムトークンが正しく設定されていないか、有効期限が切れています。上記の「CPQ:ランタイムクライアントトークンの設定」セクションの手順を確認してください。
• Salesforce UI から CPQ トランザクションレコードを作成するユーザーには、その権限がありません。

権限エラーのトラブルシューティングを行うには、次の手順に従います。

1. トランザクション管理で、[ ペルソナ] をクリックします。
2. ペルソナのリストで、どのペルソナに DEFAULT のラベルが付いているかを確認します。以下のスクリーンショットは、「営業担当者」がデフォルトのペルソナであることを示しています。デフォルトでは、すべての新規ユーザーにこのペルソナがアサインされます。

   

3. 各ペルソナレコードを開きます。ユーザー名を検索します。デバッグするユーザーは、1 つのペルソナでのみ表示する必要があります。適切なペルソナを見つけたら、このペルソナのアクセスを管理するビューに注目します。この例では、ユーザーは営業担当ペルソナにリストされているユーザー名に含まれています。このペルソナのアクセスは、「営業」ビューによって管理されます。

   

4. ペルソナのアクセスを管理するビューを開きます。この例では、ビューの名前は「sales」です。ビューを開くには、トランザクション管理ホーム CPQ [ビュー] に移動し、管理ビューをクリックします。

   

5. ビューの詳細ページで、[ アクセス]、[ イベント] の順にクリックして、 createTransaction を検索します。初期ステージでは、トランザクション作成イベント (varname: createTransaction) を [ アクティブ] に設定する必要があります。

   

要約すると、任意のユーザーについて、アドミニストレーターは次の表のアイテムを管理する必要があります。