サンプル アプリを設定する

ダウンロード可能なテンプレートと事前設定済みのアセットを使用して、サンプル アプリを構築してテストできます。CX Companion テンプレートに加えて、 CX Companion のアセットを含むこのアーカイブ には、Studio Web にインポートして Orchestrator にパブリッシュできる模擬オートメーションが保存された Automations フォルダーが含まれています。

To set up and test a sample app, follow the steps below. For details on how to configure the app, see Configuring the CX Companion app.

1. CX コンパニオンテンプレートからアプリを作成します。
2. Configure the data input mode. either external events or query parameters. We recommend external events when embedding the app in a host system and query parameters when deploying a standalone app. For details, see Configuring the CX Companion app > Configure the data input mode.
3. (Optional) If you don't want to use the default 360 process included in the template, set up the CX Companion app to use a different 360 process. For details, see Configuring the CX Companion app > Configure a 360 process.

4. ダウンロードしたいくつかのモック オートメーションから個々のプロジェクトを作成するには、プロジェクトを Studio Web にインポートしてオートメーションを Orchestrator にパブリッシュします。CX Companion は、ダウンロードしたフォルダーと同じ構造を使用する Orchestrator フォルダーからアクションを読み込むように構成されているため、必ず同じ Orchestrator フォルダー構造にオートメーションを配置してください。例えば：

   
5. Configure the folder for actions in the CX Companion app. For details, see Configuring the CX Companion app > Configure the folder for actions.
6. 次のクエリを使用してアプリのデバッグを試みます パラメーター：

   &requestType=Case&requestId=500gK000003MTaQQAW&requestCaseNumber=00001000

   この手順では、アプリでクエリ パラメーター モードを有効にする必要があります (外部イベントは、アプリをデプロイした後にのみテストできます)。アプリが読み込まれ、デプロイ済みのすべてのアクションが表示されます。
7. アクションを実行してみて、Automation Tracker に結果を表示します。この手順では、アクションをデプロイするフォルダーに無人マシンまたはサーバーレス マシンが構成されていることを確認します。
8. Publish and deploy the app to Orchestrator (you can use the same folder or a different one). You can use the app URL to embed it in your host environment, depending on the data input mode. If you want to use external events, query parameters mode must be disabled by setting the variable ConfigEnableQueryParamMode to False.
9. When embedding the app in iframes of the host application, include embed_ in the URL to allow logging in through a pop-up. For information about getting the app URL, see Configuring the CX Companion app > Embedding the app
10. アプリをテストするには、以下の手順を実行します。
    • 外部イベント モードの場合は、クエリ パラメーター target を含め、ドメイン名を値として設定します (例:&target=https://www.example.com。

      これは、iframe で使用するデプロイ済みのアプリの URL のサンプルです。

      https://cloud.uipath.com/embed_/appsdev/apps_/default/run/production/22986e36-8b04-4593-b82f-aae4c14bb2dc/bd8c8ef5-a94a-43f5-9a5b-6df73d8f7aa6/IDc0b72c47295b49abaea6b701cfa5b730?el=VB&uts=true&target=https://www.example.com

      サンプル アプリで設定したイベント名は INITIATE_REQUESTです。この名前と次のいずれかのペイロードを使用してホストからイベントを送信し、サンプル アプリをテストします。

      サンプル ペイロード 1: (種類: ケース)

      {
          "RecordURL": "https://orgfarm-ef12b89682-dev-ed.develop.my.salesforce.com/lightning/r/Case/500gK000003MTaQQAW/view",
          "Type": "Case",
          "Id": "500gK000003MTaQQAW",
          "CaseNumber": "00001000",
          "Subject": "Starting generator after electrical failure",
          "Status": "Closed",
          "AccountId": "001gK0000048VSXQA2",
          "Origin": "Phone",
          "Priority": "High",
          "OwnerId": "005gK000001reLJQAY",
          "IncludeCaseHistory": true
      }

      サンプル ペイロード 2: (種類: 取引先企業)

      {
          "RecordURL": "https://orgfarm-ef12b89682-dev-ed.develop.my.salesforce.com/lightning/r/Account/001gK0000048VSXQA2/view",
          "Type": "Account",
          "Id": "001gK0000048VSXQA2",
          "AccountNumber": "CD451796",
          "Name": "Edge Communications",
          "Website": "http://edgecomm.com",
          "Phone": "[phone]",
          "Industry": "Electronics",
          "BillingCountry": "United States",
          "BillingState": "TX",
          "BillingCity": "Austin",
          "BillingStreet": "312 Constitution Place\nAustin, TX 78767\nUSA",
          "OwnerId": "005gK000001reLJQAY",
          "RenewalDate": "2025-08-31",
          "thresholdDays": 5,
          "priorityCasesOnly": true
          }

      注: 外部イベントをテストできるプレイグラウンド https://uipath.github.io/apps-demo-pages/app-cx-companion/。
    • クエリ パラメーター モードの場合、Id と Type は必須の値です。requestId パラメーターに Id 値を渡し、requestType パラメーターに Type を渡します。必要に応じて、追加のパラメーターを渡すことができます。以下に URL の例を示します。

      https://cloud.uipath.com/embed_/appsdev/apps_/default/run/production/22986e36-8b04-4593-b82f-aae4c14bb2dc/bd8c8ef5-a94a-43f5-9a5b-6df73d8f7aa6/IDc0b72c47295b49abaea6b701cfa5b730?el=VB&uts=true&requestType=Case&requestId=500gK000003MTaQQAW&requestCaseNumber=00001000