- リリース ノート
- 基本情報
- セットアップと構成
- オートメーション プロジェクト
- 依存関係
- ワークフローの種類
- ファイルの比較
- オートメーションのベスト プラクティス
- ソース管理との連携
- デバッグ
- 診断ツール
- ワークフロー アナライザー
- 変数
- 引数
- インポートされた名前空間
- レコーディング
- UI 要素
- 制御フロー
- セレクター
- オブジェクト リポジトリ
- データ スクレイピング
- 画像とテキストの自動化
- Citrix Technologies Automation
- RDP の自動化
- Salesforce の操作の自動化
- SAP のオートメーション
- VMware Horizon の自動化
- ログ
- ScreenScrapeJavaSupport ツール
- Webdriver プロトコル
- Test Suite - Studio
- 拡張機能
- トラブルシューティング
アクティビティ パッケージを管理する
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 がコントロールすることはできません。ただし、リストに表示されていないパッケージはアクティブな状態に保たれるため、実行は可能です。
注: フィードの設定は、Studio の新しいバージョンにアップグレードしても維持されます。
フィードの管理と設定は、ガバナンス ポリシーが適用されていなければ、[パッケージを管理] ウィンドウで行うことができます。ポリシーが適用されていて、フィード管理に関する権限を制限している場合は、ウィンドウにメッセージが表示されます。ガバナンスの詳細を確認してください。
UiPath.settings
ファイルにカスタム フィードを追加する必要があります。
ユーザーが定義したパッケージ ソースと既定のパッケージ ソースは、[パッケージを管理] ウィンドウで有効化/無効化できます。
フィードは即座に追加されます。フィードを追加した後に、[閉じる] ボタンまたは [キャンセル] ボタンをクリックしても、変更を元に戻すことはできません。
認証が必要なカスタムの 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>
<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"
で置き換える必要があることに注意してください。
- [設定] カテゴリの [ユーザーが定義したパッケージソース] セクションで任意のフィードをクリックします。
- [削除] ボタンをクリックします。そのフィードは、[すべてのパッケージ] カテゴリと [ユーザーが定義したパッケージ ソース] セクションから削除されます。
- [保存] をクリックして変更を適用します。
フィードは即座に削除されます。既定のフィードまたはカスタム フィードを削除した後に、[閉じる] ボタンまたは [キャンセル] ボタンをクリックしても、変更を元に戻すことはできません。
お使いのコンピューターがプロキシ サーバーの内側にある場合は、ネットワークの外側にあるフィードにアクセスできるように NuGet プロキシの設定を行う必要があります。
Package Manager の機能により、アクティビティ パッケージ、ライブラリ、フレームワーク、ラッパーなどをダウンロードできます。また、プロジェクトのためにインストール済みのものの表示や更新、独自のものの追加や削除も可能です。フィードごとに使用可能なパッケージのリストが表示され、現在のプロジェクトごとに依存関係のリストが表示されます。[パッケージを管理] ウィンドウには、常に [プロジェクト依存関係] リストが表示されます。
UiPath.Excel.Activities, UiPath.Word.Activities
)、アプリケーションのカテゴリの自動化 (UiPath.Mail.Activities, UiPath.Terminal.Activities
)、またはオートメーション内の特定のテクノロジの使用 (UiPath.OCR.Activities, UiPath.FTP.Activities
) に役立つアクティビティのバンドルです。
パッケージに関する詳細は、前のスクリーンショットに示すように [パッケージを管理] ウィンドウの右側のパネルに表示されます。
検索バーの横にある [プレリリースを含む] チェックボックスをオンにすると、ライブラリパッケージ (使用可能な場合) のベータ版が表示されます。
プロジェクトの依存関係の説明が [パッケージを管理] ウィンドウに表示されない場合は、[プレリリースを含める] チェックボックスをオンにします。
UiPath.UIAutomation.Activities
パッケージと UiPath.System.Activities
パッケージは、Studio v2018.3 以降に対応しています。
パッケージをアンインストールする
パッケージをアンインストールするには、[プロジェクト依存関係] カテゴリに移動し、使用しなくなったパッケージの横にある [アンインストール] ボタンをクリックします。[保存] をクリックしてはじめてパッケージが削除されます。
オートメーション プロジェクトの実行時には、[パッケージを管理] ボタンが無効化されます。実行が停止されるまで、アクティビティ パッケージのインストールや削除はできません。
パッケージをダウングレードする
アクティビティ パッケージのダウングレードはお勧めしません。主な理由は、依存関係に悪影響を与える可能性があることです。異なるアクティビティ パッケージ間の依存関係は、各バージョンで慎重に管理されます。そのため、ダウングレードすると不整合が発生したり、ワークフローが機能不全に陥ったりする可能性があります。さらに、新しいアクティビティ パッケージでは、古いバージョンでは利用できない改良された機能が提供されています。したがって、最適なパフォーマンスを確保し、潜在的なエラーを回避するために、アクティビティ パッケージを現在のバージョンに維持するか、最新バージョンにアップグレードすることをお勧めします。
%userprofile%\.nuget\packages
フォルダーにダウンロード・インストールされます。別のフォルダーを設定するには、次のいずれかの方法で行います。
- インストール中の場合、コマンド ラインから
PACKAGES_FOLDER
オプションを使用してインストールする。 -
インストール後の場合、
uipath.config
ファイルを手動で編集する。- テキスト エディターで
uipath.config
ファイルを開きます。既定では、このファイルはC:\Program Files\UiPath\Studio
にあります。 - ノード
packageSettings
に、新しいフォルダーへのパスを値として含めたキーpackagesInstallationFolder
を追加します。 -
変更を保存し、Robot がサービスとしてインストールされている場合は、サービスを再起動します。
たとえば、ダウンロードする場所をC:\nuget
に変更するには、uipath.config
ファイルに以下を追加します。<packageSettings> <add key="packagesInstallationFolder" value="C:\Nuget" /> </packageSettings>
<packageSettings> <add key="packagesInstallationFolder" value="C:\Nuget" /> </packageSettings>
- テキスト エディターで
オフラインの Studio マシンにパッケージをインストールするには、以下の手順を実行します。
- インターネットにアクセスできるコンピューターで、NuGet Package Explorer をダウンロードしてインストールします。
- NuGet Package Explorer を開いて、[Open a package from an online feed] を選択します。
-
[Package source] フィールドに、パッケージのダウンロード元フィードの URL を入力します。UiPath のオフィシャル パッケージ フィードは
https://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json
です。 - フィードでパッケージを検索しダウンロードします。
-
nupkg ファイルを、Studio がインストールされているコンピューター上の、Studio でパッケージ ソースとして定義されたフォルダーに転送します。パッケージを既定のローカル フィードに追加するには、ファイルを
%ProgramFiles%\UiPath\Studio\Packages
(マシン単位のインストールの場合) か、%localappdata%\Programs\UiPath\Studio\Packages
(ユーザー単位のインストールの場合) にコピーします。