アクティビティ パッケージを管理する

Studio で NuGet アクティビティ パッケージをアプリケーションおよびプロジェクト レベルで管理します。これには、フィードの設定やパッケージのインストールが含まれます。

Studio は NuGet フィードを使用してアクティビティ パッケージをインストールします。これらのフィードは、Studio で 2 つの方法で処理できます。

• アプリケーション レベル - フィードは [設定 ] > [ パッケージ ソースを管理 ] タブから設定します。
• プロジェクト レベル - フィードはリボンで [パッケージを管理] ボタンから構成されます。

アクティビティ フィードを無効化するには、対応するチェックボックスをオフにする必要があります。フィードの有効化または無効化は、プロジェクト レベルとアプリケーション レベルの両方で適用可能です。

Studio では、以下のアクティビティ フィードが既定で設定されています。

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

• ローカル - Studio でローカルにインストールされたパッケージのフィードです。このフィードのソースは、%ProgramFiles%\UiPath\Studio\Packages (マシン単位のインストールの場合) か、%localappdata%\Programs\UiPath\Studio\Packages (ユーザー単位のインストールの場合) です。

  注:

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

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

• Marketplace - このパブリック フィードには、UiPath Marketplace で公開されているすべてのアクティビティが含まれます。パッケージが UiPath によりビルドされ公式にサポートされているかどうかは、[パッケージを管理] ウィンドウの [パッケージ情報] タブに明示されます。このフィードのソースは https://gallery.uipath.com/api/v3/index.json です。

  なお、パートナーまたは Marketplace コミュニティより作成されたパッケージの掲載取り下げを UiPath がコントロールすることはできません。ただし、リストに表示されていないパッケージはアクティブな状態に保たれるため、実行は可能です。

  Marketplace のすべてのアクティビティは UiPath によって検証されます。また、Marketplace セキュリティ認定に合格する必要があります。

  

  注:

  フィードの設定は、Studio の新しいバージョンにアップグレードしても維持されます。

他のフィードは個別に追加できます。たとえば、次のようなフィードです。

• Official US (Automation Cloud for Public Sector を含む) - オンラインの UiPath オフィシャル フィードのレプリカです。このフィードでは、米国外の場所からパッケージをダウンロードすることはできません。ソースは https://pkgs.dev.azure.com/uipath-us/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.jsonです。

フィードの管理と設定は、ガバナンス ポリシーが適用されていなければ、[パッケージを管理] ウィンドウで行うことができます。ポリシーが適用されていて、フィード管理に関する権限を制限している場合は、ウィンドウにメッセージが表示されます。ガバナンスの詳細を確認してください。

カスタム フィードを追加する

注:

Enterprise インストールの場合、カスタム アクティビティ フィードは、そのユーザーの Studio から開始したワークフローでのみ使用できます。同じマシンで Orchestrator または Assistant からジョブを開始すると、ロボットは適切なパッケージを取得できません。これを回避するには、以下のメソッドを使用する代わりに、ActivitiesFeed プロパティ下の UiPath.settings ファイルにカスタム フィードを追加する必要があります。

1. [ パッケージを管理 ] ウィンドウで [ 設定] を選択します。パッケージ ソースが表示されます。

   

2. [ ] ボタンを選択して、[ ユーザー定義のパッケージ ソース ] カテゴリにフィードを追加します。

3. パッケージソースの名前または NuGet フィードの名前を入力します。

4. [ソース] フィールドに、ローカル ドライブのフォルダー パス、共有ネットワーク フォルダーのパス、または NuGet フィードの URL を入力します。

5. [追加] を選択します。新しいフィードは、ユーザー定義のパッケージ ソース間、および [パッケージを管理] ウィンドウの [すべてのパッケージ] カテゴリに自動的に追加されます。フィードは既定で有効化されています。

6. [ 保存 ] を選択して、すべての変更を適用します。

結果

カスタム フィードが [ パッケージを管理 ] ウィンドウのパッケージ ソースのリストに追加され、既定で有効化されます。

ユーザーが定義したパッケージ ソースと既定のパッケージ ソースは、[パッケージを管理] ウィンドウで有効化/無効化できます。

フィードは即座に追加されます。フィードを追加した後に、[閉じる] ボタンまたは [キャンセル] ボタンをクリックしても、変更を元に戻すことはできません。

注:

カスタム フィードに破損したパッケージまたはエディターで現在変更されているパッケージが含まれている場合、パッケージ マネージャーはフィード内のパッケージを読み込むことができません。

セキュリティで保護されたフィードを追加する

認証が必要なカスタムの NuGet フィードを追加する場合には、ここで説明する手順に従ってください。

NuGet フィード、ユーザー名、パスワードを NuGet.config ファイル (パス:%AppData%\NuGet) に追加する必要があります。完了すると、フィードが [パッケージを管理] ウィンドウに表示されるはずです。

<packageSources>
  <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  <add key="FeedName" value="https://FeedSource" />
  </packageSources>
  
 <packageSourceCredentials>
  <FeedName>
    <add key="Username" value="YourUsername" />
    <add key="Password" value="YourPassword" />
  </FeedName>
</packageSourceCredentials>

非暗号化されたパスワードを使用する場合は、key="Password"を key="ClearTextPassword" で置き換える必要があることに注意してください。

カスタム フィードを削除する

注:

[パッケージを管理] ウィンドウから削除できるのは、ユーザーが定義したパッケージ ソースのみです。

1. [設定] カテゴリで、[ユーザー定義のパッケージ ソース] セクションのいずれかのフィードを選択します。
2. [ を削除] ボタンを押します。そのフィードは 、[すべてのパッケージ] カテゴリと [ユーザーが定義したパッケージ ソース ] セクションから削除されます。
3. [ 保存 ] を選択して変更を適用します。

フィードは即座に削除されます。既定のフィードまたはカスタム フィードを削除した後に、[閉じる] ボタンまたは [キャンセル] ボタンをクリックしても、変更を元に戻すことはできません。

プロキシ サーバー経由でフィードに接続する

お使いのコンピューターがプロキシ サーバーの内側にある場合は、ネットワークの外側にあるフィードにアクセスできるように NuGet プロキシの設定を行う必要があります。

1. https://www.nuget.org/downloads から nuget.exe をダウンロードします。
2. nuget.exe がダウンロードされたフォルダー内でコマンド プロンプト ウィンドウを開き、以下のコマンドを実行してプロキシ サーバーのアドレス、ユーザー名、パスワードを設定します。

   nuget.exe config -set http_proxy=<http://proxy.server.address:port>

   nuget.exe config -set http_proxy.user=<mydomain\myUserName>

   nuget.exe config -set http_proxy.password=<myPassword>

3. %AppData%\NuGet にあるファイル NuGet.config が新しい設定に更新されていることを確認します。

   <config>
       <add key="http_proxy" value="http://proxy.server.address:port" />
       <add key="http_proxy.user" value="mydomain\myUserName" />
       <add key="http_proxy.password" value="myEncryptedPassword" />
   </config>
   

4. Studio を再起動します。

パッケージを管理する

Package Manager の機能により、アクティビティ パッケージ、ライブラリ、フレームワーク、ラッパーなどをダウンロードできます。また、プロジェクトのためにインストール済みのものの表示や更新、独自のものの追加や削除も可能です。フィードごとに使用可能なパッケージのリストが表示され、現在のプロジェクトごとに依存関係のリストが表示されます。[パッケージを管理] ウィンドウには、常に [プロジェクト依存関係] リストが表示されます。

アクティビティ パッケージは、特定のアプリケーションの自動化 (UiPath.Excel.Activities, UiPath.Word.Activities)、アプリケーションのカテゴリの自動化 (UiPath.Mail.Activities, UiPath.Terminal.Activities)、またはオートメーション内の特定のテクノロジの使用 (UiPath.OCR.Activities, UiPath.FTP.Activities) に役立つアクティビティのバンドルです。

パッケージに関する詳細は、前のスクリーンショットに示すように [パッケージを管理] ウィンドウの右側のパネルに表示されます。

注:

NuGet v3 の制約により、アクティビティ パッケージのリリース ノートは、[パッケージを管理] ウィンドウには表示されません。

検索バーの横にある [プレリリースを含む] チェックボックスをオンにすると、ライブラリ パッケージ (使用可能な場合) のベータ版が表示されます。チェックボックスの表示/非表示は、ガバナンス ポリシーを使用して制御できます。

プロジェクトの依存関係の説明が [パッケージを管理] ウィンドウに表示されない場合は、[プレリリースを含める] チェックボックスをオンにします。

注:

UiPath.UIAutomation.Activities パッケージと UiPath.System.Activities パッケージは、Studio v2018.3 以降に対応しています。

パッケージをインストールする

注:

アクティビティ パッケージのダウンロードとインストールにはインターネット接続が必要です。

注:

組織で適用されているパッケージ署名が使用されている場合は、公式のパッケージをインストールできるように、信頼された UiPath 証明書を追加する必要があります。詳しくは、こちらをご覧ください。

1. [パッケージを管理] ウィンドウで、[すべてのパッケージ] カテゴリを選択します。フィードから収集されたすべてのパッケージのリストが開きます。

   

2. インストールするパッケージを検索します。利用可能なアクティビティ パッケージとバージョンは、プロジェクトに選択した対応 OS によって異なります。

次のことが可能です。

• リストを下にスクロールしながらパッケージを探します。
• 名前または説明の一部を検索バーに入力して、パッケージを検索します。
• 検索バーの横にあるフィルター アイコンをクリックし、表示したいオプションだけを選択して、リストをフィルター処理します。
  • プレリリースを含む - パッケージのベータ版を含める (該当する場合)。
  • UiPath のみ - UiPath がパブリッシュしたパッケージだけを表示。
  • アクティビティのみ - アクティビティ パッケージだけを表示。
  • ライブラリのみ - ライブラリだけを表示。
  • UI ライブラリのみ - オブジェクト リポジトリからパブリッシュされた UI ライブラリだけを表示。
  • 対応バージョンのみ - 最新バージョンがプロジェクトの対応 OS に対応しているパッケージのみを表示します。プロジェクトの対応 OS に対応している古いバージョンが存在するパッケージを表示する場合は、このオプションを選択しないでください。

3. アクティビティ パッケージを選択して、その説明、バージョン、依存関係、プロジェクト URL、パブリッシュ日を確認します。
4. [ バージョン ] の横にあるドロップダウン リストを選択してパッケージのバージョンを選択し、[ ランタイム ルール] を設定します。プロジェクト依存関係のランタイム ルールについて詳しくは 、「依存関係を管理する 」をご覧ください。
5. [ インストール ] ボタンを選択します。または、パッケージ名の横にある アイコンを選択して アイコンでマークすると、インストールの準備が整います。
   注:

   サードパーティ パッケージとその依存関係に関する利用規約には、パッケージのインストール時に暗黙的に同意しています。UiPath のパッケージとそれらの依存関係に対する利用規約には、Studio のインストール時に暗黙的に同意しています。UiPath の利用規約 と プライバシー ポリシーをお読みください。

6. [ 保存 ] を選択して、パッケージをインストールするか、バージョンを更新します。
   注:

   アクティビティ パッケージのインストール時にパスが破損した場合は、インストールが完了しません。次のローカル フォルダー %userprofile%\.nuget\packages および %userprofile%\AppData\Local\UiPath\.cache のコンテンツをバックアップしてから、消去することをお勧めします。

パッケージをアンインストールする

パッケージをアンインストールするには、[プロジェクト依存関係] カテゴリに移動し、使用しなくなったパッケージの横にある [アンインストール] ボタンをクリックします。[保存] をクリックしてはじめてパッケージが削除されます。

オートメーション プロジェクトの実行時には、[パッケージを管理] ボタンが無効化されます。実行が停止されるまで、アクティビティ パッケージのインストールや削除はできません。

パッケージをダウングレードする

Downgrading activity packages is not recommended. The main reason is the negative effects it can have on dependencies. Dependencies between different activity packages are carefully managed in each version. Therefore, downgrading might cause inconsistencies, or even dysfunctional workflows.

Moreover, newer activity packages offer improved features and functionalities that might not be available in older versions. Thus, to ensure optimal performance and avoid potential errors, it is advisable to keep activity packages at their current versions or upgrade to the latest versions.

パッケージのダウンロード フォルダーを変更する

既定では、アクティビティ パッケージは %userprofile%\.nuget\packages フォルダーにダウンロード・インストールされます。別のフォルダーを設定するには、次のいずれかの方法で行います。

• インストール中の場合、コマンド ラインから PACKAGES_FOLDER オプションを使用してインストールする。
• インストール後の場合、uipath.config ファイルを手動で編集する。
  1. テキスト エディターで uipath.config ファイルを開きます。既定では、このファイルは C:\Program Files\UiPath\Studio にあります。
  2. ノード packageSettings に、新しいフォルダーへのパスを値として含めたキー packagesInstallationFolder を追加します。
  3. 変更を保存し、Robot がサービスとしてインストールされている場合は、サービスを再起動します。

たとえば、ダウンロードする場所を C:\nuget に変更するには、uipath.config ファイルに以下を追加します。

 ```
 <packageSettings>
   <add key="packagesInstallationFolder" value="C:\Nuget" />
 </packageSettings>
 ```

注:

.nuget フォルダーの内容を削除すると、Studio でプロジェクトを開くときに依存関係の競合が発生します。

パッケージをオフライン環境で管理する

インターネットに接続されていないコンピューターで Studio を使用している場合、他のコンピューターにパッケージをダウンロードした後、Studio がインストールされているコンピューターに手動で転送することができます。この操作は、Orchestrator への接続を利用できない場合にのみ必要になります。Studio が Orchestrator に接続されている場合は、Orchestrator フィードからパッケージをインストールできます。

注:

Studio がオンライン フィードからパッケージをダウンロードしないようにするには、オフラインのマシン上のオンライン フィードをすべて無効化します。

オフラインの Studio マシンにパッケージをインストールするには、以下の手順を実行します。

1. インターネットにアクセスできるコンピューターで、NuGet Package Explorer をダウンロードしてインストールします。
2. NuGet Package Explorer を開いて、[Open a package from an online feed] を選択します。
3. [Package source] フィールドに、パッケージのダウンロード元フィードの URL を入力します。UiPath のオフィシャル パッケージ フィードは https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json です。
4. フィードでパッケージを検索しダウンロードします。
5. nupkg ファイルを、Studio がインストールされているコンピューター上の、Studio でパッケージ ソースとして定義されたフォルダーに転送します。パッケージを既定のローカル フィードに追加するには、ファイルを %ProgramFiles%\UiPath\Studio\Packages (マシン単位のインストールの場合) か、%localappdata%\Programs\UiPath\Studio\Packages (ユーザー単位のインストールの場合) にコピーします。

オプション パッケージを含むアーカイブを使用する

Studio インストーラーのサイズを縮小するため、v2022.10 のリリース以降、UiPathStudio.msi ファイルに一部のアクティビティ パッケージが含まれなくなりました。エアギャップ環境で作業するユーザーや、必要なパッケージを常にローカル ストレージに保持するユーザー向けに、インストーラーに含まれないパッケージの ZIP アーカイブとそれらのパッケージの依存関係を Customer Portal からダウンロードできるようにしました。アーカイブを使用することにより、Studio または Robot のマシンにパッケージを配置できます。

アーカイブには、以下のパッケージの最新バージョンが含まれています。

• UiPath.MobileAutomation.Activities
• UiPath.Terminal.Activities
• UiPath.Persistence.Activities
• UiPath.PDF.Activities

ローカル フィード フォルダーにパッケージを追加するには、以下の手順を実行します。

1. UiPath Customer Portal から ZIP アーカイブをダウンロードします。
2. アーカイブを、Studio または Robot のマシンからアクセス可能な場所に配置します。
3. 次のいずれかの方法でパッケージを追加します。

• インストール中 - インストールを開始する前に、Studio の MSI インストーラーと同じルート フォルダーにアーカイブを配置します。パッケージは、インストーラーによってローカル フィード フォルダーに追加されます。
• インストール後 - アーカイブの内容を以下の既定のローカル パッケージ フォルダーに展開します。
  • ユーザー単位のインストールの場合は %localappdata%\Programs\UiPath\Studio\Packages
  • マシン単位のインストールの場合は %ProgramFiles%\UiPath\Studio\Packages

コネクタを管理する

[すべてのコネクタ] カテゴリで、UiPath® Integration Service のコネクタを追加、削除、フィルター処理、検索できます。Integration Service のコネクタは構築済みの強力な API 連携機能で、UiPath の外部にあるアプリケーションとの連携プロセスを簡素化すると共に、一貫性のある開発エクスペリエンスを提供します。コネクタについて詳しくは、『 Integration Service ガイド』をご覧ください。

利用可能なすべてのコネクタは、[ すべてのコネクタ ] カテゴリにアルファベット順に一覧表示されます。コネクタを選択すると、右側にコネクタのパネルが開き、以下を確認できます。

• コネクタの詳細な説明

• コネクタが属するカテゴリ

• コネクタの所有者

• コネクタのドキュメント ページへのリンク

• コネクタと共に提供されるアクティビティ

• コネクタと共に提供されるトリガー

  

コネクタをプロジェクトに追加するには、以下の手順を実行します。

1. 利用可能なコネクタのリストで、各コネクタの横にある [プロジェクトに追加] または [プロジェクトから削除] ボタンを選択します。アイコン は、コネクタのインストールが保留中であることを示します。
2. [パッケージを管理] ウィンドウの一番下にある [保存] ボタンを選択します。コネクタがプロジェクトに追加され、[アクティビティ] パネルの [インストール済み] カテゴリに表示されます。

コネクタ ペインの [プロジェクトに追加] ボタンまたは [プロジェクトから削除] ボタンを選択して [保存] を選択することで、コネクタを追加または削除することもできます。

注:

コネクタをインストールすると、 UiPath.IntegrationService.Activities パッケージもインストールされ、プロジェクト依存関係として追加されます。

コネクタの名前または説明の一部を検索バーに入力して、コネクタを検索できます。コネクタのカテゴリ ([CRM] や [メール] など) を検索することもできます。

コネクタのリストをフィルター処理するには、検索バーの横にあるフィルター アイコンを選択し、以下の 1 つまたは複数のオプションを選択します。

1. グループ化
   • UiPath - UiPath が作成したコネクタだけを表示します。
   • 自分の組織 - 組織が作成したコネクタだけを表示します。
   • 自分 - 自分が作成したコネクタだけを表示します。
2. バージョン
   • プレビュー - プレビュー版のコネクタだけを表示します。