分析Bot Scanner報告以進行移轉
您可以分析由Bot Scanner產生的報告,以取得可移轉的bots (TaskBots 和 MetaBots) 之相關資訊。使用Bot Scanner來決定您是否已準備好立即開始移轉,或是想要等到支援更多命令時再開始移轉。
- 已分析的bots數目
- 您可以與無法移轉至 Automation 360 的bots數目和百分比
- 在bots中使用的命令和變數,以及使用頻率
- 目前無法移轉bots與此問題發生頻率的原因
- 因命令行為改變,移轉後使用者所需的動作與檢閱
大部分 Enterprise 10 或 Enterprise 11 功能會按原樣提供;然而,部分功能的實作方法不同,以支援網頁 (無用戶端) 營運。對於這些功能,您必須變更bots的寫入方式。
Bot Scanner設計為掃描使用 Enterprise Client 的 Enterprise 10 和 Enterprise 11 版本所建立的bots (TaskBots 和 MetaBots)。總檔案計數包含略過且未掃描的檔案數目。
報告可於 [Automation Anywhere 機器人掃描器] 對話方塊中 [選取目的地資料夾] 欄位中的指定輸出位置取得。Bot Scanner會為每個掃描的bot產生摘要報告和個別報告。其會為 MetaBot 中每個可用邏輯建立個別報告。
系統會為每個已掃描的bot建立包含報告 (XML 格式) 的 raw-data 資料夾。其會協助工程師進一步分析移轉程序,並於必要時採取更正動作。已掃描bots的摘要報告或個別報告中未包含任何個人識別資訊 (PII)。
- Migratable_Bots:包含可移轉至 Automation 360 的bots報告。
- Non_Migratable_Bots:包含無法移轉至 Automation 360 的bots報告。
- Failed_to_Analyze:包含Bot Scanner無法分析的bots報告。
- MetaBots:包含 MetaBots 可以和無法移轉至 Automation 360 的報告,以及Bot Scanner無法分析的報告。
所有bots的摘要報告
摘要報告提供是否可移轉至 Automation 360、掃描bots的總數與支援移轉至 Automation 360 的bots (以百分比表示) 之相關資訊。
例如,考量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 尚未支援命令和變數。
以下影像為來自Bot Scanner的範例報告:
下表說明範例Bot Scanner報告中的各種欄位 (如前一影像中的編號):
欄位/選項 | 說明 |
---|---|
![]() |
Automation 360 後需要採取動作的bots (5%),前往此檢視取得清單。 | :針對移轉至
![]() |
|
![]() |
|
![]() |
Automation 360 且無需任何人為介入的bots,前往此檢視取得清單。請按一下清單中的任何bot名稱,以離線檢視 XML 報告。 | :針對可移轉至
![]() |
重要: 若無法移轉任何下層bots,則無法移轉上層bot。同樣的,若 MetaBot 中可用的任何邏輯無法移轉,則無法移轉 MetaBot。
|
![]() |
|
![]() |
下載 (CSV 檔案) bots清單或可移轉或無法移轉的命令,以便離線檢閱檔案或與他人共用檔案。 |
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 $AAApplicationPath$</error>
<error count="1">Command [If FolderNotExist]
is not supported</error>
<error count="3">System variable $CurrentDirectory$</error>
<error count="3">System variable $Extension$</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 $AAApplicationPath$</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 $CurrentDirectory$</msg>
<msg type="error" review="true" category="variable">System
variable $Extension$</msg>
<msg type="error" review="true" category="variable">System
variable $FileName$</msg>
</command>
</commands>
<variables>
<variable name="$CSV-TXT-Default-DATA$"
type="TABLE" value-type=""/>
</varaibles>
</analysis>
節點 | 屬性 | 說明 |
---|---|---|
狀態 | -- | 提供相依項目、錯誤和警告數量的相關資訊。 |
-- | 相依項目 | 指定bot的相依項目數量。ucount 表示唯一相依項目的數量,而 count 則表示相依項目的總數。 |
-- | 錯誤 | 指定bot的錯誤數量。ucount 表示唯一錯誤的數量,而 count 則表示錯誤的總數。 |
命令 | -- | 提供bot使用的各種命令和動作之相關資訊。 |
-- | 命令目標動作 | 為命令指定執行的動作。 |
-- | 名稱 | 指定命令名稱。 |
-- | 行 | 指定bot中可用命令的行號。 |
-- | grp | 指定命令所屬的命令群組。 |
-- | api | 指定命令使用的 API 名稱。 |