閱讀及檢閱 Automation Anywhere 文件

Automation 360

關閉內容

內容

開啟內容

分析Bot Scanner報告以進行移轉

  • 已更新:2022/03/29
    • Automation 360 v.x
    • 移轉
    • RPA 工作區

分析Bot Scanner報告以進行移轉

您可以分析由Bot Scanner產生的報告,以取得可移轉的bots (TaskBotsMetaBots) 之相關資訊。使用Bot Scanner來決定您是否已準備好立即開始移轉,或是想要等到支援更多命令時再開始移轉。

Bot Scanner提供下列關於bots的主要資訊:
  • 已分析的bots數目
  • 您可以與無法移轉至 Automation 360bots數目和百分比
  • bots中使用的命令和變數,以及使用頻率
  • 目前無法移轉bots與此問題發生頻率的原因
  • 因命令行為改變,移轉後使用者所需的動作與檢閱
重要: Automation 360 會經常更新,以達到 Enterprise 10Enterprise 11 版本的 100% 功能相應。系統在 Automation 360 中支援移轉的bots、命令和變數的百分比,將會在之後的版本持續增加直到達成 100% 為止。亦即,在 Enterprise 10Enterprise 11 中執行的每項功能,在 Automation 360 中有其相應功能。

大部分 Enterprise 10Enterprise 11 功能會按原樣提供;然而,部分功能的實作方法不同,以支援網頁 (無用戶端) 營運。對於這些功能,您必須變更bots的寫入方式。

Bot Scanner設計為掃描使用 Enterprise ClientEnterprise 10Enterprise 11 版本所建立的bots (TaskBotsMetaBots)。總檔案計數包含略過且未掃描的檔案數目。

報告可於 [Automation Anywhere 機器人掃描器] 對話方塊中 [選取目的地資料夾] 欄位中的指定輸出位置取得。Bot Scanner會為每個掃描的bot產生摘要報告和個別報告。其會為 MetaBot 中每個可用邏輯建立個別報告。

系統會為每個已掃描的bot建立包含報告 (XML 格式) 的 raw-data 資料夾。其會協助工程師進一步分析移轉程序,並於必要時採取更正動作。已掃描bots的摘要報告或個別報告中未包含任何個人識別資訊 (PII)。

若選擇與我們分享報告以協助改善產品,請壓縮檔案至 raw-data 資料夾中,並與客戶成功經理 (CSM) 和合作夥伴支持經理 (PEM) 相互協調。系統不會自動與 Automation Anywhere 分享任何資料。

系統會在包含各種報告的 raw-data 資料夾中建立四個資料夾:
  • Migratable_Bots:包含可移轉至 Automation 360bots報告。
  • Non_Migratable_Bots:包含無法移轉至 Automation 360bots報告。
  • Failed_to_Analyze:包含Bot Scanner無法分析的bots報告。
  • MetaBots:包含 MetaBots 可以和無法移轉至 Automation 360 的報告,以及Bot Scanner無法分析的報告。

所有bots的摘要報告

摘要報告提供是否可移轉至 Automation 360、掃描bots的總數與支援移轉至 Automation 360bots (以百分比表示) 之相關資訊。

例如,考量Bot Scanner已掃描 10 個bots。在 10 個bots中,如果 8 個bots已準備好移轉至 Automation 360,則可移轉的bots百分比為 80%,而其中無法移轉的bots百分比,現在則為 20%。

檢閱Bot Scanner報告
請考慮以下情況,您一共掃描 1618 個bots,其中 98% (1614個bots) 可以移轉到 Automation 360。然而,5% 的bots在移轉後需要採取動作,且由於特定原因,有 2% (4 個bots) 目前無法移轉。在這種情況下,Bot Scanner報告可讓您執行下列動作:
  • 針對剩餘 5% 的bots找出要採取的動作與檢閱,以便您成功移轉大部分的bots並在移轉後於 Automation 360 執行機器人。
  • 識別可在無需人為介入的情況下移轉至 Automation 360bots
  • 瞭解目前有 2% bots無法移轉的原因,以及可供稍後移轉機器人的估計時間。原因可能是因為 Automation 360 尚未支援命令和變數。

以下影像為來自Bot Scanner的範例報告:

Bot Scanner報告範例

下表說明範例Bot Scanner報告中的各種欄位 (如前一影像中的編號):

欄位/選項 說明
Bot Scanner報告選項 1 [可移轉的機器人] > [需執行動作] > [機器人]:針對移轉至 Automation 360 後需要採取動作的bots (5%),前往此檢視取得清單。
Bot Scanner報告選項 2
  • Bot名稱:若要檢視特定bot所需動作的訊息,請按一下bot名稱。此訊息提供您必須執行的手動步驟,以成功在 Automation 360 執行移轉的bot
  • 您也可以檢視bot包含的命令,以及bot使用命令的頻率或次數。
註: 每則訊息都包含原因,以及移轉後必須執行的動作。如需這些訊息清單,請參閱須採取動作的訊息。使用訊息代碼 (例如 A101) 快速檢視特定訊息。
Bot Scanner報告選項 3
  • [可移轉的機器人] > [需檢閱項目] > [機器人]:針對可移轉至 Automation 360 且應在移轉後檢閱的bots,前往此檢視取得清單。
  • 若要檢視特定bot的需要檢閱訊息,請按一下bot名稱。此訊息提供有關命令在 Automation 360 的行為相較於 Enterprise 11Enterprise 10 行為的變化。
註: 每則訊息都包含移轉後必須檢閱的資訊。如需這些訊息清單,請參閱檢閱所需訊息。使用訊息代碼 (例如 R102) 快速檢視特定訊息。
Bot Scanner報告選項 4 [可移轉的機器人] > [無需審核] > [機器人]:針對可移轉至 Automation 360 且無需任何人為介入的bots,前往此檢視取得清單。請按一下清單中的任何bot名稱,以離線檢視 XML 報告。
Bot Scanner報告選項 5
  • [現在無法移轉的機器人] > [機器人]:針對目前無法移轉至 Automation 360bots (在此案例中為 2% 的bots),前往此檢視取得清單。
  • 若要檢視特定bot的錯誤訊息,請按一下bot名稱。此訊息提供命令的詳細資料,這些命令會封鎖特定bot的移轉,以及命令位於bot的行號。
註: 每則訊息都包含您無法移轉特定bot的原因。如需這些訊息清單,請參閱錯誤訊息。使用訊息代碼 (例如 E101) 快速檢視特定訊息。
重要: 若無法移轉任何下層bots,則無法移轉上層bot。同樣的,若 MetaBot 中可用的任何邏輯無法移轉,則無法移轉 MetaBot
Bot Scanner報告選項 6
  • [可移轉的機器人] > [命令]:前往此檢視取得可移轉的命令清單,以及所有掃描的bots使用命令的次數,並檢視每個類別的這些詳細資料 (「需執行動作」、「需檢閱項目」和「無需審核」)。
  • [無法移轉的機器人] > [命令]:前往此檢視取得無法移轉至 Automation 360 的命令和系統變數的清單。

    您也可以檢視下列資訊,例如因用於下層bots的命令或變數不受支援而受影響的上層bots數目,在所有已掃描bots中使用命令或系統變數的頻率,以及包含可用於移轉之個別命令或變數的即將發行版本等。

Bot Scanner報告選項 7 下載 (CSV 檔案) bots清單或可移轉或無法移轉的命令,以便離線檢閱檔案或與他人共用檔案。

Bot Scanner的下個版本可供使用前,報告是有效的。Bot Scanner的下個版本可供使用時,會顯示報告到期訊息。您必須下載Bot Scanner的最新版本,然後再次掃描bots

移轉後所需的驗證和動作

bots中的某些命令可能在Bot Scanner報告中標示為需要檢閱。移轉這些項目後,您需要執行特定驗證或更新bots

下列Bot Scanner訊息需要驗證或採取某些動作:

  • 下層機器人路徑完全變數化,並於執行階段解決。若變數中指定的路徑無效,機器人會執行失敗。請檢閱移轉機器人。

    請確認下層bot可在變數化路徑中指定的位置上使用。若上層bot中的路徑不正確,請將路徑更新為正確的下層bot

  • 系統變數 [錯誤描述] 傳回的值可能會與舊版不同。請檢閱移轉的機器人。

    Automation 360 中某些錯誤訊息關於相同錯誤的描述可能與 Enterprise 11Enterprise 10 中有所不同。若 Enterprise 11Enterprise 10 bot設定為根據錯誤訊息描述而做出決策,您可能必須根據錯誤訊息中的新描述,更新移轉的bot

  • [Database - Connect] 命令移轉完成,但 [Windows 驗證] 需要額外設定。如需更多詳細資料,請參閱資料庫套件文件。

    完成指定步驟,以使用 Windows 驗證連線至 Microsoft SQL Server。請參閱使用 Windows 驗證連線至 Microsoft SQL Server

  • 含變數條件的 [IF] 移轉完成。然而,無法判斷使用者變數的日期格式,因此以預設的日期格式 mm/dd/yyyy HH:mm:ss 移轉。請檢閱並視需要變更格式。

    將移轉bot中的日期格式更新為該botEnterprise 11 中使用的相同格式。

  • 無法判斷用於位置的變數為索引或欄名稱。索引位置從 0 開始,而非 1,因此請視需要採取必要動作。

    若您已在 Enterprise 11Enterprise 10 bot中使用 FileData 欄 [$variable$] 或 Excel 欄 [$variable$] 系統變數,我們會假設您已在 $variable$ 中使用欄名稱。在這種情況下,移轉的bot會包含 FileData 欄 {$variable$} 運算式。若 Enterprise 11Enterprise 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:傳遞認證類型變數。
      1. 在下層bots中建立認證類型變數作為輸入變數。
      2. 在上層botTask Bot package [執行] action中更新輸入值欄位,即可將 Credential Vault 屬性用於為下層bot建立的認證類型變數 (對應至 MetaBot 邏輯)。
    • 選項 2:傳遞認證值以作為全域值。
      1. 針對 Enterprise 11 [執行邏輯] 命令中使用的認證,在 Automation 360 中建立全域值。
      2. 在上層botTask Bot package [執行] action中更新輸入值欄位,即可將全域值用於為下層bot建立的認證類型變數 (對應至 MetaBot 邏輯)。
    若您在安裝 Automation 360 時並未使用已還原的 Enterprise 11 資料庫,則必須先為 Enterprise 11 bot中使用的認證變數建立所需的儲存櫃,然後再執行前述步驟。
    註: Automation 360 可讓您在僅指派 Credential Vault 屬性給認證類型變數的情況下,提供強化的安全性。這會限制 Credential Vault 屬性的任何不安全處理,並有可能已指派給非認證類型變數。

個別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>
            
以下表格說明在先前影像中所述的 XML 報告中可用的各種屬性:
節點 屬性 說明
狀態 -- 提供相依項目、錯誤和警告數量的相關資訊。
-- 相依項目 指定bot的相依項目數量。ucount 表示唯一相依項目的數量,而 count 則表示相依項目的總數。
-- 錯誤 指定bot的錯誤數量。ucount 表示唯一錯誤的數量,而 count 則表示錯誤的總數。
命令 -- 提供bot使用的各種命令和動作之相關資訊。
-- 命令目標動作 為命令指定執行的動作。
-- 名稱 指定命令名稱。
-- 指定bot中可用命令的行號。
-- grp 指定命令所屬的命令群組。
-- api 指定命令使用的 API 名稱。