パッケージとライブラリ

UiPath Robot で使用される NuGet パッケージ: 既定のフィード、ローカル フィードと Orchestrator フィード、パッケージのキャッシュ動作、Studio でのフィードの設定。

パッケージとは、アクティビティ、ワークフロー、ファイル、データ ソースなどの、オートメーションのすべての要素で構成されるバンドルです。Studio でプロジェクトを作成したら、そのプロジェクトをパッケージとして特定の場所またはフィードにパブリッシュします。ロボットはそこからパッケージをダウンロードし、そのパッケージを使用してオートメーションを実行できます。

重要:

パッケージの場所を指定するには、絶対パスを使用してください。

既定のフィード

Studio では、以下の場所とフィードが既定で設定されています。

• Orchestrator テナントおよび Orchestrator ホスト - ロボットが Orchestrator に接続されている場合はこれらのアクティビティ フィードが既定で追加され、無効化することはできません。Orchestrator テナント オプションは、Orchestrator でテナント ライブラリ フィードが有効化されている場合にのみ利用できます。このフィードのソースは https://[Orchestrator_host]/nuget/activities です。

• Local - The feed for the packages installed locally with Studio. When Studio of the same version is installed side by side with the Robot, the feed is the Packages folder of Studio, %ProgramFiles%\UiPathPlatform\Studio\<version>\Packages for per-machine installations or %LocalAppData%\Programs\UiPathPlatform\Studio\<version>\Packages for per-user installations. Otherwise, it's the Packages folder in the Robot installation folder, which might not exist.

  注:

  [パッケージを管理] ウィンドウに表示されるローカル フィードからのパッケージのパブリッシュ日は、パッケージがパブリッシュされた日付ではなく Studio インストーラーがビルドされた日付です。

• オフィシャル - UiPath の公式のフィードです。UiPath が公式にサポートしているアクティビティ パッケージが含まれています。このフィードのソースは https://pkgs.uipath.com/official/index.json です。

• Marketplace - このパブリック フィードには、UiPath Marketplace で公開されているすべてのアクティビティが含まれます。

  注:

  パッケージが UiPath によりビルドされ公式にサポートされているかどうかは、[パッケージを管理] ウィンドウの [パッケージ情報] タブに明示されます。

  このフィードのソースは https://gallery.uipath.com/api/v3/index.json です。

カスタム フィード

In Enterprise installations, a custom activity feed can only be used in workflows started from Studio on that user. Starting a job on the same machine from Orchestrator or the Assistant results in the Robot not being able to retrieve the appropriate package. To avoid such scenarios, add the custom feed to the NuGet.config file of the Robot. For the steps, refer to Configuring activity feeds.

重要:

カスタム フィードを使用するには、ロボットがカスタムの場所にアクセスできることを確認してください。

アクティビティ フィード

複数のフィードが使用されている場合、NuGet は最も応答が速いフィードを選択します。アクティビティ パッケージには複数のバージョンが含まれる可能性があるため、Robot は、次のように Studio のランタイム ルールに基づいてバージョンを検索します。

• [ストリクト] のランタイム ルールの場合、ロボットは指定されたパッケージ バージョンのみを検索します。たとえば、[バージョン] で 2.5.0 を選択し、[ランタイム ルール] を [ストリクト] に設定した場合、ロボットはバージョン 2.5.0 のみを検索します。見つからなかった場合、エラーがスローされます。
• [最も低い適用可能なバージョン] のランタイム ルールの場合、ロボットは指定されたパッケージ バージョン以降を検索します。たとえば、[バージョン] で 2.5.0 を選択し、[ランタイム ルール] を [最も低い適用可能なバージョン] に設定した場合、ロボットはバージョン 2.5.0 以降のバージョン (2.5.0、2.5.1、2.5.2 など) を検索します。見つからなかった場合、エラーがスローされます。

フィードに署名済みのパッケージと依存関係がない場合、オートメーションが失敗する可能性があります。これは、ロボットはパッケージと依存関係がすべて署名済みであることを予期するためです。これを防ぐには、設定されたすべてのフィードに、署名済みのパッケージおよび依存関係のみが含まれていることを確認してください。

重要:

• 構成ファイルを編集した場合、変更を有効にするには毎回 Robot サービスを再起動する必要があります。

• NuGet.config からの HTTPS フィードを無視するには、UiPath.config の <packageSettings> の下に次の行を追加します。

  <add key="skipHttpConfigurationSources" value="true" />
  

The UiPath Platform Installer adds two feeds to the NuGet.config file in the Robot installation folder: the Local feed, and the Executors feed, which holds the executor packages for agents, functions, and API workflows. Both are enabled by default.

ロボットを Orchestrator に接続すると、NuGet フィードが Orchestrator によって提供されます。このフィードには、UiPath によって公式にサポートされているアクティビティ パッケージが含まれています。このフィードは、既定で有効化されており、ストレージ設定によって異なります。

次のリストは、ロボットが使用するフィードを、Orchestrator へのロボットの接続に応じてまとめたものです。

• ロボットが Orchestrator に接続されている
  • NuGet.Repository.Type が Legacy に設定されている場合、アクティビティは既定で ~/NuGetPackages/Activities の場所に保存されます。この値はカスタマイズでき、Orchestrator マシンの web.config ファイルの NuGet.Activities.Path パラメーターで保持されます。
  • NuGet.Repository.Type が Composite に設定されている場合、アクティビティはパラメーター Storage.Type および Storage.Location で指定された場所に保存されます。
    重要:

    Composite オプションは、パッケージ ディレクトリでのコピーおよび貼り付けコマンドの使用を制限します。

• ロボットが Orchestrator に接続されていない ロボットが Orchestrator に接続されておらず、ローカル フィードで必要なアクティビティが見つからない場合、以下のフィードが使用されます。

  https://pkgs.uipath.com/official/index.json
  

これは公式のオンライン UiPath フィードであり、Studio のパッケージ マネージャーがアクティビティを取得するソースです。既定では、このフィードはアクティブではありません。有効化するには、Studio で [設定] > [パッケージ ソースを管理] に移動し、対応するオプションを選択します。

フォールバック パッケージ フォルダー

フォールバック パッケージ フォルダーとは、主要ソースに障害が発生した場合にロボットが必要なパッケージを取得できるバックアップ フォルダーです。

このフォルダーを設定するには、ロボット端末に NUGET_FALLBACK_PACKAGES 環境変数を追加します。この環境変数には、これらのバックアップ フォルダーへのフル パスそれぞれをセミコロンで区切ったリストを含める必要があります。環境変数が存在しない場合、ロボットは NuGet パッケージのフォールバック フォルダーを Nuget.config ファイルから読み取ろうとします。

重要:

フォールバック フォルダーを使用してオートメーションまたはワークフロー全体を保存および実行することはできません。

フォールバック フォルダーにデプロイされたプロセスはサポートされていません。依存関係のみがサポートされています。