コード化されたアクション Apps を構築してデプロイする

UiPath でコード化されたアクション アプリを構築してデプロイします。開始する前の必要条件、アプリと Action Center とのデータの交換方法、ローカルでテストする方法、タスク インターフェイスとしてのデプロイ方法

コード化されたアクション アプリは、コード化されたアプリと同じライフサイクルを経ます。コードで定義され、UiPath に接続され、Orchestrator にデプロイされた後、Action Center タスクのインターフェイスとして使用されます。

このプロセスには、次の段階が含まれます。

1. 統合開発環境 (IDE) でアクション アプリのロジックを定義する。
2. セキュリティで保護された UiPath への接続を確立する
3. Orchestrator にアクション アプリをデプロイする。
4. アクション アプリを Action Center タスクのユーザー インターフェイスとして使用する。コード化されたアクション アプリは、エージェント、RPA プロセス、Maestro プロセスなど、さまざまなサーフェスから作成されたタスクのインターフェイスとして機能します。

はじめる前に

重要:

In Automation Cloud Dedicated and Test Cloud Dedicated, use UiPath CLI version 1.202.0 for the pack, publish --type Action, deploy, and push steps until your Dedicated production environment is upgraded to the Apps release dated September 24, 2026. Later CLI versions contain breaking changes that are incompatible with the Apps version currently running in Dedicated environments. After your Dedicated production environment is upgraded to the September 24, 2026 Apps release, you can use later versions of the UiPath CLI.

次の条件が整っていることを確認します。

• Node.js 20.x 以降と npm を使用したローカル開発環境で、アプリの構築と UiPath ツールのインストールに使用されます。nodejs.org からインストーラーをダウンロードします。このインストーラーには npm が含まれます。既にインストールされているものを確認するには、 node -v を実行して npm -v。
• codedapp ツールがインストールされている UiPath CLIインストールの手順については、 『UiPath CLI ガイド』をご覧ください。
• 対象の Orchestrator フォルダーにパッケージをパブリッシュし、アプリをデプロイする権限。

アクション アプリの機能によっては、外部アプリ ID も必要になる場合があります。

アクション アプリを使用する場合は、	外部アプリ ID が必要です。
タスクの読み取りのみを完了します	いいえ
Orchestrator や Data Fabric などの他の UiPath サービスも呼び出す	はい

外部アプリ ID が必要な場合は、組織に登録されている外部アプリケーションから取得する必要があります。アクション アプリはブラウザーで実行され、アプリ シークレットを保存できないため、ユーザー スコープを設定して 非機密アプリケーション として登録してください。外部アプリケーションを登録するには、『Automation Cloud 管理ガイド』の「 外部アプリケーションを追加する 」をご覧ください。

アクション アプリを構築する

コード化されたアクション アプリは、Action Center によってレンダリングされたサンドボックス化されたフレーム内で実行されるため、タスク データを直接読み書きすることはできません。UiPath のコード化されたアクション アプリ SDK は、そのギャップを埋めるものとして、このアプリに以下の 4 つの機能を提供します。

• アプリが読み込まれたら、タスクとそのデータを受け取ります。
• 通知 Action Center - ユーザーがフォームを編集して [保存 ] ボタンを有効化できるようにします。
• ユーザーが選択したアクションと最終データを使用してタスクを完了します。
• Action Center 内でユーザーに対してメッセージを表示します。

これら 4 つに加えて、UiPath では、通常の Web プロジェクトに 2 つのワンタイム設定を追加しています。

• 組織へのコネクションプロジェクトのルートにある小さな構成ファイルにより、組織、テナント、および外部アプリ ID (必要な箇所) を識別します。
• ローカル開発の設定。プロジェクトのビルド ツール用の UiPath プラグインは、アプリを開発者のマシンで実行している間に同じ構成を提供するため、アプリをデプロイする前に実際のテナントに対してテストできます。

SDK メソッド、構成ファイル、ビルド ツール プラグイン、アプリをパッケージ化する前に必要な調整など、開発者向けの完全な設定については、 コード化されたアクション アプリ SDK のドキュメントをご覧ください。

アクション アプリをローカルでテストします

Action Center では、ローカルホストで実行されるコード化されたアクション Apps に対してタスク シミュレーション エクスペリエンスが提供されます。動作する前に、UiPath 側で 2 つの設定を行う必要があります。

Action Center のリダイレクト URI を外部アプリケーションに追加します

アクション アプリが使用する外部アプリケーションにリダイレクト URI https://<host>/<orgId>/<tenantId>/actions_ を追加します。ここでは、サインインする環境 <host> cloud.uipath.comなどです。

<orgId> と <tenantId> は GUID であり、ブラウザーのアドレス バーに表示される組織名やテナント名ではありません。エントリが欠落している場合、または GUID の代わりに名前を使用しているエントリは、 invalid_request または Invalid redirect_uriで失敗します。

両方の GUID を取得するには、 を使用してサインイン uip login、次のコマンドを実行します。

uip login status --output json

応答では、 OrganizationId および TenantIdとして返されます。

このエントリは通常、外部アプリケーションを使用するコード化されたアクション アプリが初めてデプロイされたときに追加されます。アプリが送信する正確な値を読み取るには、アプリを開き、ブラウザーの [ネットワーク] タブで/identity_/connect/authorize要求からredirect_uriをコピーします。

Action Center のデバッグ ページを開きます

1. https://<host>/<orgName>/<tenantName>/actions_/debug/coded-action-appに移動します。このページでは、リダイレクト URI とは異なり、組織とテナントを名前で呼びます。
2. アプリの詳細を入力し、読み込みます。

アクション アプリをデプロイする

デプロイは 2 つのパートに分かれて行われます。開発者がアクション アプリをパッケージ化してパブリッシュしてから、そのパッケージを Orchestrator フォルダーにデプロイします。

アクション アプリをパッケージ化してパブリッシュする

コード化されたアクション アプリは、オートメーションで使用されるパッケージ形式と同じ .nupkg パッケージとして Orchestrator にパブリッシュされます。これは --type Actionとともにパブリッシュされ、Action Center タスクのユーザー インターフェイスとして選択できるように登録されます。

1. アプリを構築します。

   npm run build
   

2. ビルド出力をパッケージ化します。

   uip codedapp pack dist -n <appName> --version 1.0.0
   

3. UiPath 組織にサインインします。

   uip login
   

4. パッケージをアクション アプリとして、テナント フィードまたは個人用ワークスペース フィードにパブリッシュします。

   uip codedapp publish --type Action
   

5. アプリをデプロイします。

   uip codedapp deploy
   

各コマンドの完全な引数のリストについては、『UiPath CLI ガイド』の「uip codedapp」をご覧ください。

Orchestrator からアクション アプリをデプロイする

パッケージがすでにパブリッシュされている場合、またはコマンド ラインを使用しない場合は、代わりに Orchestrator からアクション アプリをデプロイします。

1. Orchestrator で [ テナント ] > [パッケージ] に移動します。
2. [アップロード] を選択し、uip codedapp packが作成した .nupkg ファイルをアップロードします。詳しい手順については、「 パッケージを管理する」をご覧ください。
3. アプリをデプロイするフォルダーに移動し、[ オートメーション] > Apps] に移動します。
4. [ アプリをデプロイ] を選択し、アプリとそのバージョンを選択します。詳しい手順については、「 アプリを管理する」をご覧ください。

Studio Web からアクション アプリをデプロイする

アクション アプリがコード化されたアプリ プロジェクトとして Studio Web ソリューション内に構築されている場合、そのアプリは単独でではなく、そのソリューションと一緒にパッケージ化およびデプロイされます。アクション アプリのバージョンは、依存するワークフロー、エージェント、リソースと歩調を合わせています。

1. アプリをローカルでビルドしてから、Studio Web プロジェクトにプッシュします。

   uip codedapp push --project-id <project-id>
   

2. Studio Web でソリューションを開き、[ デプロイ] を選択します。

3. パッケージ バージョンを設定し、個人用ワークスペースにパッケージ化するか共有ワークスペースにパッケージ化するかを選択します。デプロイに名前を付け、フォルダーを選択して [ デプロイ] を選択します。

[デプロイ] パネルのオプションの完全なセットについては、『Studio Web ガイド』の「 ソリューションをパブリッシュしてデプロイする 」をご覧ください。

デプロイが完了すると、アクション アプリは Action Center で利用可能になり、タスクのインターフェイスとして割り当てることができます。