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

Migrate legacy automation projects to the modern UiPath platform using the Activity Migrator CLI tool.

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

アクティビティ移行ツールは、組織がレガシ オートメーション プロジェクトを最新の 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 activities migration

To benefit from the latest enhancements, we recommend using the Integration Service connections-based Google Workspace activities. The Activity Migrator supports converting classic activities to modern activities within the same UiPath.GSuite.Activities package. These modern activities automate across Google Workspace (formerly known as GSuite) applications, covering six services: Gmail, Calendar, Drive, Docs, Sheets, and Apps Script.

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

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

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

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

• 複数の Windows - レガシ プロジェクトを Windows 対応のプロジェクトに変換する場合 (一括変換に対応)
• Migration of UI Automation, Mail, or classic GSuite activities is needed.
• 上記のシナリオの任意の組み合わせに該当する場合

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

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

1. UiPath Automation Cloud に移動します。
2. 右上隅にある [ヘルプ] ボタンを選択します。
3. [リソース] で [ダウンロード] を選択します。
4. Under the Featured Download list, select Activity Migrator Tool.
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	Comma-separated list of extensions to enable. See Available 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	Migrate activities even when full compatibility cannot be guaranteed. The migration generates the closest supported equivalent, which may require manual adjustments to function correctly. Requires UI Automation package 25.10.38 or later (see --uia-package-version). This option is ignored when using earlier package versions. Default: false.
--mail-o365-package-version	移行のために使用する Microsoft Office 365 アクティビティ パッケージのバージョンです。既定値はバージョン 3.6.10 です。移行後のバージョンは既定値よりも後のバージョンにする必要があります。そうでない場合は、既定値が使用されます。
--config, --mail-config	カスタム構成の JSON ファイルへのパスを指定します。この構成を使用して、特定のアクティビティの既定の動作を変更したり、移行中にユーザーが入力する必要があるプロパティに定数値を割り当てたりできます。「構成ファイル」をご覧ください。
--gsuite-package-version	The version of the UiPath.GSuite.Activities activities package to use for migration. Defaults to version 3.8.10 if not specified. The target version must be higher than the default version. If the target version is lower, the default version will be used.
--gsuite-config	カスタム構成の JSON ファイルへのパスを指定します。この構成を使用して、特定のアクティビティの既定の動作を変更したり、移行中にユーザーが入力する必要があるプロパティに定数値を割り当てたりできます。「構成ファイル」をご覧ください。
--gsuite-migrate-only	Comma-separated list of services included in GSuite migrator (case sensitive). Available values: gmail, calendar, drive, docs, sheets, appsscript. If specified, only those services will be run.

プロジェクトを移行する

このオプションは、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	Comma-separated list of extensions to enable. See Available 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	Migrate activities even when full compatibility cannot be guaranteed. The migration generates the closest supported equivalent, which may require manual adjustments to function correctly. Requires UI Automation package 25.10.38 or later (see --uia-package-version). This option is ignored when using earlier package versions. Default: false.
--mail-o365-package-version	移行のために使用する Microsoft Office 365 アクティビティ パッケージのバージョンです。既定値はバージョン 3.6.10 です。移行後のバージョンは既定値よりも後のバージョンにする必要があります。そうでない場合は、既定値が使用されます。
--config, --mail-config	カスタム構成の JSON ファイルへのパスを指定します。この構成を使用して、特定のアクティビティの既定の動作を変更したり、移行中にユーザーが入力する必要があるプロパティに定数値を割り当てたりできます。「構成ファイル」をご覧ください。
--gsuite-package-version	The version of the UiPath.GSuite.Activities activities package to use for migration. Defaults to version 3.8.10 if not specified. The target version must be higher than the default version. If the target version is lower, the default version will be used.
--gsuite-config	カスタム構成の JSON ファイルへのパスを指定します。この構成を使用して、特定のアクティビティの既定の動作を変更したり、移行中にユーザーが入力する必要があるプロパティに定数値を割り当てたりできます。「構成ファイル」をご覧ください。
--gsuite-migrate-only	Comma-separated list of services included in GSuite migrator (case sensitive). Available values: gmail, calendar, drive, docs, sheets, appsscript. If specified, only those services will be run.

リポジトリの一括移行

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

コマンド: <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	Comma-separated list of extensions to enable. See Available 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

Migrate only Mail and GSuite classic activities in the project, without touching other activities, such as UI Automation classic activities:

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

Migrate only the Legacy project to Windows (same as Studio Windows - Legacy converter). The command does not migrate any of the supported activity types:

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 レポートです。移行されたプロジェクトは出力パスに保存されます。

Supported syntax for collections

Several CLI options accept collection values: --enabled-extensions, --disabled-extensions, and --gsuite-migrate-only. Each supports multiple syntaxes for specifying values.

サポートされる形式

For example, all of these bind the same values to the ["drive", "gmail"] collection:

• Comma-separated: --gsuite-migrate-only=drive,gmail or --gsuite-migrate-only=drive --gsuite-migrate-only=gmail
• Space-separated: --gsuite-migrate-only drive,gmail or --gsuite-migrate-only drive --gsuite-migrate-only gmail
• Colon syntax (less common): --gsuite-migrate-only:drive,gmail
• Mixed syntax: --gsuite-migrate-only=drive --gsuite-migrate-only gmail

既定の動作

If the option is missing from the command:

• --gsuite-migrate-only - migrates all Google Workspace services
• --enabled-extensions - all extensions are enabled
• --disabled-extensions- no extensions are disabled

注:

Specifying an occurrence with no values (for example, --gsuite-migrate-only "") is rejected by the validator.

Available extensions

The following extensions can be specified for the --enabled-extensions or --disabled-extensions option:

拡張子	説明
UiAutomationActivities	Migrates classic UI Automation activities in the UiPath.UIAutomation.Activities package to modern UI Automation activities.
MailActivities	Migrates dependencies from UiPath.Mail.Activities (classic Outlook-based activities) to UiPath.MicrosoftOffice365.Activities (Integration Service–based activities).
MicrosoftActivitiesExtension	Tries to convert activities from the Microsoft.Activities.Extensions package, which works only on .NET Framework (Legacy).
GSuiteActivities	Migrates classic GSuite activities in the UiPath.GSuite.Activities package to modern activities within the same package.

例: --enabled-extensions MailActivities,GSuiteActivities

By default, all extensions are enabled. If the --enabled-extensions option is not specified, the analyze, upgrade, and bulk commands will process all the activities in supported packages.

構成ファイル

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

Pass the file path to the migrator using the --config option with the assignment operator =, as in this example: --config=C:\to-migrate\connection.json. You must use the appropriate config option depending on the migration type:

• For Outlook Mail activities migration: --config or --mail-config
• For classic GSuite activities migration: --gsuite-config

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

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

Special Notes

• The only {property-name} that can be assigned is ConnectionId.
• * acts as a wildcard and matches any value in {path-to-workflow}, {connector-type} and {activity-display-name}. Thus, multiple workflows or activities can be specified for the same collection of properties. When multiple entries match the same workflow, activity, connector tuple, only the last match is applied.
• The [{connector-type}] part is optional. When omitted, the entry matches any activity regardless of connector type. When specified, the entry only matches activities bound to that connector. At least one of [{connector-type}] or {activity-display-name} must be present.

Reserved Configuration Keys

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

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

Available Connector Types

The following connector types can be used with the [{connector-type}] pattern:

Google (GSuite) connectors:

• uipath-google-drive: Google Drive connector
• uipath-google-docs: Google Docs connector
• uipath-google-sheets: Google Spreadsheets connector
• uipath-google-gmail: Gmail connector
• uipath-google-workspace: Google Workspace connector
• uipath-google-tasks: Google Tasks connector
• uipath-google-forms: Google Forms connector

Microsoft connectors:

• uipath-microsoft-outlook365: Microsoft Outlook 365 Graph connector
• uipath-microsoft-outlook365ews: Microsoft Outlook 365 EWS (Exchange Web Services) connector
• uipath-microsoft-onedrive: Microsoft OneDrive connector
• uipath-microsoft-365: Microsoft Office 365 connector
• uipath-mail-mail: Mail connector

Orchestrator から ConnectionId を取得する

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

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

結果

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

Setting Connection IDs for Mail activities

The ConnectionId property is not populated automatically during migration. You must set it manually per workflow/activity using a configuration file. The configuration file can be passed to the Activity Migrator using the --config <config> or --mail-config <config> command line argument.

The following example assigns different connection IDs to specific Productivity activities (Microsoft Office 365), using a wildcard fallback:

{
    "* > *": {
        "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] * overrides for all Outlook activities.
• *\\Projects\\MailMigration\\Main.xaml > [uipath-microsoft-outlook365] Get * further narrows to Get * activities in a specific workflow.

Setting Connection IDs for GSuite activities

The modern Connection-Service activities require a ConnectionId that the migrator generally cannot infer. Two cases:

1. Inside an OAuth GSuiteApplicationScope — the activity inherits the scope's connection at run time, so ConnectionId is left empty (UseConnectionService is set to false on the activity).
2. Outside a scope, OR after a connection-service scope was unwrapped to a Sequence during migration — the activity needs an explicit ConnectionId. The migrator cannot generate one because Studio runtime, not the migrator, owns the IS connection lifecycle.

To unblock this case the migrator accepts a JSON config file (--gsuite-config <path>) that declaratively maps activity instances to ConnectionId values. The same mechanism is used by Mail (--mail-config, alias --config).

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

In the schema above, each rule is a glob over three coordinates:

• {path-to-workflow} — the workflow file path (Windows-style separators normalised). * is a wildcard.
• [{connector-type}] — optional. The IS connector key bound to the modern activity (e.g. uipath-google-drive, uipath-google-gmail). If omitted, the rule matches any connector.
• {activity-display-name} — the display name of the migrated activity. * is a wildcard.

When multiple rules match the same workflow + activity + connector tuple, the last match wins per property, and properties set by an earlier match are preserved when not overwritten — making it easy to layer a global default with per-activity overrides:

{
  "* > *": {
    "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"
  }
}

The example above also configures different connection IDs for different Google Workspace services (Drive, Sheets, Docs, Gmail).

ConnectionId is the only property the config can populate. When a ConnectionId is required but no rule matches, the migrator emits an action required pointing the user back at the config file.

移行後の 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 のワークフロー アナライザーのルール

• The ST-AMG-001 Workflow Analyzer rule is available starting with Studio 2024.10.25 LTS, Studio 2025.10.8 LTS and Studio 2026.0.189 STS.

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

移行前

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. 変更を文書化する: 監査やロールバックのために、移行したプロジェクト、移行後のバージョン、適用された設定を記録します。