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 でソリューションを管理する」をご覧ください。

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

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

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

• Use the Add to Solution button to open a menu with two sections:
  • Add to Solution - Add a project to your solution:
    • 新しいオートメーション プロジェクトを作成します。
    • Use Automation from Template to create an automation project from a template.
    • Create a new Maestro Flow or Maestro Automate project.
    • 既存のオートメーション プロジェクトをインポートする。
  • Add to Project - Add a new item to the current project:
    • A folder or a file.
    • A workflow file: sequence, flowchart, long running workflow, or state machine.
    • A form, a coded workflow, a coded test case, or a code source file.
    • A test case or a global handler.
    注:

    [ソリューション] パネル内で右クリックして [ ソリューションに追加 ] ウィンドウにアクセスすることもできます。

• 検索バーを使用して、ソリューション内の特定のプロジェクト、ファイル、ページ、アクション、変数、引数を検索します。
• ソリューションを右クリックして、名前を変更したり、Studio Web で開いたり、空のソリューションの場合はプロジェクトを追加します。[ ソリューションに追加 ] ボタンで提供されるオプションと同じオプションを使用します。
• Open the context menu of the solution and select Automation from Template to add a project based on a template. For more information, refer to Creating a project from a template.
• プロジェクトを右クリックすると、次のことが可能です。
  • Studio でプロジェクトを開き、プロジェクト固有のオプションを含むプロジェクトのコンテキスト メニューにアクセスする。
  • Studio Web で、プロジェクトを新しいブラウザー タブで開く。
  • Add files and folders to the project, or open its folder with Open Project Folder. These options are available for every project type in the solution. Projects that aren't active offer only Add > Folder... and File..., while the active project offers the full project menu.
  • ソリューションからプロジェクトを削除する。

When you open a solution in Studio, you can only make changes to the following project types:

• RPA projects
• Maestro Flow and Maestro Automate projects
• Data Fabric entity projects, which you edit with the UiPath Maestro extension

Other project types included in a solution cannot be modified from Studio and require you to continue editing the solution in Studio Web (this includes app projects, agentic processes, API projects, and agents).

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

The project list refreshes when another tool, such as the UiPath Maestro extension or uip solution projects add, changes the solution.

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

You can add a new project based on a template to a solution, without creating the project outside the solution first.

1. In the Explorer panel, open the context menu of the solution and select Automation from Template.
2. Select a template, and then configure the new project.

Studio creates the project inside the solution folder and adds it to the solution in the Explorer panel.

Creating a Maestro project

You can add two kinds of Maestro projects to a solution:

• Maestro Flow - Orchestrates a business process across agents, humans, and systems.
• Maestro Automate - Brings AI agents and APIs together in a single workflow.

To add one:

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

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

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

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

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

Both products use the same flow canvas, so you can move an existing project from one to the other.

1. In the Explorer panel, open the context menu of a Maestro project.
2. Select Convert to Maestro Automate or Convert to Maestro Flow, depending on the current project type.
3. Confirm the conversion.

After the conversion, every flow in the project publishes and runs on the runtime of the new project type. The flows themselves are not changed.

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

サポートされていないプロジェクトを右クリックして Studio Web で開くか、ソリューションから削除します。Studio Web で行った変更はクラウドに保存され、プロジェクトは新しいブラウザー タブで開きます。

The experience of designing and debugging RPA projects within a solution is the same as with standalone RPA projects, except when a project calls other projects of the solution through a Run Job activity. For more information, refer to Debugging projects that call other projects.

注:

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

The active project

RPA projects and Maestro Flow projects can be the active project of a solution. If the last active project can't be restored when you open a solution, Studio activates the first project in the solution that it can open, preferring RPA projects.

You can remove any project from the solution, including the active project, as long as at least one project remains in the solution. Removing a project deletes its files, so Studio asks you to confirm the removal first. When you remove the active project:

• The open files of the project are closed without prompting you to save them.
• Unsaved files from other projects still prompt you to save them. Canceling the prompt cancels the removal.
• No other project is activated automatically. Select the project you want to work on next.

Running and debugging in a solution

Debugging projects that call other projects

When you debug a file in a solution with more than one project, and the file calls another project of the solution through a Run Job activity, Studio prepares the solution automatically before debugging starts. Studio packs the solution, publishes it to your Personal Workspace, and deploys the called projects, so that they run as Orchestrator jobs when they are invoked. You don't need to publish the called projects or sync the solution to the cloud first.

Keep in mind the following:

• If Studio can determine that the file you debug never reaches a Run Job call, it skips this preparation, and debugging starts right away.
• If Studio cannot determine this, for example for coded workflows or dynamic invoke targets, it prepares the solution anyway.
• The file you debug runs locally. Breakpoints and stepping apply only to the project you debug. The called projects run remotely, and you cannot step into them.

Running and debugging Maestro flows

You can run and debug Maestro .flow files from the Studio ribbon, the same way as other files in the solution. The Run, Debug, Stop, Continue, Step Into, Step Over, and Step Out buttons control the flow session, and the output of the flow is displayed in the Output panel.

• Sessions that you start from the flow canvas are also controlled from the ribbon.
• Break is not available for flows.
• Breakpoints, stack frames, and variables are managed in the flow canvas.
• Running and debugging flows requires the UiPath Maestro extension.

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

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

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

リソースは、Studio と Studio Web のどちらからでも作成、定義、削除できます。リソースを削除するには、[ソリューション エクスプローラー] でリソースを右クリックして [削除] を選択します。詳しくは、『Studio Web ガイド』の「ソリューションのリソース」をご覧ください。

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

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

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

Studio Web でソリューションを作成した後、Studio で引き続き作業を続けることもできます。Studio Web の [ワークスペース] ページで、ソリューションの右側のメニューを開き、[デスクトップ版の Studio で開く] を選択します。または、Studio Web でソリューションを開き、[ソリューション エクスプローラー] でソリューション名を右クリックして、[デスクトップ版の Studio で開く] を選択します。

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, or only the active project or its test cases. For more information, refer to Publishing a solution.
• 一部のプロジェクトの種類 (エージェンティック プロセス、アプリ、API ワークフロー、エージェント) は、Studio Web でのみ開いて編集することができます。Studio では強力な RPA 設計とデバッグ エクスペリエンスが得られ、Studio Web ではエージェンティック オートメーション機能にアクセスできます。
• Support for solutions will be added to CI/CD integrations with UiPath CLI in the future.
• Studio Web の [ソリューション エクスプローラー] では Windows プロジェクトを表示できますが、それらを編集できるのは、Studio でソリューションを開いた場合のみです。
• 1 つのソリューションで一度に作業できるユーザーは 1 人のみです。解決できない競合 (あるユーザーが Studio Web で API ワークフロー プロジェクトを構築し、別のユーザーが Studio で RPA プロジェクトを編集している場合など) を防ぐために、ソリューション レベルのロックを導入しました。このロックがない場合、後でクラウドに同期すると、変更が 1 セット上書きされる可能性があります。Studio Web がローカル ワークスペースをサポートし (ソリューション全体をディスクに保存)、標準の Git フローで競合を安全に解決できるようになると、この制限は解消されます。
  ヒント:

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