依存関係を管理する

Studio でプロジェクトの依存関係を管理します。オートメーション プロジェクトにリンクされているアクティビティ パッケージの追加、更新、削除などがあります。

Studio のプロジェクト依存関係とは、特定のプロジェクトにリンクされたパッケージを指します。これらのパッケージには、既定またはカスタムのアクティビティが含まれています。

依存関係はコンテキストに基づいており、以下を考慮します。

• プロジェクトで使用されるアクティビティ
• プロジェクトの変数
• 入力引数と出力引数

依存関係は、プロジェクトの定義に少なくとも 1 つの参照がある場合にのみ設定されます。

既定の依存関係とカスタムの依存関係

プロジェクトの既定の依存関係は、プロジェクトの種類、対応 OS、またはプロジェクトの作成に使用したテンプレートによって異なります。

これ以外のものを追加する場合は、[パッケージを管理] をクリックして、それらをインストールします。インストールした依存関係は、現在のプロジェクトでのみ使用できます。プロジェクトごとの依存関係のリストは project.json ファイルで確認できます。

The Explorer panel displays the activities packages installed in the automation project, together with their sub dependencies, runtime rules, requested, and resolved versions. The project compatibility is displayed in the Dependencies node.

依存関係の上にホバーすると、要求済み/解決済みのバージョンが表示されます。[管理]、[修復]、[依存関係を削除] などのコンテキストによる操作は、依存関係にのみ使用可能であり、サブパッケージには使用できません。

ツリー内の依存関係のステータスは、次のように色分けされます。

• 赤 - 依存関係が見つかりませんでした。
• オレンジ - サブパッケージが見つかりませんでした。
• 灰色 - 依存関係は未解決です。
• 薄い青 - 解決されたバージョンのほうが要求されたバージョンよりも高くなっています。
• 濃い青 - 要求されたバージョンと解決されたバージョンは完全に一致しています。

依存関係を追加・更新する

プロジェクトに依存関係を追加するには、[ パッケージを管理 ] ウィンドウからインストールします。利用可能なパッケージは、 プロジェクトの対応 OS によって異なります。また、パッケージに含まれるアクティビティのいずれかを、[アクティビティ] パネルの [利用可能] カテゴリか、アクティビティを追加する検索バーからプロジェクトに追加すると、そのパッケージをインストールできます。

現在のプロジェクトで新しいバージョンが使用可能になると、リボンの [パッケージを管理] ボタンが更新アイコン になります。

1. To manage dependencies in a project, open the context menu for the Dependencies category in the Explorer panel, and then select Manage. This opens the Manage Packages window, with the Project Dependencies category. The icon shows which packages are currently installed.

   

2. Default dependencies are displayed, together with the versions that are currently linked to the project. To update a package, select the update icon , next to the available version number. The icon is shown next to the package, meaning that dependencies are ready to be installed.

3. 依存関係は、[ 保存] を選択した後にのみプロジェクトにインストールされます。同時に、プロジェクトに属する project.json ファイル内の依存関係のバージョンが更新されます。

結果

選択した依存関係がプロジェクトに追加または更新されます。パッケージのバージョンは project.json ファイルで更新されます。

依存関係を削除する

• To remove a project dependency, right-click the dependency in the Explorer panel, and then select Remove Dependency. The dependency is removed from the Explorer panel and project.json file. Alternatively, you can go to Manage Packages > Project Dependencies, select the dependency to remove, and then click Uninstall.
• To remove all unused dependencies in the project, select Remove Unused > Dependencies in the Studio ribbon, or use the Ctrl + Shift + R keyboard shortcut. All the installed packages that have no references in the current project are removed from the Explorer panel and project.json file.

依存関係を修復する

If a workflow opened in Studio has references to packages with versions that aren’t available in current Studio feeds, said dependencies are marked as broken in the Explorer panel and details are made available in the Output panel.

依存関係を修復する

Studio allows for all dependencies to be repaired in bulk or individually. To repair all broken dependencies, right-click on the Dependency node in the Explorer panel, and click on Repair Dependencies.

個別に修復するには、破損した依存関係を右クリックして、[依存関係を修復] をクリックします。または、[管理] を選択して、[パッケージを管理] を開き、パッケージを更新することもできます。

NuGet では、最も低い適用可能なバージョン ランタイム ルールを適用することにより、破損した依存関係を修復します。以前設定されていたものよりも高いバージョンの中で最初に適用可能なパッケージ バージョンを検索します。

注:

デザイナーパネルでは、存在しないアクティビティや無効なアクティビティがマークされます。また、ワークフローとその解決されない依存関係に関する追加情報がエラーバナーに表示されます。

依存関係のルールを設定する

アクティビティ パッケージは複数のバージョンで使用可能です。このため、[パッケージを管理] を使用してこれらのバージョンをインストールまたは更新する際には、これらの各バージョンについて依存関係のランタイム ルールを設定できます。

[ランタイム ルール] では、ランタイムでインストールするパッケージ バージョンを指定します。2 つのオプションを使用できます。

The Strict runtime rule is the default state for dependencies added upon process creation, and for activities packages installed from the Manage Packages window. It means that only the specified version of the package is used at runtime to execute the parent process. The Strict rule is marked in the Explorer panel, under Dependencies by the sign next to the package version.

The Lowest Applicable Version runtime rule means that if the target package isn’t found, the next higher version is searched in order to resolve dependencies. The Lowest Applicable Version rule is marked in the Explorer panel, under Dependencies by the sign next to the package version.

依存関係ルールを使用して実行する

Studio からオートメーション プロジェクトを実行する場合、Robot は、各プロジェクトにあらかじめ設定されたランタイム ルールに従って、プロジェクトの実行に必要な、指定または指定したパッケージ バージョンをダウンロードします。実行時に使用された依存関係に ストリクト のランタイム ルールが設定されており、正確なパッケージ バージョンが見つからなかった場合、エラーがスローされます。プロジェクトの依存関係にランタイム ルールを設定する方法について詳しくは 、「依存関係を管理する 」をご覧ください。

依存関係の競合を解決する

アクティビティ パッケージをインストールするときは、以前設定された依存関係のランタイム ルールが考慮されます。ただし、プロジェクトの自動化時にバージョン間の競合が発生する可能性があります。

オートメーション プロジェクトとそのライブラリの両方に、同じアクティビティ パッケージが含まれていて、バージョンとランタイム ルールが異なる場合があります。設計時に、NuGet は最上位レベルの依存関係 (階層内のプロジェクトに最も近い依存関係) を選択することで、このような競合を解決します。

競合の解決は次のように行われます。

プロジェクトにバージョン 1.0 のアクティビティ パッケージが含まれています。このプロジェクトはライブラリを参照しています。ライブラリは同じパッケージの、より高いバージョンを使用します。トップレベルの依存関係である v1.0 が使用されます。ダウングレードが検出されたことを示す警告が表示されます。

この解決方法は、ランタイム ルール ([ストリクト] であるか [最も低い適用可能なバージョン]] であるか) を問わず、以前設定されたアクティビティ パッケージに適用可能です。

• [はい] を選択すると、プロジェクトで参照しているアクティビティ パッケージが、ライブラリで使用されているバージョンにアップグレードされます。

• [いいえ] を選択した場合、Package Manager が開き、[パッケージを管理] ウィンドウが表示されます。

  

プロジェクトには、バージョン 2.0 のアクティビティ パッケージが含まれています。ライブラリでも同じパッケージが使用されますが、バージョンがこれより低く、ランタイム ルールが ストリクト () に設定されています。この場合に使用される最上位の依存関係は v2.0 であり、パッケージがプロジェクトにインストールされると警告が表示されます。

プロジェクトには、バージョン 2.0 のアクティビティ パッケージが含まれています。ライブラリは同じパッケージを使用しますが、バージョンがそれより低く、ランタイム ルール 最も 低い適用可能なバージョン です。この場合に使用される最上位の依存関係は v2.0 であり、パッケージがプロジェクトにインストールされると警告が表示されます。

プロジェクトが、アクティビティ パッケージ バージョン 1.0 でスト リクト のランタイム ルールを持つライブラリを参照している。このプロジェクトは別のライブラリを参照していますが、アクティビティ パッケージのバージョンは 2.0 です。この場合の最上位の依存関係は、v2.0 のパッケージです。これはバージョンが最も高いためです。アクティビティ パッケージのインストール時に警告が表示されます。

この競合において、このプロジェクトは 2 つのライブラリを参照しています。この 2 つのライブラリは、[ストリクト] な依存関係で相互参照しています。このようなシナリオはサポートされません。詳細については、「依存関係の解決」をご覧ください。

依存関係の循環は、パッケージが自身を参照する場合に発生する競合です。プロジェクト名を「UiPath」とした場合は、Studio は依存関係の競合を検出します。これは、「UiPath」パッケージが既に存在し、UiPath.UIAutomation.Activities に対して依存関係を有するためです。プロジェクトの名前を付ける際には、依存関係として追加しようとする既存パッケージと同じ名前は避けることをお勧めします。

同じ依存関係の循環は、「UiPath」など、依存関係として追加しようとする既存パッケージの名前と同じ名前のフォルダーから .xaml ファイルを開き、そのフォルダーに project.json が存在しない場合にも発生します。関連する project.json ファイルが存在しない .xaml ファイルを開くと、Studio が関連ファイルを作成し、親フォルダーの名前に "name" タグが付加されます。

以前のバージョンで作成したプロジェクトを開く

重要:

v2016.2 の Studio で作成されたプロジェクトは、v2020.4 以降のバージョンで直接開くことができません。これらのプロジェクトは、まず v2018.4 の Studio で開いてから、v2020.4 以降のバージョンで開いてください。

v2018.3 より前 (v2016.2 を除く) のバージョンで依存関係あり/なしで作成したプロジェクトを開くと、Studio は欠落している依存関係の取得または既定の依存関係の追加を試みるために、自動移行を実行するかどうかを尋ねます。

Upon confirmation, Studio attempts to retrieve missing dependencies and sets the Strict runtime rule for the packages that it finds. When using the Repair Dependency option in the Explorer panel, Studio attempts to install the next best package version. If the package version is not found, alerts are shown in the Output panel and you should check the configured feeds in the Manage Packages window.

古いプロジェクトの依存関係

依存関係を含み、v2018.3 よりも前の Studio で構築されたプロセスは、v2018.3 の Robot により継続して実行されます。そうしたプロジェクトのランタイム ルールは、最も低い適用可能なバージョン に設定されます。

v2018.3 より前のバージョンで作成されたプロジェクトのうち、パブリッシュされたことのないプロジェクトは、 project.json ファイルに依存関係が記載されていません。そのようなプロジェクトを開くと、[ 出力 ] パネルのアラートが不足している依存関係を通知します。Studio でローカルに配信された UiPath パッケージはストリクト ランタイム ルールで依存関係として追加されます。そのようなパッケージの最新バージョンは自動的に設定されます。

そのようなプロジェクトに、Studio でローカルに提供されたもの以外のパッケージが含まれる場合、以下をお勧めします。

• 作成された Studio バージョンを使用してプロジェクトをパブリッシュし、project.json ファイルに依存関係を追加して移行プロセスを支援します。
• 必要なフィードを設定した後に、[ パッケージを管理 ] ウィンドウから不足しているパッケージを手動でインストールする
• プロジェクト依存関係一括更新ツールを使用して、不足している依存関係を多数のプロジェクトに追加する。
  注:

  無効なアクティビティを含むワークフローは、保存できません。必要な依存関係をインストールし、そのプロジェクトを保存してください。

アクティビティ パッケージ UiPath.V7.Activities、UiPath.Platform.Activities、UiPath.Framework.Activities は廃止されました。UiPath.Platform.Activities および UiPath.Framework.Activities のパッケージを持つプロジェクトを開くと、Studio v2018.3 またはそれ以降のバージョンは自動移行を実行し、古いバージョンのアクティビティを新しいバージョンのものに置き換えることを試みます。

注:

UiPath.V7.Activities パッケージの一部であるアクティビティを含むワークフローは、移行できません。

移行が自動的に実行されない一部のケースについては、回避策を用いることができます。

1. Notepad++ で、project.json ファイルを開きます。
2. "schemaVersion": "3.2" パラメーターを削除します。
3. "studioVersion" を "toolVersion" に置き換えます。
4. "toolVersion" 値を "18.3.xxx" から以前のバージョンに変更します。たとえば、値を "18.3.0.958" から "18.2.958" に変更します。ファイルを保存します。
5. Open the .xaml file with Studio v2018.3 or above for the migration to be performed. The deprecated activities packages are replaced with new ones, as illustrated in the Dependencies section of the Explorer panel.
   注:

   場合によっては、パッケージ UiPath.Platform.Activities および UiPath.Framework.Activities を含む .xaml ファイルは 移行が自動的に行われず、回避策も適用できないことがあります。このような場合には、プロジェクトを Studio v2018.2 またはそれ以前のバージョンで開き、前述のパッケージに属するアクティビティを UiPath.Core.Activities パッケージに含まれるアクティビティに置き換えることを推奨します。UiPath.V7.Activities パッケージからのアクティビティを含むワークフローについても、同じことができます。

Studio v2018.4.1 以降、Microsoft.Activities v.1.0.1 と Microsoft.Activities.Extensions v2.0.6.9 に UiPathStudio.msi インストーラーにはパッケージ化されなくなりました。

これらのパッケージを依存関係として含むプロジェクトを移行するときに修復が必要な場合は、公式フィードまたはローカル フィードから 2 つのパッケージをインストールします。v2018.4.1 より前のバージョンで作成されたこのようなプロジェクトを実行する前に、Robot がアクセスできるフィードで前述のパッケージが利用可能であることを確認してください。

v2018.4.1 より前のバージョンからアップグレードする場合、2 つのアクティビティ パッケージはローカル フィードに残ります。