通知を受け取る

UiPath Studio

UiPath Studio ガイド

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

アクティビティ フィードについて

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

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

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

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

  • Orchestrator - This activities feed is added by default if your Robot is connected to Orchestrator. For more info, see the About the Activities Feed chapter. This feed is enabled by default, and has the following source: https://[Orchestrator_host]/nuget/activities です。
  • Local - The feed can be excluded when installing Studio with the .msi installer. If you choose not to install the local activities feed, the folder is still created, but contains only the default activities, UiPath.UIAutomation.Activities UiPath.System.Activities UiPath.Excel.Activities and UiPath.Mail.Activities, together with dependencies previously set to a project. If installed, the feed is enabled by default, and has the following source: %ProgramFiles(x86)%\UiPath\Studio\Packages. Check out the list of default activities packages here.
  • Official - The official online UiPath feed, where you can find the activity packages that are officially supported by us. This feed is disabled by default, and has the following source: https://www.myget.org/F/workflow/ です。
  • Go! - The Go! public feed contains all the activities published on the UiPath Go! marketplace by our ever-growing community of partners, freelancers and UiPath RPA developers. Please note that whether or not packages are built and officially supported by UiPath is specifically stated in the Manage Packages window, Package Information tab. This feed is disabled by default, and has the following source: https://gallery.uipath.com/api/v2 です。
    パートナーまたは Go! フィード コミュニティより作成されたパッケージがに表示されてない場合がありますが、UiPath はこれをコントロールできません。ただし、UiPath は表示されていないパッケージを有効に保ち、実行時の後方互換性を確保します。
10821082

📘

注:

フィード構成は、新しい Studio Enterprise Edition にアップグレードしても保持されます。ただし、Orchestrator で提供されたライセンスで Studio をアクティベーションする場合、ローカルOrchestrator フィードのみが既定で有効化されます。

カスタム フィードの追加

📘

注:

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 Agent (Robot Tray) results in the Robot not being able to retrieve the appropriate package. To avoid such scenarios, you should add the custom feed in the UiPath.settings file under the ActivitiesFeed property instead of using the method below.

  1. [パッケージを管理] ウィンドウで、[設定] をクリックします。パッケージのソースが表示されます。
11251125
  1. image alt textimage alt text ボタンをクリックして、[ユーザー定義のパッケージ ソース] カテゴリにフィードを追加します。
  2. パッケージソースの名前または NuGet フィードの名前を入力します。
  3. [ソース] フィールドに、ローカル ドライブのフォルダー パス、共有ネットワーク フォルダーのパス、または NuGet フィードの URL を入力します。
  4. [追加] をクリックします。[パッケージを管理] ウィンドウの [ユーザーが定義したパッケージ ソース] および [すべてのパッケージ] カテゴリに、新しいフィードが自動的に追加されます。既定では、このフィールドは有効化されています。
  5. [保存] をクリックしてすべての変更を適用します。

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

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

📘

注:

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

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

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

You need to add the NuGet feed, username and password values in the NuGet.config file, located at the following path: %AppData%\NuGet. When it’s done, the feed should be visible in the Manage Packages window.

<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>

Please take into account that key="ClearTextPassword" should replace key="Password" when unencrypted passwords are used.

カスタム フィードの削除

📘

注:

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

  1. [設定] カテゴリの [ユーザーが定義したパッケージソース] セクションで任意のフィードをクリックします。
  2. [削除] image alt textimage alt text ボタンをクリックします。そのフィードは、[すべてのパッケージ] カテゴリと [ユーザーが定義したパッケージソース] セクションから削除されます。
  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. Check that the NuGet.config file located in %AppData%\NuGet has been updated with the new configuration:
<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="myEencryptedPassword" />
</config>
  1. Studio を再起動します。

パッケージの管理

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

11251125

An activity package is a bundle of activities that can help you automate a certain application (UiPath.Excel.Activities, UiPath.Word.Activities) or a category of apps (UiPath.Mail.Activities, UiPath.Terminal.Activities), or use certain technologies in your automations (UiPath.OCR.Activities, UiPath.FTP.Activities など)。

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

📘

注:

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

検索バーの横にある [プレリリースを含む] チェックボックスをオンにすると、ライブラリパッケージ (使用可能な場合) のベータ版が表示されます。
プロジェクトの依存関係の説明が [パッケージを管理] ウィンドウに表示されない場合は、[プレリリースを含める] チェックボックスをオンにします。

📘

重要:

UiPath.UIAutomation.Activities and UiPath.System.Activities packages are compatible with Studio v2018.3 and above.

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

📘

注:

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

  1. [パッケージを管理] ウィンドウで、[すべてのパッケージ] カテゴリを選択します。フィードから収集されたすべてのパッケージのリストが開きます。
11251125
  1. リストを下にスクロールして、目的のパッケージを探すか、検索バーにパッケージ名を入力します。アクティビティ パッケージのベータ版を含める (該当する場合) には、[プレリリースを含む] チェックボックスをオンにします。
  2. アクティビティ パッケージを選択して、その説明、バージョン、依存関係、プロジェクト URL、パブリッシュ日を確認します。
  3. [バージョン] の横のドロップダウン リストをクリックして、パッケージのバージョンを選択し、[ランタイム ルール] を設定します。プロジェクトの依存関係に関するランタイム ルールの詳細については、「依存関係の管理」ページをご覧ください。
  4. [インストール] ボタンをクリックします。または、パッケージ名の横にある image alt textimage alt text アイコンをクリックします。インストールの準備が完了すると、image alt textimage alt text アイコンになります。
547547
  1. アクティビティ パッケージのライセンス契約条件を確認する必要がある場合には、[ライセンスへの同意] ウィンドウが表示されます。[ライセンスを確認] をクリックしてライセンス契約の条件を確認します。
    • ライセンス契約の条件に同意してパッケージをインストールするには、[I Accept](同意する) をクリックします。
    • インストールをキャンセルして [パッケージ管理] ウィンドウに戻るには、[I Decline (同意しない)] をクリックします。

📘

注:

複数のアクティビティ パッケージをインストールする場合には、[ライセンスへの同意] ウィンドウが表示されます。ここには、それぞれのアクティビティ パッケージについてライセンス契約へのリンクが記載されています。[同意する] または [同意しない] をクリックして、すべてのパッケージのライセンス契約を同意するか、拒否します。

  1. ライセンス契約のないパッケージは、[保存] をクリックするだけでプロジェクトにインストールされます。

📘

注:

If during the installation of an activity package the path gets corrupted, the installation doesn’t complete. It is recommended to backup and then clear the content of the following local folders %userprofile%\.nuget\packages and %userprofile%\AppData\Local\UiPath\.cache です。

パッケージのアンインストール

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

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

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

By default, activities packages are downloaded and installed in the %userprofile%\.nuget\packages folder. You can set a different folder in one of the following ways:

  • During installation, by installing from the command line with the option PACKAGES_FOLDER です。

  • After installation, by manually editing the uipath.config file:

    1. Open the uipath.config file in a text editor. By default, the file is located in C:\Program Files (x86)\UiPath\Studio です。
    2. In the packageSettings node, add the packagesInstallationFolder key with the path to the new folder as its value.
    3. 変更を保存し、Robot がサービスとしてインストールされている場合は、サービスを再起動します。

    For example, add the following to uipath.config to change the download location to C:\nuget です。

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

1 年前に更新


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


改善の提案は、API リファレンスのページでは制限されています

改善を提案できるのは Markdown の本文コンテンツのみであり、API 仕様に行うことはできません。