Studio ガイド

最終更新日時 2025年3月25日

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 - レガシプロジェクトの作成オプションを復元できます。このためには、以下を実行します。

[Automation Ops™] > [ガバナンス] に移動します。
Studio の新しいガバナンスポリシーを定義します。必ず 24.10.0 の Studio ポリシーテンプレートを選択してください。
ガバナンスポリシーのウィンドウで [デザイン] タブを選択し、[デザインスタイル] セクションまでスクロールします。
[使用できる対応フレームワーク] の設定を有効化して、ターゲットフレームワークとして [Windows - レガシ] をオンにします。
ガバナンスポリシーを保存してデプロイします。

詳しくは、『Automation Ops ガイド』の「Studio のポリシーの設定」をご覧ください。

または、以下の手順で、ファイルベースのガバナンスモデルを使用して設定を構成することもできます。

Studio から JSON ガバナンスファイルを生成します。
ガバナンスファイル内で AllowedProjectFrameworks の設定を見つけます。
Classic パラメーターの値を True に設定します。
ガバナンスファイルを保存してデプロイします。

詳しくは、『Studio ガイド』の「ガバナンス」をご覧ください。

今後の変更に関する最新情報は、「非推奨化のタイムライン」をご覧ください。

既存の 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 プロジェクトに正常に変換するには手動で変更する必要があります。	`new Object() {}` から `{}` `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」という名前を付けると、コンパイルエラーが発生します。	変数に「expression」という名前を付けないようにします。
`Communication between UiPath Studio and the Taxonomy Manager ended unexpectedly.`	古いバージョンの Intelligent OCR アクティビティパッケージを含むプロジェクトを変換した後は、必ず最新バージョンの Intelligent OCR パッケージにアップグレードしてください。
`BC36915: Cannot infer an element type because more than one type is possible. Specifying the type of the array might correct this error.` `BC30512: Option Strict On disallows implicit conversions from 'Object()' to 'String()'. The selected value is incompatible with the property type.` `BC36914: Cannot infer an element type, and Option Strict On does not allow 'Object' to be assumed. Specifying the type of the array might correct this error.`	最新のプログラミング言語では、古いバージョンと比較してより厳密な型推論が適用されます。配列または要素を目的の型にキャストします。例: `new Object() {}` から `{}` `<object>.ToString()` `CType(<element>, Object)`
エンコードの影響を受ける操作	InvokeMethod を使用して `System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance)` を追加します。
`“` (0x201C) と `"` (0x22)	すべてのインスタンスを `"` (0x22) に置き換えます。これは、最新の .NET の文字列リテラルで有効な唯一の引用符です。
`BC30311: Value of type 'SecureString' cannot be converted to 'CvString'. The selected value is incompatible with the property type.`	Computer Vision アクティビティの引数を削除して、再度追加します。
`BC31424: Type ‘System.Data.DataTable' in assembly ‘…’ has been forwarded to assembly 'System.Data.Common’ …` `BC30652: Reference required to assembly ‘System.Collections’ … containing the type 'List(Of )'. Add one to your project.` `BC30057: Too many arguments to 'Public Overloads Property SpecificContent As Dictionary(Of String, Object)'.`	これらの検証エラーを修正するには、以下の手順を実行します。エラーを含むアクティビティのプロパティに移動します。構成を削除します ([切り取り] または Ctrl + X)。アクティビティの外側をクリックします。構成を再度追加します ([貼り付け] または Ctrl + V)。