IA-Connect 使用者介面
IA-Connect 是一個機器人流程自動化“RPA”平台,它將 RPA 功能從雲添加到本地虛擬機或通過 Citrix 或 Microsoft 遠程桌面“RDS”連接。 這是 Windows 應用程式使用者介面自動化 'UIA' 的模組。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | 創世紀實驗室 |
| URL | https://www.ultima.com/ultima-labs |
| IAConnect@ultima.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 創世紀商業 |
| 網站 | https://www.ultima.com/ultima-labs |
| 隱私策略 | https://www.ultima.com/privacy-policy |
| 類別 | IT運營;生產力 |
IA-Connect 是一個機器人流程自動化 (RPA) 平台,可將 RPA 功能從 Power Automate 雲端流程新增至內部部署虛擬機器,或透過 Citrix 或 Microsoft 遠端桌面 (RDS) 連線。 IA-Connect 連接器提供超過 800 個動作,可讓您直接從 Power Automate 雲端流程自動化每種類型的內部部署應用程式。 所有 IA-Connect 動作都可以直接從 Power Automate 雲端流程取得,從而在雲端型應用程式和內部部署應用程式之間輕鬆整合,並能夠在 RPA 流程中利用現有的 Power Automate 條件、迴圈、動態內容、運算式和例外狀況處理。 利用 IA-Connect Connectors 還可以從 Flow 執行歷史記錄中提供完整的執行歷史記錄和可審計性,同時也無需使用單獨的應用程式/控制台/工作室來開發 RPA 流程。
先決條件
若要使用任何 IA-Connect 連接器,您必須安裝 IA-Connect 軟體。 這是 30 天的免費測試,之後您將需要 IA-Connect 許可證。
IA-Connect 軟體由兩個主要組件組成:
IA-Connect Orchestrator,這是 Azure WebApp,您將在自己的 Azure 租用戶中裝載。 這會處理 RPA 流程到一或多個內部部署或雲端虛擬機器的路由和安全性。
IA-Connect 代理程式和導向器,安裝在可存取您要自動化軟體的虛擬機器上。 此外,IA-Connect 代理程式可以在 Citrix 或 Microsoft 遠端桌面服務 (RDS) 工作階段內執行,其中 RPA 命令會透過虛擬通道傳遞到遠端工作階段中以執行。 IA-Connect 代理程式可以從網路共用執行,而且不需要安裝。
可用的 IA-Connect 連接器
可用的 IA-Connect 連接器包括:
- IA-Connect 動態程式碼
- IA-Connect 爪哇
- IA-Connect JML
- IA-Connect 大型主機
- IA-Connect Microsoft辦公室
- IA-Connect SAP GUI
- IA-Connect 場
- IA-Connect 使用者介面
- IA-Connect 網頁瀏覽器
如何取得認證
為了獲得您的許可證並開始您的 30 天免費試用,請在我們的網站上提交請求 (https://www.ultima.com/IA-Connect/Power-Automate)。
收到試用請求後,我們將透過提供的電子郵件地址與您聯繫,以協助設定 IA-Connect 軟體並為您提供試用授權。 這是一個功能齊全的試用版,可讓您在試用期內測試自己環境中所有 9 個 IA-Connect Connector 的 800 個動作中的任何一個。
開始使用連接器
提交 IA-Connect 試用請求後,您將能夠下載包含 IA-Connect 軟件以及涵蓋安裝和設置的文件的 ZIP 文件。 我們還將根據需要與您聯繫,在安裝過程中提供支援和指導。
Support
在試用期間,您可以聯絡 Ultima Labs (IAConnect@ultima.com) 尋求支援和協助。
購買 IA-Connect 許可證後,您將收到支持代幣,這些代幣可以兌換 Ultima 位於英國的技術服務中心 (TSC) 的定制培訓或支持。
已知問題、常見錯誤和常見問題
我們的知識庫包含許多文章,涵蓋任何已知問題、使用 IA-Connect 連接器時可能發生的常見錯誤以及常見問題。 這可在 IA-Connect 試 https://support.ultima.com/ultimalabs 用期間和購買 IA-Connect 許可證時訪問,並提供訪問這些資源的帳戶。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 金鑰 | securestring | 此 API 的 API 金鑰 | 對 |
| IA-Connect Orchestrator 位址 | 字串 | 指定不含 HTTP(S) 元件的 IA-Connect Orchestrator 位址 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| UIA 元素的全域輸入密碼 |
將滑鼠移至元素的中心,聚焦元素,左鍵按一下,然後按按鍵。 通常與不接受原生 UIA 輸入法的密碼輸入搭配使用。 |
| UIA 桌面元素是否存在 |
報告桌面元素是否存在,並提供一些基本元素屬性。 |
| UIA元素是否存在 |
報告元素是否存在,並傳回一些基本元素屬性。 |
| 全域輸入文字到 UIA 元素中 |
將滑鼠移至元素的中心,聚焦元素,左鍵按一下,然後按按鍵。 通常與不接受原生 UIA 輸入法的文字輸入搭配使用。 |
| 全域鼠標單擊UIA元素搜索顏色區域 |
將滑鼠移至 UIA 元素內符合指定色彩準則的圖元區域,並執行滑鼠按兩下。 元素應該先放在前面,因為螢幕截圖是在元素位置拍攝螢幕的副本。 |
| 全局滑鼠中鍵單擊 UIA 元素 |
將滑鼠相對於 UIA 元素移動到中心,或選取的邊、角或偏移,然後按一下滑鼠中鍵。 |
| 全局滑鼠右鍵按一下 UIA 元素 |
將滑鼠相對於 UIA 元素移動到中心,或選取的邊、角或偏移,然後按一下滑鼠右鍵。 |
| 全局雙擊滑鼠左鍵 UIA 元素 |
將滑鼠相對於 UIA 元素移動到中心,或所選的邊緣、角落或偏移,然後按兩下滑鼠左鍵。 |
| 全局鼠標左鍵單擊 UIA 元素 |
將滑鼠相對於 UIA 元素移動到中心,或所選的邊、角或偏移,然後按一下滑鼠左鍵。 |
| 切換 UIA 元素 |
切換元素 (通常是核取方塊或選項方塊)。 這會讓元素處於與目前狀態相反的狀態(例如,已勾選變成未勾選,反之亦然)。 如果您想要設定特定狀態,請改用「檢查元素」動作。 |
| 取得 UIA 元素值 |
傳回元素的值。 值通常與文字輸入區域相關聯,但許多元素可以具有此屬性。 |
| 取得 UIA 元素屬性 |
傳回元素的所有屬性。 如果您不確定哪個欄位包含所需的屬性值,這會很有用。 |
| 取得 UIA 元素搜尋模式 |
擷取 IA-Connect Agent for UIA 動作正在使用的 UIA 元素搜尋模式。 |
| 取得 UIA 元素搜尋色彩區域 |
傳回 UIA 元素內符合指定色彩準則的像素區域詳細數據。 應先將元素放在前面,因為代理程式會透過在元素座標處截取螢幕截圖來定位顏色。 |
| 取得 UIA 元素文字值 |
傳回元素的文字值。 文字值通常與標籤相關聯,但許多元素可以具有此屬性。 |
| 取得 UIA 元素標籤值 |
傳回元素上的標籤值。 |
| 取得 UIA 元素模式 |
擷取哪些 UIA 模式可用於 UIA 元素,因此哪些 IA-Connect UIA 動作可能會對元素產生影響。 |
| 取得 UIA 桌面元素 |
傳回桌面上所有視窗和對話方塊的清單。 |
| 取得 UIA 清單元素專案 |
傳回在指定元素下找到的子元素專案清單 (通常是下拉式清單/功能表專案)。 |
| 取得 UIA 父元素控制碼 |
傳回指定元素之父元素的控制碼。 父元素被定義為位於 UIA “樹狀結構” 上下一級的元素,並且幾乎總是包含元素。 |
| 取得 UIA 資料方格元素內容 |
傳回 datagrid 元素的內容。 這是一個包含行、列、標題和儲存格(即表格)的元素。 此動作也可用來擷取先前執行此動作的結果,並以代理程式執行緒身分執行。 |
| 取得 UIA 資料方格元素屬性 |
傳回 DataGrid 元素的資料表屬性。 這是一個包含行、列、標題和儲存格(即表格)的元素。 |
| 取得 Win32 視窗 |
快速 Win32 動作,傳回所有 Win32 視窗的清單,這些視窗可選擇性地具有指定的類別名稱或視窗標題,或者您可以指定更進階的搜尋篩選,包括萬用字元。 雖然此動作使用 Win32 API,但它可以偵測 Windows、Java、ModernUI 和 Web 視窗。 Win32 Windows 可以包含非預期的項目,包括工作列、桌面、開始功能表、透明覆蓋、螢幕外或隱藏窗口,因此傳回的清單可能包含比預期更多的結果。 |
| 取得多個 UIA 元素作為資料表 |
列舉指定父元素的子元素值,並以表格格式傳回。 這可用來從技術上不是資料表,但已排列成資料表結構的元素傳回資料列和資料行。 此動作也可用來擷取先前執行此動作的結果,並以代理程式執行緒身分執行。 |
| 取得多個 UIA 元素屬性 |
傳回多個元素的屬性。 如果您不確定哪些欄位包含所需的屬性值,這會很有用。 |
| 取得多個 UIA 父元素屬性 |
傳回指定元素的父元素階層樹狀結構,一直到桌面 (根層級) 。 父元素被定義為位於 UIA “樹狀結構” 上下一級的元素,並且幾乎總是包含元素。 |
| 取得最上層 Win32 視窗的 UIA 控制碼 |
快速 Win32 動作,可傳回任何具有指定類別名稱或視窗標題之最上層 Win32 視窗的 UIA 控制碼,或者您可以指定更進階的搜尋篩選,包括萬用字元。 頂層視窗是連線到桌面的視窗。 雖然此動作使用 Win32 API,但它可以偵測 Windows、Java、ModernUI 和 Web 視窗。 窗口必須存在,IA-Connect 不會等待。 使用更強大的 UIA 動作「UIA 桌面元素是否存在」更常見,但此 Win32 動作通常執行速度更快。 |
| 取得桌面的 UIA 控制碼 |
傳回桌面的控制碼。 這是一個過時的操作,因為句柄 '-2' 可以用來引用桌面元素,但也因為有很多操作可以相對於桌面進行搜索(例如“等待桌面元素”)。 |
| 取得焦點元素主視窗的 UIA 句柄 |
傳回目前焦點 UIA 元素之主視窗的控制碼。 「主」視窗通常是應用程式主視窗:登入對話框或子視窗通常不是「主」視窗。 |
| 取得焦點元素的 UIA 控制碼 |
傳回目前焦點 UIA 元素的控制碼。 |
| 取得螢幕座標的 UIA 元素 |
傳回位於指定螢幕座標的 UIA 元素。 |
| 取得進程主視窗的 UIA 句柄 |
簡單且快速的 Win32 動作,傳回進程任何主視窗的控制碼 (以名稱指定) 。 「主」視窗通常是應用程式主視窗:登入對話框或子視窗通常不是「主」視窗。 視窗必須存在:IA-Connect 不會等待。 建議使用「等待桌面元素」動作,功能更強大。 |
| 取得進程標識碼主視窗的 UIA 句柄 |
簡單且快速的 Win32 動作,可傳回進程任何主要視窗的控制碼 (由進程標識碼指定) 。 「主」視窗通常是應用程式主視窗:登入對話框或子視窗通常不是「主」視窗。 建議使用「等待桌面元素」動作,功能更強大。 |
| 在 UIA 元素中尋找可見的搜尋影像 |
傳回搜尋影像 (作為此動作的輸入) 是否已明顯位於畫面上的 UIA 元素內。 元素應該先放在前面,因為代理程式會在元素的座標處截取螢幕截圖,並在螢幕擷取畫面中搜尋提供的搜尋影像。 |
| 在 UIA 元素周圍繪製矩形 |
在元素的周邊繪製矩形,以協助識別找到的元素是所需的元素。 矩形會在 5 秒後自動移除。 |
| 在UIA元素中輸入密碼 |
UIA 動作,將密碼輸入元素 (通常是密碼輸入欄位) ,取代現有的文字。 |
| 將 UIA 元素屬性作為清單 |
將元素的屬性作為單行清單(單行集合/資料表)傳回,而不是單個項目,這可能有用,具體取決於您打算如何使用資料。 |
| 將 UIA 元素設定為數值 |
設定具有數值輸入的元素值,例如文字欄位或捲軸。 |
| 將 UIA 元素設定為數值範圍值 |
設定具有數值範圍的元素值,例如捲軸。 |
| 將 UIA 視窗設定為正常 |
使用指定的 UIA 控制碼將視窗正規化 (,也就是將它設定為一般大小的視窗,而不是最小化或最大化) 。 |
| 將文字輸入到 UIA 元素中 |
UIA 動作,將文字輸入元素 (通常是文字輸入欄位) ,取代現有的文字,或在特定位置插入新值。 |
| 將文字輸入到多個 UIA 元素中 |
UIA 動作,將不同的文字片段輸入到多個元素(通常是文字輸入欄位)中,取代現有文字或在特定位置插入新值。 |
| 展開 UIA 元素 |
展開元素(通常是功能表/下拉式項目)。 如果項目已經展開,則不會發生任何動作。 |
| 截取 UIA 元素位置的螢幕截圖 |
擷取元素位置的螢幕擷取畫面,並傳回影像。 元素應該先放在前面,因為螢幕截圖是在元素位置拍攝螢幕的副本。 |
| 按 UIA 元素 |
按下元素 (通常是按鈕)。 |
| 按一下 依索引的 UIA 清單元素專案 |
按一下符合指定索引的清單元素。 這通常用於在下拉式清單/功能表項目中選取項目。 |
| 按名稱單擊 UIA 列表元素項目 |
按一下具有指定名稱的清單元素。 這通常用於在下拉式清單/功能表項目中選取項目。 |
| 搜尋第一個 UIA 父元素 |
在 UIA 樹狀結構階層中搜尋符合搜尋準則的第一個父元素。 父元素被定義為位於 UIA “樹狀結構” 上下一級的元素,並且幾乎總是包含元素。 |
| 摺疊 UIA 元素 |
摺疊元素 (通常是功能表/下拉式項目)。 如果項目已經折疊,則不會發生任何事情。 |
| 是否檢查 UIA 元素 |
此動作會傳回 true 或 false,指出是否已勾選元素 (通常是核取方塊或選項方塊)。 |
| 最大化 UIA 視窗 |
使用指定的 UIA 控制碼最大化視窗。 |
| 最小化 UIA 視窗 |
將具有指定 UIA 控制碼的視窗最小化。 |
| 檢查 UIA 元素 |
將元素的狀態 (通常是核取方塊或選項方塊) 設定為已核取或未核取。 |
| 檢查多個 UIA 元素 |
將多個元素 (通常是核取方塊或選項方塊) 的狀態設定為核取或未核取。 |
| 焦點 UIA 元素 |
聚焦元素,使其成為鍵盤焦點的作用中元素,而且視應用程式而定,可能會將元素視窗帶到前景。 |
| 移動 UIA 元素 |
將 UIA 元素移至畫面上的指定位置。 此動作通常只適用於 Window 元素 (具有轉換模式) 。 |
| 等候可見的搜尋影像不存在於 UIA 元素中 |
等候,直到搜尋影像 (作為此動作的輸入) 無法在畫面上的 UIA 元素內可見 (或從未找到) ,或指定的時間量已過且影像仍然存在。 元素應該先放在前面,因為代理程式會在元素的座標處截取螢幕截圖,並在螢幕擷取畫面中搜尋提供的搜尋影像。 UIA 元素必須從一開始就存在。 一旦影像不再存在,動作就會立即完成。 |
| 等待 UIA 元素 |
等候元素 (通常是視窗內的個別元素,例如按鈕或文字輸入區域) 存在。 |
| 等待 UIA 元素不存在 |
等候元素 (通常是視窗中的個別元素,例如按鈕或文字輸入區域) 不再存在。 |
| 等待 UIA 元素內可見的搜尋影像 |
等候,直到搜尋影像 (作為此動作的輸入) 已明顯位於螢幕上的 UIA 元素內,或經過指定的時間量為止。 元素應該先放在前面,因為代理程式會在元素的座標處截取螢幕截圖,並在螢幕擷取畫面中搜尋提供的搜尋影像。 UIA 元素必須從一開始就存在。 找到影像後,動作會立即完成。 |
| 等待 UIA 最上層 Win32 視窗 |
快速 Win32 動作,會等候指定的時間,讓最上層 Win32 視窗存在,再傳回 UIA 控制碼。 頂層視窗是連線到桌面的視窗。 您可以依類別名稱或視窗標題進行搜尋,也可以指定更進階的搜尋篩選器,包括萬用字元。 雖然此動作使用 Win32 API,但它可以偵測 Windows、Java、ModernUI 和 Web 視窗。 使用更強大的 UIA 動作「等候桌面元素」更常見,但此 Win32 動作通常執行速度更快。 |
| 等待 UIA 桌面元素 |
等候桌面元素 (通常是視窗) 存在。 |
| 等待 UIA 桌面元素不存在 |
等候桌面元素 (通常是視窗) 不再存在。 |
| 等待 UIA 進程主視窗 |
簡單且快速的 Win32 動作,會等候進程的主要視窗 (以名稱指定) 存在指定的時間,再傳回控制碼。 「主」視窗通常是應用程式主視窗:登入對話框或子視窗通常不是「主」視窗。 建議使用「等待桌面元素」動作,功能更強大。 |
| 等待 UIA 進程識別碼主視窗 |
簡單且快速的 Win32 動作,會等候進程的主要視窗 (由進程標識碼) 存在,並傳回控制碼。 「主」視窗通常是應用程式主視窗:登入對話框或子視窗通常不是「主」視窗。 建議使用「等待桌面元素」動作,功能更強大。 |
| 設定 UIA 交易逾時 |
控制 UIA API 等候應用程式傳回元素相關資訊的時間長度。 通常只有在應用程式沒有回應時,才會達到此交易逾時。 |
| 設定 UIA 元素捲動百分比 |
設定指定元素的水平和/或垂直捲動百分比(如果該元素支援捲動)。 如果元素支援「捲動」模式,您可以將此動作直接套用至元素,並指定水平或垂直捲動量 (或兩者兼而有之)。 如果元素不支援「捲動」模式,此動作會回復至 '範圍值' 或 'value' 模式,但您必須將這些模式直接套用至捲軸控制項,而不是元素本身。 |
| 設定 UIA 元素搜尋模式 |
選擇執行 UIA 動作時,IA-Connect Agent 應使用哪個 UIA 元素搜尋模式。 通常,只有在預設模式(全部尋找)發生問題時,才會使用此動作。 |
| 設定前景 UIA 視窗 |
將視窗帶到前景。 |
| 調整 UIA 元素的大小 |
調整 UIA 元素的大小。 此動作通常只適用於 Window 元素 (具有轉換模式) 。 |
| 輸入傳回至 UIA 元素 |
將 Windows 回傳/換行輸入到元素 (通常是文字輸入欄位) 中,取代現有的文字或在特定位置插入回傳。 |
| 進程有Win32窗口嗎 |
簡單且快速的 Win32 動作,可報告進程 (以名稱指定) 是否有任何可見視窗。 視窗必須存在:IA-Connect 不會等待。 建議使用「等待桌面元素」動作,功能更強大。 |
| 選取 UIA 元素 |
選取元素 (通常是清單或下拉式清單中的項目)。 |
| 重設所有 UIA 元素控制碼 |
重設目前由 IA-Connect 儲存的所有 UIA 元素控制碼,如果您已識別許多元素,而且儲存了大量元素控制碼,這會很有用。 在元素句柄數量極多 (100,000+) 的案例中,此動作也可用於釋放 RAM 使用量。 |
| 關閉 UIA 元素視窗 |
關閉元素視窗。 通常僅適用於視窗或對話方塊。 |
| 頂層Win32視窗存在嗎 |
快速 Win32 動作,可報告最上層 Win32 視窗是否存在。 頂層視窗是連線到桌面的視窗。 您可以依類別名稱或視窗標題進行搜尋,也可以指定更進階的搜尋篩選器,包括萬用字元。 雖然此動作使用 Win32 API,但它可以偵測 Windows、Java、ModernUI 和 Web 視窗。 窗口必須存在,IA-Connect 不會等待。 使用更強大的 UIA 動作「UIA 桌面元素是否存在」更常見,但此 Win32 動作通常執行速度更快。 |
UIA 元素的全域輸入密碼
將滑鼠移至元素的中心,聚焦元素,左鍵按一下,然後按按鍵。 通常與不接受原生 UIA 輸入法的密碼輸入搭配使用。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
焦點元素優先
|
FocusElement | boolean |
IA-Connect 應該在全局點擊之前嘗試聚焦元素嗎? |
|
|
全局鼠標左鍵單擊元素
|
GlobalMouseClickOnElement | boolean |
在輸入文字之前,是否應該在元素座標處執行全域滑鼠點擊(以聚焦元素)? |
|
|
使用雙擊滑鼠刪除取代現有值
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
是否應該透過雙擊滑鼠(突出顯示它)然後刪除來替換任何現有值? |
|
|
使用 CTRL-A 刪除取代現有值
|
ReplaceExistingValueUsingCTRLADelete | boolean |
是否應該通過按 Ctrl-A (突出顯示所有)然後刪除來替換任何現有值? 某些元素可能不支援使用 Ctrl-A 突出顯示,在這種情況下,應嘗試「使用雙擊滑鼠刪除取代現有值」的替代選項。 |
|
|
輸入密碼
|
PasswordToInput | True | password |
使用鍵盤進行全域輸入的密碼值。 |
|
使用傳送金鑰事件
|
SendKeyEvents | boolean |
如果設定為 true,則會使用傳送金鑰事件 (將模擬擊鍵傳送至作業系統的較低層級 API)。 如果設定為 false,則會改用傳送金鑰 (將擊鍵傳送至焦點元素的較高層級 API)。 |
|
|
間隔(以毫秒為單位)
|
Interval | integer |
每次按鍵之間的毫秒數。 |
|
|
不要解讀符號
|
DontInterpretSymbols | boolean |
「輸入密碼」中的符號不應被解釋為特殊鍵(例如,+ 代表 Shift,^ 代表 Ctrl)? 如果您嘗試輸入實際符號,則應將其設定為 true。 |
|
|
密碼包含儲存的密碼
|
PasswordContainsStoredPassword | boolean |
如果密碼包含 (或完全) IA-Connect 儲存的密碼識別碼 (格式為 {IAConnectPassword:StoredPasswordIdentifier}) 或 IA-Connect Orchestrator 一般認證 (格式為 {OrchestratorCredential:FriendlyName}),則設定為 true。 例如,此儲存的密碼可能是由「產生密碼」動作產生,或由 IA-Connect Orchestrator 保留。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
驗證元素邊界內的可點擊點
|
ValidateClickablePointWithinElementBoundary | boolean |
針對某些元素,UIA 不知道元素內的可點擊點,而且會傳回無效的座標 (例如 0,0) ,而不是元素的中心。 如果此輸入設定為 true,IA-Connect 會檢查 UIA 所提供座標的有效性,如果不在元素的界限內,則會忽略 UIA 所提供的值,並改用元素的中心。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
UIA 桌面元素是否存在
報告桌面元素是否存在,並提供一些基本元素屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋程序識別碼
|
SearchProcessId | integer |
如果指定 (值為 1 或更高) ,則搜尋只會考慮具有此處理程序識別碼 (PID) 的處理程序所擁有的元素。 如果 IA-Connect 啟動了該程序,則PID由 IA-Connect 環境/工作階段操作中的“運行程序”操作提供。 如果您不知道 PID,請將此欄位保留空白(或 0)。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
傳回元素句柄
|
ReturnElementHandle | boolean |
如果設定為 true,則會傳回所定位元素的控制碼。 此句柄可用於進一步的動作,以充當「父項」句柄。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
包含子程序
|
IncludeChildProcesses | boolean |
如果設定為 true 並指定「搜尋處理程序 ID」,則該處理程序 ID 的子處理程序也會包含在搜尋中。 如果設定為 false,則只會傳回符合確切「搜尋程式 ID」的程式。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果元素存在,則傳回 true,如果不存在,則傳回 false。 |
|
元素控點
|
ElementHandle | integer |
元素的 UIA 控制碼。 這可作為輸入,以進一步作用於此元素的 UIA 動作。 |
|
元素名稱
|
ElementName | string |
元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
元素的 UIA 當地語系化控制項類型。 |
UIA元素是否存在
報告元素是否存在,並傳回一些基本元素屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋程序識別碼
|
SearchProcessId | integer |
如果指定 (值為 1 或更高) ,則搜尋只會考慮具有此處理程序識別碼 (PID) 的處理程序所擁有的元素。 如果 IA-Connect 啟動了該程序,則PID由 IA-Connect 環境/工作階段操作中的“運行程序”操作提供。 如果您不知道 PID,請將此欄位保留空白(或 0)。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
傳回元素句柄
|
ReturnElementHandle | boolean |
如果設定為 true,則會傳回所定位元素的控制碼。 此句柄可用於進一步的動作,以充當「父項」句柄。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
包含子程序
|
IncludeChildProcesses | boolean |
如果設定為 true 並指定「搜尋處理程序 ID」,則該處理程序 ID 的子處理程序也會包含在搜尋中。 如果設定為 false,則只會搜尋符合確切「搜尋程式 ID」的程式。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果元素存在,則傳回 true,如果不存在,則傳回 false。 |
|
元素控點
|
ElementHandle | integer |
元素的 UIA 控制碼。 這可作為輸入,以進一步作用於此元素的 UIA 動作。 |
|
元素名稱
|
ElementName | string |
元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
元素的 UIA 當地語系化控制項類型。 |
全域輸入文字到 UIA 元素中
將滑鼠移至元素的中心,聚焦元素,左鍵按一下,然後按按鍵。 通常與不接受原生 UIA 輸入法的文字輸入搭配使用。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
焦點元素優先
|
FocusElement | boolean |
IA-Connect 應該在全局點擊之前嘗試聚焦元素嗎? |
|
|
全局鼠標左鍵單擊元素
|
GlobalMouseClickOnElement | boolean |
在輸入文字之前,是否應該在元素座標處執行全域滑鼠點擊(以聚焦元素)? |
|
|
使用雙擊滑鼠刪除取代現有值
|
ReplaceExistingValueUsingDoubleClickDelete | boolean |
是否應該透過雙擊滑鼠(突出顯示它)然後刪除來替換任何現有值? |
|
|
使用 CTRL-A 刪除取代現有值
|
ReplaceExistingValueUsingCTRLADelete | boolean |
是否應該通過按 Ctrl-A (突出顯示所有)然後刪除來替換任何現有值? 某些元素可能不支援使用 Ctrl-A 突出顯示,在這種情況下,應嘗試「使用雙擊滑鼠刪除取代現有值」的替代選項。 |
|
|
要輸入的文字
|
TextToInput | string |
使用鍵盤進行全域輸入的文字值。 |
|
|
使用傳送金鑰事件
|
SendKeyEvents | boolean |
如果設定為 true,則會使用傳送金鑰事件 (將模擬擊鍵傳送至作業系統的較低層級 API)。 如果設定為 false,則會改用傳送金鑰 (將擊鍵傳送至焦點元素的較高層級 API)。 |
|
|
間隔(以毫秒為單位)
|
Interval | integer |
每次按鍵之間的毫秒數。 |
|
|
不要解讀符號
|
DontInterpretSymbols | boolean |
「要輸入的文字」中的符號不應被解釋為特殊鍵(例如,+ 代表 Shift,^ 代表 Ctrl)? 如果您嘗試輸入實際符號,則應將其設定為 true。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
驗證元素邊界內的可點擊點
|
ValidateClickablePointWithinElementBoundary | boolean |
針對某些元素,UIA 不知道元素內的可點擊點,而且會傳回無效的座標 (例如 0,0) ,而不是元素的中心。 如果此輸入設定為 true,IA-Connect 會檢查 UIA 所提供座標的有效性,如果不在元素的界限內,則會忽略 UIA 所提供的值,並改用元素的中心。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
全域鼠標單擊UIA元素搜索顏色區域
將滑鼠移至 UIA 元素內符合指定色彩準則的圖元區域,並執行滑鼠按兩下。 元素應該先放在前面,因為螢幕截圖是在元素位置拍攝螢幕的副本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
搜尋顏色
|
SearchColour | True | string |
以 0xAARRGGBB、#AARRGGBB、0xRRGGBB 或 #RRGGBB 格式搜尋顏色,其中每個顏色通道都是十六進位格式的字節(00 完全關閉,FF 完全開啟)。 例如:#FF0000 代表紅色,#00FF00 代表藍色,#000000代表黑色,#FFFFFF 代表白色。 |
|
最大顏色偏差
|
MaxColourDeviation | True | integer |
元素顏色在不被視為相符之前可以偏離搜尋顏色的最大值。 0 表示沒有偏差。 偏差以 RGB 值測量。 例如:#FF0000 與 #FE0102 有4個不同。 15 的偏差將是一個很好的起點。 |
|
左圖元X偏移
|
LeftPixelXOffset | integer |
搜尋區域左邊緣的可選 X 偏移。 這可讓您增加 (負值) 或減少 (正值) 搜尋區域。 |
|
|
右圖元 X 偏移
|
RightPixelXOffset | integer |
搜尋區域右邊緣的可選 X 偏移。 這可讓您增加 (使用正值) 或減少 (使用負值) 搜尋區域。 |
|
|
頂部像素 Y 位移
|
TopPixelYOffset | integer |
搜尋區域頂部邊緣的可選 Y 偏移。 這可讓您增加 (負值) 或減少 (正值) 搜尋區域。 |
|
|
底部像素 Y 偏移
|
BottomPixelYOffset | integer |
搜尋區域底部邊緣的可選 Y 偏移。 這可讓您增加 (使用正值) 或減少 (使用負值) 搜尋區域。 |
|
|
滑鼠按鈕
|
MouseButton | string |
要按下的滑鼠按鈕(左、右、中、雙左)。 |
|
|
按一下偏移 X
|
ClickOffsetX | integer |
要偏移點擊動作的 X 像素數。 此參數同時支援正 (右) 和負 (左) 偏移值。 |
|
|
按一下偏移 Y
|
ClickOffsetY | integer |
要偏移點擊動作的 Y 像素數。 此參數支援正(向下)和負(向上)偏移值。 |
|
|
相對於
|
OffsetRelativeTo | string |
要偏移的顏色區域的相對位置 (中心/中心/中間、左、右、上、下、左上、右上、左下、右下)。 |
|
|
延遲(以毫秒為單位)
|
DelayInMilliseconds | integer |
如果執行按兩下,則每次按兩下之間的延遲(以毫秒為單位)。 |
|
|
隱藏代理程式
|
HideAgent | boolean |
設定為 true 可自動隱藏代理程式 (如果可見),以確保它不會遮擋正在分析的元素。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
指令結果
|
UIAGlobalMouseClickElementSearchColourRegionResult | boolean |
命令的結果(成功或失敗)。 |
|
錯誤訊息
|
ErrorMessage | string |
如果指令不成功,則會包含傳回的錯誤訊息。 |
全局滑鼠中鍵單擊 UIA 元素
將滑鼠相對於 UIA 元素移動到中心,或選取的邊、角或偏移,然後按一下滑鼠中鍵。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
焦點元素優先
|
FocusElementFirst | boolean |
IA-Connect 應該在全局點擊之前嘗試聚焦元素嗎? |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
按一下偏移 X
|
ClickOffsetX | integer |
要偏移點擊動作的 X 像素數。 此參數同時支援正 (右) 和負 (左) 偏移值。 |
|
|
按一下偏移 Y
|
ClickOffsetY | integer |
要偏移點擊動作的 Y 像素數。 此參數支援正(向下)和負(向上)偏移值。 |
|
|
相對於
|
OffsetRelativeTo | string |
要偏移的元素的相對位置 (中心/中心/中間、左、右、上、下、左上、右上、左下、右下)。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
驗證元素邊界內的可點擊點
|
ValidateClickablePointWithinElementBoundary | boolean |
針對某些元素,UIA 不知道元素內的可點擊點,而且會傳回無效的座標 (例如 0,0) ,而不是元素的中心。 如果此輸入設定為 true,IA-Connect 會檢查 UIA 所提供座標的有效性,如果不在元素的界限內,則會忽略 UIA 所提供的值,並改用元素的中心。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
全局滑鼠右鍵按一下 UIA 元素
將滑鼠相對於 UIA 元素移動到中心,或選取的邊、角或偏移,然後按一下滑鼠右鍵。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
焦點元素優先
|
FocusElementFirst | boolean |
IA-Connect 應該在全局點擊之前嘗試聚焦元素嗎? |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
按一下偏移 X
|
ClickOffsetX | integer |
要偏移點擊動作的 X 像素數。 此參數同時支援正 (右) 和負 (左) 偏移值。 |
|
|
按一下偏移 Y
|
ClickOffsetY | integer |
要偏移點擊動作的 Y 像素數。 此參數支援正(向下)和負(向上)偏移值。 |
|
|
相對於
|
OffsetRelativeTo | string |
要偏移的元素的相對位置 (中心/中心/中間、左、右、上、下、左上、右上、左下、右下)。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
驗證元素邊界內的可點擊點
|
ValidateClickablePointWithinElementBoundary | boolean |
針對某些元素,UIA 不知道元素內的可點擊點,而且會傳回無效的座標 (例如 0,0) ,而不是元素的中心。 如果此輸入設定為 true,IA-Connect 會檢查 UIA 所提供座標的有效性,如果不在元素的界限內,則會忽略 UIA 所提供的值,並改用元素的中心。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
全局雙擊滑鼠左鍵 UIA 元素
將滑鼠相對於 UIA 元素移動到中心,或所選的邊緣、角落或偏移,然後按兩下滑鼠左鍵。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
延遲(以毫秒為單位)
|
DelayInMilliseconds | integer |
每次點擊之間的延遲(以毫秒為單位)。 |
|
|
焦點元素優先
|
FocusElementFirst | boolean |
IA-Connect 應該在全局點擊之前嘗試聚焦元素嗎? |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
按一下偏移 X
|
ClickOffsetX | integer |
要偏移點擊動作的 X 像素數。 此參數同時支援正 (右) 和負 (左) 偏移值。 |
|
|
按一下偏移 Y
|
ClickOffsetY | integer |
要偏移點擊動作的 Y 像素數。 此參數支援正(向下)和負(向上)偏移值。 |
|
|
相對於
|
OffsetRelativeTo | string |
要偏移的元素的相對位置 (中心/中心/中間、左、右、上、下、左上、右上、左下、右下)。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
驗證元素邊界內的可點擊點
|
ValidateClickablePointWithinElementBoundary | boolean |
針對某些元素,UIA 不知道元素內的可點擊點,而且會傳回無效的座標 (例如 0,0) ,而不是元素的中心。 如果此輸入設定為 true,IA-Connect 會檢查 UIA 所提供座標的有效性,如果不在元素的界限內,則會忽略 UIA 所提供的值,並改用元素的中心。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
全局鼠標左鍵單擊 UIA 元素
將滑鼠相對於 UIA 元素移動到中心,或所選的邊、角或偏移,然後按一下滑鼠左鍵。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
焦點元素優先
|
FocusElementFirst | boolean |
IA-Connect 應該在全局點擊之前嘗試聚焦元素嗎? |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
按一下偏移 X
|
ClickOffsetX | integer |
要偏移點擊動作的 X 像素數。 此參數同時支援正 (右) 和負 (左) 偏移值。 |
|
|
按一下偏移 Y
|
ClickOffsetY | integer |
要偏移點擊動作的 Y 像素數。 此參數支援正(向下)和負(向上)偏移值。 |
|
|
相對於
|
OffsetRelativeTo | string |
要偏移的元素的相對位置 (中心/中心/中間、左、右、上、下、左上、右上、左下、右下)。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
驗證元素邊界內的可點擊點
|
ValidateClickablePointWithinElementBoundary | boolean |
針對某些元素,UIA 不知道元素內的可點擊點,而且會傳回無效的座標 (例如 0,0) ,而不是元素的中心。 如果此輸入設定為 true,IA-Connect 會檢查 UIA 所提供座標的有效性,如果不在元素的界限內,則會忽略 UIA 所提供的值,並改用元素的中心。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
切換 UIA 元素
切換元素 (通常是核取方塊或選項方塊)。 這會讓元素處於與目前狀態相反的狀態(例如,已勾選變成未勾選,反之亦然)。 如果您想要設定特定狀態,請改用「檢查元素」動作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
取得 UIA 元素值
傳回元素的值。 值通常與文字輸入區域相關聯,但許多元素可以具有此屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素值
|
ElementValue | string |
元素的值。 |
取得 UIA 元素屬性
傳回元素的所有屬性。 如果您不確定哪個欄位包含所需的屬性值,這會很有用。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
傳回元素句柄
|
ReturnElementHandle | boolean |
如果設定為 true,則會傳回所定位元素的控制碼。 此句柄可用於進一步的動作,以充當「父項」句柄。 |
|
|
傳回元素值
|
ReturnElementValue | boolean |
如果設定為 true,則會傳回定位元素的值。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
驗證元素邊界內的可點擊點
|
ValidateClickablePointWithinElementBoundary | boolean |
針對某些元素,UIA 不知道元素內的可點擊點,而且會傳回無效的座標 (例如 0,0) ,而不是元素的中心。 如果此輸入設定為 true,IA-Connect 會檢查 UIA 所提供座標的有效性,如果不在元素的界限內,則會忽略 UIA 所提供的值,並改用元素的中心。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素名稱
|
ElementName | string |
元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
元素的 UIA 自動化識別碼。 |
|
元素架構識別碼
|
ElementFrameworkId | string |
元素的 UIA 架構識別碼。 |
|
元素控制類型
|
ElementControlType | string |
UIA 控制項類型為數字。 這類似於當地語系化控制項類型,但不是特定於語言的。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
元素的 UIA 當地語系化控制項類型。 |
|
元素已啟用
|
ElementIsEnabled | boolean |
傳回元素是否已啟用。 |
|
元素在螢幕外
|
ElementIsOffscreen | boolean |
傳回元素是否在畫面外。 |
|
元素可按鍵盤聚焦
|
ElementIsKeyboardFocusable | boolean |
傳回元素是否可以由鍵盤聚焦。 |
|
Element 具有鍵盤焦點
|
ElementHasKeyboardFocus | boolean |
傳回元素目前是否具有鍵盤焦點。 |
|
元素是密碼欄位
|
ElementIsPasswordField | boolean |
傳回元素是否為密碼輸入欄位。 |
|
元素加速鍵
|
ElementAcceleratorKey | string |
傳回可按下的熱鍵來啟動元素。 |
|
元素存取金鑰
|
ElementAccessKey | string |
傳回可按下的熱鍵來啟動功能表元素。 |
|
元素左邊緣
|
ElementLeftEdge | integer |
元素或視窗的左邊緣與顯示器的左邊緣之間的距離 (以像素為單位)。 |
|
元素右邊緣
|
ElementRightEdge | integer |
元素或視窗的右邊緣與顯示器的左邊緣之間的距離 (以像素為單位)。 |
|
元素頂部邊緣
|
ElementTopEdge | integer |
元素或視窗的頂端邊緣與顯示器的頂端邊緣之間的距離 (以像素為單位)。 |
|
元素底部邊緣
|
ElementBottomEdge | integer |
元素或視窗底部邊緣與顯示器頂部邊緣之間的距離 (以像素為單位)。 |
|
元素可點擊點 X
|
ElementClickablePointX | integer |
元素中相對於基礎應用程式所傳回的顯示器左邊緣的中央可點按點的 X 座標 (以像素為單位)。 |
|
元素可點擊點 Y
|
ElementClickablePointY | integer |
元素中中央可點按點的 Y 座標 (以像素為單位),相對於基礎應用程式所傳回的顯示器頂端邊緣。 |
|
元素程序 ID
|
ElementProcessId | integer |
擁有此元素之進程的進程 ID (PID)。 |
|
元素控點
|
ElementHandle | integer |
如果輸入 'Return 元素控制碼' 設定為 true,這會保留數值元素控制碼,可用於進一步動作,作為進一步動作的 '父' 控制碼。 |
|
元素值
|
ElementValue | string |
如果輸入「傳回元素值」設定為 true,且元素具有值模式,則會保留該值。 |
|
元素文字值
|
ElementTextValue | string |
如果輸入的「傳回元素值」設定為 true,且元素具有文字值模式,則會保留該文字值。 |
取得 UIA 元素搜尋模式
擷取 IA-Connect Agent for UIA 動作正在使用的 UIA 元素搜尋模式。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
UIA 元素搜尋模式
|
UIAElementSearchMode | string |
IA-Connect 代理程式目前使用的 UIA 元素搜尋模式。 |
取得 UIA 元素搜尋色彩區域
傳回 UIA 元素內符合指定色彩準則的像素區域詳細數據。 應先將元素放在前面,因為代理程式會透過在元素座標處截取螢幕截圖來定位顏色。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
搜尋顏色
|
SearchColour | True | string |
以 0xAARRGGBB、#AARRGGBB、0xRRGGBB 或 #RRGGBB 格式搜尋顏色,其中每個顏色通道都是十六進位格式的字節(00 完全關閉,FF 完全開啟)。 例如:#FF0000 代表紅色,#00FF00 代表藍色,#000000代表黑色,#FFFFFF 代表白色。 |
|
最大顏色偏差
|
MaxColourDeviation | True | integer |
元素顏色在不被視為相符之前可以偏離搜尋顏色的最大值。 0 表示沒有偏差。 偏差以 RGB 值測量。 例如:#FF0000 與 #FE0102 有4個不同。 15 的偏差將是一個很好的起點。 |
|
左圖元X偏移
|
LeftPixelXOffset | integer |
搜尋區域左邊緣的可選 X 偏移。 這可讓您增加 (負值) 或減少 (正值) 搜尋區域。 |
|
|
右圖元 X 偏移
|
RightPixelXOffset | integer |
搜尋區域右邊緣的可選 X 偏移。 這可讓您增加 (使用正值) 或減少 (使用負值) 搜尋區域。 |
|
|
頂部像素 Y 位移
|
TopPixelYOffset | integer |
搜尋區域頂部邊緣的可選 Y 偏移。 這可讓您增加 (負值) 或減少 (正值) 搜尋區域。 |
|
|
底部像素 Y 偏移
|
BottomPixelYOffset | integer |
搜尋區域底部邊緣的可選 Y 偏移。 這可讓您增加 (使用正值) 或減少 (使用負值) 搜尋區域。 |
|
|
隱藏代理程式
|
HideAgent | boolean |
設定為 true 可自動隱藏代理程式 (如果可見),以確保它不會遮擋正在分析的元素。 |
|
|
將螢幕座標傳回為實體座標
|
ReturnPhysicalCoordinates | boolean |
設定為 true,讓螢幕座標傳回為實體座標。 設定為 false,讓螢幕座標傳回為虛擬座標。 如果基礎顯示縮放比例為 100%,則實體座標和虛擬座標都相同。 元素座標一律會傳回為虛擬座標。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
符合顏色的像素數
|
NumberOfPixelsMatchingColour | integer |
符合指定顏色的像素數。 |
|
顏色比對邊界框元素左像素
|
ColourMatchBoundingBoxElementLeftPixelXCoord | integer |
最左邊像素的虛擬 X 座標,符合指定色彩,相對於元素虛擬左上角。 |
|
顏色比對邊界框元素右側像素
|
ColourMatchBoundingBoxElementRightPixelXCoord | integer |
最右邊像素的虛擬 X 座標,符合指定色彩,相對於元素虛擬左上角。 |
|
顏色比對邊界方塊元素頂端像素
|
ColourMatchBoundingBoxElementTopPixelYCoord | integer |
符合指定色彩的最頂端圖元的虛擬 Y 座標,相對於元素虛擬左上角。 |
|
顏色比對邊界方塊元素底部像素
|
ColourMatchBoundingBoxElementBottomPixelYCoord | integer |
最底部圖元的虛擬 Y 座標,符合指定色彩,相對於元素虛擬左上角。 |
|
顏色比對邊界框元素中心 X 像素
|
ColourMatchBoundingBoxElementCenterPixelXCoord | integer |
邊界方塊中心的虛擬 X 座標,其中包含符合指定色彩的圖元,相對於元素虛擬左上角。 |
|
顏色比對邊界框元素中心 Y 像素
|
ColourMatchBoundingBoxElementCenterPixelYCoord | integer |
邊界方塊中心的虛擬 Y 座標,其中包含符合指定色彩的像素,相對於元素虛擬左上角。 |
|
顏色匹配邊界框屏幕左側像素
|
ColourMatchBoundingBoxScreenLeftPixelXCoord | integer |
符合指定色彩的最左邊像素的螢幕像素 X 座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
顏色匹配邊界框屏幕右像素
|
ColourMatchBoundingBoxScreenRightPixelXCoord | integer |
最右邊像素符合指定色彩的螢幕像素 X 座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
顏色比對邊界框螢幕頂端像素
|
ColourMatchBoundingBoxScreenTopPixelYCoord | integer |
符合指定色彩的最頂端像素的螢幕像素 Y 座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
顏色比對邊界框螢幕底部像素
|
ColourMatchBoundingBoxScreenBottomPixelYCoord | integer |
符合指定色彩的最底部像素的螢幕像素 Y 座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
顏色匹配邊界框屏幕中心 X 像素
|
ColourMatchBoundingBoxScreenCenterPixelXCoord | integer |
邊界方塊中心的螢幕像素 X 座標,其中包含符合指定色彩的像素。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
顏色匹配邊界框屏幕中心 Y 像素
|
ColourMatchBoundingBoxScreenCenterPixelYCoord | integer |
邊界方塊中心的螢幕像素 Y 座標,其中包含符合指定色彩的像素。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
取得 UIA 元素文字值
傳回元素的文字值。 文字值通常與標籤相關聯,但許多元素可以具有此屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素文字值
|
ElementTextValue | string |
元素的文字值。 |
取得 UIA 元素標籤值
傳回元素上的標籤值。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素標籤值
|
ElementLabelValue | string |
元素上的標籤值。 |
取得 UIA 元素模式
擷取哪些 UIA 模式可用於 UIA 元素,因此哪些 IA-Connect UIA 動作可能會對元素產生影響。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
展開摺疊模式可用
|
ExpandCollapsePatternAvailable | boolean |
UIA 展開摺疊模式可供使用,因此展開或摺疊元素的動作 (例如,下拉式功能表) 可能會運作。 |
|
可用的叫用模式
|
InvokePatternAvailable | boolean |
UIA 叫用模式可供使用,因此按下元素或按一下清單元素專案的動作可能會運作。 |
|
提供範圍值模式
|
RangeValuePatternAvailable | boolean |
UIA 範圍值模式可供使用,因此捲動元素或滑桿的動作可能會運作。 |
|
提供滾動圖案
|
ScrollPatternAvailable | boolean |
UIA 捲動模式可供使用,因此捲動元素的動作可能會運作。 |
|
可用的選擇項目模式
|
SelectionItemPatternAvailable | boolean |
UIA 選取項目型樣可供使用,因此選取元素的動作可能會運作。 |
|
可用的文字模式
|
TextPatternAvailable | boolean |
UIA 文字模式可供使用,因此讀取元素文字值的動作可能會運作。 |
|
提供切換模式
|
TogglePatternAvailable | boolean |
UIA 切換模式可供使用,因此檢查、取消勾選或切換元素的動作可能會正常運作。 |
|
可用的值模式
|
ValuePatternAvailable | boolean |
UIA 值模式可供使用,因此將文字輸入元素或讀取元素值的動作可能會運作。 捲軸也可以對值模式做出反應。 |
|
提供窗戶圖案
|
WindowPatternAvailable | boolean |
UIA 視窗模式可用,因此關閉、最大化或最小化元素的動作可能會起作用。 |
|
提供網格圖案
|
GridPatternAvailable | boolean |
UIA 網格模式可供使用。 IA-Connect不使用此模式。 |
|
提供網格項目模式
|
GridItemPatternAvailable | boolean |
可以使用 UIA 方格項目模式。 IA-Connect不使用此模式。 |
|
舊版 I可用的可存取模式
|
LegacyIAccessiblePatternAvailable | boolean |
可以使用 UIA 舊版 IAccessible 模式。 IA-Connect不使用此模式。 |
|
提供選擇模式
|
SelectionPatternAvailable | boolean |
UIA 選取模式可供使用。 IA-Connect不使用此模式。 |
|
提供試算表模式
|
SpreadsheetPatternAvailable | boolean |
UIA 試算表型樣可供使用。 IA-Connect不使用此模式。 |
|
提供試算表項目模式
|
SpreadsheetItemPatternAvailable | boolean |
UIA 試算表項目型樣可供使用。 IA-Connect不使用此模式。 |
|
提供表格圖案
|
TablePatternAvailable | boolean |
UIA 表格型樣可供使用。 IA-Connect不使用此模式。 |
|
可用的表格項目模式
|
TableItemPatternAvailable | boolean |
可以使用 UIA 資料表項目型樣。 IA-Connect不使用此模式。 |
|
可用的文字模式 2
|
TextPattern2Available | boolean |
UIA 文字型樣 2 可供使用。 IA-Connect不使用此模式。 |
|
提供文字編輯模式
|
TextEditPatternAvailable | boolean |
UIA 文字編輯型樣可供使用。 IA-Connect不使用此模式。 |
|
可用的轉換模式
|
TransformPatternAvailable | boolean |
UIA 轉換模式可供使用。 IA-Connect不使用此模式。 |
取得 UIA 桌面元素
傳回桌面上所有視窗和對話方塊的清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋元素當地語系化控制項類型
|
SearchElementLocalizedControlType | string |
依元素的當地語系化控制類型篩選結果。 |
|
|
搜尋程序識別碼
|
SearchProcessID | integer |
如果指定,則搜尋只會考慮具有此進程識別碼 (PID) 的進程所擁有的元素。 如果 IA-Connect 啟動了該程序,則PID由 IA-Connect 環境/工作階段操作中的“運行程序”操作提供。 如果您不知道PID,請將此欄位留空。 |
|
|
傳回元素句柄
|
ReturnElementHandle | boolean |
如果設定為 true,則會傳回所定位元素的控制碼。 此句柄可用於進一步的動作,以充當「父項」句柄。 |
|
|
第一個要退貨的商品
|
FirstItemToReturn | integer |
第一個要傳回的項目的元素索引,從1開始。 如果您想要以相反的順序傳回元素 (從 UIA 樹狀結構的底部開始) ,您也可以指定從 -1 開始的負索引。 |
|
|
退貨項目上限
|
MaxItemsToReturn | integer |
要傳回的元素數目上限,或 0 傳回所有專案。 |
|
|
包含子程序
|
IncludeChildProcesses | boolean |
如果設定為 true 並指定「搜尋處理程序 ID」,則該處理程序 ID 的子處理程序也會包含在搜尋中。 如果設定為 false,則只會傳回符合確切「搜尋程式 ID」的程式。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
找到的元素數量
|
NumberOfElementsFound | integer |
找到符合搜尋條件的桌面元素數目。 |
|
傳回的元素數目
|
NumberOfElementsReturned | integer |
傳回的桌面元素數目 (如果指定要傳回的專案數目上限,則可能低於找到的元素數目)。 |
|
元素屬性
|
ElementProperties | array of object |
找到符合搜尋準則的桌面元素的元素屬性。 |
|
items
|
ElementProperties | object |
取得 UIA 清單元素專案
傳回在指定元素下找到的子元素專案清單 (通常是下拉式清單/功能表專案)。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
先展開
|
ExpandFirst | boolean |
如果設定為 true,則 IA-Connect 會在搜尋清單項目元素之前嘗試展開清單。 這對於動態清單很有用,因為在清單展開之前,可能不會建立清單項目元素。 |
|
|
折疊後
|
CollapseAfter | boolean |
如果設定為true,則清單將在執行搜尋後摺疊。 |
|
|
檢查所選項目
|
CheckForSelectedItems | boolean |
如果設定為 true,則輸出集合會包含其他屬性,指出目前是否已選取清單項目。 |
|
|
展開和收合之間的秒數
|
SecondsBetweenExpandCollapse | double |
展開和摺疊動作之間等待的秒數 (如果這些動作設定為 true)。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
清單項目數
|
NumberOfListItems | integer |
清單中的項目數。 |
|
清單項目JSON
|
ListItemsJSON | string |
清單中項目的屬性,以 JSON 格式。 |
|
所選項目數量
|
NumberOfSelectedItems | integer |
清單中選取的項目數目。 |
|
第一個所選項目的索引
|
IndexOfFirstSelectedItem | integer |
第一個所選項目清單中的索引。 |
|
所選項目名稱
|
SelectedItemName | string |
所選項目的名稱。 |
取得 UIA 父元素控制碼
傳回指定元素之父元素的控制碼。 父元素被定義為位於 UIA “樹狀結構” 上下一級的元素,並且幾乎總是包含元素。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
元素控點
|
ElementHandle | True | integer |
目標元素的 UIA 控制碼。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
父元素控點
|
ParentElementHandle | integer |
父元素的 UIA 控制碼。 |
取得 UIA 資料方格元素內容
傳回 datagrid 元素的內容。 這是一個包含行、列、標題和儲存格(即表格)的元素。 此動作也可用來擷取先前執行此動作的結果,並以代理程式執行緒身分執行。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
僅擷取螢幕欄
|
OnScreenColumnsOnly | boolean |
如果設定為true,則只會傳回螢幕上的欄。 |
|
|
僅擷取螢幕上的列
|
OnScreenRowsOnly | boolean |
如果設定為true,則只會傳回螢幕上的列。 |
|
|
將 Null 值傳回為空白
|
ReturnNullValuesAsBlank | boolean |
如果設定為 true,則 null 值將以 '' (即空白) 的形式傳回。 如果設定為 false,則 Null 值通常會傳回為 '(null)'。 |
|
|
替代標頭列名稱
|
AlternativeHeaderRowName | string |
根據預設,DataGrid 中的標頭資料列具有 UIA 元素名稱 'Top Row'。 如果標頭列有不同的名稱,請在此處指定該名稱。 |
|
|
傳回資料列 UIA 名稱
|
ReturnRowUIAName | boolean |
如果此輸入設定為 ,則資料列 UIA 名稱會儲存在輸出集合的資料行中。 資料行的名稱是由輸入 '要儲存資料列 UIA 名稱的資料行名稱'所定義。 |
|
|
要儲存資料列 UIA 名稱的資料行名稱
|
NameOfColumnToStoreRowUIAName | string |
如果輸入 '傳回資料列 UIA 名稱' 設定為 true,則此輸入會指定輸出集合中的數據行名稱,以保存資料列 UIA 名稱。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
第一個要退貨的商品
|
FirstItemToReturn | integer |
要傳回的第一個項目(行)的元素索引,從1開始。 |
|
|
退貨項目上限
|
MaxItemsToReturn | integer |
要傳回的專案 (資料列) 數目上限,或傳回所有專案 (資料列) 的 0 數目上限。 |
|
|
掃描前 N 列以尋找空列
|
ScanFirstNRowsForEmptyRows | integer |
某些資料網格在 UIA 樹狀結構中有一些空/空資料列元素(通常位於頂部),IA-Connect 會自動跳過這些資料列元素,因為它們不代表 UI 中可見的表格中的任何內容。 如果此輸入設定為 0 (預設值),則 IA-Connect 代理程式將一律從第一列開始掃描資料列元素,即使「第一個要傳回的項目」設定為擷取資料表中更深的資料列也一樣。 這可確保與列索引編號的一致性,但會影響效能,因為需要掃描從第一列到請求列的所有列。 如果您確定表格中唯一的空/空行元素位於前 N 行(例如 10)行中,您可以將其設置為 N(例如 10)以潛在地提高性能。 除非您知道自己在做什麼,否則不要設定為 0 以外的值。 |
|
|
將表格讀取為執行緒
|
ReadTableAsThread | boolean |
如果設定為 false (預設值),IA-Connect 代理程式會立即讀取表格,並將內容傳回給控制器。 如果讀取大型資料表,此動作可能會逾時。如果設定為 true,IA-Connect 代理程式會將資料表讀取為代理程式執行緒,而 IA-Connect 導向器 (或 Orchestrator、PowerShell 模組、Blue Prism) 可以監控此代理程式執行緒的狀態,等待其完成。 這允許在不逾時的情況下讀取大型表。 IA-Connect 代理程式 9.3 和更早版本只能立即讀取表格,而不能作為代理程式執行緒讀取。 |
|
|
擷取執行緒識別碼的輸出資料
|
RetrieveOutputDataFromThreadId | integer |
如果您先前以代理程式執行緒身分執行此動作,並將「等待執行緒的秒數」設定為 0,請提供代理程式執行緒識別碼以擷取結果。 此代理程式執行緒識別碼將由先前呼叫此動作提供。 如果您正在讀取資料網格 (因此不會擷取先前以代理程式執行緒身分執行的查詢結果) ,請設定為 0 (預設值)。 |
|
|
等待執行緒的秒數
|
SecondsToWaitForThread | integer |
如果「將表格讀取為執行緒」設定為 true,則等待代理程式執行緒完成的秒數。 如果讀取資料表的代理程式執行緒在此時間內尚未完成,則會引發例外狀況。 設定為 0 以略過等待:代理程式將繼續讀取資料網格,但也可用於下一個動作。 然後,您可以使用動作 '等候代理程式執行緒順利完成' 來等候代理程式執行緒完成,然後重新執行此 '取得 UIA 資料網格元素內容' 動作,並將輸入 '擷取執行緒 ID 的輸出資料' 設為代理程式執行緒 ID,以擷取結果 (資料網格的內容)。 |
|
|
每 N% 垂直捲動資料網格
|
ScrollDataGridVerticallyEveryNPercent | integer |
如果您定期將資料網格捲動到(或靠近)正在捲動的位置,則已觀察到讀取某些大型資料網格(例如:具有數千列)的效能會有所改善。 如果設定為 0 (預設值),則讀取內容時不會捲動資料網格。 如果設定為介於 1 到 100 之間的值,則在讀取內容時,資料網格將定期捲動 (每 N% 的列總數)。 例如:如果設定為 20,則資料網格將以 0、20、40、60、80% 捲動。 或者,使用「每 N 列垂直捲動資料網格」來捲動每 N 列一次,而不是每 N 個百分點捲動一次。 |
|
|
每 N 行垂直捲動資料網格
|
ScrollDataGridVerticallyEveryNRows | integer |
如果您定期將資料網格捲動到(或靠近)正在捲動的位置,則已觀察到讀取某些大型資料網格(例如:具有數千列)的效能會有所改善。 如果設定為 0 (預設值),則讀取內容時不會捲動資料網格。 如果設定為值 1 或更高,則在讀取內容時,資料網格將每 N 列捲動一次。 例如:如果設定為 5,則資料網格將每 5 列捲動一次。 或者,使用「每 N 個百分比垂直捲動資料網格」來捲動每 N 個百分比的資料列,而不是每 N 個資料列。 |
|
|
垂直捲動資料網格元素控點
|
ScrollDataGridVerticallyElementHandle | integer |
如果在讀取內容時垂直捲動資料格線,則此輸入會定義 IA-Connect 如何尋找垂直捲軸。 如果設定為 0,IA-Connect 將嘗試直接捲動資料網格,方法是使用「捲動」模式(如果資料網格支援)或搜尋資料網格中包含的垂直捲軸。 或者,您可以指定垂直捲軸元素的 IA-Connect UIA 控制碼 (捲軸元素本身,而不是其中的按鈕) ,其值為 1 或更高。 |
|
|
捲動的最小資料網格列
|
MinimumDataGridRowsForScrolling | integer |
如果在讀取內容時垂直捲動資料網格,則此輸入會指定表格中所需的最小列數 IA-Connect 然後才能執行捲動。 如果設定為 0,則無論列數如何,IA-Connect 都會捲動。 如果設定為正數,則只有當資料網格具有該列數或更多時,IA-Connect 才會執行捲動。 |
|
|
如果無法捲動,則引發例外狀況
|
RaiseExceptionIfCannotScroll | boolean |
如果在讀取內容時垂直捲動資料網格:如果應將捲動失敗視為例外狀況,請將此輸入設定為 true,如果應忽略捲動失敗,請將此輸入設定為 false(預設值)。 常見的捲動失敗包括找不到捲軸,或捲軸沒有適合捲動的 UIA 模式 ('scroll'、'rangevalue' 或 'value') 。 |
|
|
替代垂直捲軸名稱
|
AlternativeVerticalScrollbarName | string |
根據預設,資料方格中的垂直捲軸「列」具有 UIA 元素名稱 '垂直捲軸'。 如果垂直捲軸有不同的名稱,請在此處指定該名稱。 如果您希望 IA-Connect 在讀取內容時定期捲動資料網格,輸入的「垂直捲動資料網格元素句柄」欄位設定為 0(指定 IA-Connect 應該直接捲動資料網格),但資料網格不會實作「滾動」模式,則會使用此選項。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
資料網格內容JSON
|
DataGridContentsJSON | string |
datagrid 元素內容,採用 JSON 格式。 |
|
表格中的列數
|
NumberOfRowsInTable | integer |
如果立即讀取表格,則輸出表格中的列數。 |
|
表格中的欄數
|
NumberOfColumnsInTable | integer |
如果立即讀取表格,則輸出表格中的直欄數。 |
|
執行緒識別碼
|
ThreadId | integer |
如果此動作以代理程式執行緒身分執行,則此輸出會保留代理程式執行緒 ID,可用來監視動作的處理程序,並在執行緒完成時擷取資料網格內容。 |
取得 UIA 資料方格元素屬性
傳回 DataGrid 元素的資料表屬性。 這是一個包含行、列、標題和儲存格(即表格)的元素。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
替代標頭列名稱
|
AlternativeHeaderRowName | string |
根據預設,DataGrid 中的標頭資料列具有 UIA 名稱 'Top Row'。 如果標頭列有不同的名稱,請在此處指定該名稱。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
欄數
|
NumberOfColumns | integer |
資料網格中的欄數。 |
|
可見欄數
|
NumberOfVisibleColumns | integer |
資料網格中可見的欄數。 |
|
列數
|
NumberOfRows | integer |
資料網格中的列數。 |
|
可見列數
|
NumberOfVisibleRows | integer |
資料網格中可見的列數。 |
|
第一個可見列
|
FirstVisibleRow | integer |
資料網格中第一個可見資料列的索引。 |
|
最後一個可見列
|
LastVisibleRow | integer |
資料網格中最後一個可見資料列的索引。 |
|
捲軸數目
|
NumberOfScrollbars | integer |
資料網格具有的捲軸數目。 |
|
捲軸名稱
|
ScrollbarNames | string |
以逗號分隔的捲軸名稱清單 (例如 Horizontal、Vertical)。 |
取得 Win32 視窗
快速 Win32 動作,傳回所有 Win32 視窗的清單,這些視窗可選擇性地具有指定的類別名稱或視窗標題,或者您可以指定更進階的搜尋篩選,包括萬用字元。 雖然此動作使用 Win32 API,但它可以偵測 Windows、Java、ModernUI 和 Web 視窗。 Win32 Windows 可以包含非預期的項目,包括工作列、桌面、開始功能表、透明覆蓋、螢幕外或隱藏窗口,因此傳回的清單可能包含比預期更多的結果。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋類別名稱
|
SearchClassName | string |
要搜尋的最上層視窗的可選類別名稱,例如 'Chrome_WidgetWin_1'。 |
|
|
搜尋視窗標題
|
SearchWindowTitle | string |
要搜尋的最上層視窗的選用標題。 |
|
|
僅擷取最上層視窗
|
TopLevelWindowsOnly | boolean |
設定為 true,只擷取 OS 視為最上層的 Win32 視窗。 設定為 false 以擷取所有 Win32 視窗。 請注意,視窗的 Win32 定義會包含您可能無法辨識為視窗的專案,而且許多對話框和訊息方塊會標示為最上層,即使它們是父視窗的子系也一樣。 |
|
|
僅擷取可見的視窗
|
VisibleWindowsOnly | boolean |
設定為 true 只會擷取 OS 認為可見的 Win32 視窗。 設定為 false 以擷取可見和不可見的 Win32 視窗。 請注意,螢幕外或透明視窗可能會標示為可見,但您看不到它們。 |
|
|
僅擷取具有標題列的視窗
|
WindowsWithTitlebarOnly | boolean |
設定為 true 只會擷取具有標題列的 Win32 視窗。 設定為 false 以擷取 Win32 視窗,無論它們是否有標題列。 請注意,某些透明視窗有標題列,但您看不到它們。 |
|
|
僅擷取具有標題的視窗
|
WindowsWithTitleOnly | boolean |
設定為 true 只會擷取具有標題的 Win32 視窗 (,亦即包含某些文字的標題列) 。 設定為 false 以擷取 Win32 視窗,無論它們是否有標題。 請注意,標題欄是窗口頂部的條帶,而標題是其中的文本。 |
|
|
忽略透明視窗
|
IgnoreTransparentWindows | boolean |
設定為 true 只會擷取沒有透明度的 Win32 視窗。 設定為 false 可擷取 Win32 視窗,無論它們是否設定了透明度。 |
|
|
搜尋程序識別碼
|
SearchProcessId | integer |
擁有視窗之進程的選擇性進程識別碼 (例如,由 IA-Connect 環境/工作階段動作中「執行進程」動作的輸出所提供)。 設定為 0 以不依進程識別碼搜尋。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Title] 類似 '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個視窗符合搜尋,這可讓您指定要排序的視窗屬性。 例如:如果「依列名稱排序」是 [TopEdge],則會依上緣排序傳回視窗清單。 如果此欄位留空,則會依偵測到的順序傳回視窗。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個視窗符合搜尋,且指定排序欄,請設定為 true (預設值) 以遞增排序,或設定為 false 以遞減排序。 |
|
|
傳回 UIA 元素控制碼
|
ReturnElementHandle | boolean |
如果設定為 true,則會在輸出集合中傳回每個位於 Win32 視窗的 UIA 控制碼 (在 'UIAHandle' 資料行中) 。 此控制碼可用於進一步動作,以作為 IA-Connect UIA 動作中的「父」控制碼。 |
|
|
第一個要退貨的商品
|
FirstItemToReturn | integer |
要傳回的第一個視窗(列)的索引,從 1 開始。 |
|
|
退貨項目上限
|
MaxItemsToReturn | integer |
要傳回的視窗數目上限,或 0 傳回所有專案。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Win32 視窗 JSON
|
Win32WindowsJSON | string |
符合搜尋準則的 Win32 視窗清單,採用 JSON 格式。 |
|
Win32 視窗數
|
NumberOfWin32Windows | integer |
傳回的 Win32 視窗數目。 |
取得多個 UIA 元素作為資料表
列舉指定父元素的子元素值,並以表格格式傳回。 這可用來從技術上不是資料表,但已排列成資料表結構的元素傳回資料列和資料行。 此動作也可用來擷取先前執行此動作的結果,並以代理程式執行緒身分執行。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
搜尋儲存格標頭子元素當地語系化控制項類型
|
SearchCellHeaderSubElementLocalizedControlType | string |
要搜尋的儲存格標頭子元素當地語系化控制項類型。 如果不搜尋儲存格標頭,請保留空白。 |
|
|
搜尋儲存格標頭子元素控制項類型
|
SearchCellHeaderSubElementControlType | integer |
要搜尋的儲存格標頭子元素控制項類型 (非當地語系化整數)。 這是不同語言的相同值。 如果不搜索單元格標頭,請保留為 0。 |
|
|
搜尋儲存格子元素當地語系化控制項類型
|
SearchCellSubElementLocalizedControlType | string |
要搜尋的儲存格子元素當地語系化控制項類型。 |
|
|
搜尋儲存格子元素控制項類型
|
SearchCellSubElementControlType | integer |
要搜尋的儲存格子元素控制項類型 (非當地語系化整數)。 這是不同語言的相同值。 |
|
|
搜尋儲存格子元素的後代
|
SearchDescendantsForCellSubElements | boolean |
如果設定為 true,則會在所在元素下方的 UIA 樹狀結構中搜尋儲存格和儲存格標頭子元素 (,也就是將填入輸出表格中儲存格的元素值)。 這更徹底,但可能需要更長的時間。 如果您只對元素正下方的元素感興趣,您可能希望將此設定為 false。 |
|
|
要傳回的第一個儲存格標頭子元素
|
FirstCellHeaderSubElementToReturn | integer |
要傳回的第一個儲存格標頭子元素的索引,從 1 開始。 如果您想要以相反的順序傳回元素 (從 UIA 樹狀結構的底部開始) ,您也可以指定從 -1 開始的負索引。 |
|
|
要傳回的儲存格標頭子元素數目上限
|
MaxCellHeaderSubElementsToReturn | integer |
要傳回的儲存格標頭子元素數目上限,或傳回所有子元素的 0。 |
|
|
要傳回的第一個儲存格子元素
|
FirstCellSubElementToReturn | integer |
要傳回的第一個儲存格子元素的索引,從 1 開始。 如果您想要以相反的順序傳回元素 (從 UIA 樹狀結構的底部開始) ,您也可以指定從 -1 開始的負索引。 |
|
|
要傳回的儲存格子元素數目
|
MaxCellSubElementsToReturn | integer |
要傳回的儲存格子元素數目上限,或 0 傳回所有子元素。 |
|
|
要求的資料行數目
|
RequestedNumberOfColumns | integer |
您要在輸出表格中加入的資料行數目。 此值必須正確適用於正在讀取的元素,否則您將收到非預期的結果。 |
|
|
儲存格子元素值優先順序
|
CellSubElementValuePriority | integer |
使用儲存格子元素值作為要在輸出表格中使用的值的優先順序。 1 是最高優先順序。 2 是第二優先。 3 是第三優先級。 0 表示不使用。 |
|
|
儲存格子元素文字值優先順序
|
CellSubElementTextValuePriority | integer |
使用儲存格子元素文字值作為要在輸出表格中使用的值的優先順序。 1 是最高優先順序。 2 是第二優先。 3 是第三優先級。 0 表示不使用。 |
|
|
儲存格子元素名稱值優先順序
|
CellSubElementNameValuePriority | integer |
使用儲存格子元素名稱 (標籤通用) 作為要在輸出表格中使用的值的優先順序。 1 是最高優先順序。 2 是第二優先。 3 是第三優先級。 0 表示不使用。 |
|
|
最小儲存格子元素寬度
|
MinimumCellSubElementWidth | integer |
要包含在表格中的儲存格子元素的最小寬度 (以像素為單位)。 |
|
|
最小儲存格子元素高度
|
MinimumCellSubElementHeight | integer |
要包含在表格中的儲存格子元素的最小高度 (以像素為單位)。 |
|
|
搜尋儲存格子元素邊界框左
|
SearchCellSubElementBoundingBoxLeft | integer |
僅包括完全包含在邊界框內的儲存格子元素。 默認情況下,邊界框很大,可以包含所有元素。 |
|
|
搜尋儲存格子元素邊界方塊右側
|
SearchCellSubElementBoundingBoxRight | integer |
僅包括完全包含在邊界框內的儲存格子元素。 默認情況下,邊界框很大,可以包含所有元素。 |
|
|
搜尋儲存格子元素邊界方塊頂端
|
SearchCellSubElementBoundingBoxTop | integer |
僅包括完全包含在邊界框內的儲存格子元素。 默認情況下,邊界框很大,可以包含所有元素。 |
|
|
搜尋儲存格子元素邊界框底部
|
SearchCellSubElementBoundingBoxBottom | integer |
僅包括完全包含在邊界框內的儲存格子元素。 默認情況下,邊界框很大,可以包含所有元素。 |
|
|
將表格讀取為執行緒
|
ReadTableAsThread | boolean |
如果設定為 false (預設值),IA-Connect 代理程式會立即讀取表格,並將內容傳回給控制器。 如果讀取大型資料表,此動作可能會逾時。如果設定為 true,IA-Connect 代理程式會將資料表讀取為代理程式執行緒,而 IA-Connect 導向器 (或 Orchestrator、PowerShell 模組、Blue Prism) 可以監控此代理程式執行緒的狀態,等待其完成。 這允許在不逾時的情況下讀取大型表。 IA-Connect 代理程式 9.3 和更早版本只能立即讀取表格,而不能作為代理程式執行緒讀取。 |
|
|
擷取執行緒識別碼的輸出資料
|
RetrieveOutputDataFromThreadId | integer |
如果您先前以代理程式執行緒身分執行此動作,並將「等待執行緒的秒數」設定為 0,請提供代理程式執行緒識別碼以擷取結果。 此代理程式執行緒識別碼將由先前呼叫此動作提供。 如果您正在讀取資料表,請設定為 0 (預設值) (因此不會擷取先前以代理程式執行緒身分執行的查詢結果)。 |
|
|
等待執行緒的秒數
|
SecondsToWaitForThread | integer |
如果「將表格讀取為執行緒」設定為 true,則等待代理程式執行緒完成的秒數。 如果讀取資料表的代理程式執行緒在此時間內尚未完成,則會引發例外狀況。 設定為 0 可略過等待:代理程式將繼續讀取表格,但也可用於下一個動作。 然後,您可以使用動作 '等候代理程式執行緒順利完成' 來等候代理程式執行緒完成,然後重新執行此 '取得多個 UIA 元素作為資料表' 動作,並將輸入 '擷取執行緒 ID 的輸出資料' 設為代理程式執行緒 ID,以擷取結果 (表格的內容)。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
找到的儲存格子元素數目
|
NumberOfCellSubElementsFound | integer |
找到符合搜尋準則的儲存格子元素 (非標頭) 數目。 |
|
傳回的儲存格子元素數目
|
NumberOfCellSubElementsReturned | integer |
傳回的儲存格子元素 (不是標頭) 數目 (如果指定要傳回的第一個或最大項目數目,則可能低於找到的元素數目)。 |
|
表格內容JSON
|
TableContentsJSON | string |
從多個元素內容建立的資料表,採用 JSON 格式。 |
|
表格中的列數
|
NumberOfRowsInTable | integer |
輸出表格中的列數。 |
|
表格中的欄數
|
NumberOfColumnsInTable | integer |
輸出表格中的欄數。 |
|
執行緒識別碼
|
ThreadId | integer |
如果此動作以代理程式執行緒身分執行,則此輸出會保留代理程式執行緒識別碼,可用來監視動作的處理程序,並在執行緒完成時擷取表格內容。 |
取得多個 UIA 元素屬性
傳回多個元素的屬性。 如果您不確定哪些欄位包含所需的屬性值,這會很有用。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素當地語系化控制項類型
|
SearchElementLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋後代
|
SearchDescendants | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
傳回元素句柄
|
ReturnElementHandle | boolean |
如果設定為 true,則會傳回所定位元素的控制碼。 此句柄可用於進一步的動作,以充當「父項」句柄。 |
|
|
傳回元素值
|
ReturnElementValue | boolean |
如果設定為 true,則會傳回定位元素的值。 |
|
|
第一個要退貨的商品
|
FirstItemToReturn | integer |
第一個要傳回的項目的元素索引,從1開始。 如果您想要以相反的順序傳回元素 (從 UIA 樹狀結構的底部開始) ,您也可以指定從 -1 開始的負索引。 |
|
|
退貨項目上限
|
MaxItemsToReturn | integer |
要傳回的元素數目上限,或 0 傳回所有專案。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
找到的元素數量
|
NumberOfElementsFound | integer |
找到符合搜尋準則的元素數目。 |
|
傳回的元素數目
|
NumberOfElementsReturned | integer |
傳回的元素數目 (如果指定要傳回的專案數目上限,則可能低於找到的元素數目)。 |
|
元素屬性
|
ElementProperties | array of object |
找到符合搜尋準則之元素的元素內容。 |
|
items
|
ElementProperties | object |
取得多個 UIA 父元素屬性
傳回指定元素的父元素階層樹狀結構,一直到桌面 (根層級) 。 父元素被定義為位於 UIA “樹狀結構” 上下一級的元素,並且幾乎總是包含元素。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
元素控點
|
ElementHandle | True | integer |
目標元素的 UIA 控制碼。 |
|
要處理的最大父母
|
MaxParentsToProcess | integer |
要處理的父元素數目上限。 依預設,此值會設定為 50。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
UIA 父元素
|
UIAParentElements | array of object |
所有已定位父元素 (及其屬性) 的清單。 傳回的屬性與「取得多個元素屬性」動作所傳回的屬性相同。 |
|
items
|
UIAParentElements | object | |
|
傳回的父元素數目
|
NumberOfParentElementsReturned | integer |
從搜尋傳回的父元素數目。 |
取得最上層 Win32 視窗的 UIA 控制碼
快速 Win32 動作,可傳回任何具有指定類別名稱或視窗標題之最上層 Win32 視窗的 UIA 控制碼,或者您可以指定更進階的搜尋篩選,包括萬用字元。 頂層視窗是連線到桌面的視窗。 雖然此動作使用 Win32 API,但它可以偵測 Windows、Java、ModernUI 和 Web 視窗。 窗口必須存在,IA-Connect 不會等待。 使用更強大的 UIA 動作「UIA 桌面元素是否存在」更常見,但此 Win32 動作通常執行速度更快。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋類別名稱
|
SearchClassName | string |
要搜尋的頂層視窗的元素類別名稱,例如「記事本」。 |
|
|
搜尋視窗標題
|
SearchWindowTitle | string |
要搜尋的最上層視窗的標題。 |
|
|
搜尋程序識別碼
|
SearchProcessId | integer |
擁有視窗之進程的選用進程識別碼 (例如,由 IA-Connect 環境/工作階段動作中的「執行進程」動作的輸出所提供)。 設定為 0 以不依進程識別碼搜尋。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選擇性的進階篩選器,可進一步限制使用條件運算子對可用視窗屬性進行搜尋。 範例 1:[寬度] < 200。 範例 2:[Title] 類似 '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個視窗符合搜尋,這可讓您指定要排序的視窗屬性。 這將與「比對索引」結合使用,以選擇所需的視窗。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會傳回最接近螢幕頂端的相符視窗。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個視窗符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
視窗句柄
|
WindowHandle | integer |
視窗的 UIA 控制碼。 這可作為此視窗內進一步 UIA 動作的輸入。 |
|
元素名稱
|
ElementName | string |
視窗元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
視窗元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
視窗元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
視窗元素的 UIA 當地語系化控制項類型。 |
取得桌面的 UIA 控制碼
傳回桌面的控制碼。 這是一個過時的操作,因為句柄 '-2' 可以用來引用桌面元素,但也因為有很多操作可以相對於桌面進行搜索(例如“等待桌面元素”)。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
視窗句柄
|
WindowHandle | integer |
桌面的 UIA 控制碼。 這可作為此視窗內進一步 UIA 動作的輸入。 |
|
元素名稱
|
ElementName | string |
桌面元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
桌面元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
桌面元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
桌面元素的 UIA 當地語系化控制項類型。 |
取得焦點元素主視窗的 UIA 句柄
傳回目前焦點 UIA 元素之主視窗的控制碼。 「主」視窗通常是應用程式主視窗:登入對話框或子視窗通常不是「主」視窗。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
視窗句柄
|
WindowHandle | integer |
視窗的 UIA 控制碼。 這可作為此視窗內進一步 UIA 動作的輸入。 |
|
元素名稱
|
ElementName | string |
視窗元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
視窗元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
視窗元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
視窗元素的 UIA 當地語系化控制項類型。 |
取得焦點元素的 UIA 控制碼
傳回目前焦點 UIA 元素的控制碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
視窗句柄
|
WindowHandle | integer |
視窗的 UIA 控制碼。 這可作為此視窗內進一步 UIA 動作的輸入。 |
|
元素名稱
|
ElementName | string |
元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
元素的 UIA 當地語系化控制項類型。 |
取得螢幕座標的 UIA 元素
傳回位於指定螢幕座標的 UIA 元素。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
X 座標
|
XCoord | integer |
應該搜尋 UIA 元素的螢幕 X 座標值 (以像素為單位)。 |
|
|
Y 座標
|
YCoord | integer |
應該搜尋 UIA 元素的螢幕 Y 座標值 (以圖元為單位)。 |
|
|
如果找不到元素,則引發例外狀況
|
RaiseExceptionIfElementNotFound | boolean |
如果 UIA 元素不位於指定位置,IA-Connect 應該引發例外狀況嗎? |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
找到元素
|
ElementFound | boolean |
如果在指定位置找到 UIA 元素,則傳回 true。 |
|
元素控點
|
ElementHandle | integer |
元素的 UIA 控制碼。 這可作為輸入,以進一步作用於此元素的 UIA 動作。 |
|
元素名稱
|
ElementName | string |
元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
元素的 UIA 當地語系化控制項類型。 |
取得進程主視窗的 UIA 句柄
簡單且快速的 Win32 動作,傳回進程任何主視窗的控制碼 (以名稱指定) 。 「主」視窗通常是應用程式主視窗:登入對話框或子視窗通常不是「主」視窗。 視窗必須存在:IA-Connect 不會等待。 建議使用「等待桌面元素」動作,功能更強大。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋程序名稱
|
SearchProcessName | True | string |
要搜尋的進程名稱,例如記事本。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
視窗句柄
|
WindowHandle | integer |
視窗的 UIA 控制碼。 這可作為此視窗內進一步 UIA 動作的輸入。 |
|
元素名稱
|
ElementName | string |
視窗元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
視窗元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
視窗元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
視窗元素的 UIA 當地語系化控制項類型。 |
取得進程標識碼主視窗的 UIA 句柄
簡單且快速的 Win32 動作,可傳回進程任何主要視窗的控制碼 (由進程標識碼指定) 。 「主」視窗通常是應用程式主視窗:登入對話框或子視窗通常不是「主」視窗。 建議使用「等待桌面元素」動作,功能更強大。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋程序識別碼
|
ProcessId | True | integer |
要等待的處理程序的識別碼 (如 IA-Connect 環境/工作階段動作中的「執行處理程序」動作所提供)。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
視窗句柄
|
WindowHandle | integer |
視窗的 UIA 控制碼。 這可作為此視窗內進一步 UIA 動作的輸入。 |
|
元素名稱
|
ElementName | string |
視窗元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
視窗元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
視窗元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
視窗元素的 UIA 當地語系化控制項類型。 |
在 UIA 元素中尋找可見的搜尋影像
傳回搜尋影像 (作為此動作的輸入) 是否已明顯位於畫面上的 UIA 元素內。 元素應該先放在前面,因為代理程式會在元素的座標處截取螢幕截圖,並在螢幕擷取畫面中搜尋提供的搜尋影像。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
搜尋影像類型
|
SearchImageType | string |
定義「搜尋影像」輸入所代表的內容。 如果設定為「導向器映像檔」,則搜尋映像是導向器可存取的檔案路徑。 如果設定為「代理程式映像檔」,則搜尋影像是代理程式可存取之檔案的路徑。 如果設定為「Base64」,則搜尋影像是影像的 base64 表示法。 |
|
|
搜尋圖片
|
SearchImage | string |
要在指定 UIA 元素內尋找的搜尋影像。 根據指定的「搜尋影像類型」,這可以保存影像檔案的路徑(在導向器或代理程式端),或包含要搜尋的影像的 base64(文字表示)。 |
|
|
替代搜尋影像類型
|
AltSearchImageType | string |
定義「替代搜尋影像」輸入所代表的內容。 如果設定為「無」或空白,則沒有替代搜尋影像。 如果設定為「導向器映像檔」,則搜尋映像是導向器可存取的檔案路徑。 如果設定為「代理程式映像檔」,則搜尋影像是代理程式可存取之檔案的路徑。 如果設定為「Base64」,則搜尋影像是影像的 base64 表示法。 |
|
|
替代搜尋圖片
|
AltSearchImage | string |
選擇性替代搜尋影像,以在指定的 UIA 元素內尋找。 根據指定的「替代搜尋影像類型」,這可以保存影像檔案的路徑(在導向器或代理程式端),或包含要搜尋的影像的 base64(文字表示)。 如果您指定替代搜尋影像,代理程式將尋找搜尋或替代搜尋影像,並報告找到哪一個。 |
|
|
最大顏色偏差
|
MaxColourDeviation | integer |
元素的像素顏色可以偏離搜尋圖片像素顏色的最大值,才會被視為不相符。 0 表示沒有偏差。 偏差以 RGB 值測量。 例如:#FF0000 與 #FE0102 有4個不同。 這允許忽略微小的顏色差異。 |
|
|
最大像素差異
|
MaxPixelDifferences | integer |
在影像被視為不相符之前,整個搜尋影像中可以差異的最大像素數(高於最大色彩偏差)。 這允許忽略影像之間的細微差異,但較高的值可能會增加尋找影像所需的時間。 建議設定為 0,必要時少量增加。 如果設定為高於 0 的值,您也必須設定「連續像素差異上限」。 |
|
|
最大連續像素差異
|
MaxConsecutivePixelDifferences | integer |
在影像被視為不相符之前,任何一列中可以不同的最大連續像素數(超過最大色彩偏差)。 這允許忽略影像之間的細微差異,但較高的值可能會增加尋找影像所需的時間。 建議設定為 0,必要時少量增加。 如果設定為高於 0 的值,您也必須設定「像素差異上限」。 |
|
|
左圖元X偏移
|
LeftPixelXOffset | integer |
搜尋區域左邊緣的可選 X 偏移。 這可讓您增加 (負值) 或減少 (正值) 搜尋區域。 |
|
|
右圖元 X 偏移
|
RightPixelXOffset | integer |
搜尋區域右邊緣的可選 X 偏移。 這可讓您增加 (使用正值) 或減少 (使用負值) 搜尋區域。 |
|
|
頂部像素 Y 位移
|
TopPixelYOffset | integer |
搜尋區域頂部邊緣的可選 Y 偏移。 這可讓您增加 (負值) 或減少 (正值) 搜尋區域。 |
|
|
底部像素 Y 偏移
|
BottomPixelYOffset | integer |
搜尋區域底部邊緣的可選 Y 偏移。 這可讓您增加 (使用正值) 或減少 (使用負值) 搜尋區域。 |
|
|
像素 X 偏移單位
|
PixelXOffsetsUnit | string |
如果左右像素 X 偏移以像素為單位,則設定為「像素」(預設值)。 如果左右像素 X 偏移量以元素寬度的百分比來衡量,則設定為「百分比」。 |
|
|
像素 Y 偏移單位
|
PixelYOffsetsUnit | string |
如果頂部和底部像素 Y 偏移以像素為單位測量,則設定為「像素」(預設值)。 如果頂部和底部像素 Y 偏移量以元素高度的百分比來測量,則設定為「百分比」。 |
|
|
搜尋影像索引
|
SearchImageIndex | integer |
設定為 1 ,可在 UIA 元素內尋找搜尋影像的第一個實例 (搜尋方向)。 第二個實例設定為 2,第 N 個實例設定為 ...., N。 如果您也在搜尋替代影像,則會先掃描 UIA 元素以尋找搜尋影像,然後掃描替代影像,以搜尋該特定影像的請求實例(即代理程式需要其中一個,而不是兩個影像的混合)。 |
|
|
圖片搜尋方向
|
ImageSearchDirection | string |
搜索方向。 「從上」從上到上按列搜索,在每列內從左到右掃描。 「從底部」從底部按行搜索,在每行內從左到右掃描。 「從左邊開始」會從左邊依欄搜尋,在每欄內從上到下掃描。 「從右」會從右邊依欄搜尋,在每欄內從上到下掃描。 這可以與“搜索圖像索引”結合使用,從頂部、底部、左側或右側定位第 N 個圖像。 若要提高效能,請選取您認為會更快找到影像的搜尋方向。 |
|
|
隱藏代理程式
|
HideAgent | boolean |
設定為 true 可自動隱藏代理程式 (如果可見),以確保它不會遮擋正在分析的元素。 |
|
|
將螢幕座標傳回為實體座標
|
ReturnPhysicalCoordinates | boolean |
設定為 true,讓螢幕座標傳回為實體座標。 設定為 false,讓螢幕座標傳回為虛擬座標。 如果基礎顯示縮放比例為 100%,則實體座標和虛擬座標都相同。 元素座標一律會傳回為虛擬座標。 |
|
|
顯示醒目提示矩形
|
ShowHighlightRectangle | boolean |
如果設定為 true,IA-Connect 代理程式將反白顯示螢幕上定位的影像。 這在開發期間可能很有用,以協助視覺化偵測到正確的影像。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
搜尋圖片位於
|
SearchImageLocated | boolean |
如果搜尋影像已找到,則設為 true。 如果找不到搜尋影像,則設為 false。 |
|
哪個搜尋圖片位於
|
WhichSearchImageLocated | integer |
如果找不到搜尋影像,則設為 0。 如果找到搜尋影像,則設定為 1。 如果找到替代搜尋影像,請設定為 2。 |
|
影像比對邊界方塊元素左圖元
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
符合指定影像的最左邊圖元的虛擬 X 座標,相對於元素虛擬左上角。 |
|
影像比對邊界方塊元素右圖元
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
最右邊圖元的虛擬 X 座標,符合指定影像,相對於元素虛擬左上角。 |
|
影像比對邊界方塊元素頂端像素
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
符合指定影像的最頂端圖元的虛擬 Y 座標,相對於元素虛擬左上角。 |
|
影像比對邊界方塊元素底部像素
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
符合指定影像的最底部圖元的虛擬 Y 座標,相對於元素虛擬左上角。 |
|
影像比對框元素中心 X 像素
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
邊界方塊中心的虛擬 X 座標,其中包含符合指定影像的像素,相對於元素虛擬左上角。 |
|
影像比對框框元素中心 Y 像素
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
邊界方塊中心的虛擬 Y 座標,其中包含符合指定影像的像素,相對於元素虛擬左上角。 |
|
圖片比對邊界框螢幕左像素
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
符合指定影像的最左邊圖元的螢幕圖元 X 座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
圖像匹配邊界框屏幕右側像素
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
符合指定影像的最右邊圖元的螢幕圖元 X 座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
影像比對框框螢幕頂端像素
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
符合指定影像的最上層圖元的螢幕圖元Y座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
圖片比對邊界框螢幕底部像素
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
符合指定影像的最底部圖元的螢幕圖元 Y 座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
影像比對框框螢幕中心 X 像素
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
邊界方塊中心的螢幕像素 X 座標,其中包含符合指定影像的像素。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
影像比對邊界框螢幕中心 Y 像素
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
邊界方塊中心的螢幕像素 Y 座標,其中包含符合指定影像的像素。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
在 UIA 元素周圍繪製矩形
在元素的周邊繪製矩形,以協助識別找到的元素是所需的元素。 矩形會在 5 秒後自動移除。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
筆顏色
|
PenColour | string |
要繪製的矩形的顏色(例如紅色、綠色、藍色、黃色、紫色或橙色)或字符串十六進制代碼(例如 #FF0000)。 |
|
|
手寫筆粗細像素
|
PenThicknessPixels | integer |
醒目提示矩形框線的粗細 (以像素為單位)。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
在UIA元素中輸入密碼
UIA 動作,將密碼輸入元素 (通常是密碼輸入欄位) ,取代現有的文字。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
輸入密碼
|
PasswordToInput | True | password |
要輸入的密碼值。 |
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
密碼包含儲存的密碼
|
PasswordContainsStoredPassword | boolean |
如果密碼包含 (或完全) IA-Connect 儲存的密碼識別碼 (格式為 {IAConnectPassword:StoredPasswordIdentifier}) 或 IA-Connect Orchestrator 一般認證 (格式為 {OrchestratorCredential:FriendlyName}),則設定為 true。 例如,此儲存的密碼可能是由「產生密碼」動作產生,或由 IA-Connect Orchestrator 保留。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
嘗試值模式
|
TryValuePattern | boolean |
如果設定為 true (預設值),IA-Connect 代理程式會嘗試使用 UIA 值型樣來執行文字輸入動作。 如果所選元素中的 UIA 值模式無法使用,則 IA-Connect 代理程式將回復到其他模式(透過此動作的其他輸入啟用或停用)。 如果設定為 false,IA-Connect 代理程式將不會嘗試使用值模式,並會立即回復到其他選擇的模式。 |
|
|
嘗試舊版模式
|
TryLegacyPattern | boolean |
如果設定為 true,如果值型樣無法使用 (因為元素上不存在,或因為其使用已停用) ,IA-Connect 代理程式將嘗試使用 UIA 舊版模式來執行文字輸入動作。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
將 UIA 元素屬性作為清單
將元素的屬性作為單行清單(單行集合/資料表)傳回,而不是單個項目,這可能有用,具體取決於您打算如何使用資料。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
元素控點
|
ElementHandle | True | integer |
目標元素的 UIA 控制碼。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
找到的元素數量
|
NumberOfElementsFound | integer |
找到的元素數目。 |
|
傳回的元素數目
|
NumberOfElementsReturned | integer |
傳回的元素數目。 |
|
UIA 元素屬性 JSON
|
UIAElementPropertiesJSON | string |
元素的 UIA 屬性,採用 JSON 格式。 |
將 UIA 元素設定為數值
設定具有數值輸入的元素值,例如文字欄位或捲軸。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
新值
|
NewValue | True | integer |
要將元素設定為的數值。 |
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
如果輸入驗證失敗,則引發例外狀況
|
RaiseExceptionIfInputValidationFails | boolean |
如果啟用,IA-Connect 代理程式將在輸入請求的文字後檢查元素的新值。 如果新值與預期值不符,則會引發例外狀況。 如果此輸入為false(預設值),則會在日誌中輸入警告,但不會引發例外狀況。 |
|
|
嘗試值模式
|
TryValuePattern | boolean |
如果設定為 true (預設值),IA-Connect 代理程式會嘗試使用 UIA 值型樣來執行文字輸入動作。 如果所選元素中的 UIA 值模式無法使用,則 IA-Connect 代理程式將回復到其他模式(透過此動作的其他輸入啟用或停用)。 如果設定為 false,IA-Connect 代理程式將不會嘗試使用值模式,並會立即回復到其他選擇的模式。 |
|
|
嘗試舊版模式
|
TryLegacyPattern | boolean |
如果設定為 true,如果值型樣無法使用 (因為元素上不存在,或因為其使用已停用) ,IA-Connect 代理程式將嘗試使用 UIA 舊版模式來執行文字輸入動作。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
將 UIA 元素設定為數值範圍值
設定具有數值範圍的元素值,例如捲軸。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
新值
|
NewValue | True | double |
要將元素設定為的數值範圍值。 |
|
新值是百分比
|
NewValueIsPercentage | boolean |
新值是百分比嗎? |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
將 UIA 視窗設定為正常
使用指定的 UIA 控制碼將視窗正規化 (,也就是將它設定為一般大小的視窗,而不是最小化或最大化) 。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
視窗句柄
|
WindowHandle | True | integer |
要正規化視窗的 UIA 控制碼。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
將文字輸入到 UIA 元素中
UIA 動作,將文字輸入元素 (通常是文字輸入欄位) ,取代現有的文字,或在特定位置插入新值。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
要輸入的文字
|
TextToInput | string |
要輸入的文字值。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
取代現有值
|
ReplaceExistingValue | boolean |
如果元素中存在現有文本,是否應該替換? |
|
|
插入位置
|
InsertPosition | integer |
開始插入文字的位置 (索引)。 如果有現有文字,則可以使用插入位置在現有文字內的特定位置插入。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
如果輸入驗證失敗,則引發例外狀況
|
RaiseExceptionIfInputValidationFails | boolean |
如果啟用,IA-Connect 代理程式將在輸入請求的文字後檢查元素的新值。 如果新值與預期值不符,則會引發例外狀況。 如果此輸入為false(預設值),則會在日誌中輸入警告,但不會引發例外狀況。 |
|
|
嘗試值模式
|
TryValuePattern | boolean |
如果設定為 true (預設值),IA-Connect 代理程式會嘗試使用 UIA 值型樣來執行文字輸入動作。 如果所選元素中的 UIA 值模式無法使用,則 IA-Connect 代理程式將回復到其他模式(透過此動作的其他輸入啟用或停用)。 如果設定為 false,IA-Connect 代理程式將不會嘗試使用值模式,並會立即回復到其他選擇的模式。 |
|
|
嘗試舊版模式
|
TryLegacyPattern | boolean |
如果設定為 true,如果值型樣無法使用 (因為元素上不存在,或因為其使用已停用) ,IA-Connect 代理程式將嘗試使用 UIA 舊版模式來執行文字輸入動作。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
將文字輸入到多個 UIA 元素中
UIA 動作,將不同的文字片段輸入到多個元素(通常是文字輸入欄位)中,取代現有文字或在特定位置插入新值。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
輸入元素
|
InputElementsJSON | True | string |
要以 JSON 格式輸入文字的 UIA 元素陣列。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
展開 UIA 元素
展開元素(通常是功能表/下拉式項目)。 如果項目已經展開,則不會發生任何動作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
截取 UIA 元素位置的螢幕截圖
擷取元素位置的螢幕擷取畫面,並傳回影像。 元素應該先放在前面,因為螢幕截圖是在元素位置拍攝螢幕的副本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
圖像格式
|
ImageFormat | string |
要用於螢幕擷取畫面的影像格式。 這可能會影響傳回資料的品質和大小。 支援的格式為 PNG(預設)、JPG、BMP 和 GIF。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
隱藏代理程式
|
HideAgent | boolean |
設定為 true 可自動隱藏代理程式 (如果可見),以確保它不會遮擋螢幕擷取畫面。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
螢幕影像為 Base64
|
ScreenBitmapBase64 | string |
螢幕影像是 Base64 編碼字串。 |
按 UIA 元素
按下元素 (通常是按鈕)。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
等待按鈕事件完成
|
Wait | boolean |
自動化是否應該等待按鈕事件完成,然後再繼續。 如果設定為 true,如果按鈕開啟強制回應對話方塊,可能會導致逾時。 |
|
|
Win32點擊按鈕
|
Win32ClickButton | boolean |
如果設定為 true,則會使用 Win32 點擊事件,而不是使用 UIA。 這是「觸發並忘記」點擊事件,在處理點擊後顯示的強制回應對話框或沒有 UIA 叫用模式的元素時非常有用。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
嘗試叫用模式
|
TryInvokePattern | boolean |
如果設定為 true (預設值) ,IA-Connect 代理程式會嘗試使用 UIA 叫用模式來執行按下動作 (除非 'Win32 按兩下按鈕' 設定為 true) 。 如果所選元素中的 UIA 叫用模式無法使用,則 IA-Connect 代理程式將回復至其他模式 (透過此動作的其他輸入來啟用或停用)。 如果設定為 false,IA-Connect 代理程式將不會嘗試使用叫用模式,並會立即回復到其他選擇的模式。 |
|
|
嘗試舊版模式
|
TryLegacyPattern | boolean |
如果設定為 true,如果叫用模式無法使用 (因為元素上不存在或停用其使用) ,且 'Win32 按兩下按鈕' 為 false,IA-Connect 代理程式會嘗試使用 UIA 舊版模式來執行按下動作。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
按一下 依索引的 UIA 清單元素專案
按一下符合指定索引的清單元素。 這通常用於在下拉式清單/功能表項目中選取項目。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
先展開
|
ExpandFirst | boolean |
如果設定為 true,則 IA-Connect 會在搜尋清單項目元素之前嘗試展開清單。 這對於動態清單很有用,因為在清單展開之前,可能不會建立清單項目元素。 |
|
|
折疊後
|
CollapseAfter | boolean |
如果設定為true,則清單將在執行搜尋後摺疊。 |
|
|
項目索引
|
ItemIndex | integer |
要按一下的項目清單中的索引。 |
|
|
展開和收合之間的秒數
|
SecondsBetweenExpandCollapse | double |
展開和摺疊動作之間等待的秒數 (如果這些動作設定為 true)。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
按名稱單擊 UIA 列表元素項目
按一下具有指定名稱的清單元素。 這通常用於在下拉式清單/功能表項目中選取項目。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
先展開
|
ExpandFirst | boolean |
如果設定為 true,則 IA-Connect 會在搜尋清單項目元素之前嘗試展開清單。 這對於動態清單很有用,因為在清單展開之前,可能不會建立清單項目元素。 |
|
|
折疊後
|
CollapseAfter | boolean |
如果設定為true,則清單將在執行搜尋後摺疊。 |
|
|
項目名稱
|
ItemName | string |
要按一下的元素項目名稱。 |
|
|
展開和收合之間的秒數
|
SecondsBetweenExpandCollapse | double |
展開和摺疊動作之間等待的秒數 (如果這些動作設定為 true)。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
搜尋第一個 UIA 父元素
在 UIA 樹狀結構階層中搜尋符合搜尋準則的第一個父元素。 父元素被定義為位於 UIA “樹狀結構” 上下一級的元素,並且幾乎總是包含元素。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
元素控點
|
ElementHandle | True | integer |
目標元素的 UIA 控制碼。 |
|
搜尋父元素當地語系化控制項類型
|
SearchParentLocalizedControlType | string |
要搜尋的父 UIA 元素當地語系化控制項類型。 這可以透過檢查來發現。 |
|
|
搜尋父元素控制項類型
|
SearchParentControlType | integer |
要搜尋的父 UIA 元素控制項類型 (非當地語系化整數) 。 這是不同語言的相同值。 |
|
|
要處理的最大父母
|
MaxParentsToProcess | integer |
要處理的父元素數目上限。 依預設,此值會設定為 50。 |
|
|
如果找不到父元素,則引發例外狀況
|
RaiseExceptionIfParentElementNotFound | boolean |
如果找不到搜尋 UIA 元素,IA-Connect 應該引發例外狀況嗎? |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
找到父元素
|
ParentElementFound | boolean |
如果找到搜尋父 UIA 元素,則傳回 true。 |
|
父元素控點
|
ParentElementHandle | integer |
已找到父元素的 UIA 控制碼。 這可作為輸入,以進一步作用於此元素的 UIA 動作。 |
|
父元素名稱
|
ParentElementName | string |
所在父元素的 UIA 名稱。 |
|
父元素類別名稱
|
ParentElementClassName | string |
所定位父元素的 UIA 類別名稱。 |
|
父元素自動化識別碼
|
ParentElementAutomationId | string |
所定位父元素的 UIA 自動化識別碼。 |
|
父元素當地語系化控制項類型
|
ParentElementLocalizedControlType | string |
已定位父元素的 UIA 當地語系化控制項類型。 |
摺疊 UIA 元素
摺疊元素 (通常是功能表/下拉式項目)。 如果項目已經折疊,則不會發生任何事情。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
是否檢查 UIA 元素
此動作會傳回 true 或 false,指出是否已勾選元素 (通常是核取方塊或選項方塊)。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
已檢查元素
|
ElementIsChecked | boolean |
如果元素已核取,則傳回 true,如果未核取,則傳回 false。 |
最大化 UIA 視窗
使用指定的 UIA 控制碼最大化視窗。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
視窗句柄
|
WindowHandle | True | integer |
要最大化之視窗的 UIA 控制碼。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
最小化 UIA 視窗
將具有指定 UIA 控制碼的視窗最小化。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
視窗句柄
|
WindowHandle | True | integer |
要最小化之視窗的 UIA 控制碼。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
檢查 UIA 元素
將元素的狀態 (通常是核取方塊或選項方塊) 設定為已核取或未核取。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
檢查元素
|
CheckElement | boolean |
該元素應該被選中 (true) 還是未選中 (false)? |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
檢查多個 UIA 元素
將多個元素 (通常是核取方塊或選項方塊) 的狀態設定為核取或未核取。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
輸入元素
|
InputElementsJSON | True | string |
要檢查的 UIA 元素陣列,採用 JSON 格式。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
焦點 UIA 元素
聚焦元素,使其成為鍵盤焦點的作用中元素,而且視應用程式而定,可能會將元素視窗帶到前景。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
移動 UIA 元素
將 UIA 元素移至畫面上的指定位置。 此動作通常只適用於 Window 元素 (具有轉換模式) 。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
水平移動型
|
HorizontalMovementType | string |
運動類型:絕對或相對。 |
|
|
水平位置
|
HorizontalPosition | True | integer |
元素的新水平位置。 移動類型(例如,絕對或相對)由輸入“水平移動類型”定義。 若要保持水平位置不變,請選擇值 0,並將「水平移動類型」設定為「相對」。 |
|
垂直移動類型
|
VerticalMovementType | string |
運動類型:絕對或相對。 |
|
|
垂直位置
|
VerticalPosition | True | integer |
元素的新垂直位置。 移動類型(例如,絕對或相對)由輸入「垂直移動類型」定義。 若要保持垂直位置不變,請選擇值 0 並將「垂直移動類型」設定為「相對」。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
指令結果
|
UIAMoveElementResult | boolean |
命令的結果(成功或失敗)。 |
|
錯誤訊息
|
ErrorMessage | string |
如果指令不成功,則會包含傳回的錯誤訊息。 |
等候可見的搜尋影像不存在於 UIA 元素中
等候,直到搜尋影像 (作為此動作的輸入) 無法在畫面上的 UIA 元素內可見 (或從未找到) ,或指定的時間量已過且影像仍然存在。 元素應該先放在前面,因為代理程式會在元素的座標處截取螢幕截圖,並在螢幕擷取畫面中搜尋提供的搜尋影像。 UIA 元素必須從一開始就存在。 一旦影像不再存在,動作就會立即完成。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
搜尋影像類型
|
SearchImageType | string |
定義「搜尋影像」輸入所代表的內容。 如果設定為「導向器映像檔」,則搜尋映像是導向器可存取的檔案路徑。 如果設定為「代理程式映像檔」,則搜尋影像是代理程式可存取之檔案的路徑。 如果設定為「Base64」,則搜尋影像是影像的 base64 表示法。 |
|
|
搜尋圖片
|
SearchImage | string |
要在指定 UIA 元素內尋找的搜尋影像。 根據指定的「搜尋影像類型」,這可以保存影像檔案的路徑(在導向器或代理程式端),或包含要搜尋的影像的 base64(文字表示)。 |
|
|
替代搜尋影像類型
|
AltSearchImageType | string |
定義「替代搜尋影像」輸入所代表的內容。 如果設定為「無」或空白,則沒有替代搜尋影像。 如果設定為「導向器映像檔」,則搜尋映像是導向器可存取的檔案路徑。 如果設定為「代理程式映像檔」,則搜尋影像是代理程式可存取之檔案的路徑。 如果設定為「Base64」,則搜尋影像是影像的 base64 表示法。 |
|
|
替代搜尋圖片
|
AltSearchImage | string |
選擇性替代搜尋影像,以在指定的 UIA 元素內尋找。 根據指定的「替代搜尋影像類型」,這可以保存影像檔案的路徑(在導向器或代理程式端),或包含要搜尋的影像的 base64(文字表示)。 如果您指定替代搜尋影像,代理程式將尋找搜尋或替代搜尋影像,並報告找到哪一個。 |
|
|
最大顏色偏差
|
MaxColourDeviation | integer |
元素的像素顏色可以偏離搜尋圖片像素顏色的最大值,才會被視為不相符。 0 表示沒有偏差。 偏差以 RGB 值測量。 例如:#FF0000 與 #FE0102 有4個不同。 這允許忽略微小的顏色差異。 |
|
|
最大像素差異
|
MaxPixelDifferences | integer |
在影像被視為不相符之前,整個搜尋影像中可以差異的最大像素數(高於最大色彩偏差)。 這允許忽略影像之間的細微差異,但較高的值可能會增加尋找影像所需的時間。 建議設定為 0,必要時少量增加。 如果設定為高於 0 的值,您也必須設定「連續像素差異上限」。 |
|
|
最大連續像素差異
|
MaxConsecutivePixelDifferences | integer |
在影像被視為不相符之前,任何一列中可以不同的最大像素數(高於最大色彩偏差)。 這允許忽略影像之間的細微差異,但較高的值可能會增加尋找影像所需的時間。 建議設定為 0,必要時少量增加。 如果設定為高於 0 的值,您也必須設定「像素差異上限」。 |
|
|
左圖元X偏移
|
LeftPixelXOffset | integer |
搜尋區域左邊緣的可選 X 偏移。 這可讓您增加 (負值) 或減少 (正值) 搜尋區域。 |
|
|
右圖元 X 偏移
|
RightPixelXOffset | integer |
搜尋區域右邊緣的可選 X 偏移。 這可讓您增加 (使用正值) 或減少 (使用負值) 搜尋區域。 |
|
|
頂部像素 Y 位移
|
TopPixelYOffset | integer |
搜尋區域頂部邊緣的可選 Y 偏移。 這可讓您增加 (負值) 或減少 (正值) 搜尋區域。 |
|
|
底部像素 Y 偏移
|
BottomPixelYOffset | integer |
搜尋區域底部邊緣的可選 Y 偏移。 這可讓您增加 (使用正值) 或減少 (使用負值) 搜尋區域。 |
|
|
像素 X 偏移單位
|
PixelXOffsetsUnit | string |
如果左右像素 X 偏移以像素為單位,則設定為「像素」(預設值)。 如果左右像素 X 偏移量以元素寬度的百分比來衡量,則設定為「百分比」。 |
|
|
像素 Y 偏移單位
|
PixelYOffsetsUnit | string |
如果頂部和底部像素 Y 偏移以像素為單位測量,則設定為「像素」(預設值)。 如果頂部和底部像素 Y 偏移量以元素高度的百分比來測量,則設定為「百分比」。 |
|
|
搜尋影像索引
|
SearchImageIndex | integer |
設定為 1 ,可在 UIA 元素內尋找搜尋影像的第一個實例 (搜尋方向)。 第二個實例設定為 2,第 N 個實例設定為 ...., N。 如果您也在搜尋替代影像,則會先掃描 UIA 元素以尋找搜尋影像,然後掃描替代影像,以搜尋該特定影像的請求實例(即代理程式需要其中一個,而不是兩個影像的混合)。 |
|
|
圖片搜尋方向
|
ImageSearchDirection | string |
搜索方向。 「從上」從上到上按列搜索,在每列內從左到右掃描。 「從底部」從底部按行搜索,在每行內從左到右掃描。 「從左邊開始」會從左邊依欄搜尋,在每欄內從上到下掃描。 「從右」會從右邊依欄搜尋,在每欄內從上到下掃描。 這可以與“搜索圖像索引”結合使用,從頂部、底部、左側或右側定位第 N 個圖像。 若要提高效能,請選取您認為會更快找到影像的搜尋方向。 |
|
|
隱藏代理程式
|
HideAgent | boolean |
設定為 true 可自動隱藏代理程式 (如果可見),以確保它不會遮擋正在分析的元素。 |
|
|
顯示醒目提示矩形
|
ShowHighlightRectangle | boolean |
如果設定為 true,IA-Connect 代理程式將反白顯示螢幕上定位的影像。 這在開發期間可能很有用,以協助視覺化偵測到正確的影像。 |
|
|
等待搜尋影像不存在的秒數
|
SecondsToWait | integer |
等待搜尋影像不可見位於 UIA 元素內的秒數。 如果在此時間之後影像仍然存在,則如果「如果影像仍然存在,則會引發例外狀況」設定為true,否則動作會報告影像仍然存在。 |
|
|
搜尋之間的毫秒
|
MillisecondsBetweenSearches | integer |
在每個 UIA 元素螢幕掃描之間等待的毫秒數。 由於影像辨識可能會耗盡 CPU 成本,因此延遲有助於降低和分散 CPU 使用率。 例如:如果您預期影像最多可能需要 1 分鐘才能顯示,則在掃描之間新增 5000 毫秒 (5 秒) 的暫停,會大幅降低 CPU 使用率 (大幅減少掃描次數),但只會對回應時間產生很小的影響。 允許的最小值為 100 毫秒 (1/10 秒)。 |
|
|
如果影像仍然存在,則引發例外狀況
|
RaiseExceptionIfImageStillPresent | boolean |
如果 IA-Connect 如果影像在等待期間後仍然存在,則應該引發例外狀況,則設定為 true。 |
|
|
擷取執行緒識別碼的輸出資料
|
RetrieveOutputDataFromThreadId | integer |
如果您先前將「等候執行緒」設定為 false (這會導致代理程式在背景執行緒中執行等候),請提供代理程式執行緒識別碼以擷取結果。 此代理程式執行緒識別碼將由先前呼叫此動作提供。 否則,請設定為 0 (預設值)。 |
|
|
等待執行緒
|
WaitForThread | boolean |
設定為 true 以等候代理程式執行緒完成;代理程式將等待「等待搜尋影像不存在的秒數」指定的時間。 設定為false可略過等待;代理程式將繼續在背景執行緒中執行等待,但也可用於下一個動作。 然後,您可以使用動作 '等候代理程式執行緒順利完成' 來等候代理程式執行緒完成,然後重新執行此 '等待 UIA 元素內不存在可見的搜尋影像' 動作,並將輸入 '擷取執行緒 ID 的輸出資料' 設定為代理程式執行緒 ID,以擷取結果。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
搜尋等待前存在的影像
|
SearchImagePresentBeforeWait | boolean |
如果搜尋影像在等待期間開始時存在,則此輸出將設定為 true。 如果搜尋影像從一開始就不存在,則此輸出將設定為 false。 |
|
搜尋等待後仍然存在的影像
|
SearchImageStillPresentAfterWait | boolean |
如果搜尋影像仍然存在,則在等待期間過後,此輸出將設定為 true。 如果搜尋影像不再存在,則在等待期間,此輸出會設定為 false (一旦影像不再存在,動作就會立即完成)。 |
|
哪個搜尋影像仍然存在
|
WhichSearchImageStillPresent | integer |
如果等待期過後,如果沒有搜尋影像仍然存在,則此輸出將設定為 0。 如果搜尋影像仍然存在,則在等待期間後設定為 1。 如果替代搜尋影像仍然存在,則在等待期間後設定為 2。 |
|
執行緒識別碼
|
ThreadId | integer |
如果您已將「等候執行緒」設定為 false (這會導致代理程式在背景執行緒中執行等候),則此輸出會保留代理程式執行緒識別碼,可用來監視動作的處理程序,並在稍後執行緒完成時擷取結果。 |
等待 UIA 元素
等候元素 (通常是視窗內的個別元素,例如按鈕或文字輸入區域) 存在。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋程序識別碼
|
SearchProcessId | integer |
如果指定 (值為 1 或更高) ,則搜尋只會考慮具有此處理程序識別碼 (PID) 的處理程序所擁有的元素。 如果 IA-Connect 啟動了該程序,則PID由 IA-Connect 環境/工作階段操作中的“運行程序”操作提供。 如果您不知道 PID,請將此欄位保留空白(或 0)。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
傳回元素句柄
|
ReturnElementHandle | boolean |
如果設定為 true,則會傳回所定位元素的控制碼。 此句柄可用於進一步的動作,以充當「父項」句柄。 |
|
|
等待秒數
|
SecondsToWait | True | integer |
等待元素存在的秒數上限。 |
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
包含子程序
|
IncludeChildProcesses | boolean |
如果設定為 true 並指定「搜尋處理程序 ID」,則該處理程序 ID 的子處理程序也會包含在搜尋中。 如果設定為 false,則只會傳回符合確切「搜尋程式 ID」的程式。 |
|
|
如果找不到元素,則引發例外狀況
|
RaiseExceptionIfElementNotFound | boolean |
如果等待期間過後 UIA 元素不存在,IA-Connect 是否應該引發例外狀況? |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果元素存在,則傳回 true,如果不存在,則傳回 false。 |
|
元素控點
|
ElementHandle | integer |
元素的 UIA 控制碼。 這可作為輸入,以進一步作用於此元素的 UIA 動作。 |
|
元素名稱
|
ElementName | string |
元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
元素的 UIA 當地語系化控制項類型。 |
等待 UIA 元素不存在
等候元素 (通常是視窗中的個別元素,例如按鈕或文字輸入區域) 不再存在。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋程序識別碼
|
SearchProcessId | integer |
如果指定 (值為 1 或更高) ,則搜尋只會考慮具有此處理程序識別碼 (PID) 的處理程序所擁有的元素。 如果 IA-Connect 啟動了該程序,則PID由 IA-Connect 環境/工作階段操作中的“運行程序”操作提供。 如果您不知道 PID,請將此欄位保留空白(或 0)。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
等待秒數
|
SecondsToWait | True | integer |
等待元素不存在的最大秒數。 |
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
包含子程序
|
IncludeChildProcesses | boolean |
如果設定為 true 並指定「搜尋處理程序 ID」,則該處理程序 ID 的子處理程序也會包含在搜尋中。 如果設定為 false,則只會傳回符合確切「搜尋程式 ID」的程式。 |
|
|
如果元素仍然存在,則引發例外狀況
|
RaiseExceptionIfElementStillExists | boolean |
如果 UIA 元素在等候期間後仍然存在,IA-Connect 是否應該引發例外狀況? |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素在等待之前存在
|
ElementExistsBeforeWait | boolean |
如果元素在等待之前存在,則傳回 true,如果沒有,則傳回 false。 |
|
元素在等待後存在
|
ElementExistsAfterWait | boolean |
如果元素在等待後存在,則傳回 true,如果沒有,則傳回 false。 |
等待 UIA 元素內可見的搜尋影像
等候,直到搜尋影像 (作為此動作的輸入) 已明顯位於螢幕上的 UIA 元素內,或經過指定的時間量為止。 元素應該先放在前面,因為代理程式會在元素的座標處截取螢幕截圖,並在螢幕擷取畫面中搜尋提供的搜尋影像。 UIA 元素必須從一開始就存在。 找到影像後,動作會立即完成。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
搜尋影像類型
|
SearchImageType | string |
定義「搜尋影像」輸入所代表的內容。 如果設定為「導向器映像檔」,則搜尋映像是導向器可存取的檔案路徑。 如果設定為「代理程式映像檔」,則搜尋影像是代理程式可存取之檔案的路徑。 如果設定為「Base64」,則搜尋影像是影像的 base64 表示法。 |
|
|
搜尋圖片
|
SearchImage | string |
要在指定 UIA 元素內尋找的搜尋影像。 根據指定的「搜尋影像類型」,這可以保存影像檔案的路徑(在導向器或代理程式端),或包含要搜尋的影像的 base64(文字表示)。 |
|
|
替代搜尋影像類型
|
AltSearchImageType | string |
定義「替代搜尋影像」輸入所代表的內容。 如果設定為「無」或空白,則沒有替代搜尋影像。 如果設定為「導向器映像檔」,則搜尋映像是導向器可存取的檔案路徑。 如果設定為「代理程式映像檔」,則搜尋影像是代理程式可存取之檔案的路徑。 如果設定為「Base64」,則搜尋影像是影像的 base64 表示法。 |
|
|
替代搜尋圖片
|
AltSearchImage | string |
選擇性替代搜尋影像,以在指定的 UIA 元素內尋找。 根據指定的「替代搜尋影像類型」,這可以保存影像檔案的路徑(在導向器或代理程式端),或包含要搜尋的影像的 base64(文字表示)。 如果您指定替代搜尋影像,代理程式將尋找搜尋或替代搜尋影像,並報告找到哪一個。 |
|
|
最大顏色偏差
|
MaxColourDeviation | integer |
元素的像素顏色可以偏離搜尋圖片像素顏色的最大值,才會被視為不相符。 0 表示沒有偏差。 偏差以 RGB 值測量。 例如:#FF0000 與 #FE0102 有4個不同。 這允許忽略微小的顏色差異。 |
|
|
最大像素差異
|
MaxPixelDifferences | integer |
在影像被視為不相符之前,整個搜尋影像中可以差異的最大像素數(高於最大色彩偏差)。 這允許忽略影像之間的細微差異,但較高的值可能會增加尋找影像所需的時間。 建議設定為 0,必要時少量增加。 如果設定為高於 0 的值,您也必須設定「連續像素差異上限」。 |
|
|
最大連續像素差異
|
MaxConsecutivePixelDifferences | integer |
在影像被視為不相符之前,任何一列中可以不同的最大像素數(高於最大色彩偏差)。 這允許忽略影像之間的細微差異,但較高的值可能會增加尋找影像所需的時間。 建議設定為 0,必要時少量增加。 如果設定為高於 0 的值,您也必須設定「像素差異上限」。 |
|
|
左圖元X偏移
|
LeftPixelXOffset | integer |
搜尋區域左邊緣的可選 X 偏移。 這可讓您增加 (負值) 或減少 (正值) 搜尋區域。 |
|
|
右圖元 X 偏移
|
RightPixelXOffset | integer |
搜尋區域右邊緣的可選 X 偏移。 這可讓您增加 (使用正值) 或減少 (使用負值) 搜尋區域。 |
|
|
頂部像素 Y 位移
|
TopPixelYOffset | integer |
搜尋區域頂部邊緣的可選 Y 偏移。 這可讓您增加 (負值) 或減少 (正值) 搜尋區域。 |
|
|
底部像素 Y 偏移
|
BottomPixelYOffset | integer |
搜尋區域底部邊緣的可選 Y 偏移。 這可讓您增加 (使用正值) 或減少 (使用負值) 搜尋區域。 |
|
|
像素 X 偏移單位
|
PixelXOffsetsUnit | string |
如果左右像素 X 偏移以像素為單位,則設定為「像素」(預設值)。 如果左右像素 X 偏移量以元素寬度的百分比來衡量,則設定為「百分比」。 |
|
|
像素 Y 偏移單位
|
PixelYOffsetsUnit | string |
如果頂部和底部像素 Y 偏移以像素為單位測量,則設定為「像素」(預設值)。 如果頂部和底部像素 Y 偏移量以元素高度的百分比來測量,則設定為「百分比」。 |
|
|
搜尋影像索引
|
SearchImageIndex | integer |
設定為 1 ,可在 UIA 元素內尋找搜尋影像的第一個實例 (搜尋方向)。 第二個實例設定為 2,第 N 個實例設定為 ...., N。 如果您也在搜尋替代影像,則會先掃描 UIA 元素以尋找搜尋影像,然後掃描替代影像,以搜尋該特定影像的請求實例(即代理程式需要其中一個,而不是兩個影像的混合)。 |
|
|
圖片搜尋方向
|
ImageSearchDirection | string |
搜索方向。 「從上」從上到上按列搜索,在每列內從左到右掃描。 「從底部」從底部按行搜索,在每行內從左到右掃描。 「從左邊開始」會從左邊依欄搜尋,在每欄內從上到下掃描。 「從右」會從右邊依欄搜尋,在每欄內從上到下掃描。 這可以與“搜索圖像索引”結合使用,從頂部、底部、左側或右側定位第 N 個圖像。 若要提高效能,請選取您認為會更快找到影像的搜尋方向。 |
|
|
隱藏代理程式
|
HideAgent | boolean |
設定為 true 可自動隱藏代理程式 (如果可見),以確保它不會遮擋正在分析的元素。 |
|
|
將螢幕座標傳回為實體座標
|
ReturnPhysicalCoordinates | boolean |
設定為 true,讓螢幕座標傳回為實體座標。 設定為 false,讓螢幕座標傳回為虛擬座標。 如果基礎顯示縮放比例為 100%,則實體座標和虛擬座標都相同。 元素座標一律會傳回為虛擬座標。 |
|
|
顯示醒目提示矩形
|
ShowHighlightRectangle | boolean |
如果設定為 true,IA-Connect 代理程式將反白顯示螢幕上定位的影像。 這在開發期間可能很有用,以協助視覺化偵測到正確的影像。 |
|
|
等待搜尋圖片的秒數
|
SecondsToWait | integer |
等候搜尋影像位於 UIA 元素內的秒數。 如果找不到影像,則如果「找不到影像,則會引發例外狀況」設定為 true,否則動作會報告找不到影像。 |
|
|
搜尋之間的毫秒
|
MillisecondsBetweenSearches | integer |
在每個 UIA 元素螢幕掃描之間等待的毫秒數。 由於影像辨識可能會耗盡 CPU 成本,因此延遲有助於降低和分散 CPU 使用率。 例如:如果您預期影像最多可能需要 1 分鐘才能顯示,則在掃描之間新增 5000 毫秒 (5 秒) 的暫停,會大幅降低 CPU 使用率 (大幅減少掃描次數),但只會對回應時間產生很小的影響。 允許的最小值為 100 毫秒 (1/10 秒)。 |
|
|
如果找不到影像,則引發例外狀況
|
RaiseExceptionIfImageNotFound | boolean |
如果在等待期間之後找不到映像 IA-Connect 則應引發例外狀況,則設為 true。 |
|
|
擷取執行緒識別碼的輸出資料
|
RetrieveOutputDataFromThreadId | integer |
如果您先前將「等候執行緒」設定為 false (這會導致代理程式在背景執行緒中執行等候),請提供代理程式執行緒識別碼以擷取結果。 此代理程式執行緒識別碼將由先前呼叫此動作提供。 否則,請設定為 0 (預設值)。 |
|
|
等待執行緒
|
WaitForThread | boolean |
設定為 true 以等候代理程式執行緒完成;代理程式將等待「等待搜尋影像的秒數」指定的時間。 設定為false可略過等待;代理程式將繼續在背景執行等待,但也可用於下一個動作。 然後,您可以使用動作 '等候代理程式執行緒順利完成' 來等候代理程式執行緒完成,然後重新執行此 '等待 UIA 元素內可見的搜尋影像' 動作,並將輸入 '擷取執行緒 ID 的輸出資料' 設為代理程式執行緒 ID,以擷取結果。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
搜尋圖片位於
|
SearchImageLocated | boolean |
如果找到搜尋影像,則此輸出會設定為 true。 如果找不到搜尋影像,則此輸出將設定為 false。 |
|
哪個搜尋圖片位於
|
WhichSearchImageLocated | integer |
如果找不到搜尋影像,則此輸出將設定為 0。 如果找到搜尋影像,則設定為 1。 如果找到替代搜尋影像,則設定為 2。 |
|
影像比對邊界方塊元素左圖元
|
SearchImageBoundingBoxElementLeftPixelXCoord | integer |
符合指定影像的最左邊圖元的虛擬 X 座標,相對於元素虛擬左上角。 |
|
影像比對邊界方塊元素右圖元
|
SearchImageBoundingBoxElementRightPixelXCoord | integer |
最右邊圖元的虛擬 X 座標,符合指定影像,相對於元素虛擬左上角。 |
|
影像比對邊界方塊元素頂端像素
|
SearchImageBoundingBoxElementTopPixelYCoord | integer |
符合指定影像的最頂端圖元的虛擬 Y 座標,相對於元素虛擬左上角。 |
|
影像比對邊界方塊元素底部像素
|
SearchImageBoundingBoxElementBottomPixelYCoord | integer |
符合指定影像的最底部圖元的虛擬 Y 座標,相對於元素虛擬左上角。 |
|
影像比對框元素中心 X 像素
|
SearchImageBoundingBoxElementCenterPixelXCoord | integer |
邊界方塊中心的虛擬 X 座標,其中包含符合指定影像的像素,相對於元素虛擬左上角。 |
|
影像比對框框元素中心 Y 像素
|
SearchImageBoundingBoxElementCenterPixelYCoord | integer |
邊界方塊中心的虛擬 Y 座標,其中包含符合指定影像的像素,相對於元素虛擬左上角。 |
|
圖片比對邊界框螢幕左像素
|
SearchImageBoundingBoxScreenLeftPixelXCoord | integer |
符合指定影像的最左邊圖元的螢幕圖元 X 座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
圖像匹配邊界框屏幕右側像素
|
SearchImageBoundingBoxScreenRightPixelXCoord | integer |
符合指定影像的最右邊圖元的螢幕圖元 X 座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
影像比對框框螢幕頂端像素
|
SearchImageBoundingBoxScreenTopPixelYCoord | integer |
符合指定影像的最上層圖元的螢幕圖元Y座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
圖片比對邊界框螢幕底部像素
|
SearchImageBoundingBoxScreenBottomPixelYCoord | integer |
符合指定影像的最底部圖元的螢幕圖元 Y 座標。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
影像比對框框螢幕中心 X 像素
|
SearchImageBoundingBoxScreenCenterPixelXCoord | integer |
邊界方塊中心的螢幕像素 X 座標,其中包含符合指定影像的像素。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
影像比對邊界框螢幕中心 Y 像素
|
SearchImageBoundingBoxScreenCenterPixelYCoord | integer |
邊界方塊中心的螢幕像素 Y 座標,其中包含符合指定影像的像素。 這是實體座標或虛擬座標,視輸入「傳回實體座標」而定。 |
|
執行緒識別碼
|
ThreadId | integer |
如果您已將「等候執行緒」設定為 false (這會導致代理程式在背景執行緒中執行等候),則此輸出會保留代理程式執行緒識別碼,可用來監視動作的處理程序,並在稍後執行緒完成時擷取結果。 |
等待 UIA 最上層 Win32 視窗
快速 Win32 動作,會等候指定的時間,讓最上層 Win32 視窗存在,再傳回 UIA 控制碼。 頂層視窗是連線到桌面的視窗。 您可以依類別名稱或視窗標題進行搜尋,也可以指定更進階的搜尋篩選器,包括萬用字元。 雖然此動作使用 Win32 API,但它可以偵測 Windows、Java、ModernUI 和 Web 視窗。 使用更強大的 UIA 動作「等候桌面元素」更常見,但此 Win32 動作通常執行速度更快。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋類別名稱
|
SearchClassName | string |
要搜尋的頂層視窗的元素類別名稱,例如「記事本」。 |
|
|
搜尋視窗標題
|
SearchWindowTitle | string |
要搜尋的最上層視窗的標題。 |
|
|
等待秒數
|
SecondsToWait | True | integer |
等待視窗存在的秒數上限。 |
|
搜尋程序識別碼
|
SearchProcessId | integer |
擁有視窗之進程的選用進程識別碼 (例如,由 IA-Connect 環境/工作階段動作中的「執行進程」動作的輸出所提供)。 設定為 0 以不依進程識別碼搜尋。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選擇性的進階篩選器,可進一步限制使用條件運算子對可用視窗屬性進行搜尋。 範例 1:[寬度] < 200。 範例 2:[Title] 類似 '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個視窗符合搜尋,這可讓您指定要排序的視窗屬性。 這將與「比對索引」結合使用,以選擇所需的視窗。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會傳回最接近螢幕頂端的相符視窗。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個視窗符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
如果找不到視窗,則引發例外狀況
|
RaiseExceptionIfWindowNotFound | boolean |
如果等候期間後搜尋 Win32 視窗不存在,IA-Connect 是否應該引發例外狀況? |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
視窗句柄
|
WindowHandle | integer |
視窗的 UIA 控制碼。 這可作為此視窗內進一步 UIA 動作的輸入。 |
|
元素名稱
|
ElementName | string |
視窗元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
視窗元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
視窗元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
視窗元素的 UIA 當地語系化控制項類型。 |
|
元素存在
|
ElementExists | boolean |
如果視窗存在,則傳回 true,如果不存在,則傳回 false。 |
等待 UIA 桌面元素
等候桌面元素 (通常是視窗) 存在。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋程序識別碼
|
SearchProcessId | integer |
如果指定 (值為 1 或更高) ,則搜尋只會考慮具有此處理程序識別碼 (PID) 的處理程序所擁有的元素。 如果 IA-Connect 啟動了該程序,則PID由 IA-Connect 環境/工作階段操作中的“運行程序”操作提供。 如果您不知道 PID,請將此欄位保留空白(或 0)。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
傳回元素句柄
|
ReturnElementHandle | boolean |
如果設定為 true,則會傳回所定位元素的控制碼。 此句柄可用於進一步的動作,以充當「父項」句柄。 |
|
|
等待秒數
|
SecondsToWait | True | integer |
等待元素存在的秒數上限。 |
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
包含子程序
|
IncludeChildProcesses | boolean |
如果設定為 true 並指定「搜尋處理程序 ID」,則該處理程序 ID 的子處理程序也會包含在搜尋中。 如果設定為 false,則只會傳回符合確切「搜尋程式 ID」的程式。 |
|
|
如果找不到元素,則引發例外狀況
|
RaiseExceptionIfElementNotFound | boolean |
如果等待期間過後 UIA 元素不存在,IA-Connect 是否應該引發例外狀況? |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果元素存在,則傳回 true,如果不存在,則傳回 false。 |
|
元素控點
|
ElementHandle | integer |
元素的 UIA 控制碼。 這可作為輸入,以進一步作用於此元素的 UIA 動作。 |
|
元素名稱
|
ElementName | string |
元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
元素的 UIA 當地語系化控制項類型。 |
等待 UIA 桌面元素不存在
等候桌面元素 (通常是視窗) 不再存在。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋程序識別碼
|
SearchProcessId | integer |
如果指定 (值為 1 或更高) ,則搜尋只會考慮具有此處理程序識別碼 (PID) 的處理程序所擁有的元素。 如果 IA-Connect 啟動了該程序,則PID由 IA-Connect 環境/工作階段操作中的“運行程序”操作提供。 如果您不知道 PID,請將此欄位保留空白(或 0)。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
等待秒數
|
SecondsToWait | True | integer |
等待元素不存在的最大秒數。 |
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
包含子程序
|
IncludeChildProcesses | boolean |
如果設定為 true 並指定「搜尋處理程序 ID」,則該處理程序 ID 的子處理程序也會包含在搜尋中。 如果設定為 false,則只會傳回符合確切「搜尋程式 ID」的程式。 |
|
|
如果元素仍然存在,則引發例外狀況
|
RaiseExceptionIfElementStillExists | boolean |
如果 UIA 元素在等候期間後仍然存在,IA-Connect 是否應該引發例外狀況? |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素在等待之前存在
|
ElementExistsBeforeWait | boolean |
如果元素在等待之前存在,則傳回 true,如果沒有,則傳回 false。 |
|
元素在等待後存在
|
ElementExistsAfterWait | boolean |
如果元素在等待後存在,則傳回 true,如果沒有,則傳回 false。 |
等待 UIA 進程主視窗
簡單且快速的 Win32 動作,會等候進程的主要視窗 (以名稱指定) 存在指定的時間,再傳回控制碼。 「主」視窗通常是應用程式主視窗:登入對話框或子視窗通常不是「主」視窗。 建議使用「等待桌面元素」動作,功能更強大。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋程序名稱
|
SearchProcessName | True | string |
要搜尋的進程名稱,例如記事本。 |
|
等待秒數
|
SecondsToWait | True | integer |
等待進程主視窗的秒數上限。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
視窗句柄
|
WindowHandle | integer |
視窗的 UIA 控制碼。 這可作為此視窗內進一步 UIA 動作的輸入。 |
|
元素名稱
|
ElementName | string |
視窗元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
視窗元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
視窗元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
視窗元素的 UIA 當地語系化控制項類型。 |
|
元素存在
|
ElementExists | boolean |
如果視窗存在,則傳回 true,如果不存在,則傳回 false。 |
等待 UIA 進程識別碼主視窗
簡單且快速的 Win32 動作,會等候進程的主要視窗 (由進程標識碼) 存在,並傳回控制碼。 「主」視窗通常是應用程式主視窗:登入對話框或子視窗通常不是「主」視窗。 建議使用「等待桌面元素」動作,功能更強大。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋程序識別碼
|
ProcessId | True | integer |
要等待的處理程序的識別碼 (如 IA-Connect 環境/工作階段動作中的「執行處理程序」動作所提供)。 |
|
等待秒數
|
SecondsToWait | True | integer |
等待進程主視窗的秒數上限。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果元素存在,則傳回 true,如果不存在,則傳回 false。 |
|
視窗句柄
|
WindowHandle | integer |
視窗的 UIA 控制碼。 這可作為此視窗內進一步 UIA 動作的輸入。 |
|
元素名稱
|
ElementName | string |
視窗元素的 UIA 名稱。 |
|
元素類別名稱
|
ElementClassName | string |
視窗元素的 UIA 類別名稱。 |
|
元素自動化識別碼
|
ElementAutomationId | string |
視窗元素的 UIA 自動化識別碼。 |
|
元素當地語系化控制項類型
|
ElementLocalizedControlType | string |
視窗元素的 UIA 當地語系化控制項類型。 |
設定 UIA 交易逾時
控制 UIA API 等候應用程式傳回元素相關資訊的時間長度。 通常只有在應用程式沒有回應時,才會達到此交易逾時。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
逾時 (秒)
|
TimeoutInSeconds | True | double |
UIA API 會等候應用程式傳回元素相關資訊的時間長度上限。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
設定 UIA 元素捲動百分比
設定指定元素的水平和/或垂直捲動百分比(如果該元素支援捲動)。 如果元素支援「捲動」模式,您可以將此動作直接套用至元素,並指定水平或垂直捲動量 (或兩者兼而有之)。 如果元素不支援「捲動」模式,此動作會回復至 '範圍值' 或 'value' 模式,但您必須將這些模式直接套用至捲軸控制項,而不是元素本身。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
水平捲動百分比
|
HorizontalScrollPercentage | double |
水平捲動元素的位置 (含 0 到 100,支援小數) 或 -1 保持水平捲動位置不變。 |
|
|
垂直捲動百分比
|
VerticalScrollPercentage | double |
垂直捲動元素的位置 (含 0 到 100,支援小數) 或 -1 保持垂直捲動位置不變。 |
|
|
嘗試捲動圖案
|
TryScrollPattern | boolean |
如果設定為 true,IA-Connect 代理程式會嘗試使用 UIA 捲動模式來執行捲動動作。 如果所選元素中的 UIA 捲動模式無法使用,則 IA-Connect 代理程式將回復到其他所選模式(透過此動作的其他輸入啟用或停用)。 如果設定為 false,IA-Connect 代理程式將不會嘗試使用捲動模式,並立即回復到其他選擇的模式。 嘗試的模式順序 (如果透過此動作的輸入啟用) 是捲動、範圍值和值。 |
|
|
嘗試範圍值模式
|
TryRangeValuePattern | boolean |
如果設定為 true,IA-Connect 代理程式會嘗試使用 UIA 範圍值模式來執行捲動動作。 如果所選元素中的 UIA 範圍值模式無法使用,則 IA-Connect 代理程式將回復至其他所選模式 (透過此動作的其他輸入啟用或停用)。 如果設定為 false,IA-Connect 代理程式將不會嘗試使用範圍值模式,並立即回復到其他選擇的模式。 嘗試的模式順序 (如果透過此動作的輸入啟用) 是捲動、範圍值和值。 |
|
|
嘗試值模式
|
TryValuePattern | boolean |
如果設定為 true,IA-Connect 代理程式會嘗試使用 UIA 值模式來執行捲動動作。 如果所選元素中的UIA值模式無法使用,則 IA-Connect 代理程式將回復到其他選擇的模式(透過此操作的其他輸入啟用或停用)。 如果設定為 false,IA-Connect 代理程式將不會嘗試使用值模式,並會立即回復到其他選擇的模式。 嘗試的模式順序 (如果透過此動作的輸入啟用) 是捲動、範圍值和值。 警告:在編輯元素上使用值模式只需將值輸入編輯元素即可。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
指令結果
|
UIASetElementScrollPercentageResult | boolean |
命令的結果(成功或失敗)。 |
|
錯誤訊息
|
ErrorMessage | string |
如果指令不成功,則會包含傳回的錯誤訊息。 |
設定 UIA 元素搜尋模式
選擇執行 UIA 動作時,IA-Connect Agent 應使用哪個 UIA 元素搜尋模式。 通常,只有在預設模式(全部尋找)發生問題時,才會使用此動作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
UIA 元素搜尋模式
|
UIAElementSearchMode | True | string |
要使用的 UIA 元素搜尋模式。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
指令結果
|
SetUIAElementSearchModeResult | boolean |
命令的結果(成功或失敗)。 |
|
錯誤訊息
|
ErrorMessage | string |
如果指令不成功,則會包含傳回的錯誤訊息。 |
設定前景 UIA 視窗
將視窗帶到前景。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
視窗句柄
|
WindowHandle | True | integer |
視窗的 UIA 控制碼,應該設定為前景視窗。 |
|
切換視窗
|
ToggleWindow | boolean |
應該透過嘗試聚焦或點擊來切換視窗? 這有助於確保窗口可靠地被帶到前景。 |
|
|
切換使用全域滑鼠左鍵點擊代理程式
|
ToggleUsesGlobalLeftMouseClickAgent | boolean |
如果選擇切換視窗,則會指定是否先使用全域滑鼠按一下來聚焦 IA-Connect 代理程式。 |
|
|
切換延遲(以秒為單位)
|
ToggleDelay | double |
如果選擇切換視窗,則會指定切換後的暫停。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
調整 UIA 元素的大小
調整 UIA 元素的大小。 此動作通常只適用於 Window 元素 (具有轉換模式) 。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
調整寬度類型
|
ResizeWidthType | string |
寬度調整大小的類型:絕對或相對。 |
|
|
新寬度
|
NewWidth | True | integer |
元素的新寬度。 調整大小的類型 (例如,絕對或相對) 是由輸入「調整寬度大小類型」所定義。 若要保持寬度不變,請選擇值 0,並將「調整寬度類型大小」設定為「相對」。 |
|
調整大小高度類型
|
ResizeHeightType | string |
高度調整大小的類型:絕對或相對。 |
|
|
新高度
|
NewHeight | True | integer |
元素的新高度。 調整大小的類型 (例如絕對或相對) 是由輸入「調整大小高度類型」所定義。 若要保持高度不變,請選擇值 0,並將「調整高度類型大小」設定為「相對」。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
指令結果
|
UIAResizeElementResult | boolean |
命令的結果(成功或失敗)。 |
|
錯誤訊息
|
ErrorMessage | string |
如果指令不成功,則會包含傳回的錯誤訊息。 |
輸入傳回至 UIA 元素
將 Windows 回傳/換行輸入到元素 (通常是文字輸入欄位) 中,取代現有的文字或在特定位置插入回傳。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
取代現有值
|
ReplaceExistingValue | boolean |
如果元素中存在現有文本,是否應該替換? |
|
|
插入位置
|
InsertPosition | integer |
開始插入文字的位置 (索引)。 如果有現有文字,則可以使用插入位置在現有文字內的特定位置插入。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
如果輸入驗證失敗,則引發例外狀況
|
RaiseExceptionIfInputValidationFails | boolean |
如果啟用,IA-Connect 代理程式將在輸入請求的文字後檢查元素的新值。 如果新值與預期值不符,則會引發例外狀況。 如果此輸入為false(預設值),則會在日誌中輸入警告,但不會引發例外狀況。 |
|
|
嘗試值模式
|
TryValuePattern | boolean |
如果設定為 true (預設值),IA-Connect 代理程式會嘗試使用 UIA 值型樣來執行文字輸入動作。 如果所選元素中的 UIA 值模式無法使用,則 IA-Connect 代理程式將回復到其他模式(透過此動作的其他輸入啟用或停用)。 如果設定為 false,IA-Connect 代理程式將不會嘗試使用值模式,並會立即回復到其他選擇的模式。 |
|
|
嘗試舊版模式
|
TryLegacyPattern | boolean |
如果設定為 true,如果值型樣無法使用 (因為元素上不存在,或因為其使用已停用) ,IA-Connect 代理程式將嘗試使用 UIA 舊版模式來執行文字輸入動作。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
進程有Win32窗口嗎
簡單且快速的 Win32 動作,可報告進程 (以名稱指定) 是否有任何可見視窗。 視窗必須存在:IA-Connect 不會等待。 建議使用「等待桌面元素」動作,功能更強大。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋程序名稱
|
SearchProcessName | True | string |
要搜尋的進程名稱,例如記事本。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
進程有視窗
|
ProcessHasWindow | boolean |
如果進程有可見視窗,則傳回 true,如果沒有,則傳回 false。 |
選取 UIA 元素
選取元素 (通常是清單或下拉式清單中的項目)。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
重設所有 UIA 元素控制碼
重設目前由 IA-Connect 儲存的所有 UIA 元素控制碼,如果您已識別許多元素,而且儲存了大量元素控制碼,這會很有用。 在元素句柄數量極多 (100,000+) 的案例中,此動作也可用於釋放 RAM 使用量。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
關閉 UIA 元素視窗
關閉元素視窗。 通常僅適用於視窗或對話方塊。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父視窗控點
|
ParentWindowHandle | True | integer |
父 UIA 視窗句柄 (值為 1 或更高) ,以作為搜尋的起點。 這可以透過「檢查」來發現,使用「等待桌面元素」或「等待元素」等動作。 |
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素自動化識別碼
|
SearchElementAutomationId | string |
要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋元素當地語系化控制項類型
|
SearchLocalizedControlType | string |
要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。 |
|
|
搜尋 UIA 子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true,則會搜尋父視窗控制碼下方的整個 UIA 樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋 UIA 樹狀結構中父視窗控制碼正下方的元素。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[Name] 類似於 'Document*' 和 [ClassName] 類似於 'Label*'。 如需更多範例,請參閱文件。 |
|
|
依欄名稱排序
|
SortByColumn | string |
如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。 |
|
|
比對索引是遞增的
|
MatchIndexAscending | boolean |
如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。 |
|
|
要搜尋的元素數目上限
|
MaxElementsToSearch | integer |
在 UIA 樹狀結構中尋找目標元素時要搜尋的元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
最大相對搜尋深度
|
MaxRelativeSearchDepth | integer |
在父元素下方搜尋子元素的最大相對樹狀結構深度。 直接子元素的深度值為 1。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 設定為 0 可獲得無限的搜尋深度。 此輸入通常用於優化元素搜尋。 |
|
|
每個節點要搜尋的子元素數目上限
|
MaxChildElementsToSearchPerNode | integer |
在 UIA 樹狀結構中搜尋目標元素時,要在每個元素下方搜尋的子元素數目上限。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 依預設,此值會設定為 0 (無限制)。 此輸入通常用於優化元素搜尋。 |
|
|
不周遊的元素當地語系化控制項類型
|
ElementLocalizedControlTypesNotToTraverse | string |
UIA 元素當地語系化控制項類型的逗點分隔清單,在搜尋目標元素的 UIA 樹狀結構時,不會遍歷 (逐步執行) 。 搜尋仍會檢查個別元素是否符合搜尋準則,但如果該元素的當地語系化控制項類型在此排除清單上,則不會搜尋該元素的任何子元素。 只有在 UIA 元素搜尋模式為「樹狀結構漫步」時,此輸入才有效 (這可以在偵測器的設定頁面中啟用)。 此輸入通常用於優化元素搜尋。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
頂層Win32視窗存在嗎
快速 Win32 動作,可報告最上層 Win32 視窗是否存在。 頂層視窗是連線到桌面的視窗。 您可以依類別名稱或視窗標題進行搜尋,也可以指定更進階的搜尋篩選器,包括萬用字元。 雖然此動作使用 Win32 API,但它可以偵測 Windows、Java、ModernUI 和 Web 視窗。 窗口必須存在,IA-Connect 不會等待。 使用更強大的 UIA 動作「UIA 桌面元素是否存在」更常見,但此 Win32 動作通常執行速度更快。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
搜尋類別名稱
|
SearchClassName | string |
要搜尋的頂層視窗的元素類別名稱,例如「記事本」。 |
|
|
搜尋視窗標題
|
SearchWindowTitle | string |
要搜尋的最上層視窗的標題。 |
|
|
搜尋程序識別碼
|
SearchProcessId | integer |
擁有視窗之進程的選用進程識別碼 (例如,由 IA-Connect 環境/工作階段動作中的「執行進程」動作的輸出所提供)。 設定為 0 以不依進程識別碼搜尋。 |
|
|
匹配索引
|
MatchIndex | integer |
如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。 |
|
|
搜尋篩選
|
SearchFilter | string |
選擇性的進階篩選器,可進一步限制使用條件運算子對可用視窗屬性進行搜尋。 範例 1:[寬度] < 200。 範例 2:[Title] 類似 '*Excel' AND [IsMinimised] = False AND [IsResizeable] = True。 如需更多範例,請參閱文件。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式:workflow() |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
視窗存在
|
WindowExists | boolean |
如果視窗存在,則傳回 true,如果不存在,則傳回 false。 |