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

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

サンプル アプリをセットアップしてテストするには、以下の手順に従います。アプリの設定方法について詳しくは、「 CXコンパニオンアプリの設定」を参照してください。

1. CX コンパニオンテンプレートからアプリを作成します。
2. データ入力モードを設定します。外部イベントまたはクエリ パラメーターのいずれかです。アプリをホスト システムに埋め込む場合は外部イベント、スタンドアロン アプリをデプロイする場合はクエリ パラメーターを使用することをお勧めします。詳しくは、「 CXコンパニオンアプリの設定 」> 「データ入力モードの設定」を参照してください。
3. (Optional) テンプレートに含まれるデフォルトの360度プロセスを使用しない場合は、別の360度プロセスを使用するようにCXコンパニオンアプリを設定します。詳しくは、「 CX Companion アプリの設定 」> 「360度プロセスの設定」を参照してください。

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

   
5. CXコンパニオンアプリでのアクションのフォルダを設定します。詳しくは、「 CXコンパニオンアプリを設定する 」>「 アクション用のフォルダーを設定する」をご覧ください。
6. 次のクエリを使用してアプリのデバッグを試みます パラメーター：

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

   この手順では、アプリでクエリ パラメーター モードを有効にする必要があります (外部イベントは、アプリをデプロイした後にのみテストできます)。アプリが読み込まれ、デプロイ済みのすべてのアクションが表示されます。
7. アクションを実行してみて、Automation Tracker に結果を表示します。この手順では、アクションをデプロイするフォルダーに無人マシンまたはサーバーレス マシンが構成されていることを確認します。
8. アプリをパブリッシュして Orchestrator にデプロイします (同じフォルダーを使用することも、別のフォルダーを使用することもできます)。データ入力モードによっては、アプリの URL を使用してホスト環境にアプリを埋め込むことができます。外部イベントを使用する場合は、変数 ConfigEnableQueryParamMode を Falseに設定して、クエリ パラメーター モードを無効化する必要があります。
9. ホスト アプリケーションの iframe にアプリを埋め込む場合は、URL に embed_ を含めて、ポップアップからログインできるようにします。アプリのURLの取得については、「CXコンパニオンアプリの設定」>アプリの埋め込みを参照してください
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