分析Bot Scanner報告以進行移轉
- 已更新： 2022/12/27
分析Bot Scanner報告以進行移轉
您可以分析由 Bot Scanner 獲取有關的信息 bots (TaskBots 和 MetaBots) 和 可以遷移的進程使用Bot Scanner來決定您是否已準備好立即開始移轉，或是想要等到支援更多命令時再開始移轉。
這 Bot Scanner 報告提供以下信息：
- Bots：在裡面 Bot Scanner 報告，一個 bot 是個人 TaskBot (.atmx) 或 MetaBot (.mbot) 用於其他 bots.
Bots的 詳細信息 bots 可以遷移的，需要操作或審查的，以及不能遷移的。
- 流程：在裡面 Bot Scanner 報告，一個過程是一個 bot 未用於任何其他 bots 並且可以包括一個或多個孩子 bots.
進程 選項卡提供有關可以遷移的進程、需要操作或審查的進程以及無法遷移的進程的詳細信息。
- 數量 bots 和過程分析
- 以板的形式顯示遷移狀態的高級摘要 bots 和流程
- 數量 bots 以及您可以和不能遷移到的流程 Automation 360
- 中使用的命令 bots 和使用頻率
- 原因 bots 和流程當前無法遷移以及此類事件發生的頻率
- 由於命令行為的變化，遷移後用戶需要的操作和評論
- Bots 以及無法遷移的進程及其相應的錯誤信息
- 中的行數 bots, 以及每行的總行數 bots 與進程相關聯
- 個人行號 bots 以及需要審查或採取行動的流程
大部分 Enterprise 10 或 Enterprise 11 功能會按原樣提供；然而，部分功能的實作方法不同，以支援網頁 (無用戶端) 營運。對於這些功能，您必須變更bots的寫入方式。
Bot Scanner設計為掃描使用 Enterprise Client 的 Enterprise 10 和 Enterprise 11 版本所建立的bots (TaskBots 和 MetaBots)。總檔案計數包含略過且未掃描的檔案數目。
報告可於 [Automation Anywhere 機器人掃描器] 對話方塊中 [選取目的地資料夾] 欄位中的指定輸出位置取得。這 Bot Scanner 生成一個總結報告 (summary.html) 和一個單獨的 XML bot 它掃描了。其會為 MetaBot 中每個可用邏輯建立個別報告。
系統會為每個已掃描的bot建立包含報告 (XML 格式) 的 raw-data 資料夾。其會協助工程師進一步分析移轉程序，並於必要時採取更正動作。已掃描bots的摘要報告或個別報告中未包含任何個人識別資訊 (PII)。
若選擇與我們分享報告以協助改善產品，請壓縮檔案至 raw-data 資料夾中，並與客戶成功經理 (CSM) 和合作夥伴支持經理 (PEM) 相互協調。系統不會自動與 Automation Anywhere 分享任何資料。
所有bots的摘要報告
- 你是否可以遷移到 Automation 360
- 總數 bots 已掃描
- bots 唯一提供有關信息的報告 bots 支持遷移到 Automation 360 （百分比）
- processes only 報告提供有關支持遷移到的進程的信息 Automation 360
- bots 和過程組合報告，提供有關的信息 bots 和流程支持遷移到 Automation 360
例如，考量Bot Scanner已掃描 10 個bots。在 10 個bots中，如果 8 個bots已準備好移轉至 Automation 360，則可移轉的bots百分比為 80%，而其中無法移轉的bots百分比，現在則為 20%。
- 確定其餘 5% 的操作和評論 bots 這樣您就可以成功遷移大部分 bots 並運行它們 Automation 360 遷移後。
- 識別可在無需人為介入的情況下移轉至 Automation 360 的bots。
- 瞭解目前有 2% bots無法移轉的原因，以及可供稍後移轉機器人的估計時間。原因可能是因為 Automation 360 尚未支援命令和變數。
- 單擊 進程 選項卡。
- 單擊要查看的消息選項卡。
- 在 Master Task Reference 列中，單擊展開圖標（
）以查看流程。 - 單擊進程名稱以查看消息。
- 確定其餘 15 個流程的操作和審查，以便您可以成功遷移大部分流程並將它們用於 Automation 360 遷移後。
- 確定可以遷移到的進程 Automation 360 無需任何人工干預。
- 確定當前無法遷移 1 個進程的原因以及稍後可以遷移它們的估計時間。
原因可能是因為 Automation 360 尚未支援命令和變數。
以下影像為來自Bot Scanner的範例報告：
下表說明範例Bot Scanner報告中的各種欄位 (如前一影像中的編號)：
| 欄位/選項 | 說明 |
|---|---|
| 1 | 提供您的遷移準備情況的摘要和狀態 bots.根據以下內容查看已遷移的狀態：
|
| 2 | 提供以下信息的摘要 bots:
|
| 3 | 提供額外資源以簡化遷移過程。 |
| 4 | 提供進程的以下信息的摘要：
|
| 5 |
|
| 6 | 或 ：轉到此視圖以獲取列表 bots 或遷移後需要採取行動的流程 Automation 360.
|
| 7 |
點擊消息代碼查看修改信息 Automation 360 命令的行為與 Enterprise 11 或者 Enterprise 10 行為。 |
| 8 | 或 ：轉到此視圖以獲取列表 bots 或可以遷移到的進程 Automation 360 無需任何人工干預。 |
| 9 | 或 ：轉到此視圖以獲取列表 bots 或當前無法遷移到的進程 Automation 360. |
| 10 | ：轉到此視圖以獲取可以遷移的命令列表以及這些命令在所有已掃描文件中的使用次數 bots. |
| 11 |
單擊消息代碼以查看您必須執行的手動步驟才能成功運行遷移的進程 Automation 360. 您也可以檢視bot包含的命令，以及bot使用命令的頻率或次數。 |
| 12 | 提供的位置 bot. |
| 13 | 提供狀態 bot 或過程。 |
| 14 |
|
| 15 | 對於進程，此字段顯示進程數 bots 在遷移到之後需要採取行動的過程中 Automation 360..單擊展開圖標（），然後單擊標記為 需要操作。 點擊消息代碼查看修改信息 Automation 360 命令的行為與 Enterprise 11 或者 Enterprise 10 行為。 註: 該字段僅適用於進程。 |
| 16 | 對於進程，此字段顯示進程數 bots 在遷移到之後需要審查的過程中 Automation 360.單擊展開圖標（），然後單擊標記為 Review Required。 點擊消息代碼查看修改信息 Automation 360 命令的行為與 Enterprise 11 或者 Enterprise 10 行為。 註: 該字段僅適用於進程。 |
| 17 | 下載（作為 CSV 文件）列表 bots、進程或命令，可以或不能遷移，以便您可以與其他人共享文件。 |
| 18 |
|
Bot Scanner的下個版本可供使用前，報告是有效的。Bot Scanner的下個版本可供使用時，會顯示報告到期訊息。您必須下載Bot Scanner的最新版本，然後再次掃描bots。
移轉後所需的驗證和動作
bots中的某些命令可能在Bot Scanner報告中標示為需要檢閱。移轉這些項目後，您需要執行特定驗證或更新bots。
下列Bot Scanner訊息需要驗證或採取某些動作：
- 下層機器人路徑完全變數化，並於執行階段解決。若變數中指定的路徑無效，機器人會執行失敗。請檢閱移轉機器人。
請確認下層bot可在變數化路徑中指定的位置上使用。若上層bot中的路徑不正確，請將路徑更新為正確的下層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中的日期格式更新為該bot在 Enterprise 11 中使用的相同格式。
- 無法判斷用於位置的變數為索引或欄名稱。索引位置從 0 開始，而非 1，因此請視需要採取必要動作。
若您已在 Enterprise 11 或 Enterprise 10 bot中使用 FileData 欄 [$variable$] 或 Excel 欄 [$variable$] 系統變數，我們會假設您已在 $variable$ 中使用欄名稱。在這種情況下，移轉的bot會包含 FileData 欄 {$variable$} 運算式。若 Enterprise 11 或 Enterprise 10 bot中的 $variable$ 包含欄數，您必須將移轉bot中的運算式更新為 FileData 欄 [$var.String:toNumber()$]。
- 使用認證變數作為 MetaBot 邏輯輸入的 [執行邏輯] 命令
使用 [執行邏輯] 命令的Bots，將 Credential Vault 屬性從 TaskBot 傳遞到 MetaBot 邏輯，並且可以移轉至 Automation 360。認證名稱和屬性名稱會顯示在移轉的bot對應行中的欄位。
如果您已使用還原後的 Enterprise 11 資料庫移轉，則會針對 Enterprise 11 bot所使用的認證變數，在 Automation 360 中建立一個相應的 locker。
選擇下列其中一個選項以成功執行移轉的bots：- 選項 1：傳遞認證類型變數。
- 在下層bots中建立認證類型變數作為輸入變數。
- 在上層bot的 Task Bot package [執行] action中更新輸入值欄位，即可將 Credential Vault 屬性用於為下層bot建立的認證類型變數 (對應至 MetaBot 邏輯)。
- 選項 2：傳遞認證值以作為全域值。
- 針對 Enterprise 11 [執行邏輯] 命令中使用的認證，在 Automation 360 中建立全域值。
- 在上層bot的 Task Bot package [執行] action中更新輸入值欄位，即可將全域值用於為下層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使用的各種命令和動作之相關資訊。 |
| -- | 命令目標動作 | 為命令指定執行的動作。 |
| -- | 名稱 | 指定命令名稱。 |
| -- | 行 | 指定bot中可用命令的行號。 |
| -- | grp | 指定命令所屬的命令群組。 |
| -- | api | 指定命令使用的 API 名稱。 |
| -- | msg 類型 | 提供訊息類型的相關資訊。錯誤 類型表示命令無法遷移 到Automation 360, info 類型表示該命令可以遷移，但是它的一些屬性會在遷移過程中發生變化。 |
| -- | 檢閱 | 提供是否需要檢閱命令的相關資訊。
|
| -- | 類別 | 提供顯示訊息的命令或變數之相關資訊。 |
| 變數 | 提供bot所使用之系統變數的相關資訊。 | |
| -- | 變數名稱 | 指定變數名稱。 |
| -- | 類型 | 指定變數類型。 |
| -- | 值類型 | 指定為該變數提供的值類型。 |
有關如何分析掃描儀報告的信息，請參見以下視頻