共用方式為


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
Email 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。