Solutions (ソリューション)

Studio でソリューションを作成および管理し、オートメーション プロジェクトをその依存関係と共にグループ化し、完全なエンドツーエンドのオートメーションとしてテナント全体にデプロイします。

ソリューションは、エンドツーエンドの業務プロセスを自動化するために必要なすべてのものをグループ化し、オートメーション プロジェクトをその依存関係と一緒に開発し、テナント全体に一括してデプロイする機能を提供します。

ソリューションは、エンドツーエンドのオートメーションをバージョン管理された 1 つのユニットとしてモデル化するためのクラウドレベルのコンテナーです。ソリューションでは、以下を作成およびオーケストレーションできます。

• RPA ワークフロー
• API ワークフロー
• Agents
• エージェンティック プロセス
• アプリ (人間参加型の検証)

これらのコンポーネントはすべて、ソリューション レベルで一元管理する、ソリューションのスコープのリソース (アセット、コネクション、キュー、ストレージなど) を共有します。また、ソリューションはポータブルで、一度パッケージ化すれば、環境固有の設定でテナントや組織全体にデプロイできます。

詳細については、『 Studio Web ガイド』をご覧ください。ソリューションの構築、パッケージ化、デプロイの方法をエンドツーエンドで確認するには、「 ソリューション開発ライフサイクル」をご覧ください。

Studio でソリューションを作成する

ソリューションは、Studio で直接作成できます。 開始 ページから空のソリューションを作成することも、最初のプロジェクトと一緒に作成することもできます。

開始ページから開始

1. Studio の [開始 ] ページの [ 新しいプロジェクト] で [ ソリューション] を選択します。
2. [ 新しいソリューション ] ウィンドウで、ソリューションの名前と場所を入力するか、事前に入力された値を保持して [ 作成] を選択します。
   注:

   既存のフォルダーと競合する名前はダイアログで拒否されます。

Studio によって空のソリューションが作成され、[ エクスプローラー] パネルで開きます。プロジェクトを追加するには、[ ソリューションに追加 ] ボタンを選択するか、ソリューションのルート ノードのコンテキスト メニューを開きます。どちらも同じオプションを提供します。

新しいプロジェクトから開始する

1. Studio で、新しい プロセス プロジェクトまたは テンプレート プロジェクトを開始します。
2. 新しいプロジェクト設定で、[ 新しいソリューションを作成] を有効化します。Studio によってソリューションが作成され、プロジェクトが [エクスプローラー ] パネルの最初のメンバーとして開きます。
3. ソリューションにさらにプロジェクトを追加するには、[エクスプローラー] パネルの [ソリューションに追加] ボタンを選択します。新しいオートメーション プロジェクトを作成することも、既存のオートメーション プロジェクトをインポートすることもできます。
   注:

   [エクスプローラー] パネルのコンテキスト メニューを開いて、同じオプションにアクセスすることもできます。

Studio Web で作成したソリューションで作業を続けるには、Studio Web の [ワークスペース ] ページからソリューションを開き、[ デスクトップ版の Studio で開く] を選択します。その他のオプションについては、「 Studio および Studio Web でソリューションを管理する」をご覧ください。

[エクスプローラー] パネル

[エクスプローラー] パネルでは、ソリューション内のプロジェクトと各プロジェクト内のプロジェクト ファイルを管理できます。

[エクスプローラー] パネルでは、以下の操作を実行できます。

• [ソリューションに追加] ボタンを使用して、次の 2 つのセクションを含むメニューを開きます。
  • ソリューションに追加 - プロジェクトをソリューションに追加します。
    • 新しいオートメーション プロジェクトを作成します。
    • [ テンプレートからのオートメーション ] を使用して、テンプレートからオートメーション プロジェクトを作成します。
    • 新しい Maestro Flow または Maestro Automate プロジェクトを作成します。
    • 既存のオートメーション プロジェクトをインポートする。
  • プロジェクトに追加 - 現在のプロジェクトに新しい項目を追加します。
    • フォルダーまたはファイル。
    • ワークフロー ファイル: シーケンス、フローチャート、長期実行のワークフロー、ステート マシン。
    • フォーム、コード化されたワークフロー、コード化されたテスト ケース、またはコード ソース ファイル。
    • テスト ケースまたはグローバル ハンドラー。
    注:

    You can also access the Add to Solution window from the context menu of the Solution panel.

• 検索バーを使用して、ソリューション内の特定のプロジェクト、ファイル、ページ、アクション、変数、引数を検索します。
• Open the context menu of the solution to rename it, open it in Studio Web, or, for an empty solution, add a project — the same options offered by the Add to Solution button.
• ソリューションのコンテキスト メニューを開き、[ テンプレートからオートメーション ] を選択すると、テンプレートに基づいたプロジェクトが追加されます。詳しくは、「 テンプレートからプロジェクトを作成する」をご覧ください。
• Open the context menu of the solution or a folder and select Add > Folder... to group projects into folders. For more information, refer to Organizing projects into folders.
• Open the context menu of a project to:
  • Studio でプロジェクトを開き、プロジェクト固有のオプションを含むプロジェクトのコンテキスト メニューにアクセスする。
  • Studio Web で、プロジェクトを新しいブラウザー タブで開く。
  • プロジェクトにファイルやフォルダーを追加するか、[ プロジェクト フォルダーを開く] を使用してそのフォルダーを開きます。これらのオプションは、ソリューションに含まれるすべてのプロジェクトの種類で使用できます。アクティブでないプロジェクトでは [>フォルダーを追加...] と [ファイル...] のみが提供され、アクティブなプロジェクトでは完全なプロジェクト メニューが提供されます。
  • ソリューションからプロジェクトを削除する。

Studio でソリューションを開くと、次のプロジェクトの種類にのみ変更を加えることができます。

• RPA プロジェクト
• Maestro Flow と Maestro Automate プロジェクト
• Data Fabric エンティティ プロジェクト。 UiPath Maestro 拡張機能を使用して編集します

ソリューションに含まれる他のプロジェクトの種類 (アプリ プロジェクト、エージェンティック プロセス、API プロジェクト、エージェントなど) は Studio からは変更できないため、引き続き Studio Web でソリューションを編集する必要があります。

サポートされていない他の種類のプロジェクトは、ソリューション エクスプローラーで RPA プロジェクトやフロー プロジェクトと共に参照できます。いずれかのエンティティからファイルを開くと、コンテキスト バナーに、制限された編集エクスペリエンスの説明と、Studio Web で編集するためのリンクが表示されます。

UiPath Maestro 拡張機能や uip solution projects addなどの別のツールによってソリューションが変更されると、プロジェクトのリストが更新されます。

テンプレートからプロジェクトを作成する

テンプレートに基づいて新しいプロジェクトをソリューションに追加できます。最初にソリューションの外部でプロジェクトを作成する必要はありません。

1. [ エクスプローラー ] パネルでソリューションのコンテキスト メニューを開き、[ テンプレートから自動化] を選択します。
2. テンプレートを選択し、新しいプロジェクトを設定します。

Studio によってソリューション フォルダー内にプロジェクトが作成され、[ エクスプローラー] パネルでソリューションに追加されます。

Maestro プロジェクトを作成する

ソリューションには、次の 2 種類の Maestro プロジェクトを追加できます。

• Maestro Flow - エージェント、人間、システムにわたってビジネス プロセスをオーケストレーションします。
• Maestro Automate - AI エージェントと API を 1 つのワークフローに統合します。

追加するには、次の手順を実行します。

1. [ エクスプローラー] パネルで、[ ソリューションに追加 ] ボタンを選択します。
2. [ Maestro Flow ] または [ Maestro Automate] を選択します。
3. プロジェクトの名前を入力し、[ 新規作成] を選択します。

Studio がコマンド ラインから実行するのと同じ方法で、プロジェクトをソリューションに uip maestro flow init つ編み込み、フロー ファイルを開きます。

.flow ファイルを初めて開くと、UiPath Maestro 拡張機能をインストールするよう促すメッセージが表示されます。インストールすると、完全な視覚的なフロー キャンバスを取得できます。タイムアウトが設定されていない場合、ファイルはプレーン テキストとして開きます。

フロー自体の構築方法については、 『Maestro ユーザー ガイド』をご覧ください。

Maestro Flow と Maestro Automate の間で変換する

どちらの製品でも同じフロー キャンバスを使用するため、既存のプロジェクトを一方から他方に移動できます。

1. [ エクスプローラー] パネルで、Maestro プロジェクトのコンテキスト メニューを開きます。
2. 現在のプロジェクトの種類に応じて、[ Maestro Automate に変換 ] または [ Maestro Flow に変換] を選択します。
3. 変換を確認します。

変換後、プロジェクト内のすべてのフローは新しいプロジェクトの種類のランタイムでパブリッシュされて実行されます。フロー自体は変更されません。

プロジェクトをフォルダーに整理する

You can group the projects of a solution into folders in the Explorer panel. Folders can be nested.

To add a folder:

1. In the Explorer panel, open the context menu of the solution or an existing folder.
2. Select Add > Folder....
3. Enter a name for the folder.

The context menu of a folder also offers the Add to Solution options:

• Automation - Create a new automation project in the folder.
• Automation from Template - Create an automation project from a template in the folder.
• Import Existing Project - Import an existing automation project into the folder.

You can rename and delete a folder from its context menu, with the following restrictions:

• A folder that contains projects of the solution can't be deleted. Remove the projects from the solution first.
• A folder that contains the open project can't be renamed or deleted. Close the project first.
• The folder that stores the solution's resource definitions can't be renamed or deleted from Studio.

RPA 以外のプロジェクトを管理する

From the context menu of any unsupported project, you can open it in Studio Web, publish it on its own, or remove it from the solution. Changes made in Studio Web are saved to the cloud and the project opens in a new browser tab. For publishing, refer to Publishing a Single Project.

ソリューション内で RPA プロジェクトを設計およびデバッグする方法は、プロジェクトが [ ジョブを実行] アクティビティを介してソリューションの他のプロジェクトを呼び出す場合を除き、スタンドアロンの RPA プロジェクトの場合と同じです。詳しくは、「 他のプロジェクトを呼び出すプロジェクトをデバッグする」をご覧ください。

注:

Windows - レガシ プロジェクトをソリューションに追加またはインポートすることはできません。

アクティブなプロジェクト

RPA プロジェクトと Maestro Flow プロジェクトを、ソリューションのアクティブなプロジェクトにすることができます。ソリューションを開いたときに最後にアクティブだったプロジェクトを復元できない場合、Studio では、ソリューション内で開くことができる最初のプロジェクトがアクティブ化され、RPA プロジェクトが優先されます。

ソリューション内に少なくとも 1 つのプロジェクトが残っている限り、アクティブなプロジェクトを含め、任意のプロジェクトをソリューションから削除できます。プロジェクトを削除するとファイルが削除されるため、最初に削除の確定を求められます。アクティブなプロジェクトを削除すると、以下の手順が実行されます。

• プロジェクトの開いているファイルは閉じられ、保存を求められません。
• 他のプロジェクトから保存されていないファイルでは、保存を求めるメッセージが表示されます。プロンプトをキャンセルすると、削除がキャンセルされます。
• 他のプロジェクトは自動的にアクティブ化されません。次に作業するプロジェクトを選択します。

ソリューション内で実行およびデバッグする

他のプロジェクトを呼び出すプロジェクトをデバッグする

複数のプロジェクトを含むソリューション内のファイルをデバッグする場合、そのファイルが [ ジョブを実行] アクティビティを介してソリューションの別のプロジェクトを呼び出すと、デバッグが開始される前にソリューションが自動的に準備されます。Studio はソリューションをパッケージ化して個人用ワークスペースにパブリッシュし、呼び出されたプロジェクトをデプロイして、呼び出されたときに Orchestrator ジョブとして実行されるようにします。最初に呼び出されたプロジェクトをパブリッシュしたり、ソリューションをクラウドに同期したりする必要はありません。

次の点に注意してください。

• デバッグしたファイルが ジョブの実行 呼び出しに到達しないと Studio が判断できた場合、この準備はスキップされ、デバッグが直ちに開始されます。
• コード化されたワークフローや動的呼び出しターゲットなど、Studio がこれを判別できない場合は、そのままソリューションを準備します。
• デバッグするファイルはローカルで実行されます。ブレークポイントとステップは、デバッグするプロジェクトにのみ適用されます。呼び出されたプロジェクトはリモートで実行され、ユーザーがそのプロジェクトにステップインすることはできません。

Maestro フローを実行およびデバッグする

Maestro .flow ファイルは、ソリューション内の他のファイルと同じ方法で、Studio のリボンから実行およびデバッグできます。[ 実行]、[ デバッグ]、[ 停止]、[ 続行]、[ ステップ イン]、[ ステップ オーバー]、および [ステップ アウト ] ボタンはフロー セッションを制御し、フローの出力は [ 出力] パネルに表示されます。

• フロー キャンバスから開始するセッションも、リボンから制御します。
• フローでは休憩は利用できません。
• ブレークポイント、スタック フレーム、変数はフロー キャンバスで管理します。
• フローを実行およびデバッグするには、 UiPath Maestro 拡張機能が必要です。

定義済みのリソース パネル

[定義済みのリソース] パネルには、ソリューションに含まれるリソースが表示されます。パネルは折りたたむことができます。リソースはアクティビティで使用されるため、ソリューションに自動的に追加され、以下のカテゴリにグループ化されます。

• Apps - データに接続するカスタム ビジネス アプリケーションを構築できる、オートメーションによって提供されるユーザー インターフェイスです。
• アセット - さまざまなオートメーション プロジェクトで使用できる共有変数または資格情報です。
• ビジネス ルール - Decision Model and Notation (DMN) ファイルの保存と管理に使用するオブジェクトです。
• コネクション - シングル ユーザーと外部アプリケーションの間でタスクを確立するのに役立つ Integration Service のコネクションです。
• コンテキスト - コンテキスト グラウンディングのインデックスです。これにより、権限が設定されたナレッジ ベースにアクセスできるようになります。
• プロセス - 特定のフォルダーにリンクされたパッケージ バージョンです。
• キュー - 無制限の数のアイテムを保持できるコンテナーです。
• ストレージ バケット - オートメーション プロジェクトの作成時に使用するフォルダー単位のストレージ ソリューションです。
• タスク カタログ - さまざまな基準に基づいてアクションを分類できるアクション コンテナーです。アクションを格納するカタログは、Studio Web のアクション作成アクティビティを使用してアクションが作成されるときに設定されます。
• 依存関係 - 特定のプロジェクトにコンテキスト的にリンクされたアクティビティのカテゴリです。

Resources can be created, defined, or deleted both from Studio and Studio Web. To delete a resource, open its context menu in the Solution Explorer and select Remove. To learn more, refer to Solution Resources in the Studio Web guide.

アクティビティはソリューションのコンテキストを認識します。ソリューション リソースを扱うアクティビティ (キュー アイテムを追加など) 内では、リソース ピッカー ウィジェットに利用可能なすべてのリソース (アセット、キュー、コネクションなど) が表示されます。[Orchestrator を開く] ボタンを使用して、Orchestrator でプラットフォーム リソースを管理することもできます。

Editing a resource

1. In the Defined Resources panel, open the context menu of a resource and select Open.
2. Edit the resource in the tab that opens.

Changes are saved as you make them. When you rename a resource, the Defined Resources panel and the tab title show the new name.

Studio および Studio Web でソリューションを管理する

ソリューションに加えた変更は常にクラウドに同期されるため、Studio と Studio Web をシームレスに切り替えることができます。

After you create a solution in Studio Web, you have the option to continue working in Studio. From the Workspace page in Studio Web, open the menu on the right side of a solution and select Open in Studio Desktop. Alternatively, open the solution in Studio Web, open the context menu of the solution name in the Solution Explorer, and select Open in Studio Desktop.

Studio Web で作成したソリューションを開いた後、ステータス バーの「クラウド ソリューション」ラベルを選択するとドロップダウン メニューが開き、ソリューションを管理できるオプションが表示されます。

• ブラウザーで開く - ソリューションを Studio Web で開きます。ソリューションが Studio Web によってロックされている場合、エラーが表示され、ソリューションは新しいタブで読み取り専用モードで開かれます。
• Cloud と同期 - Studio で行った変更をプッシュし、Studio Web でソリューションの構築を続けます。

Git でバージョン管理されるソリューションを追加するには、ステータス バーの「ソース管理に追加」ラベルを選択します。これにより、コミットとブランチをソリューション レベルで管理できます。

注:

• Studio は、プロジェクトがソリューションの一部であることを検出します。ソリューションの一部であるローカル プロジェクトを開くと、自動的にソリューション コンテキスト全体が開きます。
• クロスプラットフォーム プロジェクトを Windows 対応のプロジェクトに変換する場合、プロジェクトは直接変換され、元のプロジェクトのコピーを作成するオプションはありません。

Studio および Studio Web でソリューションを操作する

Studio と Studio Web でソリューションを操作する際は、以下の違いに注意してください。

• 個々のプロジェクトの名前の変更は現在 Studio Web でのみサポートされています。
• From Studio, you can publish the whole solution, a single project, or the test cases of the active project. For more information, refer to Publishing a solution.
• 一部のプロジェクトの種類 (エージェンティック プロセス、アプリ、API ワークフロー、エージェント) は、Studio Web でのみ開いて編集することができます。Studio では強力な RPA 設計とデバッグ エクスペリエンスが得られ、Studio Web ではエージェンティック オートメーション機能にアクセスできます。
• UiPath CLI との CI/CD 連携には、今後、ソリューションのサポートが追加される予定です。
• Studio Web の [ソリューション エクスプローラー] では Windows プロジェクトを表示できますが、それらを編集できるのは、Studio でソリューションを開いた場合のみです。
• 1 つのソリューションで一度に作業できるユーザーは 1 人のみです。解決できない競合 (あるユーザーが Studio Web で API ワークフロー プロジェクトを構築し、別のユーザーが Studio で RPA プロジェクトを編集している場合など) を防ぐために、ソリューション レベルのロックを導入しました。このロックがない場合、後でクラウドに同期すると、変更が 1 セット上書きされる可能性があります。Studio Web がローカル ワークスペースをサポートし (ソリューション全体をディスクに保存)、標準の Git フローで競合を安全に解決できるようになると、この制限は解消されます。
  ヒント:

  • Git をソリューション レベルで使用して、オートメーション プロジェクトをその構成と一緒にバージョン管理してください。