アクティビティ移行ツールについて

アクティビティ移行ツールの CLI ツールを使用して、レガシ オートメーション プロジェクトを最新の UiPath Platform に移行します。

アクティビティ移行ツールの目的

アクティビティ移行ツールは、組織がレガシ オートメーション プロジェクトを最新の UiPath Platform に移行して最新機能にアクセスできるようにするために不可欠なコマンド ライン インターフェイス (CLI) ツールです。

• プロセスの設定と依存関係の転送を簡素化および効率化し、移行プロセスを自動化します。
• 依存関係やアクティビティを手動で転送する代わりに、移行時に一貫性と正確性を確保し、手作業やミスを減らします。

サポートされる移行シナリオ

プロジェクトのフレームワークの移行

以下のような戦略的、技術的、およびサポート関連の理由から、Windows - レガシ プロジェクトを Windows 対応のプロジェクトに移行することを強くお勧めします。

1. パフォーマンスの向上: .NET Core および最新の Windows API との連携が強化されるため、Windows プロジェクトがより高速かつ効率的に実行されます。
2. 外部ライブラリとの相互運用性の向上: Windows プロジェクトでは新しいバージョンのライブラリと依存関係がサポートされるため、外部システムとの連携が容易になります。

UI Automation モダンの機能にアクセスする

統合ターゲットや Healing Agent など、UI Automation の新機能の多くは、最新の UI Automation フレームワークにのみ対応しています。したがって、クラシック UI Automation アクティビティからモダン エクスペリエンスへの移行が必要です。

非推奨の Outlook アクティビティの移行

Microsoft はクラシック Outlook の廃止を進めており、Microsoft 365 の採用を推奨しています。そのため、アクティビティ移行ツールは、UiPath.Mail.Activities (クラシック Outlook API に依存) から、UiPath Integration Service に基づく UiPath.MicrosoftOffice365.Activities へのオートメーションの依存関係の移行をサポートしています。

GSuite アクティビティの移行

最新の強化項目を活用するには、 Integration Service のコネクションベースの Google Workspace アクティビティの使用をお勧めします。アクティビティ移行ツールは、同じ UiPath.GSuite.Activities パッケージ内でクラシック アクティビティをモダン アクティビティに変換できます。これらのモダン アクティビティは、 Gmail、 カレンダー、 ドライブ、 ドキュメント、 スプレッドシート、 Apps Script の 6 つのサービスに対応する Google Workspace (旧 GSuite) アプリケーション全体を自動化します。

アクティビティ移行ツールと Studio の Windows - レガシ プロジェクト変換ツールの比較

Studio の Windows - レガシ プロジェクト変換ツールは、以下の場合に使用します。

• Windows - レガシ プロジェクトを Windows 対応のプロジェクトに 1 つずつ変換するだけでよい場合
• アクティビティの移行が不要である場合

アクティビティ移行ツールは、以下の場合に使用します。

• 複数の Windows - レガシ プロジェクトを Windows 対応のプロジェクトに変換する場合 (一括変換に対応)
• UI Automation、Mail、またはクラシック GSuite アクティビティの移行が必要な場合
• 上記のシナリオの任意の組み合わせに該当する場合

アクティビティ移行ツールの入手場所

ツールをダウンロードするには、以下の手順を実行します。

1. UiPath Automation Cloud に移動します。
2. 右上隅にある [ヘルプ] ボタンを選択します。
3. [リソース] で [ダウンロード] を選択します。
4. [ おすすめのダウンロード ] リストで [ アクティビティ移行ツール] を選択します。
5. ダウンロード リンクを選択します。

結果

Activity Migrator .zip ファイルがマシンにダウンロードされます。コマンドを実行する前に、そのファイルを展開して <tool-install-dir> フォルダーにインストールしてください。

要件

• Studio がインストールされていないマシンでツールを使用する場合は、.NET Desktop Runtime 8.0 をインストールする
• 移行したプロジェクトをバージョン 2024.10 以降の Studio で開く

アクティビティ移行ツールの使用方法

コマンド: <tool-install-dir>\UiPath.Upgrade.exe

使用法: UiPath.Upgrade.exe [command] [options]

グローバル オプション

オプション	説明
-?-h、--help	ヘルプや使用状況に関する情報を表示します。

使用可能なコマンド

コマンド	説明
version	バージョン情報を表示します。
analyze	移行対象のプロジェクトを分析します。変更は加えません。
upgrade	1 つのプロジェクトまたはその一部を移行します。
bulk	フォルダー内のすべてのプロジェクトを分析または移行します。

プロジェクトを分析する

このオプションは、移行を実際に実行したり、プロジェクトを変更したりせずに、移行をシミュレートしてレポートを生成します。

コマンド: <tool-install-dir>\UiPath.Upgrade.exe analyze

使用法: UiPath.Upgrade.exe analyze [options]

オプション	説明
-?, -h, --help	ヘルプや使用状況に関する情報を表示します。
-p, --project-path (必須)	分析またはアップグレードするプロジェクトへのパスです。<project-path> として指定するフォルダーには、プロジェクトの project.json ファイルが含まれている必要があります。
-o, --output-path	アップグレードしたプロジェクトの出力パスです (任意)。指定しない場合、サフィックス _Upgraded が付いた新しいフォルダーが作成されます。
-v, --verbose	詳細なログを有効化します。
-f, --output-format	出力形式です。console (既定) または sarif を指定します。
-e, --extension-directory	拡張機能を検索するディレクトリです。高度な用途専用です。
--ignore-missing-dependencies	アップグレード時に、見つからない依存関係を無視します。見つからない依存関係は警告として表示されます。影響を受けるワークフローでは、見つからない型が報告されたり、コンパイルに失敗したり、必要な他の移行の実行に失敗したりすることがあります。
--orchestrator-url	組織名を含む、Orchestrator の完全な URL です (例: https://cloud.uipath.com/myorg)。指定しない場合、Studio からの接続が使用されます。指定する場合は、資格情報も指定する必要があります。資格情報は、--orchestrator-pat を使用して個人用アクセス トークン (PAT) で指定するか、--orchestrator-application-id と --orchestrator-application-secret を使用して外部アプリケーション ID とシークレットで指定します。
--orchestrator-tenant	Orchestrator のテナント名です。指定しない場合は、既定で DefaultTenant に設定されます。
--orchestrator-pat	Orchestrator の認証用の個人用アクセス トークン (PAT) です。Orchestrator ライブラリ フィードへのアクセスに使用します。個人用アクセス トークンを作成し、Orchestrator API のアクセス スコープ OR.Execution.Read を追加します。「個人用アクセス トークン」をご覧ください。または、--orchestrator-application-id と --orchestrator-application-secret を使用して、アプリケーション ID とシークレットを設定します。
--orchestrator-application-id	Orchestrator の認証用の OAuth アプリケーション ID です (PAT の代替手段)。--orchestrator-application-secret とともに使用します。「外部の OAuth アプリケーションを管理する」をご覧ください。
--orchestrator-application-secret	Orchestrator の認証用の OAuth アプリケーション シークレットです (PAT の代替手段)。--orchestrator-application-id とともに使用します。「外部の OAuth アプリケーションを管理する」をご覧ください。
--enabled-extensions	有効化する拡張機能のコンマ区切りのリストです。詳しくは 、「利用可能な拡張機能」をご覧ください。
--disabled-extensions	無効化する拡張機能のコンマ区切りのリストです。利用可能な拡張機能は、検出された拡張機能に基づいて動的に入力されます。
--disable-all-extensions	すべての拡張機能を無効化します。このオプションは、--enabled-extensions および --disabled-extensions と相互に排他的です。
--uia-package-version	移行に使用する UI Automation アクティビティ パッケージのバージョンです。指定しない場合は、既定で 25.10.21 に設定されます。移行後のバージョンは既定値よりも後のバージョンにする必要があります。そうでない場合は、既定値が使用されます。
--uia-fix-selector-strategy	true に設定すると、移行後に既存の式に含まれる SelectorStrategy 列挙体のあいまいさが修正されます。UI Automation バージョン 25.10.29 以降に適用されます。既定値は false です。このあいまいさは、SelectorStrategy 列挙体が UiPath.Core 名前空間と UiPath.UIAutomationNext.Enums 名前空間の両方に存在するために発生します。この問題は、完全修飾名を使用すると解決します。
--uia-enable-partial-migration	完全な相互運用性を保証できない場合でも、アクティビティを移行します。移行では、サポートされている最も近い同等のファイルが生成されます。正しく機能するには手動で調整する必要がある場合があります。UI Automation パッケージ 25.10.38 以降が必要です ( --uia-package-versionを参照)。以前のパッケージ バージョンを使用する場合、このオプションは無視されます。既定値は falseです。
--mail-o365-package-version	移行のために使用する Microsoft Office 365 アクティビティ パッケージのバージョンです。既定値はバージョン 3.6.10 です。移行後のバージョンは既定値よりも後のバージョンにする必要があります。そうでない場合は、既定値が使用されます。
--config, --mail-config	カスタム構成の JSON ファイルへのパスを指定します。この構成を使用して、特定のアクティビティの既定の動作を変更したり、移行中にユーザーが入力する必要があるプロパティに定数値を割り当てたりできます。「構成ファイル」をご覧ください。
--gsuite-package-version	移行に使用する UiPath.GSuite.Activities アクティビティ パッケージのバージョンです。指定しない場合は、既定でバージョン 3.8.10 が使用されます。移行後のバージョンは既定のバージョンよりも後のバージョンにする必要があります。移行後のバージョンがそれより古い場合は、既定のバージョンが使用されます。
--gsuite-config	カスタム構成の JSON ファイルへのパスを指定します。この構成を使用して、特定のアクティビティの既定の動作を変更したり、移行中にユーザーが入力する必要があるプロパティに定数値を割り当てたりできます。「構成ファイル」をご覧ください。
--gsuite-migrate-only	GSuite 移行ツールに含まれるサービスのコンマ区切りのリストです (大文字と小文字を区別)。利用可能な値は、 gmail、 calendar、 drive、 docs、 sheets、 appsscriptです。指定すると、これらのサービスのみが実行されます。

プロジェクトを移行する

このオプションは、1 つのプロジェクトまたはその一部の移行を実際に実行します。

コマンド: <tool-install-dir>\UiPath.Upgrade.exe upgrade

使用法: UiPath.Upgrade.exe upgrade [options]

オプション	説明
-?, -h, --help	ヘルプや使用状況に関する情報を表示します。
-p, --project-path (必須)	プロジェクトの project.json ファイルを含むフォルダーへのパスです。
-o, --output-path	アップグレードしたプロジェクトの出力パスです (任意)。指定しない場合、サフィックス _Upgraded が付いた新しいフォルダーが作成されます。
-v, --verbose	詳細なログを有効化します。
-f, --output-format	出力形式です。console (既定) または sarif を指定します。
-e, --extension-directory	拡張機能を検索するディレクトリです。高度な用途専用です。
--ignore-missing-dependencies	アップグレード時に、見つからない依存関係を無視します。見つからない依存関係は警告として表示されます。影響を受けるワークフローでは、見つからない型が報告されたり、コンパイルに失敗したり、必要な他の移行の実行に失敗したりすることがあります。
--orchestrator-url	組織名を含む、Orchestrator の完全な URL です。指定しない場合、Studio からの接続が使用されます。指定する場合は、資格情報が必要です。
--orchestrator-tenant	Orchestrator のテナント名です。指定しない場合は、既定で DefaultTenant に設定されます。
--orchestrator-pat	Orchestrator の認証用の個人用アクセス トークン (PAT) です。OR.Execution.Read スコープが必要です。
--orchestrator-application-id	Orchestrator の認証用の OAuth アプリケーション ID です (PAT の代替手段)。
--orchestrator-application-secret	OAuth アプリケーション シークレットです (PAT の代替手段)。
--enabled-extensions	有効化する拡張機能のコンマ区切りのリストです。詳しくは 、「利用可能な拡張機能」をご覧ください。
--disabled-extensions	無効化する拡張機能のコンマ区切りのリストです。利用可能な拡張機能は、検出された拡張機能に基づいて動的に入力されます。
--disable-all-extensions	すべての拡張機能を無効化します。--enabled-extensions および --disabled-extensions と相互に排他的です。
--uia-package-version	移行後の UiPath.UIAutomation.Activities パッケージのバージョンです。既定値は 25.10.21 です。
--uia-fix-selector-strategy	true に設定すると、移行後に既存の式に含まれる SelectorStrategy 列挙体のあいまいさが修正されます。UI Automation バージョン 25.10.29 以降に適用されます。既定値は false です。このあいまいさは、SelectorStrategy 列挙体が UiPath.Core 名前空間と UiPath.UIAutomationNext.Enums 名前空間の両方に存在するために発生します。この問題は、完全修飾名を使用すると解決します。
--uia-enable-partial-migration	完全な相互運用性を保証できない場合でも、アクティビティを移行します。移行では、サポートされている最も近い同等のファイルが生成されます。正しく機能するには手動で調整する必要がある場合があります。UI Automation パッケージ 25.10.38 以降が必要です ( --uia-package-versionを参照)。以前のパッケージ バージョンを使用する場合、このオプションは無視されます。既定値は falseです。
--mail-o365-package-version	移行のために使用する Microsoft Office 365 アクティビティ パッケージのバージョンです。既定値はバージョン 3.6.10 です。移行後のバージョンは既定値よりも後のバージョンにする必要があります。そうでない場合は、既定値が使用されます。
--config, --mail-config	カスタム構成の JSON ファイルへのパスを指定します。この構成を使用して、特定のアクティビティの既定の動作を変更したり、移行中にユーザーが入力する必要があるプロパティに定数値を割り当てたりできます。「構成ファイル」をご覧ください。
--gsuite-package-version	移行に使用する UiPath.GSuite.Activities アクティビティ パッケージのバージョンです。指定しない場合は、既定でバージョン 3.8.10 が使用されます。移行後のバージョンは既定のバージョンよりも後のバージョンにする必要があります。移行後のバージョンがそれより古い場合は、既定のバージョンが使用されます。
--gsuite-config	カスタム構成の JSON ファイルへのパスを指定します。この構成を使用して、特定のアクティビティの既定の動作を変更したり、移行中にユーザーが入力する必要があるプロパティに定数値を割り当てたりできます。「構成ファイル」をご覧ください。
--gsuite-migrate-only	GSuite 移行ツールに含まれるサービスのコンマ区切りのリストです (大文字と小文字を区別)。利用可能な値は、 gmail、 calendar、 drive、 docs、 sheets、 appsscriptです。指定すると、これらのサービスのみが実行されます。

リポジトリの一括移行

このオプションは、フォルダー階層内で見つかったすべてのプロジェクトを分析または移行します。

コマンド: <tool-install-dir>\UiPath.Upgrade.exe bulk

使用法: UiPath.Upgrade.exe bulk [options]

オプション	説明
-?, -h, --help	ヘルプや使用状況に関する情報を表示します。
-p, --path (必須)	リポジトリまたはフォルダーへのパスです。project.json ファイルを含むすべてのサブフォルダーに対して移行が実行されます。
-c, --command (必須)	実行するコマンドです。analyze または upgrade を指定します。
-v, --verbose	詳細なログを有効化します。
-o, --output-path	アップグレードしたプロジェクトの出力ルート パスです。このフォルダーが存在しない場合は作成されます。アップグレードしたプロジェクト用に、サフィックス _Upgraded が付いた新しいフォルダーが作成されます。
--orchestrator-url	組織名を含む、Orchestrator の完全な URL です。
--orchestrator-tenant	Orchestrator のテナント名です。指定しない場合は、既定で DefaultTenant に設定されます。
--orchestrator-pat	Orchestrator の認証用の個人用アクセス トークン (PAT) です。OR.Execution.Read スコープが必要です。
--orchestrator-application-id	Orchestrator の認証用の OAuth アプリケーション ID です (PAT の代替手段)。
--orchestrator-application-secret	OAuth アプリケーション シークレットです (PAT の代替手段)。
--enabled-extensions	有効化する拡張機能のコンマ区切りのリストです。詳しくは 、「利用可能な拡張機能」をご覧ください。
--disabled-extensions	無効化する拡張機能のコンマ区切りのリストです。利用可能な拡張機能は、検出された拡張機能に基づいて動的に入力されます。
--disable-all-extensions	すべての拡張機能を無効化します。--enabled-extensions および --disabled-extensions と相互に排他的です。

例

1 つのプロジェクトを分析して詳細な出力を生成します。

UiPath.Upgrade.exe analyze -p C:\to-migrate\LegacyProcess -v

プロジェクトを移行し、移行後の UI Automation パッケージのバージョンを指定します。

UiPath.Upgrade.exe upgrade -p C:\to-migrate\LegacyProcess -o C:\to-migrate\WindowsProcess --uia-package-version=25.10.27 -v

カスタムの接続設定を使用してプロジェクトを移行します。

UiPath.Upgrade.exe upgrade --project-path=C:\to-migrate\LegacyProcess --config=C:\to-migrate\connection.json

フォルダーに対して一括分析を実行します。

UiPath.Upgrade.exe bulk -p C:\to-migrate -c analyze

プロジェクト内のメール アクティビティと GSuite クラシック アクティビティのみを移行し、UI Automation クラシック アクティビティなどの他のアクティビティには触れません。

UiPath.Upgrade.exe upgrade --project-path="C:\To Migrate\LegacyProcess" --enabled-extensions=MailActivities,GSuiteActivities

レガシ プロジェクトのみを Windows に移行します (Studio の Windows - レガシ プロジェクトと同等)。このコマンドでは、サポートされているアクティビティの種類は移行されません。

UiPath.Upgrade.exe upgrade -p "C:\To Migrate\LegacyProcess" -o "C:\To Migrate\WindowsProcess" --disable-all-extensions

注:

• コマンド ライン オプションでは次の規則を使用します。
  • -p value のような短いオプションでは、スペースを使用してオプションとその値を区切る必要があります。
  • --project-path=value のような長いオプションでは、多くの場合、等号を使用して値を特定のフラグに明示的にバインドします。ほとんどの場合、長いオプションは、--project-path value のようにスペースを使用して指定することもできます。しかし、--config オプションは例外で、--config=value のように等号構文のみを使用できます。
• upgrade コマンドの既定の出力は、.upgrade フォルダーの元のプロジェクトに保存される SARIF レポートです。移行されたプロジェクトは出力パスに保存されます。

コレクションでサポートされている構文

いくつかの CLI オプションではコレクション値を受け入れることができます。 --enabled-extensions、 --disabled-extensions、 --gsuite-migrate-onlyなどがあります。それぞれが、値を指定するための複数の構文をサポートしています。

サポートされる形式

たとえば、これらはすべて同じ値を ["drive", "gmail"] コレクションにバインドします。

• コンマ区切り: --gsuite-migrate-only=drive,gmail または --gsuite-migrate-only=drive --gsuite-migrate-only=gmail
• スペース区切り: --gsuite-migrate-only drive,gmail または --gsuite-migrate-only drive --gsuite-migrate-only gmail
• コロン構文 (あまり一般的ではありません): --gsuite-migrate-only:drive,gmail
• 混合構文: --gsuite-migrate-only=drive --gsuite-migrate-only gmail

既定の動作

コマンドに オプションがない場合:

• --gsuite-migrate-only - すべての Google Workspace サービスを移行します
• --enabled-extensions - すべての拡張機能が有効化されています。
• --disabled-extensions- 拡張機能は無効化されていません

注:

値のない出現 (例: --gsuite-migrate-only "") を指定すると、検証者によって拒否されます。

利用可能な拡張機能

[ --enabled-extensions ] または [ --disabled-extensions ] オプションには、以下の拡張子を指定できます。

拡張子	説明
UiAutomationActivities	UiPath.UIAutomation.Activities パッケージの UI Automation クラシック アクティビティを UI Automation モダン アクティビティに移行します。
MailActivities	依存関係を UiPath.Mail.Activities (Outlook ベースのクラシック アクティビティ) から UiPath.MicrosoftOffice365.Activities (Integration Service ベースのアクティビティ) に移行します。
MicrosoftActivitiesExtension	.NET Framework (レガシ) でのみ動作する Microsoft.Activities.Extensions パッケージのアクティビティの変換を試みます。
GSuiteActivities	UiPath.GSuite.Activities パッケージ内のクラシック GSuite アクティビティを、同じパッケージ内のモダン アクティビティに移行します。

例: --enabled-extensions MailActivities,GSuiteActivities

既定では、すべての拡張機能が有効化されています。[ --enabled-extensions ] オプションが指定されていない場合、 analyze、 upgrade、および bulk の各コマンドで、サポートされているパッケージのすべてのアクティビティが処理されます。

構成ファイル

構成ファイルを使用すると、移行中に手動で入力する必要があるアクティビティのプロパティに定数値を設定したり、移行の既定の動作を上書きしたりできます。

--config オプションを使用して、代入演算子 =を使用して移行ツールにファイル パスを渡します (例: --config=C:\to-migrate\connection.json)。移行の種類に応じて、適切な構成オプションを使用する必要があります。

• Outlook メール アクティビティの移行の場合: --config または --mail-config
• クラシック GSuite アクティビティを移行する場合: --gsuite-config

構成ファイルは次の形式に従う必要があります。

{
  "{reserved-configuration-key}": "{value}",
  "...": "...",
  "{path-to-workflow} > [{connector-type}] {activity-display-name}": {
    "{property-name}": "{property-value}"
  }
}

特記事項

• 割り当てることができる {property-name} は ConnectionIdのみです。
• * はワイルドカードとして機能し、 {path-to-workflow}、 {connector-type} 、 {activity-display-name}の任意の値と一致します。したがって、同じプロパティのコレクションに複数のワークフローまたはアクティビティを指定できます。複数のエントリが同じワークフロー、アクティビティ、コネクタ タプルに一致する場合、最後の一致のみが適用されます。
• [{connector-type}]部分は任意です。省略すると、エントリはコネクタの種類に関係なくすべてのアクティビティに一致します。指定した場合、エントリは、そのコネクタにバインドされているアクティビティにのみ一致します。少なくとも [{connector-type}] または {activity-display-name} のいずれかが存在する必要があります。

予約済みの構成キー

{reserved-configuration-key} は、アクティビティに固有の動作の変更を表します。

• SaveOutlookMailMessage_IgnoreSaveAsType: true に設定すると、サポートされていない種類に対する Save as type の確認が無効化されます。したがって、Save as type option に関係なくアクティビティを移行できます。

利用可能なコネクタの種類

[{connector-type}]パターンでは、以下の種類のコネクタを使用できます。

Google (GSuite) コネクタ:

• uipath-google-drive: Google ドライブ コネクタ
• uipath-google-docs: Google ドキュメント コネクタ
• uipath-google-sheets: Google スプレッドシート コネクタ
• uipath-google-gmail: Gmail コネクタ
• uipath-google-workspace: Google Workspace コネクタ
• uipath-google-tasks: Google ToDo リスト コネクタ
• uipath-google-forms: Google フォーム コネクタ

Microsoft コネクタ:

• uipath-microsoft-outlook365: Microsoft Outlook 365 Graph コネクタ
• uipath-microsoft-outlook365ews: Microsoft Outlook 365 EWS (Exchange Web Services) コネクタ
• uipath-microsoft-onedrive: Microsoft OneDrive コネクタ
• uipath-microsoft-365: Microsoft Office 365 コネクタ
• uipath-mail-mail: メール コネクタ

Orchestrator から ConnectionId を取得する

2026 年 3 月をもって、コネクションは Integration Service から Orchestrator に移行されました。ConnectionId は、Orchestrator でコネクションの URL から直接取得できます。

1. Orchestrator で目的のコネクションに移動します。Microsoft Outlook 365 コネクションがある Orchestrator フォルダーに移動します。
2. コネクションを開く: コネクションを選択して詳細を表示します。
3. URL を確認します。ConnectionId は、ブラウザーの URL に「https://cloud.uipath.com/{OrganizationName}/{TenantName}/orchestrator_/connections/{ConnectionId}/edit/tid={TId}」の形式で表示されます。

結果

コネクション ID は、ブラウザーの URL に .../connections/{ConnectionId}/edit/tid={TId}形式で表示されます。

メール アクティビティにコネクション ID を設定する

[ ConnectionId ] プロパティは、移行中に自動的には設定されません。構成ファイルを使用して、ワークフロー/アクティビティごとに手動で設定する必要があります。コマンド ライン引数 --config <config> または --mail-config <config> を使用して、構成ファイルをアクティビティ移行ツールに渡すことができます。

次の例では、ワイルドカードのフォールバックを使用して、生産性を高める特定のアクティビティ (Microsoft Office 365) に異なるコネクション ID を割り当てます。

{
    "* > *": {
        "ConnectionId": "00000000-0000-0000-0000-000000000001"
    },
    "*\\Projects\\MailMigration\\Main.xaml > Get *": {
        "ConnectionId": "00000000-0000-0000-0000-000000000002"
    },
    "*\\Projects\\MailMigration\\* > Send Mail": {
        "ConnectionId": "00000000-0000-0000-0000-000000000003"
    }
}

この例の各要素は次のとおりです。

• * > * は、すべてのアクティビティに一致します。下に一致するエントリがない場合のフォールバックとして機能します。
• *\\Projects\\MailMigration\\Main.xaml > Get * は、Main.xaml 内にある、表示名が Get で始まるすべてのアクティビティに一致します。
• *\\Projects\\MailMigration\\* > Send Mail は、MailMigration フォルダー内にあるすべてのワークフローの Send Mail アクティビティに一致します。

{
    "* > *": {
        "ConnectionId": "00000000-0000-0000-0000-000000000001"
    },
    "* > [uipath-microsoft-outlook365] *": {
        "ConnectionId": "00000000-0000-0000-0000-000000000002"
    },
    "*\\Projects\\MailMigration\\Main.xaml > [uipath-microsoft-outlook365] Get *": {
        "ConnectionId": "00000000-0000-0000-0000-000000000003"
    }
}

この例の各要素は次のとおりです。

• * > * は、すべてのアクティビティに一致します。下に一致するエントリがない場合のフォールバックとして機能します。
• * > [uipath-microsoft-outlook365] * は、すべての Outlook アクティビティで上書きされます。
• *\\Projects\\MailMigration\\Main.xaml > [uipath-microsoft-outlook365] Get * さらに、特定のワークフロー内の Get * アクティビティに絞り込みます。

GSuite アクティビティにコネクション ID を設定する

モダンの Connection-Service アクティビティに必要な ConnectionId は、移行ツールでは一般的に推測できません。2つのケース:

1. OAuth GSuiteApplicationScope内 — このアクティビティは実行時にスコープのコネクションを継承するため、ConnectionIdは空のままにします (UseConnectionServiceはアクティビティで false に設定されています)。
2. スコープの外側にある場合、または移行中にコネクションサービス スコープが Sequence にラップ解除された後 — アクティビティには明示的な ConnectionIdが必要です。Integration Service のコネクションのライフサイクルは移行ツールではなく Studio ランタイムが所有しているため、移行ツールで生成できません。

このケースのブロックを解除するために、移行ツールは、アクティビティ インスタンスを ConnectionId の値に宣言的にマッピングする JSON 構成ファイル (--gsuite-config <path>) を受け入れます。メール (--mail-config、エイリアス --config) でも同じメカニズムが使用されます。

{
  "{path-to-workflow} > [{connector-type}] {activity-display-name}": {
    "ConnectionId": "00000000-0000-0000-0000-000000000001"
  }
}

上記のスキーマでは、各ルールは 3 つの座標に対する glob です。

• {path-to-workflow} — ワークフローのファイル パスです (Windows 形式の区切り文字は正規化されています)。* はワイルドカードです。
• [{connector-type}] — 省略してもかまいません。モダン アクティビティにバインドされた Integration Service のコネクタ キー (例:uipath-google-drive、 uipath-google-gmail)。省略すると、ルールはすべてのコネクタに一致します。
• {activity-display-name} — 移行後のアクティビティの表示名です。* はワイルドカードです。

複数のルールが同じワークフロー + アクティビティ + コネクタ タプルに一致する場合、 プロパティごとに最後の一致が優先されます。前の一致によって設定されたプロパティは上書きされない状態で保持されます。そのため、アクティビティごとの上書きによるグローバルな既定の階層化が容易になります。

{
  "* > *": {
    "ConnectionId": "00000000-0000-0000-0000-000000000001"
  },
  "* > [uipath-google-drive] *": {
    "ConnectionId": "00000000-0000-0000-0000-000000000002"
  },
  "*\\Projects\\Demo\\Main.xaml > [uipath-google-drive] Get *": {
    "ConnectionId": "00000000-0000-0000-0000-000000000003"
  },
  "* > [uipath-google-sheets] *": {
    "ConnectionId": "00000000-0000-0000-0000-000000000004"
  },
  "* > [uipath-google-docs] *": {
    "ConnectionId": "00000000-0000-0000-0000-000000000005"
  },
  "* > [uipath-google-gmail] *": {
    "ConnectionId": "00000000-0000-0000-0000-000000000006"
  }
}

上記の例では、Google Workspace サービス (ドライブ、スプレッドシート、ドキュメント、Gmail) ごとに異なるコネクション ID も設定しています。

構成に入力できるプロパティはConnectionIdのみです。ConnectionIdが必要であるが、一致するルールがない場合、移行ツールは、ユーザーを構成ファイルに戻すために必要なアクションを出力します。

移行後の UI Automation アプリケーションのスコープの動作

ほとんどの UI Automation モダン アクティビティには、アプリケーション スコープ ([アプリケーション/ブラウザーを使用] アクティビティ) が必要です。移行時に、以下の 2 種類のスコープが作成されます。

自動的に作成されるスコープ

これらのスコープは、スコープが設定されたクラシック アクティビティ ([ブラウザーを開く] や [ブラウザーにアタッチ] など) の移行時に自動的に生成されます。移行後のワークフローで元の意図とフローが変更されるのを避けるため、これらのスコープは最適化されません。

合成によって生成されるスコープ

これらのスコープは、移行後にワークフローが正しくコンパイルおよび実行されるようにするために生成されます。連続する 2 つのスコープに同じプロパティ (同じセレクターや OCR エンジンなど) がある場合、元のアクティビティの順序を保ったまま 1 つのスコープに結合されます。

制限事項

UI Automation アクティビティ

• UiPath.UIAutomation.Activities のサポートされる移行後の最小バージョンは 25.10.21 です。
• 一部のアクティビティのプロパティには移行に関する制限があります。サポートされるアクティビティのリストについては、以下をご覧ください。
  • サポートされる UI Automation アクティビティ
  • サポートされない UI Automation アクティビティ
• UI Automation のモダン アクティビティを使用する移行後のワークフローは、UI Automation のクラシック アクティビティを使用する元のワークフローよりも実行速度が遅くなることがあります。

生産性を高めるアクティビティ

• UiPath.MicrosoftOffice365.Activities のサポートされる移行後の最小バージョンは 3.6.10 です。
• サポートされるアクティビティのリストについては、以下をご覧ください。
  • サポートされるメール アクティビティ
  • サポートされないメール アクティビティ

ツールの制限事項

• 既定では、アクティビティ移行ツールは、NuGet.config (オフィシャル、ローカル、Marketplace) で設定されている NuGet フィードを使用します。Orchestrator ライブラリ フィードを含めるには、analyze、upgrade、および bulk のコマンドでオプション (--orchestrator-url、--orchestrator-tenant、--orchestrator-pat、--orchestrator-application-id、--orchestrator-application-secret) を使用します。
• 動的に生成される型またはアセンブリを使用するアクティビティでは (たとえば、一部の Excel アクティビティでは、動的に生成される型のプロパティとして列名を使用することがあります)、移行後に「種類が見つかりません。」というエラーが .xaml ファイルで発生する場合があります。

Studio のワークフロー アナライザーのルール

• ワークフロー アナライザーのルール ST-AMG-001 は、Studio 2024.10.25 LTS、Studio 2025.10.8 以降で利用できますLTS および Studio 2026.0.189STS です。

移行のベスト プラクティス

移行前

1. プロジェクトをバックアップする: 移行コマンドを実行する前に、必ず完全バックアップを作成してください。
2. Studio とアクティビティ パッケージを更新する: UiPath Studio の最新バージョンを使用し、移行後のパッケージのバージョンが最小要件 (UiPath.UIAutomation.Activities >= 25.10.21 および UiPath.MicrosoftOffice365.Activities >= 3.6.10) を満たしていることを確認します。
3. アップグレード前に分析する: 最初に analyze コマンドを実行します。UiPath.Upgrade.exe analyze -p -v を使用すると、プロジェクトを変更せずに SARIF レポートを生成して潜在的な問題を特定できます。
4. 依存関係と NuGet フィードを検証する: オフィシャル フィード、ローカル フィード、Marketplace フィードが NuGet.config で正しく設定されていることを確認します。
5. プロジェクトがライブラリ プロジェクトに依存している場合は、最初にライブラリを移行する: その後、そのライブラリを使用するプロジェクトを移行します。

移行中

5. 1 つのプロジェクトから開始する: 一括操作を実行する前に、UiPath.Upgrade.exe upgrade -p -v を使用して 1 つのプロジェクトで移行をテストします。
6. 複数のプロジェクトには一括移行を使用する: 検証の完了後、UiPath.Upgrade.exe bulk -p -v を実行します。フォルダー構造がクリーンで一貫性があることを確認します。
7. コネクション ID の構成ファイルを指定する: Microsoft 365 または GSuite アクティビティの場合、必要な ConnectionId 値を含む構成ファイルを作成し、--config を使用して渡します。

{
    "* > *": {
        "ConnectionId": "00000000-0000-0000-0000-000000000001"
    }
}

移行後

8. SARIF レポートを確認する: プロジェクト ディレクトリ内の .upgrade フォルダーを確認し、フラグが付けられた問題に対処します。
9. 移行したプロジェクトを Studio で開いて [プロジェクトを分析] を実行する: ワークフロー アナライザーのルール ST-AMG-001 (Studio 2025.10.8 LTS/Studio 2026.0.189 STS 以降で利用可能) の結果を確認して、移行後のアクションが必要なアクティビティを特定します。
10. アプリケーション スコープを検証する: 結合されたスコープが期待どおりに動作することを確認します。[アプリケーション/ブラウザーを使用] アクティビティを使用してワークフローをテストします。
11. エンドツーエンドのテストを実行する: 移行したワークフローを運用環境にデプロイする前に、管理された環境で実行します。

パフォーマンスとメンテナンス

12. UI Automation セレクターを最適化する: 移行後、セレクターの精度と安定性を確認します。
13. 実行時間を監視する: モダン アクティビティは最初、実行速度が遅いことがあります。必要に応じて最適化します。
14. 変更を文書化する: 監査やロールバックのために、移行したプロジェクト、移行後のバージョン、適用された設定を記録します。