Windows - レガシに対応するプロジェクトについて

Studio v2021.10 で .NET ベースのプロジェクトがサポートされ、ターゲットフレームワークに基づくプロジェクトの対応 OS という概念が導入されました。v2021.10 より前のリリースでは、すべてのプロジェクトで .NET Framework 4.6.1 が使用されていましたが、Studio v2021.10 以降では、Windows - レガシ対応のプロジェクト (.NET Framework 4.6.1) を作成するか、.NET ベースの Windows およびクロスプラットフォーム対応のプロジェクトを作成するかを選択できます。

Windows - レガシプロジェクトでは新機能は利用不可

新しいプロジェクトの既定の対応 OS が Windows に変更されました。今後も Windows - レガシプロジェクトは引き続きサポートされますが、新機能を利用できるのは Windows とクロスプラットフォーム対応のプロジェクトだけになります。

たとえば、Studio v2022.10 で導入された以下の機能は、Windows - レガシプロジェクトでは利用できません。

データマネージャーでグローバル変数と定数を作成するためのサポート。
クロスプラットフォームプロジェクト、およびWindows プロジェクト内の一部のアクティビティでの新しいデザインエクスペリエンス。
ライブラリから生成されるアクティビティのレイアウトをカスタマイズする機能。

Windows - レガシプロジェクトを作成し続ける

ユーザーは、Backstage ビューから Windows またはクロスプラットフォームに対応した新しいプロジェクトしか作成できませんが、組織はガバナンスポリシーを使用して [使用できる対応フレームワーク] を設定することで、Windows - レガシプロジェクトの作成オプションを復元できます。今後の変更に関する最新情報は、「非推奨化のタイムライン」をご覧ください。

既存の Windows - レガシプロジェクトを編集する

Windows - レガシプロジェクトの編集、パブリッシュ、および実行は、今後のリリースでも引き続きサポートされます。つまり、他の Windows プロジェクトやクロスプラットフォームプロジェクトと同様にプロジェクトを開いて編集できます。既存の Windows - レガシプロジェクトを開くと、ウィンドウの上部にメッセージが表示されます。

Windows - レガシプロジェクトを Windows 対応のプロジェクトに変換する

重要: Windows 対応のバージョンが見つからない依存関係は「未解決」とマークされ、変換後に、Windows - レガシプロジェクトで使用されているバージョンが [プロジェクト] パネルに表示されます。UiPath が開発してオフィシャルフィードで提供しているほとんどのアクティビティパッケージは、Windows プロジェクトをサポートしています。完全なリストについては、『UiPath アクティビティガイド』をご覧ください。

Studio には組み込みの変換ツールが付属しており、このツールを使用すると、Windows - レガシプロジェクトを Windows プロジェクトに変換できます。

プロジェクトを Windows に変換すると、次のようになります。

プロジェクト依存関係は、次のルールに基づいて管理されます。
- 設定されているパッケージソースに同じバージョンのパッケージが存在する場合、Windows - レガシプロジェクトで使用されているバージョンは変更されません。
- 同じバージョンのパッケージが存在しない場合、Windows - レガシプロジェクトで使用されているバージョンは、最も近いバージョンの最高のパッチに変更されます。
すべてのアクティビティとプロパティは、変換後のプロジェクトでも保持されます。
Windows - レガシプロジェクトと Windows プロジェクトで異なる名前空間は更新されます。
Windows プロジェクトで必要な名前空間が追加され、Windows - レガシプロジェクトでのみ使用されている名前空間は削除されます。

注: Windows レガシライブラリが依存関係としてインストールされているプロセスの場合、プロセスを変換する前に、Windows レガシライブラリを変換して再パブリッシュしてください。

レガシプロジェクトを Windows 対応のプロジェクトに変換するには、以下の手順を実行します。

Windows - レガシプロジェクトを Studio で開き、1 つの Studio インスタンスでのみ開いていることを確認します。
[プロジェクト] パネルでプロジェクトノードを右クリックし、[Windows に変換] を選択します。新しいウィンドウが表示されます。
変換方法を選択します。
- Windows 対応のプロジェクトを使用して現在のプロジェクトのコピーを作成し、元の Windows - レガシプロジェクトを保持するには、[新しいプロジェクトを作成する] を選択します。新しいプロジェクトの名前、作成する場所、および任意で説明を入力します。
- 既存のプロジェクトを更新して Windows 対応のプロジェクトに変換するには、[新しいプロジェクトを作成する] チェックボックスをオフにします。このオプションを選択した場合、プロジェクトに加えた変更は元に戻せません。
[変換] をクリックします。

変換後に、依存関係の問題により未解決のアクティビティが発生した場合、それぞれのアクティビティの上部にそのアクティビティが見つからないか、読み込めなかったことを示すメッセージが表示されます。各メッセージでは、アクティビティの表示名、名前空間、プロパティとその値に関する情報を確認できます。[置換] をクリックすると代替アクティビティを検索し、存在しないアクティビティや無効なアクティビティを置換します。詳しくは、「存在しないか無効なアクティビティ」をご覧ください。

既知の制限事項

以下の式は Windows プロジェクトに対応していないため、Windows - レガシプロジェクトを Windows プロジェクトに正常に変換するには手動で変更する必要があります。

Windows - レガシの構文 Windows の構文
{} new Object() {}
{task_output.Id.ToString,task_action,now,I_comment} new Object() {task_output.Id.ToString,task_action,now,I_comment }
プロジェクトの変換前に機能していた他の式によって生成された検証エラーを解決するには、キーボードショートカット Ctrl + X を使用して式を切り取り、Ctrl + C を使用してアクティビティフィールドに貼り付け直します。
[繰り返し (コレクションの各要素)] アクティビティで、反復処理する値を持つ変数に「expression」という名前を付けると、コンパイルエラーが発生します。