Studio Web ガイド

デリバリー:

最終更新日時 2025年11月10日

CX Companion Salesforce プラグイン

UiPath CX Companion SF プラグインを使用すると、外部イベントを使用する際に CX Companion と Salesforce をすぐに連携できます。プラグインのインストールと構成の方法については、以下のセクションをお読みください。

前提条件

開始する前に、次のことを確認してください。

システム管理者プロファイルへのアクセス権を持っている。
注: 現在の Salesforce 組織を使用するか、開発組織でテストできます。

Salesforce エディションが Enterprise、 Unlimited、または Developer である。

管理パッケージのインストール

AppExchange リストにアクセスします。

UiPath-CX-Companion-SF-Plugin 管理パッケージをインストールするには、以下の手順に従います。
1. Web ブラウザーを開き、 Salesforce AgentExchange に移動します。
2. 検索バーに「 UiPath CX Companion SF Plugin」と入力します。
3. アプリの一覧をクリックし、[ 今すぐ入手] を選択します。
4. Salesforce の資格情報を使用してログインします。
重要:
CX Companion SF Plugin は現在プレビュー段階であり、Salesforce からの承認待ちです。プレビュー版は次のいずれかの方法で入手できます。
- 管理パッケージの URL を使用してダウンロードする: https://login.salesforce.com/packaging/installPackage.apexp?p0=04tPa000002FWpeIAG
- https://<yourSalesforceDomain>.lightning.force.com/packaging/installPackage.apexp?p0 p0=04tPa000002FWpeIAG からダウンロード
  ここで、 <yourSalesforceDomain> は実際の Salesforce 組織ドメインです。
インストールする場所とインストール先を選択します。
1. インストール先の環境を選択します。
  - Production - 実際の Salesforce 環境でアプリを使用する準備ができている場合は、これを選択します。
  - サンドボックス - アプリを運用環境で使用する前にテストする場合は、これを選択します。
  注:
  プレビュー版のプラグインを使用している場合、この手順は利用できません。
2. [ 特定のユーザー用にインストール] を選択します。
  この管理パッケージを一部またはすべてのユーザが使用できるようにすることを選択できます。
3. [Salesforce の AppExchange パートナープログラムの一環として配布が許可されていない Salesforce 以外のアプリケーションをインストールすることに同意します。] を選択します。
4. [インストール] をクリックします。
5. https://*.uipath.comのサードパーティアクセスを承認する、これにより、uipath.com でホストされているCXコンパニオンアプリへの信頼できるアクセスが可能になります。
6. インストールが完了したら、[ 完了] をクリックします。
  
  インストール後、新しくインストールされた管理パッケージ UiPath CX Companion SF プラグイン が [インストール済みパッケージ] リストに表示されます。

権限の割り当てとプラットフォームキャッシュ

権限セットを割り当てる
管理パッケージをインストールしたユーザに必要な権限を使用できるようにするには、以下の手順に従います。
1. [> ユーザーの 設定] > 権限セット] に移動して、 UiPath CX コンパニオンを見つけます。
2. [ 割り当てを管理 ] > [ 割り当てを追加] を選択します。
3. 必要なユーザーを選択します。
4. [ 次へ] をクリックし、[ 割り当て] をクリックします。
プラットフォームキャッシュを割り当て
プラットフォームキャッシュを再利用可能なメモリとしてこのアプリケーションに設定し、有効な Salesforce レコード ID のデータを保存する必要があります。プラットフォームキャッシュが次のように割り当てられていることを確認します。
1. [Setup] > [Platform Cache] に移動します。
2. CxCompanionCache を見つけて、[編集] をクリックします。
3. 次の容量(MB)を指定します
  - セッションキャッシュの割り当て - 組織またはトライアル (利用可能な方): 2
  - 組織キャッシュの割り当て - 組織またはトライアル (使用可能な方): 1
  注: Salesforce Developer Edition (DE) の場合、トライアル容量を使用できない場合は、[ トライアル容量を要求] をクリックして同じ容量を要求できます。
4. [保存] をクリックします。

CX Companionアプリをプラグインに接続する

CX コンパニオンがホストされている URL を特定します。アプリのURLの取得については、「 CXコンパニオンアプリの設定」> 「アプリの埋め込み」を参照してください。
信頼できる URL を設定します。

CX Companion の iframe を Lightning Web コンポーネント (LWC) 内で表示できるようにするには、CX Companion がホストされているサイトを信頼するように Salesforce インスタンスを設定する必要があります。
1. [設定] > [信頼できる URL] に移動します。
2. リストで CXCompanion_Iframe を見つけ、[ 編集] をクリックします。
3. [ CSP コンテキスト ] として [ すべて] を選択します。
4. connect-src オプションと frame-src オプションを選択し、Save をクリックします
カスタムメタデータ型を変更します。

LWC では、CX Companion が CX Companion iframe アプリケーションにコンテンツを配信するには、カスタムメタデータを設定する必要があります。
1. [設定] > [カスタムメタデータ型] に移動します。
2. ラベルの [CX コンパニオン設定] で、[ レコードの管理] を選択します。この表示ラベルは、管理パッケージのインストール時に自動的に作成されます。
3. [既定のラベル] で [編集] をクリックします。
4. CX コンパニオンのアプリ URL を [アプリ URL ] フィールドに貼り付けます。
5. CXコンパニオンのURLのホスト名として ターゲットオリジン を指定します(例:https://cloud.uipath.com。
6. SF レコードページのアクションボタンから CX コンパニオンを起動する場合、以下のフィールドによって呼び出されるウィンドウのディメンションが定義されます。これらは必要に応じて変更できます。既定値は次のとおりです。
  - レコードアクションコンポーネントの幅: 1200
  - レコードアクションコンポーネントの高さ: 800
  注: これらのディメンションとタイトルは、CX コンパニオンがオブジェクトレコードページのアクションボタンとして設定されている場合にのみ適用されます。
7. [保存] をクリックします。

CXコンパニオンの位置づけ

Salesforce UI に CX コンパニオン起動ボタンを配置するには、次の 2 つのオプションがあります。

ユーティリティバーの項目として表示され、すべてのオブジェクトに表示されます。
オブジェクトレコードページのアクションボタンとして。

ユーティリティバー項目としての位置

CXコンパニオンを有効にするアプリごとに、次の手順に従ってください(例:セールスコンソール)。これにより、ユーザーがそのアプリにいるときに、CXコンパニオンがユーティリティトレイに表示されるようになります。

次の手順では、CX コンパニオンがサービスコンソールのユーティリティバー項目として追加されています。

アプリ マネージャー > [ セットアップ] に移動します。
サービスコンソール の [ Edit (編集)] を選択します。
左側のパネルの [ユーティリティ項目 (デスクトップのみ)] で、[ ユーティリティ項目の追加] をクリックします。
- ポップアップで [Lightning Web コンポーネント] cxCompanion を検索して選択します。
- ユーティリティバーに表示される ラベル を入力します (例:CXコンパニオン)をクリックし、適切なアイコンを選択します。
- [パネルの幅] (1000 ピクセルを推奨) と [パネルの高さ] (520 ピクセルを推奨) を指定します。
- [ Enable Refresh]ボタン を選択すると、LWC内に表示され、アクティブなSFオブジェクトのデータでCXコンパニオンを更新できます。
- [保存] をクリックします。
[ユーティリティバーの配置] で、目的の配置を選択し、[保存] をクリックします。
- [既定] を選択すると、画面の左下にユーティリティバーが表示されます。
- [ミラー] を選択すると、画面の右下にユーティリティバーが表示されます。

オブジェクトレコードページでのアクションボタンとしての位置

オブジェクトレコードページの新しいアクションボタンを作成するオブジェクトごとに、次の手順を実行します。以下の手順では、CXコンパニオンをケースレコードページのアクションボタンとして追加する手順を説明します。

[設定] > [オブジェクトマネージャー] に移動して、オブジェクトに対する新しいアクションを作成します。
クイックアクションを追加するオブジェクト (例:ケース)をクリックして開きます。
左側のパネルで [ ボタン、リンク、およびアクション ] を選択し、[ 新しいアクション] をクリックします。
[アクション種別] で [Lightning Web コンポーネント] を選択します。
[Lightning Web コンポーネント] で [uipathsf:cxCompanionRecordAction] を選択します。
[ ラベル ] ボックスに、ボタンに表示するラベル (例:CX Companion) をクリックし、適切なアイコンを選択します。[名前] フィールドは自動的に入力されます。
[保存] をクリックします。
[設定] >オブジェクトマネージャに移動して、このアクションを Lightning レコードページに追加します。
クイックアクションを追加するオブジェクト (例:ケース)をクリックして開きます。
左側のパネルで [Lightning レコードページ ] をクリックします。
任意の Salesforce レコードページに移動し、[ 編集] をクリックします。
レコードページの強調表示パネルを選択し、右側のパネルで [ アクションを追加 ] をクリックして動的アクションを追加します。
CX Companionを検索し、「Done」をクリックします。
[保存] をクリックします。
ケースレコードページにボタンが追加され、新しいポップアップウィンドウで CX コンパニオンが起動します。
注: [CX コンパニオン] ウィンドウのサイズとタイトルは、前の手順「 カスタムメタデータ型の変更」で指定した内容によって決まります。

SFオブジェクトフィールドをCXコンパニオンに渡す

以下の手順に従って、CX Companion Setup Appのオブジェクトフィールドを設定します。

[アプリケーションランチャー] をクリックし、アプリケーションの [CX コンパニオン設定] を検索して選択します。
[CX Companion Object Configuration] タブを選択します。
[オブジェクト]ドロップダウンで、以前にCXコンパニオンで有効にしたオブジェクトを選択します(例:アカウントオブジェクト)。
追加するオブジェクトが [オブジェクト] ドロップダウンに表示されない場合は、以下の手順を実行します。
1. [ その他] オプションを選択します。
2. テキストボックスにオブジェクトの Salesforce レコード ID (15 桁または 18 桁) を指定し、[ メタデータを取得] をクリックします。たとえば、 取引先担当者 オブジェクトを追加するには、有効な取引先担当者の SF レコード ID を入力します (例:003Ox00000eUIKSIA4 と入力します。
3. オブジェクトのフィールドが表示されます。手順 4 に進みます。
「フィールド」セクションで、CXコンパニオンに送信する必要があるフィールドを選択します。選択したフィールドへのアクセス権をエンドユーザーが持っていることを確認します。
[ヘッダー]セクションから、CXコンパニオンのヘッダーとして表示されるフィールドを最大2つ選択します。
[ 保存 ] をクリックして設定を保存します。値が保存され、変更がCXコンパニオンに反映されるまでに時間がかかる場合があります。