Enterprise bots への移行
- 最終更新日2023/06/27
Enterprise bots への移行
bot 移行処理では、Bot Migration Wizard を使用して、.atmx 形式と .mbot 形式の Enterprise 11 または Enterprise 10 bots (Task Bots および MetaBots) を Automation 360 で使用される .bot 形式に変換し、正常に移行した bots を Control Room の公開ワークスペースにアップロードします。
前提条件
bots 移行に関するすべての前提タスクを必ず完了してください。bots への移行の前提条件のタスク。
bots の手動の依存関係はすべて、移行中に Control Room の依存関係として自動的に変換されます。[Control Room ファイルをコピー] アクションを選択すると、これらの依存関係が Control Room からそれぞれの場所にコピーされます。
手順
- Automation 360 ステージング環境にログインします。
-
[管理] > [移行] の順にクリックします。
注: bots を Enterprise 10 から Enterprise 11 に移行した場合、その移行に関する情報は [移行リスト] ページに表示されません。
-
Bot Migration Wizard 画面で、[Bot を移行] をクリックします。
-
[設定] タブで必要なオプションと設定を選択します。
オプション アクション 名前 移行名を入力するか、デフォルト名を使用します。デフォルトの移行名には、ログイン ユーザー、現在の日付、タイム スタンプが表示されます。 説明 移行の説明を入力します。 同じ名前の bot が存在する場合は上書きする 同じ名前の bot がフォルダーに存在する場合に既存の bot を上書きするには、このオプションを使用します。 Bot の依存関係を除外 このオプションを選択して、サブタスクの子 bots を移行または更新の対象から除外します。このフラグを選択することで、親と子 bots を別々に移行するか、個別に移行するかを選択できるようになりました。 Excel セル行のレガシー動作を使用 バージョン 11.3.0 以前のバージョンから移行する場合や、[Excel セル行] システム変数のレガシー動作を保持する場合に、このオプションを選択します。 送信 E メール サーバーの設定を使用する bot に [Send Email] コマンドが含まれている場合は、このオプションを選択します。これらの設定を使用して、使用する E メール サーバーのタイプを指定します。 Web サービスの設定を含める カスタム プロキシ構成をサポートする場合は、このオプションを選択します。このオプションを選択した場合、次のグローバル変数を使用する [カスタム] プロキシ設定の REST コマンドが移行されます。 - AAProxyHost (ホスト名の場合)
- AAProxyPort (ポートの場合)
Internet Explorer でビルドされた Bot を Internet Explorer モードで Edge に変換する Internet Explorer を使用する Enterprise 10 または Enterprise 11 の bots を IE モードで Microsoft Edge を使用する Automation 360 bots に移行する場合に、このオプションを選択します。 [ファイルに記録] アクションで \n 文字を \r\n に変換する このオプションを選択して、\n 文字 (LF) を \r\n 文字 (CRLF) に変換します。これにより、[ファイルに記録] アクションを使用して、移行された bots で改行が自動的に挿入されます。 アナリティクスのためのタグ bots と変数 Bot Insight のデータが Enterprise 11 bots に存在し、Bot Insight データもこれらの bots と一緒に移行する必要があるときにこのオプションを選択します。このオプションを選択すると、Bot Insight の [開く] および [閉じる] actionsが作成されます。 注: Bot Insight のデータを移行するには、このオプションを有効にする必要があります。Bot Insight のデータを bot の移行と一緒に移行する場合、Bot Insight の前提条件を満たしていることを確認します。Bot Insight 前提条件 | クラウド移行ユーティリティの前提条件
Bot Insight の前提条件を満たしていない場合、Bot Insight に伴うCloudの移行は、[進行中] 状態で停止することがあります。
また、Bot Insight およびクラウド移行ユーティリティの前提条件を満たしているかどうかにかかわらず、.atmx ファイルのインポートまたはアップロード > [移行] を選択します。この問題は、On-PremisesとCloudの両方のデプロイで見られます。
- [次へ] をクリックします。
-
移行する bots (Task Bots および MetaBots) を含む bots とフォルダーを選択します。
フォルダーを選択できるので、フォルダー内から bots を個別に選択するよりも効率的です。
- フォルダーを選択した場合は、そのフォルダー内のすべてのサブフォルダー、およびサブフォルダー内のすべての bots が自動的に移行対象として選択されます。
- フォルダーが空の場合は、移行処理でエラーが発生します。
- [次へ] をクリックします。
-
リストから 1 つまたは複数のユーザー名を選択して移行を実行し、右矢印をクリックします。
[デバイス] 列には「実行時に選択されました」またはデバイス名が表示されます。デバイス名は、そのユーザーの登録済みデバイスを示します。「実行時に選択されました」が表示されるのは、ユーザーがデフォルトのデバイスを持っていない場合です。たとえば、ユーザーはデバイスを登録しておらず、システム管理者がそのユーザーにデバイスを割り当てている場合です。選択したすべての Bot Runners に対してデフォルトのデバイスを構成する必要があります。
- Bots は、選択した Bot Runner ユーザーの間でラウンドロビン方式で分配されます。
- 選択したリストの最初の Bot Runner ユーザーが最初に使用されます。
- 親 bot とその依存関係は単一の Bot Runner ユーザーに割り当てられます。
- [次へ] をクリックします。
- オプション:
移行する前に、[Bot と依存関係にある Bot] ページで依存関係にある Task Bots と MetaBots を確認します。
フォルダーと bots を [Bot] ページで選択済みの場合は、そのフォルダーと選択した bots の依存関係がテーブルに表示されます。
依存関係にある bots (Task Bots と MetaBots) はプライマリ bot の前に移行されます。この表では、プライマリ bot を下に、その依存関係を上に示します。たとえば、以下の情報は、Sample05.atmx が Sample04.atmx に依存し、Sample04.atmx が MessageBox.atmx と MetaTask.mbot に依存していることを示しています。タイプ 名前 パス MetaBot (mbot) MetaTask.mbot Bots\My Metabots\MetaTask.mbot Task Bot (atmx) MessageBox.atmx Bots\MyTasks\MessageBox.atmx Task Bot (atmx) Sample04.atmx Bots\MyTasks\Sample04.atmx Task Bot (atmx) Sample05.atmx Bots\MyTasks\Sample05.atmx -
[Bot を移行] をクリックします。
移行を開始したユーザーと選択した Bot Runner ユーザーが移行を実行するのに必要な権限を持っているかどうかが、システムによって検証されます。また、移行を実行するユーザーと選択した Bot Runners に、次のすべての権限が付与されているかどうかが確認されます。
- 移行を実行するユーザー:
- [移行を表示] 権限
- [移行をマネージ] 権限
- 移行する bots および MetaBots が含まれたフォルダーに対する権限
- 移行を実行するために選択する、Bot Runners へのアクセス権を持つロール ([管理] > [移行] > [別のユーザーとして実行] ページ上)。
- [すべての資格情報属性値を表示および編集] 権限
- Bot Runners:
- Unattended Bot Runner ライセンス
- [自動ログイン設定] ステータス
- [Bot Runner ユーザーに移行の実行を許可] 権限
- [資格情報の標準属性を作成] 権限
- [フォルダーを作成] 権限
- [パッケージを表示] 権限
- [デバイスを登録] 権限
- [マイ Bot を表示] と [マイ Bot を実行] 権限
- Automation 360 の My Tasks および My Metabots フォルダーに対する [チェックイン] および [チェックアウト] 権限
- [デフォルト デバイス] 設定
必要なすべての権限がユーザーに付与されている場合は、選択した bots とその依存 bots の移行が開始されます。移行を終えると、正常に移行された bots、関連する Bot Insight データ、公開されたダッシュボードが Automation 360 Control Room の公開ワークスペースにアップロードされます (.atmx ファイルがあるフォルダー)。公開ワークスペースに格納されるのは、Control Room から開始された bot 移行だけです。それぞれの bot の検証エラーの詳細は、bot 移行結果に表示されます。エラーの詳細には、行番号、エラーの詳細、理由と推奨事項が含まれています。Bot 移行結果には、移行された bots の数がそれぞれのステータスとともに表示されます。[ステータス] 列をクリックすると、bots を特定のステータスでフィルタリングして、素早く分析できます。
[理由] 列で、[移行の問題を見る] オプションをクリックすると、そのエラーの詳細な理由が表示されます。[移行の問題を見る] ダイアログ ボックスには、エラーが発生した行番号、エラーの概要、およびレビュー用の詳細なエラー レポートが表示されます。
-
bot をチェックアウトして、bot に関連付けられている非公開ダッシュボードを移行します。
非公開ダッシュボードは、最初に関連する bot をチェックアウトしたユーザーについてのみ移行されます。
- [アクティビティ] > [進行中] ページで、進行中の移行アクティビティを確認します。
Enterprise 11 Bot または Enterprise 10 Bot を移行する方法については、次のビデオをご覧ください。 - 移行を実行するユーザー:
- Migration error: Physical bot files aren't available (A-People login required)
- Migration error: Unable to download the source bot file for conversion (A-People login required)
- Migration shows unsuccessful by creating duplicate atmx files (A-People login required)
- Unable to migrate due to java.lang.StackOverflowError exception (A-People login required)
- Migration error: Unable to delete the file MigrationBot (A-People login required)