【UiPath】ラストチャンス！クラシックフォルダーからモダンフォルダーへの移行方法 #2

# はじめに
前回に引き続き、Orchestratorで廃止されるクラシックフォルダーについてです。
今回は、クラシックフォルダーからモダンフォルダーへの移行ツールの紹介です。

前回の記事はこちら

https://qiita.com/shuy/items/345ece4e5c20bf65c7a2


# 移行ツール
Orchestratorには、クラシックフォルダーをモダンフォルダーに移行してくれるツールがあります。
このツールは、Cloud版とオンプレ版の両方に実装されています。
オンプレ版OCを使う場合は、最新のv22.10にバージョンアップしてから使用すること推奨します。

https://docs.uipath.com/orchestrator/lang-ja/v0/docs/migrating-from-classic-folders-to-modern-folders

UiPath公式ドキュメントには、ロボットが2,000台を超える場合の移行は、パフォーマンスの観点から移行ツールの使用を避けるべきと書いてあるので、大規模運用している場合は注意しましょう（大規模運用している方が、こんなにギリギリで対応するとは思いませんが）。

# 使い方
[テナント] > [設定] からクラシックフォルダーセクションの「移行を開始」ボタンを押します。
![使い方1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/208362b6-00ab-2dfd-534e-74d88c4f5a59.png)
![使い方2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/8aabb12a-178c-6ee3-0494-933da0b92c6e.png)

あとはウィザードに従い、進めていきます。
「②有人プロセスを実行するユーザー」と「③無人プロセスを実行するユーザー」では、移行対象のロボットに関連付けるユーザーアカウントを指定します。
![使い方3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/b753334e-8772-63a2-3ed1-dd9ba1bf43ee.png)

割り当てが可能なユーザーアカウントは、「Allow to be Automation User」ロールを持っているユーザーであり、アカウント（Windows OSにログインするID）が移行対象のロボットに設定されているアカウントと同じものである必要があります。
![使い方4.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/576db3c3-1787-ccb9-d683-0becbb8dad3a.png)

また、「③無人プロセスを実行するユーザー」で割り当てができるユーザーアカウントは上記に加え、「ロボットアカウント」となります。
![使い方5.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/72979e7a-5f44-670c-e8bd-0b621e724be6.png)

設定内容は途中で保存しておくことができます。
設定がすべて終わると、移行完了となります。
![使い方6.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/2b25ca43-094d-134c-350d-2d49c591dc79.png)


# 検証結果
移行ツールを使用した結果です。リソース別にそれぞれ見ていきます。

## フォルダー・ロボットグループ・ロボットの移行
移行前後の関係性は以下の通りです。
クラシックフォルダーは、１対１でモダンフォルダー（第一階層）に移行されます。ロボットグループはモダンフォルダーの第二階層に移行されるのですが、ロボットグループが１つしかない場合は移行されません。
モダンフォルダーではロボットは、テナントレベルでの管理となるため、モダンフォルダー以下にロボットが作成されることはありません。代わりにフォルダーへのアクセス権が付与され、ロボットがフォルダーにアクセスできるようになります。移行はロボットグループに属するロボットが対象となるため、ロボットグループに属さないロボットは移行後のフォルダーにアクセスできません。

![フォルダー移行1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/ca1fb823-fbb1-223e-40c7-86f9116f2970.png)

第一階層のフォルダー名ですが、元のフォルダー名に「Migrated」が付与されています。同一名称のフォルダーを作成できない制約のため仕方ないですが、移行前の名称に戻したいのであれば、移行元のクラシックフォルダーを削除する必要があります。
第二階層のフォルダー名は、元のロボットグループのままです。
![フォルダー移行2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/5ff643b2-55f4-fee3-154b-4ad4ae4b0da9.png)

フォルダーのアクセス権は、第一階層のフォルダーでは、元のクラシックフォルダーに設定されていたユーザーが設定されます。第二階層のフォルダーは移行時（「②有人プロセスを実行するユーザー」と「③無人プロセスを実行するユーザー」）に設定したユーザーにアクセス権が付与されます。さらに標準ロボットを移行する場合は、ロボットに紐づくマシンにもアクセス権が付与されます。
![フォルダー移行3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/e38db5ea-0436-77e3-9e08-24b45496c6c4.png)


## アセットの移行
移行前後の関係性は以下の通りです。
第一階層のフォルダーに移行させず、第二階層のフォルダーにそれぞれ移行されます。さらに、移行元のアセットと移行されたアセットは、それぞれリンクによって繋がります。
![アセット移行1.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/417a7421-d827-5d11-0ef6-0d8265b796b6.png)

リンクによって繋がっているので、1つのアセットを変更すると、リンク先すべての値も変わります。
![アセット移行2.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/70ef2db2-0231-f930-0274-471c6bef8652.png)

ロボット毎にアセット値を設定する場合は、移行前のロボットグループに従い、移行後のサブフォルダーにそれぞれ分割されて移行されます。
![アセット移行3.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/89445/a62cc035-7ce3-ec5f-28b0-01adf47d82f4.png)


# おわりに
長くなりそうなので、プロセス、トリガー、キュー、ストレージバケットの移行結果は、次回の記事とします。