使用擷取action

使用 [擷取] action擷取單一互動 (按一下、擊鍵動作或滑鼠移動)，搭配物件控制項，包括文字方塊、按鈕、表格、功能表、圓形按鈕、下拉式方塊、核取方塊、清單檢視、連結、樹狀結構或頁面分頁。

先決條件

若要使用Recorder，您必須先完成下列操作：
- 安裝 Bot Agent 並註冊裝置
- 設定使用者裝置認證
將裝置顯示和字型縮放比例設定為 100%。
如果您使用Recorderpackage版本 2.0.6-20200626-193519 或更新版本，您可以在顯示比例設定成 100%、125% 或 150% 的電腦上，利用 Google Chrome Internet Explorer、Java、Microsoft Active Accessibility 和 Microsoft UI 自動化應用程式來錄製任務。
如果您使用瀏覽器將任務自動化，請將縮放比例設定為 100%。
如果您使用Recorderpackage版本 2.0.6-20200626-193519 或更新版本，您可以在未設定 100% 縮放比例的 Google Chrome 瀏覽器中錄製任務。
如果您使用 Google Chrome 瀏覽器自動執行任務，請確保與 Automation 360 組建版本一致的 Automation Anywhere 外掛程式已啟用。
RPA Workspace的瀏覽器需求
自動化運行在 Microsoft Edge Chromium 瀏覽器在 Internet Explorer 模式使用 Universal Recorder, 確保 Internet Explorer 兼容模式已啟用。Web 應用程序上的對像是使用 HTML 技術捕獲的。要啟用此模式，請執行以下步驟：
1. 在 Microsoft Edge Chromium 瀏覽器頁面，點擊設置。
2. 在左側面板上，點擊默認瀏覽器。
3. 導航到“ 允許站點在 Internet Explorer 模式下重新加載” 選項並選擇 “ 允許。
4. 單擊添加以添加要加載的頁面的 URL Internet Explorer 模式。
  註: 您添加的頁面在其中打開 Internet Explorer 自添加頁面之日起 30 天。

錄製任務時的考量：

盡可能使用「按一下」而非快速鍵。
當您使用Recorder按一下件時，會擷取可讓bot在執行階段識別物件的物件屬性。由於鍵盤快速鍵的可靠度較低，因此請在按一下物件仍無法將任務自動化時，才使用這些快速鍵。
如果您使用瀏覽器自動執行任務，請勿使用自動填滿功能將值輸入欄位。
低速記錄任務。
避免在錄製過程中拖動窗口。
避免按選不屬於您要錄製及自動化之流程的應用程式。
當使用 Internet Explorer 時，action會等瀏覽器完全呈現，並在執行action前處於就緒狀態。

程序

若要錄製與物件控制項的單一互動，請遵循下列步驟：

按兩下或拖曳 [錄製器] > [擷取]。

指定要擷取物件的視窗。

從應用程序、瀏覽器或變量選項卡中進行選擇。

選項	說明
應用程式	從當前活動窗口的列表中選擇。此選項顯示了所有打開的應用程序和瀏覽器窗口的列表 Bot Creator 設備。
瀏覽器	從支持的瀏覽器選項卡列表中選擇。註: 該選項支持 Google Chrome, 鉻基 Microsoft Edge，和 Internet Explorer 瀏覽器。對於所有其他瀏覽器，請使用應用程序選項。
變數	選取現有的視窗變數以指定應用程式視窗標題的標題。

選擇性的: 在 [視窗標題] 欄位中插入萬用字元 (*)，以搜尋可變更的視窗標題。您可以在值的開頭、中間或結尾指定一個或多個通配符 (*)。
例如，若要在標題中有 Microsoft 的任何視窗上執行作業，請在值之前或之後新增萬用字元，以透過萬用字元來表示任何字串：*Microsoft*。bot首先搜尋完全相符的視窗標題 (Microsoft)，如果找不到相符項目，它會再搜尋在標題中的任何位置具有 Microsoft 詞彙的視窗。
您可以使用規則運算式 (regex) 來識別視窗標題。選擇正則表達式條件作為字符串或模式，然後輸入值。默認情況下，窗口標題字段區分大小寫。

要識別瀏覽器標題，您可以啟用區分大小寫選項以匹配字母大小寫，或禁用該選項以識別字母大小寫不匹配的窗口標題。
註: 確保最低 Bot Agent 您系統上安裝的版本是隨發布的版本 Automation 360 五.26。如果你有一個 Bot Agent 發布的版本 Automation 360 v.25 或更早版本，則默認情況下，窗口標題將僅使用匹配的字母大小寫（區分大小寫）進行識別。
例如，對於所有以 ((\w*)-Notepad 開頭的窗口標題名稱，您可以將字符串值輸入為 ((\w*)-Notepad，或者使用模式值作為 ((\w)\s)*document- 僅用於那些匹配此模式的窗口標題的記事本
註:
- 帶有 -titleString類型的正則表達式作為任何窗口標題的輸入值時 action，這 bot 可能會遇到運行時錯誤。為防止運行時錯誤，請確保在將字符串輸入添加為 *-title時，具有特定標題的應用程序已打開。星號 (*) 只是一個字符，不是通配符。
- 帶有 -titlePattern類型的正則表達式作為任何窗口標題的輸入值時 action，這 bot 可能會遇到運行時錯誤，因為輸入值 *-title 不正確。
  確保您使用有效的正則表達式模式。
註: 在執行階段，請驗證 TaskBot 會識別正確的視窗。若非如此，請執行下列步驟：
選擇性的: 選取 [調整視窗大小] 選項以指定視窗大小。
此選項可提供更可靠的bot。它將窗口大小調整為記錄任務時的尺寸，這增強了 bot來識別目標對象。
- 如果錄製任務時窗口最大化，則不會選擇此選項。
- 如果錄製任務時窗口不是最大尺寸，默認情況下會選擇此選項，並且寬度和高度字段會自動填充窗口的尺寸。
註: 此選項僅適用於可調整大小的窗口。其不適用於 [桌面] 或 [任務列] 選項。
按一下 [擷取物件]。
隨即顯示選取的視窗。
將鼠標移到要自動化的對像上，例如按鈕、表單域或表格。
對象周圍出現一個紅色矩形框。
註: 如果該框沒有出現並且您正在捕獲 Google Chrome, Microsoft Edge，或者 Mozilla Firefox 瀏覽器，請確認您已啟用 Automation Anywhere 這些瀏覽器的擴展。看 Google Chrome 瀏覽器擴充功能需求為了 Google Chrome 瀏覽器。
單擊對象。

檢閱 [物件屬性] 表格。

以下是根據技術類型默認選擇的對象屬性列表：

Important: 以下列表不包括所有屬性，僅限於基於技術類型的最常用和重要的屬性


技術類型	物件屬性	說明
HTML 技術	控制項類型	這是一個只讀屬性，顯示捕獲的對像類型，例如文本框或按鈕。
	DOMXPath	這是用來找出所擷取控制項或物件的路徑。DOMXPath 有兩種類型：相對 XPath 與絕對 XPath。絕對 Xpath：其包含從根元素到所需元素的完整路徑。例如，此主題的絕對 Xpath 將是 `/html/body/div/div[1]/main/ div[2]/div/div/ div[2]/div/div/div[1]/ div/article/main/ article/div/p[1]` 相對 XPath：這是一個較短的路徑，指的是您要識別的元素。相對路徑以 `//` 符號開頭。例如，此主題的相對 XPath 為 `//*[@id="cloud-using-recorder-action"]/div/p[1]` 例如，如果您要在 Google Chrome 瀏覽器上找到特定元素的 DOMXPath，請執行這些步驟：選取您要為其擷取 XPath 的元素。在元素上按一下右鍵，並選取 [檢查]。右鍵單擊“ 元素選項卡中突出顯示的元素。去複制 > Copy Xpath 複製相對路徑，選擇 Copy > Copy full Xpath 複製絕對路徑。
	路徑	它是應用程序中特定控件位置的數字表示。對於 Web 應用程序，最佳做法是在與 Path 比較時使用搜索條件中的 DOMXPath。
	HTML 名稱和 ID	這些屬性用於標識 HTML 對象
	HTML 內部文字	DOM innerText 屬性可用來設定或傳回指定節點及其子系的文字內容
	HTML 標籤	HTML 標籤就像是定義網頁瀏覽器格式和顯示內容的關鍵字。例如，如果擷取的文字含有 HTML 程式碼：`<h3 class="search_results-title">搜索結果為 ״string package״</h3>` 在 HTML 標記字段中輸入 `h3`
微軟主動輔助功能	控制項類型	此屬性僅作為參考，以確保擷取正確的物件
	路徑	這是應用程式中特定控制項位置的數字表示法
	名稱	這會指定元素的名稱，如識別碼般運作
	ID	這會指定元素的 ID，如識別碼般運作
Java技術	控制項類型	此屬性僅作為參考，以確保擷取正確的物件
Java技術	路徑	這是應用程式中特定控制項位置的數字表示法
微軟用戶界面自動化	控制項類型	此屬性僅作為參考，以確保擷取正確的物件
	路徑	這是應用程式中特定控制項位置的數字表示法
	名稱	這會指定元素的名稱，如識別碼般運作
	ID	這會指定元素的 ID，如識別碼般運作
微軟用戶界面自動化 (COM)	控制項類型	此屬性僅用作確保捕獲正確對象的參考。
	路徑	它是應用程序中特定控件位置的數字表示。
	名稱	這指定了元素的名稱並用作標識符。
	ID	這指定元素的 ID 並用作標識符。

bot會使用選取的屬性來識別執行階段的物件控制項。

驗證 [控制項類型] 符合您想要的物件。
例如，從網站捕獲表格時，請確保控件類型和 HTML 標記值為 Table。

如果 [控制項類型] 與您想要的物件不符，請重新擷取物件控制項。
選取並指派值給您要包含在物件搜尋中的物件屬性。
為了有更可靠的bot，建議您僅選取具有靜態值的屬性 (例如 [名稱]、[類別]、[類型]、[HTML ID] 和 [DOMXPATHH])，然後取消選取具有動態值的屬性 (例如 [HTML Href]、[Path] 或 [值])，這些可能會有所變化，並導致bot錯誤。
最佳做法是在對象屬性值中使用通配符 (*) 或變量來搜索屬性動態且經常更改的對象。

從下拉式清單中選取 [動作]。
若需要依物件分類的可能actions完整清單，請參閱對捕獲的對象執行的操作 Universal Recorder。
- If you record a click and keystrokes in a text box with a Control Type of Password text, the Recorder does not capture the keystrokes entered into the field. Instead, the action selects the Set text option and offers options to securely input the password. We recommend that you store the password in the Credential Vault and insert it into the action as a credential.
  See 中的憑據和憑據變量 Bot editor.
  If you navigate to the text box using the TAB keystroke instead of a click in an MSAA or SAP application, the Recorder is able to identify fields with a Control Type of Password text.
- 如果所選操作支持後台處理，則會出現 “在後台運行” 選項。
  請參閱背景處理。
選擇性的: Keep trying for (seconds) 字段中輸入一個值以指定嘗試的秒數 bot 必須等待對象控件出現在應用程序窗口中。
我們建議在使用設置文本時設置延遲時間 action 在文本字段中輸入擊鍵。

註: 指定的超時時間 bot 等待控件出現在應用程序窗口上僅適用於控件所在的窗口存在的情況。這 Recorder 首先查找應用程序窗口，然後才搜索該窗口內的對象。搜索窗口的默認時間是 30 秒。因此，即使您指定等待時間為 5 秒，如果窗口不存在，它仍然默認等待 30 秒。

Recommendation: 我們建議您首先使用 0 秒的等待時間並確保應用程序窗口存在，然後指定 5 秒的等待時間並運行 bot 來檢測物體。
選擇性的: 將輸出指派給變數。
Control Room會根據您在步驟 8 中選取的動作，建議描述性預設變數名稱。例如，如果您選擇 Get property，建議的輸出變量是 PropertyValue。如果您創建多個輸出變量，則後續變量名稱將附加 -1 以避免重複。
按一下 [儲存]。
擷取的影像不會新增為相依性，而且在您簽入bot時不會顯示在相依性清單中。

Link an object to a supporting anchor

註: You can use object anchoring in Microsoft Active Accessibility, Microsoft UI Automation, or Java applications.

At runtime, if the bot cannot reliably identify an object, link it to a nearby object (such as a link or button) that is easier for the bot to find:

Open the Capture action.
Click the Anchor tab.
Click Capture anchor.
The browser or application window activates with the main object highlighted (the object that you previously captured). A dialog box appears, verifying whether the action has correctly identified the main object.
If the correct object is highlighted, click Yes, Select anchor.
Otherwise, click No, I need to correct it to select the correct object.
Select a nearby object to the target object that is easier for the bot to find.
The object is highlighted with an anchor icon on the right of the object.
Click Save.

Automation 360