移行のために Bot Scanner レポートを分析する
- 更新日 2022/12/27
移行のために Bot Scanner レポートを分析する
移行できる Bot (TaskBot および MetaBot) およびプロセスについて情報を取得するため、Bot Scanner によって生成されたレポートを分析できます。Bot Scanner を使用して、今すぐ移行を開始するか、より多くのコマンドがサポートされるまで待ちたいかを決定します。
Bot Scanner レポートには、以下の情報が表示されます。
- Bot: Bot Scanner レポートでは、Bot は個々のタスク Bot (.atmx) または他の Bot で使用される MetaBot (.mbot) です。
[Bots] タブには、移行可能な Bot、アクションやレビューが必要な Bot、移行できない Bot の詳細情報が表示されます。
- プロセス: Bot Scanner レポートでは、プロセスは、他の Bot で使用されない Bot であり、複数の子 Bot を含めることができます。
[プロセス] タブには、移行可能なプロセス、アクションやレビューが必要なプロセス、移行できないプロセスの詳細情報が表示されます。
- 分析された Bot とプロセスの数
- Bot とプロセスの移行ステータスを示すボード形式の詳細な概要
- Automation 360 に移行できる/できない Bot とプロセスの数
- Bot で使用されるコマンド、および使用頻度
- 現在 Bot とプロセスが移行できない理由とその発生頻度
- コマンドの動作変更により、移行後にユーザーが必要とするアクションと確認
- 移行できない Bot とプロセス、およびそれに対応するエラー メッセージ
- Bot の行数、およびプロセスに関連する各 Bot の合計行数
- 確認やアクションが必要な個々の Bot とプロセスの行番号。
ほとんどの Enterprise 10 または Enterprise 11 の機能は現状で利用できるようになっていますが、(クライアントなしの) Web オペレーションをサポートするために、一部の機能は異なる方法で実装されています。これらの機能については、Bot を書き込む方法を変更する必要があります。
Bot Scanner は、Enterprise クライアント の Enterprise 10 と Enterprise 11 の両方のバージョンを使用して作成された Bot (TaskBot および MetaBot) をスキャンするように設計されています。合計ファイル数には、スキップされたファイルの数が含まれ、スキャンされていないファイルの数は含まれません。
レポートは、[Automation Anywhere Bot Scanner] ダイアログ ボックスの [宛先フォルダーを選択] フィールドで指定した出力場所にあります。Bot Scanner が概要レポート (summary.html) を生成し、スキャンされた各 Bot について別々の XML を生成します。MetaBotで使用可能な各ロジックに対して、個別のレポートが作成されます。
スキャンされた各 Bot に対して、レポート (XML 形式) を含む raw-data フォルダーが作成されます。エンジニアが移行処理をさらに分析し、必要に応じて是正措置を取るのに役立ちます。概要レポートまたはスキャンされた Bot の個別のレポートに個人識別情報 (PII) は記載されません。
製品を改善するために当社とレポートを共有する場合は、raw-data フォルダー内のファイルを圧縮し、カスタマー サクセス マネージャー (CSM) またはビジネス イネーブルメント マネージャー (PEM) にご連絡ください。データは Automation Anywhere と自動的に共有されません。
すべての Bot の概要レポート
- Automation 360 に移行できるかどうか
- スキャンした Bot の総数
- Automation 360 への移行をサポートする Bot に関する情報を提供する Bot のみのレポート (%)
- Automation 360 への移行をサポートするプロセスに関する情報を提供するプロセスのみのレポート
- Bot およびプロセスを組み合わせたレポート: Automation 360 への移行をサポートする Bot とプロセスに関する情報を提供
たとえば、Bot Scanner が 10 個の Bot をスキャンしたとします。10 個の Bot のうち、8 個の Bot の Automation 360 への移行が可能であるとすると、移行可能な Bot の割合は 80%、現在移行できない Bot の割合は 20% です。
- 残りの 5% の Bot に対するアクションと確認を特定して、大部分の Bot を正常に移行し、移行後に Automation 360 で実行できるようにします。
- 手動の介入なしで Automation 360 に移行できる Bot を特定します。
- 2% の Bot が現在移行できない理由と、後で移行できるようになるまでの推定時間を特定します。Automation 360 でまだサポートされていないコマンドや変数が原因かもしれません。
- [プロセス] タブをクリックします。
- 確認するメッセージのタブをクリックします。
- [マスター タスク リファレンス] 列で、展開アイコン (
) をクリックすると、プロセスが表示されます。 - プロセス名をクリックすると、メッセージが表示されます。
- 残りの 15 件のプロセスに対するアクションと確認を特定して、大部分のプロセスを正常に移行し、移行後に Automation 360 で使用できるようにします。
- 手動の介入なしで Automation 360 に移行できるプロセスを特定します。
- 1 つのプロセスが現在移行できない理由と、後で移行できるようになるまでの推定時間を特定します。
Automation 360 でまだサポートされていないコマンドや変数が原因かもしれません。
次の画像は、Bot Scanner からのレポートの例です。
次の表は、Bot Scanner レポートの例での (前の画像で番号付け) 各フィールドについて説明します。
| フィールド/オプション | 説明 |
|---|---|
| 1 | Bot の移行準備状況の概要とステータスを提供します。以下に基づいて、移行されたステータスを確認します。
|
| 2 | Bot に関する次の情報の概要を提供します。
|
| 3 | 移行プロセスを容易にするための追加リソースを提供します。 |
| 4 | プロセスに関する次の情報の概要を提供します。
|
| 5 |
注: 各メッセージには、移行後に確認する必要がある情報が含まれています。これらのメッセージのリストについては、「移行のメッセージ」をご覧ください。メッセージ コード (例
R102) を使用すると、特定のメッセージを素早く見ることができます。 |
| 6 | または : Automation 360 への移行後にアクションが必要な Bot またはプロセスのリストについては、このビューに移動します。
注: 各メッセージには、移行後に確認する必要がある情報が含まれています。これらのメッセージのリストについては、「移行のメッセージ」をご覧ください。メッセージ コード (例
R102) を使用すると、特定のメッセージを素早く見ることができます。 |
| 7 |
メッセージ コードをクリックすると、Enterprise 11 または Enterprise 10 の動作と比較した Automation 360 コマンドの動作の変更に関する情報が表示されます。 注: 各メッセージには、移行後に確認する必要がある情報が含まれています。これらのメッセージのリストについては、「移行のメッセージ」をご覧ください。メッセージ コード (例
R102) を使用すると、特定のメッセージを素早く見ることができます。 |
| 8 | または : 手動の介入なしで Automation 360 に移行できる Bot またはプロセスのリストについては、このビューに移動してください。 |
| 9 | または : 現在、Automation 360 に移行できない Bot またはプロセスのリストについては、このビューに移動します。 |
| 10 | : 移行可能なコマンドのリストと、スキャンしたすべての Bot でコマンドが使用された回数については、このビューに移動します。 |
| 11 |
メッセージ コードをクリックして、Automation 360 で移行したプロセスを正常に実行するために必要な手動手順を表示します。 Bot に含まれるコマンドと、そのコマンドが Bot で使用された頻度または回数を表示することもできます。 注: 各メッセージには、その原因と移行後に実行する必要があるアクションが含まれています。これらのメッセージのリストについては、「移行のメッセージ」をご覧ください。メッセージ コード (例
A101) を使用すると、特定のメッセージを素早く見ることができます。 |
| 12 | Bot の場所を指定します。 |
| 13 | Bot またはプロセスのステータスを指定します。 |
| 14 |
|
| 15 | プロセスの場合、このフィールドには Automation 360 への移行後にアクションが必要なプロセスにある Bot の数が表示されます。展開アイコン () をクリックし、[アクションが必要] フラグが設定されているタスク参照名をクリックします。 メッセージ コードをクリックすると、Enterprise 11 または Enterprise 10 の動作と比較した Automation 360 コマンドの動作の変更に関する情報が表示されます。 注: このフィールドはプロセスでのみ利用できます。
|
| 16 | プロセスの場合、このフィールドには Automation 360 への移行後に確認が必要なプロセスにある Bot の数が表示されます。展開アイコン () をクリックし、[確認が必要] フラグが設定されているタスク参照名をクリックします。 メッセージ コードをクリックすると、Enterprise 11 または Enterprise 10 の動作と比較した Automation 360 コマンドの動作の変更に関する情報が表示されます。 注: このフィールドはプロセスでのみ利用できます。
|
| 17 | 他のユーザーとファイルを共有したりできるように、移行できる、または移行できない Bot、プロセス、またはコマンドのリストを (CSV ファイルとして) ダウンロードします。 |
| 18 |
|
レポートは、Bot Scanner の次のバージョンが使用できるようになるまで有効です。Bot Scanner の次のバージョンが使用可能になると、レポート有効期限のメッセージが表示されます。Bot Scanner の最新バージョンをダウンロードして、Bot を再度スキャンする必要があります。
移行後に必要な検証とアクション
Bot 内の一部のコマンドは、Bot Scanner レポートで「確認が必要」とマークされている場合があります。これらの項目については、移行後に特定の検証を実行するか、Bot を更新する必要があります。
次の Bot Scanner メッセージが表示された場合は、確認または何らかのアクションを実行する必要があります。
- 子 Bot のパスは完全に変数化されており、実行時に解決されます。変数に指定されているパスが無効な場合、Bot は実行時に失敗します。移行した Bot を確認してください。
子 Bot が、変数化されたパスで指定されている場所に存在していることを確認します。親 Bot のパスが正しくない場合は、正しい子 Bot を指すようにパスを更新します。
- システム変数「Error Description」によって返される値は、レガシー バージョンと異なる場合があります。移行した Bot を確認してください。
Automation 360 の一部のエラー メッセージの説明は、同じエラーであっても Enterprise 11 または Enterprise 10 と異なる場合があります。Enterprise 11 または Enterprise 10 Bot が、エラー メッセージの説明に基づいて判断するように設定されている場合、移行した Bot を新しいエラー メッセージの説明に基づいて更新する必要があります。
- 「Database - Connect」コマンドの移行は完了していますが、「Windows 認証」の追加設定が必要です。詳細については、データベース パッケージのドキュメントを参照してください。
Windows 認証を使用して Microsoft SQL Server に接続するための手順を実行します。「Windows 認証を使用した Microsoft SQL Server への接続」を参照してください。
- 変数条件がある「IF」の移行が完了しました。ただし、ユーザー変数の日付形式を判別できなかったため、デフォルトの日付形式 mm/dd/yyyy HH:mm:ss で移行されています。形式を確認し、必要に応じて変更してください。
移行した Bot の日付形式を、Enterprise 11 で、その Bot に対して使用しているものと同じ形式に更新します。
- 位置として使用されている変数がインデックスまたは列名のどちらであるか判別できませんでした。インデックスの位置は 1 ではなく 0 から始まります。必要に応じてアクションを実行してください。
Enterprise 11 または Enterprise 10 Bot で FileData Column[$variable$] または Excel Column[$variable$] システム変数を使用している場合、$variable$ で列名を使用したものと見なされます。このような場合、移行した Bot には FileData Column{$variable$} 式が含まれます。Enterprise 11 または Enterprise 10 Bot の $variable$ に列番号が含まれている場合は、移行した Bot の式を FileDataColumn[$var.String:toNumber()$] に更新する必要があります。
- MetaBot のロジックの入力として資格情報変数を使用する [ロジックの実行] コマンド
タスク Bot から MetaBot ロジックに Credential Vault 属性を渡す [ロジックの実行] コマンドを使用する Bot は、Automation 360 に移行できます。資格情報名と属性名は、移行した Bot の対応する行のフィールドに表示されます。
復元した Enterprise 11 データベースを使用して移行した場合、Enterprise 11 Bot で使用されている資格情報変数に対して同等の ロッカー が Automation 360 に作成されます。
移行した Bot を正常に実行するには、次のいずれかのオプションを選択します。- オプション 1: 資格情報型変数を渡します。
- 子 Bot に、入力変数として資格情報型変数を作成します。
- 親 Bot の タスク Bot パッケージの [実行] アクションで、子 Bot (MetaBot ロジックに対応する) 用に作成した資格情報型変数に対して Credential Vault 属性を使用するように入力値フィールドを更新します。
- オプション 2: 資格情報値をグローバル値として渡します。
- Enterprise 11 の [ロジックの実行] コマンドで使用する資格情報のグローバル値を Automation 360 で作成します。
- 親 Bot の タスク Bot パッケージの [実行] アクションで、子 Bot (MetaBot ロジックに対応する) 用に作成した資格情報型変数に対してグローバル値を使用するように入力値フィールドを更新します。
Automation 360 のインストール時に、復元した Enterprise 11 データベースを使用していない場合は、前の手順を実行する前に、Enterprise 11 Bot で使用されている資格情報変数で必要なロッカーを作成する必要があります。注: Automation 360 は、資格情報型変数にのみ Credential Vault 属性を割り当てられるようにすることで、セキュリティを強化しています。これにより、資格情報型変数に割り当てられた可能性のある Credential Vault 属性の安全でない処理が制限されます。 - オプション 1: 資格情報型変数を渡します。
個別の Bot のレポート
各 Bot のレポートには、その依存性、変数、および使用されたコマンドに関する情報が記載されています。
個別の Bot のレポートは次のコードと似ています。
<analysis version="1.3.0"> <stat> <dependencies ucount="0" count="0"/> <errors ucount="6" count="12"> <error count="1">System variable $AAApplicationPathlt;/error> <error count="1">Command [If FolderNotExist] is not supported</error> <error count="3">System variable $CurrentDirectorylt;/error> <error count="3">System variable $Extensionlt;/error> </errors> </stat> <commands> <command target-action="assign" name="VariableOperation" line="1" grp="VariableOperation" api="VarOpe"> <msg type="error" review="true" category="variable">System variable $AAApplicationPathlt;/msg> <msg type="info" review="false" category="default">Command parameter [Option] of type [String] is not required.</msg> </command> <command target-action="createFolder" name="createFolder" line="3" grp="FilesFolders" api="CreateFolder"/> <command target-action="copyFiles" name="CopyFiles" line="5" grp="FilesFolders" api="CreateFolder"/> <command target-action="connect" name="Connect" line="3" grp="Database" api="Connect"/> <command target-action="OpenCSVTXT" name="ReadFrom" line="9" grp="CsvText" api="Csv" <msg tpye="info" review="false" category="command">Line in 11.x client, there is no separate option given for CSV and TEXT in Automation 360</msg> <msg type="error" review="true" category="variable">System variable $CurrentDirectorylt;/msg> <msg type="error" review="true" category="variable">System variable $Extensionlt;/msg> <msg type="error" review="true" category="variable">System variable $FileNamelt;/msg> </command> </commands> <variables> <variable name="$CSV-TXT-Default-DATAquot; type="TABLE" value-type=""/> </varaibles> </analysis>| ノード | 属性 | 説明 |
|---|---|---|
| 統計 | -- | 依存関係、エラー、警告の数に関する情報を提供します。 |
| -- | 依存関係 | Bot の依存関係の数を指定します。ucount は、一意の依存関係の数を示し、count は依存関係の合計数を示します。 |
| -- | エラー | Bot のエラー数を指定します。ucount は、一意の依存関係の数を示し、count は依存関係の合計数を示します。 |
| コマンド | -- | Bot で使用される多様なコマンドおよびアクションに関する情報を提供します。 |
| -- | command target-action | コマンドに対して実行されるアクションを指定します。 |
| -- | 名前 | コマンドの名前を指定します。 |
| -- | ライン | Bot でコマンドを利用できる行番号を指定します。 |
| -- | grp | コマンドが属するコマンド グループを指定します。 |
| -- | API | コマンドが使用する API の名前を指定します。 |
| -- | msg type | メッセージ タイプに関する情報を提供します。error タイプは、コマンドを Automation 360 に移行できないことを示します。info タイプは、コマンドを移行できるものの、移行中にその属性の一部が変更されることを示します。 |
| -- | 確認 | コマンドをレビューする必要があるかどうかに関する情報を提供します。 この属性は、 |
| -- | category | メッセージが表示されるコマンドまたは変数に関する情報を提供します。 |
| 変数 | Bot によって使用されるシステム変数に関する情報を提供します。 | |
| -- | 変数名 | 変数の名前を指定します。 |
| -- | タイプ | 変数のタイプを指定します。 |
| -- | 値の種類 | その変数に提供される値のタイプを指定します。 |
スキャナー レポートを分析する方法については、次のビデオをご覧ください。