UiPath Documentation
studio-web
latest
false
Studio Web ガイド
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 新しいコンテンツの翻訳は、およそ 1 ～ 2 週間で公開されます。

CX Companion Salesforce プラグイン

外部イベントを使用して CX Companion と Salesforce を連携させるには、UiPath CX Companion Salesforce プラグインをインストールして設定します。

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

前提条件​

Before you begin, make sure that:

  • システム管理者プロファイルへのアクセス権を持っている。

    注:

    現在の Salesforce 組織を使用するか、開発組織でテストできます。

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

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

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

UiPath-CX-Companion-SF-Plugin 管理パッケージをインストールするには、以下の手順に従います。

  1. Web ブラウザーを開き、 Salesforce AgentExchange に移動します。

  2. 検索バーに「 UiPath CX Companion SF Plugin」と入力します。

  3. Select the app listing, and then select Get It Now.

  4. Salesforce の資格情報を使用してログインします。

  5. インストールする場所とインストール先を選択します。

    1. インストール先の環境を選択します。
      • Production - 実際の Salesforce 環境でアプリを使用する準備ができている場合は、これを選択します。
      • サンドボックス - アプリを運用環境で使用する前にテストする場合は、これを選択します。
      注:

      プレビュー版のプラグインを使用している場合、この手順は利用できません。

    2. [ 特定のユーザー用にインストール] を選択します。

    You can choose to make this managed package available to some or all users. 3. Select “I acknowledge that I’m installing a Non-Salesforce Application that is not authorized for distribution as part of Salesforce’s AppExchange Partner Program.”. 4. Select Install. 5. Approve Third-Party Access for https://*.uipath.com, which will enable trusted access to the CX Companion App hosted on uipath.com. 6. After the installation finishes, select Done.

    インストール後、新しくインストールされた管理パッケージ UiPath CX Companion SF プラグイン が [インストール済みパッケージ] リストに表示されます。

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

  1. 権限セットの割り当て 管理パッケージをインストールしたユーザに必要な権限を使用できるようにするには、次の手順に従います。

    1. [> ユーザーの設定] >権限セット] に移動して、UiPath CX コンパニオンを見つけます。
    2. [ 割り当てを管理 ] > [ 割り当てを追加] を選択します。
    3. 必要なユーザーを選択します。
    4. Select Next, and then select Assign.

  2. プラットフォーム キャッシュを割り当て プラットフォーム キャッシュを、このアプリで有効な Salesforce レコード ID のデータを保存するための再利用可能なメモリとして設定する必要があります。プラットフォーム キャッシュが次のように割り当てられていることを確認します。

    1. [Setup] > [Platform Cache] に移動します。
    2. Locate CxCompanionCache and select Edit.
    3. 次の容量(MB)を指定します
      • セッション キャッシュの割り当て - 組織またはトライアル (利用可能な方): 2
      • 組織キャッシュの割り当て - 組織またはトライアル (使用可能な方): 1
      注:

      Salesforce Developer Edition (DE) の場合、トライアル容量を使用できない場合は、[ トライアル容量を要求] をクリックして同じ容量を要求できます。

    4. [保存] を選択します。

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

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

  2. 信頼できる URL を設定します。

    CX Companion の iframe を Lightning Web コンポーネント (LWC) 内で表示できるようにするには、CX Companion がホストされているサイトを信頼するように Salesforce インスタンスを設定する必要があります。

    1. [設定] > [信頼できる URL] に移動します。
    2. Find CXCompanion_Iframe in the list, and select Edit.
    3. [ CSP コンテキスト ] として [ すべて] を選択します。
    4. Select the options connect-src and frame-src and select Save

  3. カスタムメタデータ型を変更します。

    LWC では、CX Companion が CX Companion iframe アプリケーションにコンテンツを配信するには、カスタム メタデータを設定する必要があります。

    1. [設定] > [カスタムメタデータ型] に移動します。
    2. ラベルの [CX コンパニオン設定] で、[ レコードの管理] を選択します。この表示ラベルは、管理パッケージのインストール時に自動的に作成されます。

    3. For the Default label, select Edit. 4. Paste your CX Companion’s app URL in the App URL field. 5. Mention the Target Origin as the hostname of your CX Companion’s URL, e.g. https://cloud.uipath.com. 6. If CX Companion is launched from an action button in a SF record page, the following fields define the dimensions of the invoked window. These can be changed as needed. The default values are:

    • レコードアクションコンポーネントの幅: 1200
    • レコードアクションコンポーネントの高さ: 800
    注:

    これらのディメンションとタイトルは、CX コンパニオンがオブジェクトレコードページのアクションボタンとして設定されている場合にのみ適用されます。

    1. Select Save,

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

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

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

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

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

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

  1. アプリ マネージャー> [セットアップ] に移動します。

  2. サービスコンソールの [Edit (編集)] を選択します。

  3. Under Utility Items (Desktop Only) on the left panel, select Add Utility Item.

    • ポップアップで [Lightning Web コンポーネント] cxCompanion を検索して選択します。
    • ユーティリティ バーに表示される ラベル を入力します (例:CXコンパニオン)をクリックし、適切なアイコンを選択します。
    • [パネルの幅] (1000 ピクセルを推奨) と [パネルの高さ] (520 ピクセルを推奨) を指定します。
    • [ Enable Refresh]ボタン を選択すると、LWC内に表示され、アクティブなSFオブジェクトのデータでCXコンパニオンを更新できます。
    • [保存] を選択します。

  4. For Utility Bar Alignment, select the desired alignment, and then select Save.

    • [既定] を選択すると、画面の左下にユーティリティ バーが表示されます。
    • [ミラー] を選択すると、画面の右下にユーティリティ バーが表示されます。

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

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

  1. [設定] > [オブジェクト マネージャー] に移動して、オブジェクトに対する新しいアクションを作成します。

  2. クイック アクションを追加するオブジェクト (例:ケース)をクリックして開きます。

  3. Select Buttons, Links, and Actions on the left panel, and then, select New Action.

  4. [アクション種別] で [Lightning Web コンポーネント] を選択します。

  5. [Lightning Web コンポーネント] で [uipathsf:cxCompanionRecordAction] を選択します。

  6. [ ラベル ] ボックスに、ボタンに表示するラベル (例:CX Companion) をクリックし、適切なアイコンを選択します。[名前] フィールドは自動的に入力されます。

  7. [保存] を選択します。

  8. [設定] >オブジェクトマネージャに移動して、このアクションを Lightning レコードページに追加します。

  9. クイック アクションを追加するオブジェクト (例:ケース)をクリックして開きます。

  10. Select Lightning Record Pages on left hand panel.

  11. Go to any Salesforce record page, and select Edit.

  12. Select the highlight panel on the record page and, on the right panel, select Add Action to add a dynamic action.

  13. Search for CX Companion and select Done.

  14. [保存] を選択します。

  15. ケースレコードページにボタンが追加され、新しいポップアップウィンドウで CX コンパニオンが起動します。

    注:

    [CX コンパニオン] ウィンドウのサイズとタイトルは、前の手順「 カスタム メタデータ型の変更」で指定した内容によって決まります。

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

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

  1. Select App Launcher, search for and select the app CX Companion Setup.

  2. [CX Companion Object Configuration] タブを選択します。

  3. [オブジェクト]ドロップダウンで、以前にCXコンパニオンで有効にしたオブジェクトを選択します(例:アカウント オブジェクト)。

    追加するオブジェクトが [オブジェクト] ドロップダウンに表示されない場合は、以下の手順を実行します。

    1. [ その他] オプションを選択します。
    2. Specify the Salesforce record ID (15 or 18 digits) of the object in the text box, and then select Retrieve Metadata. For example, to add the Contact object, enter any valid contact’s SF record ID, e.g. 003Ox00000eUIKSIA4 in the text box.
    3. オブジェクトのフィールドが表示されます。手順 4 に進みます。

  4. 「フィールド」セクションで、CXコンパニオンに送信する必要があるフィールドを選択します。選択したフィールドへのアクセス権をエンド ユーザーが持っていることを確認します。

  5. [ヘッダー]セクションから、CXコンパニオンのヘッダーとして表示されるフィールドを最大2つ選択します。

  6. Select Save to save the configuration. It may take some time for the values to be saved and for the changes to be reflected in CX Companion.

このページは役に立ちましたか?

接続

ヘルプ リソース サポート

学習する UiPath アカデミー

質問する UiPath フォーラム

最新情報を取得