共用方式為


IA-Connect 爪哇

IA-Connect 是一個機器人流程自動化 (RPA) 平台,可將 RPA 功能從雲端添加到本地虛擬機或通過 Citrix 或 Microsoft 遠程桌面 (RDS) 連接。 這是使用 Java Access Bridge (JAB) 自動化 Java 應用程式的模組。

此連接器適用於以下產品和區域:

服務 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 連接器提供超過 650 個動作,可讓您直接從 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 大型主機
  • IA-Connect Microsoft辦公室
  • IA-Connect SAP GUI
  • IA-Connect 場
  • IA-Connect 使用者介面
  • IA-Connect 網頁瀏覽器

如何取得認證

為了獲得您的許可證並開始您的 30 天免費試用,請在我們的網站上提交請求 (https://www.ultima.com/IA-Connect/Power-Automate)。

收到試用請求後,我們將透過提供的電子郵件地址與您聯繫,以協助設定 IA-Connect 軟體並為您提供試用授權。 這是功能齊全的試用版,可讓您在試用期內測試自己環境中所有 8 個 IA-Connect Connector 的 650 個動作中的任何一個。

開始使用連接器

提交 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 秒

動作

Java 元素句柄是否相同

比較 Java 元素的兩個 Java 元素控點,以查看它們是否代表相同的 Java 物件。 如果您已識別元素並擷取其父項的控點,這會很有用。

Java 表格儲存格在螢幕上是否可見

傳回 Java 表格元素內的特定表格儲存格目前是否在螢幕上可見。

Java元素存在嗎

報告 Java 元素是否存在,並傳回一些基本元素屬性。

Java桌面元素存在嗎

報告 Java 桌面元素是否存在,並提供一些基本元素內容。

中斷與 Java Access Bridge 的連線

關閉任何執行中的 IA-Connect Java 子系統 (IA-JavaAccessBridge)。

依名稱取得 Java 選取狀態

提供子元素名稱,傳回選取範圍中子元素的選取狀態 (通常是清單或下拉式清單中的項目)。 您可以使用動作 '取得 Java 選取元素項目' 來擷取所有選取子元素項目,以檢查其名稱。

依名稱選取 Java 清單元素

選取具有指定名稱的清單元素。 這通常用於在下拉式清單/功能表項目中選取項目。

依索引取得 Java 選取狀態

透過提供子元素索引,傳回選取範圍中子元素的選取狀態 (通常是清單或下拉式清單中的項目)。 您可以使用動作 '取得 Java 選取元素項目' 來擷取所有選取的子元素項目,以檢查其索引。

依索引選取 Java 清單元素

選取符合指定索引的清單元素。 這通常用於在下拉式清單/功能表項目中選取項目。

全域輸入密碼到Java元素中

將滑鼠移至 Java 元素的中心,聚焦它,左鍵按一下,然後按按鍵。 通常與不接受原生 UIA 輸入法的密碼輸入搭配使用。

全域輸入文字到 Java 元素中

將滑鼠移至 Java 元素的中心,聚焦它,左鍵按一下,然後按按鍵。 通常與不接受原生 UIA 輸入法的文字輸入搭配使用。

全局滑鼠中鍵點擊Java元素

將滑鼠移至 Java 元素的中心,然後按一下滑鼠中鍵。

全局滑鼠右鍵點擊 Java 元素

將滑鼠移至 Java 元素的中心,然後按一下滑鼠右鍵。

全局雙擊滑鼠左鍵 Java 元素

將滑鼠移至 Java 元素的中心,然後按兩下滑鼠左鍵。

全局鼠標單擊 Java 表格單元格

將滑鼠移至 Java 表格儲存格的中心,然後按一下指定的滑鼠按鈕。

全局鼠標左鍵單擊 Java 元素

將滑鼠移至 Java 元素的中心,然後按一下滑鼠左鍵。

取得 Java 元素值

傳回元素的值。 值通常與文字輸入區域相關聯,但許多元素可以具有此屬性。

取得 Java 元素屬性

傳回 Java 元素的所有 Java 屬性。 如果您不確定哪個欄位包含所需的屬性值,這會很有用。

取得 Java 元素文字值

傳回 Java 元素的文字值。 文字值通常與文字元素相關聯,但許多元素可以具有此屬性。

取得 Java 元素的動作

傳回 Java 元素的可存取動作。 然後,可以使用動作名稱作為動作「對 Java 元素執行動作」的輸入,例如「按一下」或「全選」,對元素執行這些可存取的動作。

取得 Java 子元素屬性

傳回由索引指定的特定 Java 子元素的所有屬性。 如果您不確定哪個欄位包含所需的屬性值,這會很有用。

取得 Java 桌面元素

傳回桌面上的 Java 應用程式視窗和對話方塊清單。 您必須先連線至 Java 存取橋接器。

取得 Java 父元素屬性

傳回 Java 元素的父元素屬性。 此動作只會傳回直接父元素的屬性,不會搜尋元素樹的整個高度。

取得 Java 表格儲存格屬性

傳回 Java 表格元素內指定儲存格的內容和內容。 這是一個包含行、列、標題和單元格(即表格)的元素。 您可以選擇性地指定是否要列舉檢視區來判斷儲存格目前在螢幕上可見,且其座標是否為座標。 視口元素通常包含表格(例如它是表格的父元素)並表示表格的可見區域。

取得 Java 表格內容

傳回 Java 表格元素的內容。 這是一個包含行、列、標題和單元格(即表格)的元素。

取得 Java 表格屬性

傳回 Java 表格元素的屬性。 這是一個包含行、列、標題和單元格(即表格)的元素。 您可以選擇性地指定是否要列舉檢視區來判斷目前在畫面上顯示的資料表哪些元件。 視口元素通常包含表格(例如它是表格的父元素)並表示表格的可見區域。

取得 UIA 元素的 Java 屬性

傳回 UIA 元素的所有 Java 屬性。 如果您不確定哪個欄位包含所需的屬性值,這會很有用。

取得 Windows Access 橋接器連線狀態

傳回代理程式與 Windows 存取橋接器 (WAB) 之間連線 IA-Connect 目前狀態。 如果 IA-Connect 代理程式連線到WAB,則相關詳細資訊將作為輸出傳回。

取得 Windows 存取橋接器資訊

傳回特定 Java VM 識別碼的 Windows 存取橋接器 (WAB) 相關資訊,包括 Java 和 Windows DLL 版本。 Java VM ID 可以作為「取得 Java 元素內容」動作的輸出取得。

取得Java元素的可見邊界矩形

擷取 Java 元素的可見界限。 一般而言,Java Access Bridge 會傳回元素的虛擬位置值,而不論該元素是否在畫面上可見,且這些虛擬值是由「取得 Java 元素內容」動作所提供。 對於較大的元素(例如可以滾動的表格元素),這些元素可能並不總是在螢幕上可見,因此此操作會返回元素當前可見區域的坐標。

取得Java選取元素項目

傳回在指定 Java 選取元素下找到的所有子選取元素項目。 您可以選擇透過迴圈瀏覽選取範圍、選取清單中的每個個別選項,或讀取選取範圍的子元素標籤來擷取選取元素選項。 如果您選擇透過讀取選取範圍的子元素標籤來擷取選取元素選項,則可能需要先將「先展開」參數提供為「True」來展開選取範圍,然後您可以選擇性地關閉選取範圍,同時提供「收合之後」參數為「True」。

取得多個 Java 父元素屬性

傳回 Java 元素的所有父元素的屬性。 如果「要處理的父系數目上限」參數設定得足夠高,則此動作會搜尋元素樹狀結構的整個高度,並傳回所有父屬性。

取得所有 Java 子元素屬性

傳回所有 Java 子元素的所有屬性。 如果您不確定哪個欄位包含所需的屬性值,這會很有用。

在Java元素中輸入密碼

將密碼輸入 Java 元素 (通常是密碼輸入欄位),取代現有的文字。

在Java元素周圍繪製矩形

在 Java 元素的周邊繪製矩形,以協助識別找到的元素是所需的元素。 矩形會在 5 秒後自動移除。

在屏幕坐標處獲取 Java 表格單元格

如果作為表格子元素的 Java 表格儲存格存在於指定的座標,則此動作將識別元素及其屬性,並選擇性地傳回表格儲存格元素的控點。

在螢幕座標處建立 Java 元素的句柄

透過提供螢幕座標來建立 Java 元素的控點。 如果 Java 元素存在於指定的座標處,則動作會識別該元素並傳回其句柄。

將 Java 元素屬性作為列表

將 Java 元素的屬性作為單行清單(單行集合/資料表)而不是單個項目傳回,這可能有用,具體取決於您打算如何使用資料。

將文字輸入到Java元素中

將文字輸入 Java 元素 (通常是文字輸入欄位),取代現有文字或在特定位置插入新值。

對 Java 元素執行動作

對 Java 元素執行可存取的動作。 您可以使用「取得 Java 元素的動作」動作來查詢特定元素的這些可存取動作。 一些常見的操作是按鈕的“單擊”或文本元素的“全選”。

展開 Java 選取元素

展開或摺疊 Java 元素 (通常是功能表/下拉式項目)。 如果項目已經展開,則不會發生任何動作。

從元素句柄獲取 Java 角色 CSV

將指定元素控制碼下方的元素角色樹狀結構傳回為 CSV。 此動作只會用於開發目的,並提供應用程式元素的概觀,這對於視覺化應用程式結構和最佳化元素搜尋非常有用。

從元素搜尋取得 Java 角色 CSV

執行 Java 元素搜尋,並將所搜尋元素的詳細資料 (直到找到元素為止) 輸出為 CSV。 此動作只會用於開發目的,並提供應用程式元素的概觀,這對於視覺化應用程式結構和最佳化元素搜尋非常有用。

按 Java 元素

按下 Java 元素 (通常是按鈕)。

是 Java 視窗

傳回 UIA 視窗是否為 Java 元素。

檢查 Java 元素

將元素的狀態 (通常是核取方塊或選項方塊) 設定為已核取或未核取。

焦點 Java 元素

聚焦 Java 元素,使其成為鍵盤焦點的作用中元素,視應用程式而定,可能會將元素視窗帶到前景。

等待 Java 桌面元素

等待 Java 桌面元素(通常是視窗)存在。

等待Java元素

等待 Java 元素 (通常是視窗中的個別元素,例如按鈕或文字輸入區域) 存在。

等待Java元素不存在

等待 Java 元素(通常是視窗中的個別元素,例如按鈕或文字輸入區域)不再存在。

等待Java桌面元素不存在

等待 Java 桌面元素(通常是視窗)不再存在。

連線至 Java Access Bridge

啟動 IA-Connect Java 子系統 (IA-JavaAccessBridge),並將它連接至指定的 Java Access Bridge DLL(或留空以搜尋一個)。 您必須先執行此步驟,才能將 Java 應用程式自動化。 此動作也會啟用 Java Access Bridge,在執行任何 Java 應用程式之前,必須先啟用該橋接器。

重設所有 Java 元素控點

重設 IA-Connect 目前儲存的所有 Java 元素控點,如果您已識別大量元素且儲存了大量元素控點,這會很有用。 在元素句柄數量極多 (100,000+) 的案例中,此動作也可用於釋放 RAM 使用量。

Java 元素句柄是否相同

比較 Java 元素的兩個 Java 元素控點,以查看它們是否代表相同的 Java 物件。 如果您已識別元素並擷取其父項的控點,這會很有用。

參數

名稱 機碼 必要 類型 Description
元素 1 JAB 手柄
Element1JABHandle True integer

要比較的第一個元素控制碼。

元素 2 JAB 手柄
Element2JABHandle True integer

要比較的第二個元素控制碼。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
相同的物件
SameObject boolean

如果兩個元素控點都針對相同的 Java 物件,則傳回 true,如果元素控點針對不同的 Java 物件,則傳回 false。

Java 表格儲存格在螢幕上是否可見

傳回 Java 表格元素內的特定表格儲存格目前是否在螢幕上可見。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

處理視埠父系
ProcessViewportParents boolean

如果設定為 'True' (預設值),則也會處理視埠的父元素,以協助調整視埠的可見大小。 如果它嵌入到另一個視埠中,這非常有用。 如果設定為 'False',則不會處理視埠父元素。

要處理的最大視埠父系
MaxViewportParentsToProcess integer

列舉檢視區時要處理的父元素數目上限。 依預設,此值會設定為 50。

要考慮的檢視埠父元素角色
ViewportParentElementRolesToConsider string

列舉以計算檢視區大小時要考慮的檢視區父元素的角色。 這可用來排除大小小於視埠的父元素,這可能會扭曲大小計算,例如頁面標籤。 依預設,這些是:面板、視埠、分層窗格、根窗格。

視埠左邊界
ViewportLeftMargin integer

列舉檢視區的左內邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

檢視區上邊界
ViewportTopMargin integer

列舉檢視區的頂端內部邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

視埠右邊距
ViewportRightMargin integer

列舉檢視區的右內邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

視埠底部邊界
ViewportBottomMargin integer

列舉檢視區的底部內部邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

儲存格列索引
CellRowIndex True integer

表格中儲存格的資料列索引,從 1 開始。

儲存格資料行索引
CellColumnIndex True integer

表格中儲存格的直欄索引,從 1 開始。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
螢幕上的儲存格
CellOnScreen boolean

如果指定的儲存格目前顯示在螢幕上,則傳回 true,如果沒有,則傳回 false。

結果是肯定的
ResultIsCertain boolean

如果「螢幕上的儲存格」結果確定,則傳回 true。 如果無法計算 4 個父表界限中的任何一個,則會設定為 'False'。

螢幕外方向
OffscreenDirection string

指定儲存格螢幕外方向的文字表示,例如上方、下方、左側或右側。 如果儲存格位於上方和左或右,則會傳回為上方。 同樣,如果儲存格位於下方和左或右,則將返回為下方。

Java元素存在嗎

報告 Java 元素是否存在,並傳回一些基本元素屬性。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素存在
ElementExists boolean

如果元素存在,則傳回 true,如果不存在,則傳回 false。

元素 JAB 控點
ElementJABHandle integer

如果找到搜尋元素,這會保留數值元素句柄,可用於進一步的動作,以作為進一步搜尋的「父」句柄 (,也就是尋找相對於此句柄的元素) 。

元素名稱
ElementName string

所定位元素的 Java 名稱。

元素描述
ElementDescription string

所定位元素的 Java 描述 (如果有的話)。

元素角色
ElementRole string

定位元素(如果有)的 Java 角色(例如框架或面板)。

Java桌面元素存在嗎

報告 Java 桌面元素是否存在,並提供一些基本元素內容。

參數

名稱 機碼 必要 類型 Description
搜尋 UIA 元素名稱
SearchUIAElementName string

要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋 UIA 元素類別名稱
SearchUIAElementClassName string

要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋 UIA 元素當地語系化控制項類型
SearchUIAElementLocalizedControlType string

要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋程序識別碼
SearchProcessID integer

執行中進程的進程識別碼。 這可以作為「執行處理程序」動作的輸出擷取。

搜尋子元素
SearchChildElements boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

包含子程序
IncludeChildProcesses boolean

如果設定為 true 並指定「搜尋程序 ID」,則該程序 ID 的子程序會包含在搜尋中。 這對於 Java 來說很常見,因為啟動器 EXE 通常會運行一個子 'Java(w).exe' 進程。 如果設定為 false,則只會傳回符合確切「搜尋程式 ID」的程式。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素存在
ElementExists boolean

如果元素存在,則傳回 true,如果不存在,則傳回 false。

元素 JAB 控點
ElementJABHandle integer

如果找到搜尋元素,這會保留數值元素句柄,可用於進一步的動作,以作為進一步搜尋的「父」句柄 (,也就是尋找相對於此句柄的元素) 。

元素名稱
ElementName string

所定位元素的 Java 名稱。

元素描述
ElementDescription string

所定位元素的 Java 描述 (如果有的話)。

元素角色
ElementRole string

定位元素(如果有)的 Java 角色(例如框架或面板)。

中斷與 Java Access Bridge 的連線

關閉任何執行中的 IA-Connect Java 子系統 (IA-JavaAccessBridge)。

參數

名稱 機碼 必要 類型 Description
停用 Java Access Bridge
DisableJavaAccessBridge boolean

是否應該停用 Java Access Bridge? 根據預設,此設定為「True」。

協助工具檔案路徑
AccessibilityFilepath string

.accessibility.properties 檔案的路徑,可控制是否啟用 Java Access Bridge。 如果您未提供路徑,則預設為 %USERPROFILE%.accessibility.properties。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

依名稱取得 Java 選取狀態

提供子元素名稱,傳回選取範圍中子元素的選取狀態 (通常是清單或下拉式清單中的項目)。 您可以使用動作 '取得 Java 選取元素項目' 來擷取所有選取子元素項目,以檢查其名稱。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

項目名稱
ItemName True string

要選取或取消選取的清單項目名稱。

項目名稱區分大小寫
ItemNameCaseSensitive boolean

如果設定為 'True',則項目名稱搜尋將區分大小寫(例如,它必須與清單項目完全匹配)。 如果設定為 'False' (預設值),則項目名稱搜尋將不區分大小寫。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已選取名稱
NameIsSelected boolean

如果已選取具名選取清單項目,則傳回 true,如果未選取,則傳回 false。

依名稱選取 Java 清單元素

選取具有指定名稱的清單元素。 這通常用於在下拉式清單/功能表項目中選取項目。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

項目名稱
ItemName True string

要選取或取消選取的清單項目名稱。

選擇項目
SelectItem boolean

如果設定為「True」(預設值),則會選取項目。 如果設定為「False」,則會取消選取項目。 這通常僅與多選一起使用。

項目名稱區分大小寫
ItemNameCaseSensitive boolean

如果設定為 'True',則項目名稱搜尋將區分大小寫(例如,它必須與清單項目完全匹配)。 如果設定為 'False' (預設值),則項目名稱搜尋將不區分大小寫。

先清除選擇
ClearSelectionFirst boolean

如果設定為「True」(預設值),則會先清除選取範圍。 這主要用於多選,因為您需要選擇是選擇其他項目還是僅選擇單一項目(先清除)。 如果設定為「False」,則不會先清除選取範圍。

選取 [取得選項清單]
GetListOfOptionsBySelecting boolean

如果設為 'True',則 IA-Connect 代理程式將嘗試依序選取每個選項 (在 JAB 中) 來取得選取範圍中所有選項的清單。 如果設定為 'False' (預設值),則 '通過讀取標籤獲取選項列表' 參數應設置為 'True',否則將不會讀取選項列表。

通過閱讀標籤獲取選項列表
GetListOfOptionsByReadingLabels boolean

如果設定為「True」(預設值),則 IA-Connect 代理程式將嘗試透過讀取子標籤(在JAB樹狀結構中)來取得選取範圍中所有選項的清單。 對於下拉式清單,您幾乎肯定需要將「先展開」參數設定為「True」,因為在清單下拉之前不會公開子元素。 同時將「折疊時間」參數設定為「True」,以便稍後關閉清單。 「透過選取取得選項清單」參數也應設定為「False」,否則此選項將被忽略(因為您無法透過這兩種方法取得清單)。 如果設定為 'False',則「透過選取取得選項清單」參數應設定為 'True',否則不會讀取選項清單。

先展開
ExpandFirst boolean

如果設定為 'true' (預設值),則動作會先嘗試展開清單,再搜尋清單項目元素。 這對於動態清單很有用,因為在清單展開之前,可能不會建立其他清單項目元素。 如果設定為 'false',則不會展開清單。

折疊後
CollapseAfter boolean

如果設定為 true (預設值),則清單將在執行搜尋後摺疊。 如果設定為 false,則不會摺疊清單。

展開和收合之間的秒數
SecondsBetweenExpandCollapse double

展開和摺疊動作之間等待的秒數 (如果這些動作設定為 'True')。 依預設,這是 0.05 (20 毫秒)。

即使處於正確狀態也能用力
ForceEvenIfInCorrectState boolean

如果設定為「True」,則即使已選取元素,也會選取該元素。 如果設定為「False」(預設值),則如果已選取清單元素,IA-Connect 代理程式將不執行任何動作。

失敗時復原
RecoverOnFailure boolean

如果設定為 'True',則如果新選取失敗,將會復原原本選取的清單項目。 例如,如果已選取項目 3,而您嘗試選取項目 90 (不存在),則會重新選取項目 3。 如果設定為「False」,則不會復原最初選取的清單項目。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

依索引取得 Java 選取狀態

透過提供子元素索引,傳回選取範圍中子元素的選取狀態 (通常是清單或下拉式清單中的項目)。 您可以使用動作 '取得 Java 選取元素項目' 來擷取所有選取的子元素項目,以檢查其索引。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

項目索引
ItemIndex True integer

要查詢的清單項目狀態的索引 (從 1 開始)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已選取索引
IndexIsSelected boolean

如果已選取指定索引處的選取清單項目,則傳回 true,如果未選取,則傳回 false。

依索引選取 Java 清單元素

選取符合指定索引的清單元素。 這通常用於在下拉式清單/功能表項目中選取項目。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

項目索引
ItemIndex True integer

要選取或取消選取之清單項目的索引 (從 1 開始)。

選擇項目
SelectItem boolean

如果設定為「True」(預設值),則會選取項目。 如果設定為「False」,則會取消選取項目。 這通常僅與多選一起使用。

先清除選擇
ClearSelectionFirst boolean

如果設定為「True」(預設值),則會先清除選取範圍。 這主要用於多選,因為您需要選擇是選擇其他項目還是僅選擇單一項目(先清除)。 如果設定為「False」,則不會先清除選取範圍。

失敗時復原
RecoverOnFailure boolean

如果設定為 'True',則如果新選取失敗,將會復原原本選取的清單項目。 例如,如果已選取項目 3,而您嘗試選取項目 90 (不存在),則會重新選取項目 3。 如果設定為「False」,則不會復原最初選取的清單項目。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

全域輸入密碼到Java元素中

將滑鼠移至 Java 元素的中心,聚焦它,左鍵按一下,然後按按鍵。 通常與不接受原生 UIA 輸入法的密碼輸入搭配使用。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

焦點元素優先
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)。

按鍵間隔 (以毫秒為單位)
KeyIntervalInMilliseconds integer

每次按鍵之間的毫秒數。

按兩下間隔(以毫秒為單位)
DoubleClickIntervalInMilliseconds integer

如果參數「使用雙擊滑鼠按一下刪除取代現有值」設定為 true,則每次按一下之間的毫秒數。

不要解讀符號
DontInterpretSymbols boolean

「輸入密碼」中的符號不應被解釋為特殊鍵(例如,+ 代表 Shift,^ 代表 Ctrl)? 如果您嘗試輸入實際符號,則應將其設定為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

全域輸入文字到 Java 元素中

將滑鼠移至 Java 元素的中心,聚焦它,左鍵按一下,然後按按鍵。 通常與不接受原生 UIA 輸入法的文字輸入搭配使用。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

焦點元素優先
FocusElement boolean

IA-Connect 應該在全局點擊之前嘗試聚焦元素嗎?

全局鼠標左鍵單擊元素
GlobalMouseClickOnElement boolean

在輸入文字之前,是否應該在元素座標處執行全域滑鼠點擊(以聚焦元素)?

使用雙擊滑鼠刪除取代現有值
ReplaceExistingValueUsingDoubleClickDelete boolean

是否應該透過雙擊滑鼠(突出顯示它)然後刪除來替換任何現有值?

使用 CTRL-A 刪除取代現有值
ReplaceExistingValueUsingCTRLADelete boolean

是否應該通過按 Ctrl-A (突出顯示所有)然後刪除來替換任何現有值? 某些元素可能不支援使用 Ctrl-A 突出顯示,在這種情況下,應嘗試「使用雙擊滑鼠刪除取代現有值」的替代選項。

要輸入的文字
TextToInput string

使用鍵盤進行全域輸入的文字值。

使用傳送金鑰事件
SendKeyEvents boolean

如果設定為 true,則會使用傳送金鑰事件 (將模擬擊鍵傳送至作業系統的較低層級 API)。 如果設定為 false,則會改用傳送金鑰 (將擊鍵傳送至焦點元素的較高層級 API)。

按鍵間隔 (以毫秒為單位)
KeyIntervalInMilliseconds integer

每次按鍵之間的毫秒數。

按兩下間隔(以毫秒為單位)
DoubleClickIntervalInMilliseconds integer

如果參數「使用雙擊滑鼠按一下刪除取代現有值」設定為 true,則每次按一下之間的毫秒數。

不要解讀符號
DontInterpretSymbols boolean

「要輸入的文字」中的符號不應被解釋為特殊鍵(例如,+ 代表 Shift,^ 代表 Ctrl)? 如果您嘗試輸入實際符號,則應將其設定為 true。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

全局滑鼠中鍵點擊Java元素

將滑鼠移至 Java 元素的中心,然後按一下滑鼠中鍵。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

按一下偏移 X
ClickOffsetX integer

要偏移點擊動作的 X 像素數。 此參數同時支援正 (右) 和負 (左) 偏移值。

按一下偏移 Y
ClickOffsetY integer

要偏移點擊動作的 Y 像素數。 此參數支援正(向下)和負(向上)偏移值。

相對於
OffsetRelativeTo string

要偏移的元素的相對位置 (中心/中心/中間、左、右、上、下、左上、右上、左下、右下)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

全局滑鼠右鍵點擊 Java 元素

將滑鼠移至 Java 元素的中心,然後按一下滑鼠右鍵。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

按一下偏移 X
ClickOffsetX integer

要偏移點擊動作的 X 像素數。 此參數同時支援正 (右) 和負 (左) 偏移值。

按一下偏移 Y
ClickOffsetY integer

要偏移點擊動作的 Y 像素數。 此參數支援正(向下)和負(向上)偏移值。

相對於
OffsetRelativeTo string

要偏移的元素的相對位置 (中心/中心/中間、左、右、上、下、左上、右上、左下、右下)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

全局雙擊滑鼠左鍵 Java 元素

將滑鼠移至 Java 元素的中心,然後按兩下滑鼠左鍵。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

按一下偏移 X
ClickOffsetX integer

要偏移點擊動作的 X 像素數。 此參數同時支援正 (右) 和負 (左) 偏移值。

按一下偏移 Y
ClickOffsetY integer

要偏移點擊動作的 Y 像素數。 此參數支援正(向下)和負(向上)偏移值。

相對於
OffsetRelativeTo string

要偏移的元素的相對位置 (中心/中心/中間、左、右、上、下、左上、右上、左下、右下)。

延遲(以毫秒為單位)
DelayInMilliseconds integer

第一次和第二次點擊之間的延遲(以毫秒(千分之一秒)為單位。 預設值為 10 毫秒。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

全局鼠標單擊 Java 表格單元格

將滑鼠移至 Java 表格儲存格的中心,然後按一下指定的滑鼠按鈕。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

儲存格列索引
RowIndex True integer

表格中儲存格的資料列索引,從 1 開始。

儲存格資料行索引
ColumnIndex True integer

表格中儲存格的直欄索引,從 1 開始。

列舉檢視區
EnumerateViewport boolean

視埠元素通常包含表格,並代表表格的可見區域。 如果設定為「True」(預設值),則 IA-Connect 代理程式將嘗試透過計算檢視區的大小來偵測表格可見邊界和每個角落儲存格的索引。 這可讓您判斷目前在螢幕上顯示表格的哪些元件。 如果設定為 'False',則不會填入視埠座標。

處理視埠父系
ProcessViewportParents boolean

如果設定為 'True' (預設值),則也會處理視埠的父元素,以協助調整視埠的可見大小。 如果它嵌入到另一個視埠中,這非常有用。 如果設定為 'False',則不會處理視埠父元素。

要處理的最大視埠父系
MaxViewportParentsToProcess integer

列舉檢視區時要處理的父元素數目上限。 依預設,此值會設定為 50。

要考慮的檢視埠父元素角色
ViewportParentElementRolesToConsider string

列舉以計算檢視區大小時要考慮的檢視區父元素的角色。 這可用來排除大小小於視埠的父元素,這可能會扭曲大小計算,例如頁面標籤。 依預設,這些是:面板、視埠、分層窗格、根窗格。

視埠左邊界
ViewportLeftMargin integer

列舉檢視區的左內邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

檢視區上邊界
ViewportTopMargin integer

列舉檢視區的頂端內部邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

視埠右邊距
ViewportRightMargin integer

列舉檢視區的右內邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

視埠底部邊界
ViewportBottomMargin integer

列舉檢視區的底部內部邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

滑鼠按鈕
MouseButton True integer

按一下表格儲存格時要使用的滑鼠按鈕。 左 = 0,右 = 1,中 = 2,雙左 = 3。

按一下偏移 X
ClickOffsetX integer

要偏移點擊動作的 X 像素數。 此參數同時支援正 (右) 和負 (左) 偏移值。

按一下偏移 Y
ClickOffsetY integer

要偏移點擊動作的 Y 像素數。 此參數支援正(向下)和負(向上)偏移值。

相對於
OffsetRelativeTo string

要偏移的元素的相對位置 (中心/中心/中間、左、右、上、下、左上、右上、左下、右下)。

延遲(以毫秒為單位)
DelayInMilliseconds integer

點按之間等待的秒數,預設為 0.05 (20 毫秒)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

全局鼠標左鍵單擊 Java 元素

將滑鼠移至 Java 元素的中心,然後按一下滑鼠左鍵。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

按一下偏移 X
ClickOffsetX integer

要偏移點擊動作的 X 像素數。 此參數同時支援正 (右) 和負 (左) 偏移值。

按一下偏移 Y
ClickOffsetY integer

要偏移點擊動作的 Y 像素數。 此參數支援正(向下)和負(向上)偏移值。

相對於
OffsetRelativeTo string

要偏移的元素的相對位置 (中心/中心/中間、左、右、上、下、左上、右上、左下、右下)。

按一下元素的次數
NumberOfTimesToClickElement integer

按一下元素的次數,預設為 1。

點擊之間的等待秒數
SecondsToWaitBetweenClicks double

點擊之間等待的秒數,預設為 0。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

取得 Java 元素值

傳回元素的值。 值通常與文字輸入區域相關聯,但許多元素可以具有此屬性。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素現值
ElementCurrentValue string

元素的目前值。

元素最大值
ElementMaximumValue string

元素的最大值 (如果指定)。

元素最小值
ElementMinimumValue string

元素的最小值 (如果指定)。

取得 Java 元素屬性

傳回 Java 元素的所有 Java 屬性。 如果您不確定哪個欄位包含所需的屬性值,這會很有用。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

最大字串長度
MaxStringLength integer

描述欄位的長度上限。 這有時可能包含大量文本,因此設置最大值可以提高搜索速度。 依預設,沒有字串長度上限,因此會傳回完整的說明。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素 JAB 控點
ElementJABHandle integer

如果找到搜尋元素,這會保留數值元素句柄,可用於進一步的動作,以作為進一步搜尋的「父」句柄 (,也就是尋找相對於此句柄的元素) 。

元素 VMID
ElementVMID integer

執行 Java 程式之 Java 虛擬機器的 ID。

元素名稱
ElementName string

所定位元素的 Java 名稱。

元素描述
ElementDescription string

所定位元素的 Java 描述 (如果有的話)。

元素角色
ElementRole string

定位元素(如果有)的 Java 角色(例如框架或面板)。

元素狀態
ElementStates string

Java 元素在代理程式會話的語言環境中支援的狀態(例如可聚焦、可見)。

元素狀態en_US
ElementStates_en_US string

Java 元素在en_US語言環境中支援的狀態(例如可聚焦、可見)。

元素左邊緣
ElementLeftEdge integer

Java 元素或視窗的左邊緣與顯示器的左邊緣之間的距離 (以像素為單位)。

元素頂部邊緣
ElementTopEdge integer

Java 元素或視窗的頂端邊緣與顯示器的頂端邊緣之間的距離 (以像素為單位)。

元素寬度
ElementWidth integer

Java 元素的寬度 (以像素為單位)。

元素高度
ElementHeight integer

Java 元素的高度(以像素為單位)。

元素右邊緣
ElementRightEdge integer

Java 元素或視窗的右邊緣與顯示器的左邊緣之間的距離 (以像素為單位)。

元素底部邊緣
ElementBottomEdge integer

Java 元素或視窗的底部邊緣與顯示器的頂部邊緣之間的距離(以像素為單位)。

是元件元素
IsComponentElement boolean

如果 Java 元素是容器,則傳回 true,如果不是,則傳回 false。

是動作元素
IsActionElement boolean

如果 Java 元素是動作元素,則傳回 true,如果不是,則傳回 false。

是選取元素
IsSelectionElement boolean

如果 Java 元素是選取範圍,則傳回 true,如果不是,則傳回 false。

是文字元素
IsTextElement boolean

如果 Java 元素是文字元素,則傳回 true,如果不是,則傳回 false。

已啟用
IsEnabled boolean

如果已啟用 Java 元素,則傳回 true,如果未啟用,則傳回 false。 停用的元素通常是可見的,但無法與之互動。

可見
IsVisible boolean

如果 Java 元素可見,則傳回 true,如果不可見,則傳回 false。

正在顯示
IsShowing boolean

如果 Java 元素顯示,則傳回 true,如果未顯示,則傳回 false。

不透明
IsOpaque boolean

如果 Java 元素不透明,則傳回 true,如果不是,則傳回 false。

可聚焦
IsFocusable boolean

如果 Java 元素由鍵盤聚焦,則傳回 true,如果沒有,則傳回 false。 這可能用途有限,因為大多數元素都是鍵盤可聚焦的。

可編輯
IsEditable boolean

如果 Java 元素可編輯,則傳回 true,如果不是,則傳回 false。

是單線
IsSingleLine boolean

如果 Java 元素是單行,則傳回 true,如果不是,則傳回 false。

可調整大小
IsResizable boolean

如果 Java 元素可調整大小,則傳回 true,如果不是,則傳回 false。

是模態的
IsModal boolean

如果 Java 元素是模態,則傳回 true,如果不是,則傳回 false。 模態元素將阻止主應用程式窗口,阻止您與其互動。

被折疊
IsCollapsed boolean

如果 Java 元素已摺疊,則傳回 true,如果未摺疊,則傳回 false。

可選擇
IsSelectable boolean

如果 Java 元素是可選取的,則傳回 true,如果無法選取,則傳回 false。

已選取
IsSelected boolean

如果選取 Java 元素,則傳回 true,如果未選取,則傳回 false。

是垂直的
IsVertical boolean

如果 Java 元素是垂直的,則傳回 true,如果不是,則傳回 false。

是水平的
IsHorizontal boolean

如果 Java 元素是水平的,則傳回 true,如果不是,則傳回 false。

處於活動狀態
IsActive boolean

如果 Java 元素處於作用中狀態,則傳回 true,如果不是,則傳回 false。

已勾選
IsChecked boolean

如果檢查了 Java 元素,則傳回 true,如果未檢查,則傳回 false。

專注
IsFocussed boolean

如果 Java 元素具有鍵盤焦點,則傳回 true。 如果沒有,則為假。

展開
IsExpanded boolean

如果 Java 元素已展開,則傳回 true,如果未展開,則傳回 false。

其他元素狀態en_US
AdditionalStates_en_US string

元素支援的任何其他狀態都會在此處以en_US語言環境列出,例如可多選、暫時性。

父項中的索引
IndexInParent integer

目前父元素內的元素索引。

元素子計數
ChildrenCount integer

元素所具有的子元素數目。

元素深度
ElementDepth integer

最上層父視窗中元素的深度。

取得 Java 元素文字值

傳回 Java 元素的文字值。 文字值通常與文字元素相關聯,但許多元素可以具有此屬性。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素文字值
ElementTextValue string

元素的文字值。

取得 Java 元素的動作

傳回 Java 元素的可存取動作。 然後,可以使用動作名稱作為動作「對 Java 元素執行動作」的輸入,例如「按一下」或「全選」,對元素執行這些可存取的動作。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
無障礙動作
AccessibleActions string

搜尋元素的所有可存取動作清單,例如「按一下」。

取得 Java 子元素屬性

傳回由索引指定的特定 Java 子元素的所有屬性。 如果您不確定哪個欄位包含所需的屬性值,這會很有用。

參數

名稱 機碼 必要 類型 Description
搜尋元素 JAB 控點
SearchElementJABHandle True integer

您要傳回子元素屬性之元素的元素控制碼。 這可以使用“獲取 Java 元素屬性”或其他返回元素句柄的搜索來定位。

搜尋子索引
SearchChildIndex True integer
最大字串長度
MaxStringLength integer

描述欄位的長度上限。 這有時可能包含大量文本,因此設置最大值可以提高搜索速度。 依預設,沒有字串長度上限,因此會傳回完整的說明。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素 JAB 控點
ElementJABHandle integer

如果找到搜尋元素,這會保留數值元素句柄,可用於進一步的動作,以作為進一步搜尋的「父」句柄 (,也就是尋找相對於此句柄的元素) 。

元素 VMID
ElementVMID integer

執行 Java 程式之 Java 虛擬機器的 ID。

元素名稱
ElementName string

所定位元素的 Java 名稱。

元素描述
ElementDescription string

所定位元素的 Java 描述 (如果有的話)。

元素角色
ElementRole string

定位元素(如果有)的 Java 角色(例如框架或面板)。

元素狀態
ElementStates string

Java 元素在代理程式會話的語言環境中支援的狀態(例如可聚焦、可見)。

元素狀態en_US
ElementStates_en_US string

Java 元素在en_US語言環境中支援的狀態(例如可聚焦、可見)。

元素左邊緣
ElementLeftEdge integer

Java 元素或視窗的左邊緣與顯示器的左邊緣之間的距離 (以像素為單位)。

元素頂部邊緣
ElementTopEdge integer

Java 元素或視窗的頂端邊緣與顯示器的頂端邊緣之間的距離 (以像素為單位)。

元素右邊緣
ElementRightEdge integer

Java 元素或視窗的右邊緣與顯示器的左邊緣之間的距離 (以像素為單位)。

元素底部邊緣
ElementBottomEdge integer

Java 元素或視窗的底部邊緣與顯示器的頂部邊緣之間的距離(以像素為單位)。

元素寬度
ElementWidth integer

Java 元素的寬度 (以像素為單位)。

元素高度
ElementHeight integer

Java 元素的高度(以像素為單位)。

是元件元素
IsComponentElement boolean

如果 Java 元素是容器,則傳回 true,如果不是,則傳回 false。

是動作元素
IsActionElement boolean

如果 Java 元素是動作元素,則傳回 true,如果不是,則傳回 false。

是選取元素
IsSelectionElement boolean

如果 Java 元素是選取範圍,則傳回 true,如果不是,則傳回 false。

是文字元素
IsTextElement boolean

如果 Java 元素是文字元素,則傳回 true,如果不是,則傳回 false。

已啟用
IsEnabled boolean

如果已啟用 Java 元素,則傳回 true,如果未啟用,則傳回 false。 停用的元素通常是可見的,但無法與之互動。

可見
IsVisible boolean

如果 Java 元素可見,則傳回 true,如果不可見,則傳回 false。

正在顯示
IsShowing boolean

如果 Java 元素顯示,則傳回 true,如果未顯示,則傳回 false。

不透明
IsOpaque boolean

如果 Java 元素不透明,則傳回 true,如果不是,則傳回 false。

可聚焦
IsFocusable boolean

如果 Java 元素由鍵盤聚焦,則傳回 true,如果沒有,則傳回 false。 這可能用途有限,因為大多數元素都是鍵盤可聚焦的。

可編輯
IsEditable boolean

如果 Java 元素可編輯,則傳回 true,如果不是,則傳回 false。

是單線
IsSingleLine boolean

如果 Java 元素是單行,則傳回 true,如果不是,則傳回 false。

可調整大小
IsResizable boolean

如果 Java 元素可調整大小,則傳回 true,如果不是,則傳回 false。

是模態的
IsModal boolean

如果 Java 元素是模態,則傳回 true,如果不是,則傳回 false。 模態元素將阻止主應用程式窗口,阻止您與其互動。

被折疊
IsCollapsed boolean

如果 Java 元素已摺疊,則傳回 true,如果未摺疊,則傳回 false。

可選擇
IsSelectable boolean

如果 Java 元素是可選取的,則傳回 true,如果無法選取,則傳回 false。

已選取
IsSelected boolean

如果選取 Java 元素,則傳回 true,如果未選取,則傳回 false。

是垂直的
IsVertical boolean

如果 Java 元素是垂直的,則傳回 true,如果不是,則傳回 false。

是水平的
IsHorizontal boolean

如果 Java 元素是水平的,則傳回 true,如果不是,則傳回 false。

處於活動狀態
IsActive boolean

如果 Java 元素處於作用中狀態,則傳回 true,如果不是,則傳回 false。

已勾選
IsChecked boolean

如果檢查了 Java 元素,則傳回 true,如果未檢查,則傳回 false。

專注
IsFocussed boolean

如果 Java 元素具有鍵盤焦點,則傳回 true。 如果沒有,則為假。

展開
IsExpanded boolean

如果 Java 元素已展開,則傳回 true,如果未展開,則傳回 false。

其他元素狀態en_US
AdditionalStates_en_US string

元素支援的任何其他狀態都會在此處以en_US語言環境列出,例如可多選、暫時性。

父項中的索引
IndexInParent integer

目前父元素內的元素索引。

元素子計數
ChildrenCount integer

元素所具有的子元素數目。

元素深度
ElementDepth integer

最上層父視窗中元素的深度。

取得 Java 桌面元素

傳回桌面上的 Java 應用程式視窗和對話方塊清單。 您必須先連線至 Java 存取橋接器。

參數

名稱 機碼 必要 類型 Description
搜尋元素當地語系化控制項類型
SearchElementLocalizedControlType string

要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋程序識別碼
SearchProcessID integer

執行中進程的進程識別碼。 這可以作為「執行處理程序」動作的輸出擷取。

第一個要退貨的商品
FirstItemToReturn integer

第一個要傳回的項目的元素索引,從1開始。 如果您想要以相反的順序傳回元素 (從樹狀結構底部開始),您也可以指定從 -1 開始的負索引。 例如,索引 -10 會傳回底部的第十個項目。

退貨項目上限
MaxItemsToReturn integer

要傳回的元素數目上限。 此參數可用來傳回較小區塊中的大型元素集,例如大型資料表。 您可以一次傳回 500 列,而不是嘗試傳回整個資料表,這可能會導致極大的資料表逾時。

搜尋子元素
SearchChildElements boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大字串長度
MaxStringLength integer

描述欄位的長度上限。 這有時可能包含大量文本,因此設置最大值可以提高搜索速度。 依預設,沒有字串長度上限,因此會傳回完整的說明。

包含子程序
IncludeChildProcesses boolean

如果設定為 true 並指定「搜尋程序 ID」,則該程序 ID 的子程序會包含在搜尋中。 這對於 Java 來說很常見,因為啟動器 EXE 通常會運行一個子 'Java(w).exe' 進程。 如果設定為 false,則只會傳回符合確切「搜尋程式 ID」的程式。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
找到的元素數量
NumberOfElementsFound integer

找到符合搜尋條件的元素數。

傳回的元素數目
NumberOfElementsReturned integer

從搜尋傳回的元素數目。 如果將「要退回的項目數目上限」設定為較低的數字,則可能會低於找到的元素數量。

Java 桌面元素 JSON
JavaDesktopElementsJSON string

找到符合搜尋準則的 Java 桌面元素的元素內容,採用 JSON 格式。

取得 Java 父元素屬性

傳回 Java 元素的父元素屬性。 此動作只會傳回直接父元素的屬性,不會搜尋元素樹的整個高度。

參數

名稱 機碼 必要 類型 Description
搜尋元素 JAB 控點
SearchElementJABHandle True integer

您要傳回父元素屬性之元素的元素控制碼。 這可以使用“獲取 Java 元素屬性”或其他返回元素句柄的搜索來定位。

最大字串長度
MaxStringLength integer

描述欄位的長度上限。 這有時可能包含大量文本,因此設置最大值可以提高搜索速度。 依預設,沒有字串長度上限,因此會傳回完整的說明。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素 JAB 控點
ElementJABHandle integer

如果找到搜尋元素,這會保留數值元素句柄,可用於進一步的動作,以作為進一步搜尋的「父」句柄 (,也就是尋找相對於此句柄的元素) 。

元素 VMID
ElementVMID integer

執行 Java 程式之 Java 虛擬機器的 ID。

元素名稱
ElementName string

所定位元素的 Java 名稱。

元素描述
ElementDescription string

所定位元素的 Java 描述 (如果有的話)。

元素角色
ElementRole string

定位元素(如果有)的 Java 角色(例如框架或面板)。

元素狀態
ElementStates string

Java 元素在代理程式會話的語言環境中支援的狀態(例如可聚焦、可見)。

元素狀態en_US
ElementStates_en_US string

Java 元素在en_US語言環境中支援的狀態(例如可聚焦、可見)。

元素左邊緣
ElementLeftEdge integer

Java 元素或視窗的左邊緣與顯示器的左邊緣之間的距離 (以像素為單位)。

元素頂部邊緣
ElementTopEdge integer

Java 元素或視窗的頂端邊緣與顯示器的頂端邊緣之間的距離 (以像素為單位)。

元素右邊緣
ElementRightEdge integer

Java 元素或視窗的右邊緣與顯示器的左邊緣之間的距離 (以像素為單位)。

元素底部邊緣
ElementBottomEdge integer

Java 元素或視窗的底部邊緣與顯示器的頂部邊緣之間的距離(以像素為單位)。

元素寬度
ElementWidth integer

Java 元素的寬度 (以像素為單位)。

元素高度
ElementHeight integer

Java 元素的高度(以像素為單位)。

是元件元素
IsComponentElement boolean

如果 Java 元素是容器,則傳回 true,如果不是,則傳回 false。

是動作元素
IsActionElement boolean

如果 Java 元素是動作元素,則傳回 true,如果不是,則傳回 false。

是選取元素
IsSelectionElement boolean

如果 Java 元素是選取範圍,則傳回 true,如果不是,則傳回 false。

是文字元素
IsTextElement boolean

如果 Java 元素是文字元素,則傳回 true,如果不是,則傳回 false。

已啟用
IsEnabled boolean

如果已啟用 Java 元素,則傳回 true,如果未啟用,則傳回 false。 停用的元素通常是可見的,但無法與之互動。

可見
IsVisible boolean

如果 Java 元素可見,則傳回 true,如果不可見,則傳回 false。

正在顯示
IsShowing boolean

如果 Java 元素顯示,則傳回 true,如果未顯示,則傳回 false。

不透明
IsOpaque boolean

如果 Java 元素不透明,則傳回 true,如果不是,則傳回 false。

可聚焦
IsFocusable boolean

如果 Java 元素由鍵盤聚焦,則傳回 true,如果沒有,則傳回 false。 這可能用途有限,因為大多數元素都是鍵盤可聚焦的。

可編輯
IsEditable boolean

如果 Java 元素可編輯,則傳回 true,如果不是,則傳回 false。

是單線
IsSingleLine boolean

如果 Java 元素是單行,則傳回 true,如果不是,則傳回 false。

可調整大小
IsResizable boolean

如果 Java 元素可調整大小,則傳回 true,如果不是,則傳回 false。

是模態的
IsModal boolean

如果 Java 元素是模態,則傳回 true,如果不是,則傳回 false。 模態元素將阻止主應用程式窗口,阻止您與其互動。

被折疊
IsCollapsed boolean

如果 Java 元素已摺疊,則傳回 true,如果未摺疊,則傳回 false。

可選擇
IsSelectable boolean

如果 Java 元素是可選取的,則傳回 true,如果無法選取,則傳回 false。

已選取
IsSelected boolean

如果選取 Java 元素,則傳回 true,如果未選取,則傳回 false。

是垂直的
IsVertical boolean

如果 Java 元素是垂直的,則傳回 true,如果不是,則傳回 false。

是水平的
IsHorizontal boolean

如果 Java 元素是水平的,則傳回 true,如果不是,則傳回 false。

處於活動狀態
IsActive boolean

如果 Java 元素處於作用中狀態,則傳回 true,如果不是,則傳回 false。

已勾選
IsChecked boolean

如果檢查了 Java 元素,則傳回 true,如果未檢查,則傳回 false。

專注
IsFocussed boolean

如果 Java 元素具有鍵盤焦點,則傳回 true。 如果沒有,則為假。

展開
IsExpanded boolean

如果 Java 元素已展開,則傳回 true,如果未展開,則傳回 false。

其他元素狀態en_US
AdditionalStates_en_US string

元素支援的任何其他狀態都會在此處以en_US語言環境列出,例如可多選、暫時性。

父項中的索引
IndexInParent integer

目前父元素內的元素索引。

元素子計數
ChildrenCount integer

元素所具有的子元素數目。

元素深度
ElementDepth integer

最上層父視窗中元素的深度。

取得 Java 表格儲存格屬性

傳回 Java 表格元素內指定儲存格的內容和內容。 這是一個包含行、列、標題和單元格(即表格)的元素。 您可以選擇性地指定是否要列舉檢視區來判斷儲存格目前在螢幕上可見,且其座標是否為座標。 視口元素通常包含表格(例如它是表格的父元素)並表示表格的可見區域。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

儲存格列索引
RowIndex True integer

表格中儲存格的資料列索引,從 1 開始。

儲存格資料行索引
ColumnIndex True integer

表格中儲存格的直欄索引,從 1 開始。

返回句柄
ReturnJABHandle boolean

如果設定為 true,則會傳回儲存格的元素控制碼。

列舉檢視區
EnumerateViewport boolean

視埠元素通常包含表格,並代表表格的可見區域。 如果設定為「True」(預設值),則 IA-Connect 代理程式將嘗試透過計算檢視區的大小來偵測表格可見邊界和每個角落儲存格的索引。 這可讓您判斷目前在螢幕上顯示表格的哪些元件。 如果設定為 'False',則不會填入視埠座標。

處理視埠父系
ProcessViewportParents boolean

如果設定為 'True' (預設值),則也會處理視埠的父元素,以協助調整視埠的可見大小。 如果它嵌入到另一個視埠中,這非常有用。 如果設定為 'False',則不會處理視埠父元素。

要處理的最大視埠父系
MaxViewportParentsToProcess integer

列舉檢視區時要處理的父元素數目上限。 依預設,此值會設定為 50。

要考慮的檢視埠父元素角色
ViewportParentElementRolesToConsider string

列舉以計算檢視區大小時要考慮的檢視區父元素的角色。 這可用來排除大小小於視埠的父元素,這可能會扭曲大小計算,例如頁面標籤。 依預設,這些是:面板、視埠、分層窗格、根窗格。

視埠左邊界
ViewportLeftMargin integer

列舉檢視區的左內邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

檢視區上邊界
ViewportTopMargin integer

列舉檢視區的頂端內部邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

視埠右邊距
ViewportRightMargin integer

列舉檢視區的右內邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

視埠底部邊界
ViewportBottomMargin integer

列舉檢視區的底部內部邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
儲存格索引
CellIndex integer

表格中的儲存格索引。 第一行中的第一個單元格的索引將為 1,該行中的每個單元格增加 1。 因此,在5行3列的表格中,第二行中的第一個儲存格的索引為4。

儲存格列範圍
RowExtent integer

儲存格跨越的列數。 除非儲存格跨多列合併,否則這通常是 1。

儲存格資料行範圍
ColumnExtent integer

儲存格跨越的資料行數。 除非儲存格合併到多個欄中,否則這通常是 1。

儲存格已選取
IsSelected boolean

傳回 true,儲存格目前已選取,如果未選取,則傳回 false。

儲存格內容
CellContents string

儲存格的內容。

儲存格左邊緣
CellLeftEdge integer

儲存格元素左邊緣與顯示器左邊緣之間的距離 (以像素為單位)。

儲存格頂部邊緣
CellTopEdge integer

儲存格元素的頂端邊緣與顯示器的頂端邊緣之間的距離 (以像素為單位)。

儲存格右邊緣
CellRightEdge integer

儲存格元素右邊緣與顯示器左邊緣之間的距離 (以像素為單位)。

儲存格底部邊緣
CellBottomEdge integer

儲存格元素底部邊緣與顯示器頂部邊緣之間的距離(以像素為單位)。

儲存格寬度
CellWidth integer

儲存格元素的寬度 (以像素為單位)。

儲存格高度
CellHeight integer

儲存格元素的高度 (以像素為單位)。

輸入格在螢幕上可見
CellOnscreen boolean

如果儲存格在螢幕上可見,則傳回 true,如果沒有,則傳回 false。

可見的結果是肯定的
CellVisibleResultIsCertain boolean

如果「儲存格在螢幕上可見」結果確定,則傳回 true。 如果無法計算 4 個父表界限中的任何一個,則會設定為 'False'。

儲存格 JAB 句柄
CellJABHandle integer

表格儲存格的元素控點。

取得 Java 表格內容

傳回 Java 表格元素的內容。 這是一個包含行、列、標題和單元格(即表格)的元素。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要返回的第一列
FirstRowToReturn integer

要傳回的第一列索引。 依預設,此值會設定為 1。

傳回的列數上限
MaxRowsToReturn integer

要傳回的列數上限。 依預設,會傳回所有資料列。

要傳回的第一欄
FirstColumnToReturn integer

要傳回的第一欄的索引。 依預設,此值會設定為 1。

傳回的資料行數目上限
MaxColumnsToReturn integer

要傳回的資料行數目上限。 依預設,會傳回所有資料行。

使用表格中的欄標頭
UseColumnHeadersFromTable boolean

如果設為 'True' ,則 IA-Connect 代理程式會嘗試傳回輸出集合直欄,以符合 Java 表格中的直欄名稱。 如果設定為 'False' (預設值),則資料行標頭將在集合中稱為 'Column_N' (因為集合不能有空白名稱) 。

傳回輸出集合中的資料列索引
ReturnRowIndexInOutputCollection boolean

如果設定為 'True' (預設值),則 IA-Connect 代理程式會將輸出集合中的資料列索引傳回為其他資料行。 根據預設,資料列索引資料行會稱為 'Row_index',但可以透過在 '要儲存資料列索引的資料行名稱] 參數中傳遞資料行名稱來變更。 如果您打算篩選輸出集合,並追蹤篩選結果與哪一列相關,這很有用。 如果設定為 'False',則不會傳回任何資料列索引資料行。

要儲存資料列索引的資料行名稱
NameOfColumnToStoreRowIndex string

如果 'Return row index in output collection' 設定為 'True',則您可以在此處提供值來覆寫預設資料行名稱 '_Row_Index'。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
表格中的列數
NumberOfRowsInTable integer

表格中的列數。

表格中的欄數
NumberOfColumnsInTable integer

表格中的欄數。

選取的資料列數目
NumberOfSelectedRows integer

目前選取的列數。

選取的資料行數目
NumberOfSelectedColumns integer

目前選取的欄數。

傳回的列數
NumberOfRowsReturned integer

傳回的資料列數目,如果將「傳回的列數上限」設定為較低的數字,則可能會低於找到的資料列數目。

傳回的資料行數目
NumberOfColumnsReturned integer

傳回的資料行數目,如果將「要傳回的資料行數目上限」設定為較低的數字,則可能會低於找到的資料行數目。

表格內容JSON
TableContentsJSON string

表格元素的內容,採用 JSON 格式。 如果「使用表格中的資料行標頭」設定為true,則此集合的資料行名稱將與表格元素的資料行名稱相符。 如果列名稱為空白,則會在集合中稱為「Column_N」(因為集合不能有空白名稱)。 如果資料行名稱是重複的,則會在名稱後附加 '_N' (因為集合不能有重複的資料行名稱)。

取得 Java 表格屬性

傳回 Java 表格元素的屬性。 這是一個包含行、列、標題和單元格(即表格)的元素。 您可以選擇性地指定是否要列舉檢視區來判斷目前在畫面上顯示的資料表哪些元件。 視口元素通常包含表格(例如它是表格的父元素)並表示表格的可見區域。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

列舉檢視區
EnumerateViewport boolean

視埠元素通常包含表格,並代表表格的可見區域。 如果設定為「True」(預設值),則 IA-Connect 代理程式將嘗試透過計算檢視區的大小來偵測表格可見邊界和每個角落儲存格的索引。 這可讓您判斷目前在螢幕上顯示表格的哪些元件。 如果設定為 'False',則不會填入視埠座標。

處理視埠父系
ProcessViewportParents boolean

如果設定為 'True' (預設值),則也會處理視埠的父元素,以協助調整視埠的可見大小。 如果它嵌入到另一個視埠中,這非常有用。 如果設定為 'False',則不會處理視埠父元素。

要處理的最大視埠父系
MaxViewportParentsToProcess integer

列舉檢視區時要處理的父元素數目上限。 依預設,此值會設定為 50。

要考慮的檢視埠父元素角色
ViewportParentElementRolesToConsider string

列舉以計算檢視區大小時要考慮的檢視區父元素的角色。 這可用來排除大小小於視埠的父元素,這可能會扭曲大小計算,例如頁面標籤。 依預設,這些是:面板、視埠、分層窗格、根窗格。

視埠左邊界
ViewportLeftMargin integer

列舉檢視區的左內邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

檢視區上邊界
ViewportTopMargin integer

列舉檢視區的頂端內部邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

視埠右邊距
ViewportRightMargin integer

列舉檢視區的右內邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

視埠底部邊界
ViewportBottomMargin integer

列舉檢視區的底部內部邊界。 此值可用來排除任何可能僅顯示單一或兩個像素且幾乎完全在螢幕外的儲存格。 依預設,此值設定為 2,只有在您嘗試影響 IA-Connect 代理程式傳回的資料時,才應增加此值。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
列數
NumberOfRows integer

表格中的列數。

欄數
NumberOfColumns integer

表格中的欄數。

選取的資料列數目
NumberOfSelectedRows integer

目前選取的列數。

選取的資料行數目
NumberOfSelectedColumns integer

目前選取的欄數。

列標題中的列數
NumberOfRowsInRowHeader integer

列標頭中的列數。 這通常是 0,因為表格很少有列標頭。

欄標題中的欄數
NumberOfColumnsInColumnHeader integer

欄標題中的欄數。

視埠位於
ViewportLocated boolean

如果已找到檢視區,則傳回 true,如果找不到,則傳回 false。 如果這是 'True',則會傳回視埠座標。

視埠左邊緣
ViewportLeftEdge integer

檢視區元素左邊緣與顯示器左邊緣之間的距離 (以像素為單位)。

視埠頂部邊緣
ViewportTopEdge integer

視埠元素的頂端邊緣與顯示器的頂端邊緣之間的距離 (以像素為單位)。

視口寬度
ViewportWidth integer

視埠元素的寬度 (以像素為單位)。

視埠高度
ViewportHeight integer

視埠元素的高度 (以像素為單位)。

視埠右邊緣
ViewportRightEdge integer

檢視區元素的右邊緣與顯示器的左邊緣之間的距離 (以像素為單位)。

視埠底部邊緣
ViewportBottomEdge integer

視埠元素底部邊緣與顯示器頂部邊緣之間的距離 (以像素為單位)。

父項中左上方可見的儲存格索引
TopLeftVisibleCellIndexInParent integer

表格中左上方可見儲存格的儲存格索引。 第一行中的第一個單元格的索引將為 1,該行中的每個單元格增加 1。 因此,在5行3列的表格中,第二行中的第一個儲存格的索引為4。

左上方可見列索引
TopLeftVisibleCellRowIndex integer

表格中左上方可見儲存格的資料列索引。

左上方可見欄索引
TopLeftVisibleCellColumnIndex integer

表格中左上方可見儲存格的資料行索引。

父項中右上方可見的儲存格索引
TopRightVisibleCellIndexInParent integer

表格中右上方可見儲存格的儲存格索引。 第一行中的第一個單元格的索引將為 1,該行中的每個單元格增加 1。 因此,在5行3列的表格中,第二行中的第一個儲存格的索引為4。

右上方可見列索引
TopRightVisibleCellRowIndex integer

表格中右上方可見儲存格的資料列索引。

右上方可見欄索引
TopRightVisibleCellColumnIndex integer

表格中右上方可見儲存格的資料行索引。

父項中左下角可見的儲存格索引
BottomLeftVisibleCellIndexInParent integer

表格中左下角可見儲存格的儲存格索引。 第一行中的第一個單元格的索引將為 1,該行中的每個單元格增加 1。 因此,在5行3列的表格中,第二行中的第一個儲存格的索引為4。

左下角可見列索引
BottomLeftVisibleCellRowIndex integer

表格中左下角可見儲存格的資料列索引。

左下角可見欄索引
BottomLeftVisibleCellColumnIndex integer

表格中左下角可見儲存格的資料行索引。

父項中右下角可見的儲存格索引
BottomRightVisibleCellIndexInParent integer

表格中右下角可見儲存格的儲存格索引。 第一行中的第一個單元格的索引將為 1,該行中的每個單元格增加 1。 因此,在5行3列的表格中,第二行中的第一個儲存格的索引為4。

右下角可見列索引
BottomRightVisibleCellRowIndex integer

表格中右下角可見儲存格的資料列索引。

右下角可見欄索引
BottomRightVisibleCellColumnIndex integer

表格中右下角可見儲存格的資料行索引。

最左邊可見的資料行索引
LeftmostVisibleColumnIndex integer

最左邊可見欄的欄索引。

最右邊可見的資料行索引
RightmostVisibleColumnIndex integer

最右邊可見資料行的資料行索引。

最頂層可見列索引
TopmostVisibleRowIndex integer

最上層可見列的列索引。

最底部可見的資料列索引
BottommostVisibleRowIndex integer

最底部可見列的列索引。

取得 UIA 元素的 Java 屬性

傳回 UIA 元素的所有 Java 屬性。 如果您不確定哪個欄位包含所需的屬性值,這會很有用。

參數

名稱 機碼 必要 類型 Description
父視窗控點
ParentWindowHandle True integer

父 UIA 視窗控制碼可作為搜尋的起點。 這可以透過使用 UIA 動作 (例如「等待桌面元素」或「等待元素」) 的檢查來發現。

搜尋元素名稱
SearchElementName string

要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋元素類別名稱
SearchElementClassName string

要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋元素自動化識別碼
SearchElementAutomationId string

要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋元素當地語系化控制項類型
SearchLocalizedControlType string

要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋 UIA 子樹狀結構
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

最大字串長度
MaxStringLength integer

描述欄位的長度上限。 這有時可能包含大量文本,因此設置最大值可以提高搜索速度。 依預設,沒有字串長度上限,因此會傳回完整的說明。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素 JAB 控點
ElementJABHandle integer

如果找到搜尋元素,這會保留數值元素句柄,可用於進一步的動作,以作為進一步搜尋的「父」句柄 (,也就是尋找相對於此句柄的元素) 。

元素 VMID
ElementVMID integer

執行 Java 程式之 Java 虛擬機器的 ID。

元素名稱
ElementName string

所定位元素的 Java 名稱。

元素描述
ElementDescription string

所定位元素的 Java 描述 (如果有的話)。

元素角色
ElementRole string

定位元素(如果有)的 Java 角色(例如框架或面板)。

元素狀態
ElementStates string

Java 元素在代理程式會話的語言環境中支援的狀態(例如可聚焦、可見)。

元素狀態en_US
ElementStates_en_US string

Java 元素在en_US語言環境中支援的狀態(例如可聚焦、可見)。

元素左邊緣
ElementLeftEdge integer

Java 元素或視窗的左邊緣與顯示器的左邊緣之間的距離 (以像素為單位)。

元素頂部邊緣
ElementTopEdge integer

Java 元素或視窗的頂端邊緣與顯示器的頂端邊緣之間的距離 (以像素為單位)。

元素寬度
ElementWidth integer

Java 元素的寬度 (以像素為單位)。

元素高度
ElementHeight integer

Java 元素的高度(以像素為單位)。

元素右邊緣
ElementRightEdge integer

Java 元素或視窗的右邊緣與顯示器的左邊緣之間的距離 (以像素為單位)。

元素底部邊緣
ElementBottomEdge integer

Java 元素或視窗的底部邊緣與顯示器的頂部邊緣之間的距離(以像素為單位)。

是元件元素
IsComponentElement boolean

如果 Java 元素是容器,則傳回 true,如果不是,則傳回 false。

是動作元素
IsActionElement boolean

如果 Java 元素是動作元素,則傳回 true,如果不是,則傳回 false。

是選取元素
IsSelectionElement boolean

如果 Java 元素是選取範圍,則傳回 true,如果不是,則傳回 false。

是文字元素
IsTextElement boolean

如果 Java 元素是文字元素,則傳回 true,如果不是,則傳回 false。

已啟用
IsEnabled boolean

如果已啟用 Java 元素,則傳回 true,如果未啟用,則傳回 false。 停用的元素通常是可見的,但無法與之互動。

可見
IsVisible boolean

如果 Java 元素可見,則傳回 true,如果不可見,則傳回 false。

正在顯示
IsShowing boolean

如果 Java 元素顯示,則傳回 true,如果未顯示,則傳回 false。

不透明
IsOpaque boolean

如果 Java 元素不透明,則傳回 true,如果不是,則傳回 false。

可聚焦
IsFocusable boolean

如果 Java 元素由鍵盤聚焦,則傳回 true,如果沒有,則傳回 false。 這可能用途有限,因為大多數元素都是鍵盤可聚焦的。

可編輯
IsEditable boolean

如果 Java 元素可編輯,則傳回 true,如果不是,則傳回 false。

是單線
IsSingleLine boolean

如果 Java 元素是單行,則傳回 true,如果不是,則傳回 false。

可調整大小
IsResizable boolean

如果 Java 元素可調整大小,則傳回 true,如果不是,則傳回 false。

是模態的
IsModal boolean

如果 Java 元素是模態,則傳回 true,如果不是,則傳回 false。 模態元素將阻止主應用程式窗口,阻止您與其互動。

被折疊
IsCollapsed boolean

如果 Java 元素已摺疊,則傳回 true,如果未摺疊,則傳回 false。

可選擇
IsSelectable boolean

如果 Java 元素是可選取的,則傳回 true,如果無法選取,則傳回 false。

已選取
IsSelected boolean

如果選取 Java 元素,則傳回 true,如果未選取,則傳回 false。

是垂直的
IsVertical boolean

如果 Java 元素是垂直的,則傳回 true,如果不是,則傳回 false。

是水平的
IsHorizontal boolean

如果 Java 元素是水平的,則傳回 true,如果不是,則傳回 false。

處於活動狀態
IsActive boolean

如果 Java 元素處於作用中狀態,則傳回 true,如果不是,則傳回 false。

已勾選
IsChecked boolean

如果檢查了 Java 元素,則傳回 true,如果未檢查,則傳回 false。

專注
IsFocussed boolean

如果 Java 元素具有鍵盤焦點,則傳回 true。 如果沒有,則為假。

展開
IsExpanded boolean

如果 Java 元素已展開,則傳回 true,如果未展開,則傳回 false。

其他元素狀態en_US
AdditionalStates_en_US string

元素支援的任何其他狀態都會在此處以en_US語言環境列出,例如可多選、暫時性。

父項中的索引
IndexInParent integer

目前父元素內的元素索引。

元素子計數
ChildrenCount integer

元素所具有的子元素數目。

元素深度
ElementDepth integer

最上層父視窗中元素的深度。

取得 Windows Access 橋接器連線狀態

傳回代理程式與 Windows 存取橋接器 (WAB) 之間連線 IA-Connect 目前狀態。 如果 IA-Connect 代理程式連線到WAB,則相關詳細資訊將作為輸出傳回。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
WAB 已連接
Connected boolean

如果 IA-Connect 代理程式已連線到 Windows 存取橋接器,則傳回 true,如果未連線,則傳回 false。

WAB 連線類型
ConnectionType string

Windows 存取橋接器的連線類型,例如 COM 或原生和 32 位或 64 位。

WAB 是 64 位元
IsWAB64bit boolean

如果 Windows 存取橋接器是 64 位,則傳回 true,如果不是,則傳回 false。

線上錯誤
ConnectionError string

連線錯誤 (如果已報告)。

載入 IA-JavaAccessBridge COM DLL
LoadedIAJABDLL string

載入 IA-JavaAccessBridge COM DLL 的完整路徑。

載入的 Windows 存取橋接器 DLL
LoadedWABDLL string

載入的 Windows 存取橋接器 DLL 的完整路徑。

Windows Access Bridge DLL 版本
WABVersion string

載入的 Windows 存取橋接器 DLL 版本。

取得 Windows 存取橋接器資訊

傳回特定 Java VM 識別碼的 Windows 存取橋接器 (WAB) 相關資訊,包括 Java 和 Windows DLL 版本。 Java VM ID 可以作為「取得 Java 元素內容」動作的輸出取得。

參數

名稱 機碼 必要 類型 Description
VM 識別碼
VMID True integer

Java 虛擬機器 ID。 這在所有 Java 虛擬機中都是唯一的。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
Java 類別版本
JavaClassVersion string

Java 類別版本,例如 '1.8.0_261'。

Java DLL版本
JavaDLLVersion string

Java DLL 版本,例如 '1.8.0_261'。

Windows DLL版本
WinDLLVersion string

Windows DLL 版本,例如 '1.8.0_261'。

VM 版本
VMVersion string

Java VM 版本,例如 '1.8.0_261'。

取得Java元素的可見邊界矩形

擷取 Java 元素的可見界限。 一般而言,Java Access Bridge 會傳回元素的虛擬位置值,而不論該元素是否在畫面上可見,且這些虛擬值是由「取得 Java 元素內容」動作所提供。 對於較大的元素(例如可以滾動的表格元素),這些元素可能並不總是在螢幕上可見,因此此操作會返回元素當前可見區域的坐標。

參數

名稱 機碼 必要 類型 Description
元素 JAB 控點
ElementJABHandle True integer

您要傳回可見界限之元素的元素控點。 這可以使用“獲取 Java 元素屬性”或其他返回元素句柄的搜索來定位。

要處理的最大父母
MaxParentsToProcess integer

計算指定元素的可見大小時要處理的父元素數目上限。 依預設,此值會設定為 50。

要考慮的父元素角色
ParentElementRolesToConsider string

計算元素大小時要考慮的父元素的角色。 這可用來排除大小小於可能扭曲大小計算的元素的父元素,例如頁面標籤。 依預設,這些是:面板、視埠、分層窗格、根窗格。

繪製矩形
DrawRectangle boolean

IA-Connect 應該在元素周圍繪製一個矩形,使其在屏幕上可見嗎? 依預設,此設定為 false。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素可見矩形左側
ElementVisibleRectangleLeft integer

元素可見左邊緣與顯示器左邊緣之間的距離 (以像素為單位)。

元素可見矩形頂部
ElementVisibleRectangleTop integer

元素的可見頂端邊緣與顯示器的頂端邊緣之間的距離 (以像素為單位)。

元素可見矩形右側
ElementVisibleRectangleRight integer

元素的可見右邊緣與顯示器左邊緣之間的距離 (以像素為單位)。

元素可見矩形底部
ElementVisibleRectangleBottom integer

元素可見的底部邊緣與顯示器的頂部邊緣之間的距離(以像素為單位)。

元素可見矩形寬度
ElementVisibleRectangleWidth integer

元素的可見寬度(以像素為單位)。

元素可見矩形高度
ElementVisibleRectangleHeight integer

元素的可見高度(以像素為單位)。

取得Java選取元素項目

傳回在指定 Java 選取元素下找到的所有子選取元素項目。 您可以選擇透過迴圈瀏覽選取範圍、選取清單中的每個個別選項,或讀取選取範圍的子元素標籤來擷取選取元素選項。 如果您選擇透過讀取選取範圍的子元素標籤來擷取選取元素選項,則可能需要先將「先展開」參數提供為「True」來展開選取範圍,然後您可以選擇性地關閉選取範圍,同時提供「收合之後」參數為「True」。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

選取 [取得選項清單]
GetListOfOptionsBySelecting boolean

如果設為 'True',則 IA-Connect 代理程式將嘗試依序選取每個選項 (在 JAB 中) 來取得選取範圍中所有選項的清單。 如果設定為 'False' (預設值),則 '通過讀取標籤獲取選項列表' 參數應設置為 'True',否則將不會讀取選項列表。

通過閱讀標籤獲取選項列表
GetListOfOptionsByReadingLabels boolean

如果設定為「True」,則 IA-Connect 代理程式將嘗試透過讀取子標籤(在 JAB 樹狀結構中)來取得選取範圍中所有選項的清單。 對於下拉式清單,您幾乎肯定需要將「先展開」參數設定為「True」,因為在清單下拉之前不會公開子元素。 同時將「折疊時間」參數設定為「True」,以便稍後關閉清單。 「透過選取取得選項清單」參數也應設定為「False」,否則此選項將被忽略(因為您無法透過這兩種方法取得清單)。 如果設定為 'False' (預設值),則「透過選取取得選項清單」參數應設定為 'True',否則將不會讀取選項清單。

先展開
ExpandFirst boolean

如果設定為 'true',則動作會在搜尋清單項目元素之前嘗試展開清單。 這對於動態清單很有用,因為在清單展開之前,可能不會建立其他清單項目元素。 如果設定為 false (預設值),則不會展開清單。

折疊後
CollapseAfter boolean

如果設定為true,則清單將在執行搜尋後摺疊。 如果設定為 false (預設值),則不會摺疊清單。

展開和收合之間的秒數
SecondsBetweenExpandCollapse double

展開和摺疊動作之間等待的秒數 (如果這些動作設定為 'True')。 依預設,這是 0.05 (20 毫秒)。

要傳回的清單項目上限
MaxListItemsToReturn integer

要傳回的清單項目數目上限,預設為 100。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
所選項目數量
NumberOfSelectedItems integer

在目前選取的父選取元素下找到的子清單項目數目。

選擇 1 名稱
AccessibleSelection1Name string

第一個選取的子清單項目的名稱。

清單中的選擇 1 索引
AccessibleSelection1IndexInParent integer

第一個選取的子清單項目清單中的索引。

選取的項目JSON
JABSelectionSelectedItemsJSON string

父選取元素的選取子項清單項目,採用 JSON 格式。

選取清單項目 JSON
JABSelectionListItemsJSON string

父選取元素的所有子清單項目,採用 JSON 格式。

取得多個 Java 父元素屬性

傳回 Java 元素的所有父元素的屬性。 如果「要處理的父系數目上限」參數設定得足夠高,則此動作會搜尋元素樹狀結構的整個高度,並傳回所有父屬性。

參數

名稱 機碼 必要 類型 Description
搜尋元素 JAB 控點
SearchElementJABHandle True integer

您要傳回所有父元素屬性之元素的元素控制碼。 這可以使用“獲取 Java 元素屬性”或其他返回元素句柄的搜索來定位。

最大字串長度
MaxStringLength integer

描述欄位的長度上限。 這有時可能包含大量文本,因此設置最大值可以提高搜索速度。 依預設,沒有字串長度上限,因此會傳回完整的說明。

要處理的最大父母
MaxParentsToProcess integer

要處理的父元素數目上限。 依預設,此值會設定為 50。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
Java 父元素 JSON
JavaParentElementsJSON string

所有已定位父元素 (及其屬性) 的清單,採用 JSON 格式。 傳回的屬性與「取得 Java 元素屬性」動作所傳回的屬性相同。

傳回的父元素數目
NumberOfParentElementsReturned integer

從搜尋傳回的父元素數目。

取得所有 Java 子元素屬性

傳回所有 Java 子元素的所有屬性。 如果您不確定哪個欄位包含所需的屬性值,這會很有用。

參數

名稱 機碼 必要 類型 Description
搜尋元素 JAB 控點
SearchElementJABHandle True integer

您要傳回子元素屬性之元素的元素控制碼。 這可以使用“獲取 Java 元素屬性”或其他返回元素句柄的搜索來定位。

第一個要退貨的商品
FirstItemToReturn integer

第一個要傳回的項目的元素索引,從1開始。 如果您想要以相反的順序傳回元素 (從樹狀結構底部開始),您也可以指定從 -1 開始的負索引。 例如,索引 -10 會傳回底部的第十個項目。

退貨項目上限
MaxItemsToReturn integer

要傳回的元素數目上限。 此參數可用來傳回較小區塊中的大型元素集,例如大型資料表。 您可以一次傳回 500 列,而不是嘗試傳回整個資料表,這可能會導致極大的資料表逾時。

最大字串長度
MaxStringLength integer

描述欄位的長度上限。 這有時可能包含大量文本,因此設置最大值可以提高搜索速度。 依預設,沒有字串長度上限,因此會傳回完整的說明。

搜尋後代
SearchDescendants boolean

如果設定為 true,則會搜尋父句柄下方的所有子元素。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋父句柄的直接子元素。

搜尋 Java 元素角色
SearchRole string

要搜尋之子元素的選用 Java 元素角色。 這可以透過檢查來發現。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
傳回的子元素數目
NumberOfChildElementsReturned integer

從搜尋傳回的子元素數目。

目前深度下可用的更多元素
MoreElementsAvailableAtCurrentDepth boolean

如果目前深度有更多子元素尚未傳回,則傳回 true,因為「要傳回的專案上限」已設定為較低的數字。

在較低深度提供更多元素
MoreElementsAvailableAtLowerDepths boolean

如果 Java 樹狀結構中較低深度有更多子元素可用,如果 'Max items to return' 設定為較低的數字,則傳回 true。

比最大深度更深的元素
MoreElementsDeeperThanMaxDepth boolean

如果 'Maximum relative depth' 設定為較低的數字,則在 Java 樹狀結構中以較低的深度有更多子元素可用,則傳回 true。

Java 子元素 JSON
JavaChildElementsJSON string

所有位於的子元素 (及其屬性) 的清單,採用 JSON 格式。 傳回的屬性與「取得 Java 子元素屬性」動作所傳回的內容相同。

在Java元素中輸入密碼

將密碼輸入 Java 元素 (通常是密碼輸入欄位),取代現有的文字。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

輸入密碼
PasswordToInput True password

要輸入的密碼值。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

在Java元素周圍繪製矩形

在 Java 元素的周邊繪製矩形,以協助識別找到的元素是所需的元素。 矩形會在 5 秒後自動移除。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

筆顏色
PenColour string

要繪製的矩形的顏色(例如紅色、綠色、藍色、黃色、紫色或橙色)或字符串十六進制代碼(例如 #FF0000)。

手寫筆粗細像素
PenThicknessPixels integer

醒目提示矩形框線的粗細 (以像素為單位)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

在屏幕坐標處獲取 Java 表格單元格

如果作為表格子元素的 Java 表格儲存格存在於指定的座標,則此動作將識別元素及其屬性,並選擇性地傳回表格儲存格元素的控點。

參數

名稱 機碼 必要 類型 Description
表格元素 JAB 控點
TableElementJABHandle True integer

您要搜尋之母表格元素的 Java 元素控點。 這可能是您之前使用「取得 Java 元素屬性」找到的表格。

螢幕 X
ScreenX True integer

屏幕 X 坐標以像素為單位,以定位表格單元格。

螢幕 Y
ScreenY True integer

屏幕 Y 坐標以像素為單位,以定位表格單元格。

返回句柄
ReturnJABHandle boolean

是否應該為儲存格傳回元素句柄?

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
父項中的儲存格索引
CellIndexInParent integer

表格中儲存格的儲存格索引。 第一行中的第一個單元格的索引將為 1,該行中的每個單元格增加 1。 因此,在5行3列的表格中,第二行中的第一個儲存格的索引為4。

儲存格列索引
CellRowIndex integer

表格中儲存格的資料列索引,從 1 開始。

儲存格資料行索引
CellColumnIndex integer

表格中儲存格的直欄索引,從 1 開始。

儲存格 JAB 句柄
CellJABHandle integer

表格儲存格的元素控點。

在螢幕座標處建立 Java 元素的句柄

透過提供螢幕座標來建立 Java 元素的控點。 如果 Java 元素存在於指定的座標處,則動作會識別該元素並傳回其句柄。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
ParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

螢幕 X
ScreenX True integer

屏幕 X 坐標以像素為單位,以定位元素。

螢幕 Y
ScreenY True integer

螢幕 Y 座標 (以像素為單位) 來定位元素。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
已定位元素 JAB 控點
LocatedElementJABHandle integer

如果元素存在於指定的座標處,這會保留數值元素句柄,可用於進一步的動作,以作為進一步搜尋的「父」句柄 (,也就是相對於句柄尋找元素) 。

將 Java 元素屬性作為列表

將 Java 元素的屬性作為單行清單(單行集合/資料表)而不是單個項目傳回,這可能有用,具體取決於您打算如何使用資料。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

最大字串長度
MaxStringLength integer

描述欄位的長度上限。 這有時可能包含大量文本,因此設置最大值可以提高搜索速度。 依預設,沒有字串長度上限,因此會傳回完整的說明。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
找到的元素數量
NumberOfElementsFound integer

找到符合搜尋條件的元素數。

傳回的元素數目
NumberOfElementsReturned integer

從搜尋傳回的元素數目。 如果將「要搜尋的元素數目上限」或「每個節點要搜尋的子元素數目上限」設定為較低的數字,則可能會低於找到的元素數目。

Java 元素屬性 JSON
JABElementPropertiesJSON string

找到符合搜尋準則之 Java 元素的元素內容,採用 JSON 格式。

將文字輸入到Java元素中

將文字輸入 Java 元素 (通常是文字輸入欄位),取代現有文字或在特定位置插入新值。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要輸入的文字
TextToInput string

要輸入的文字值。

取代現有值
ReplaceExistingValue boolean

如果元素中存在現有文本,是否應該替換?

插入位置
InsertPosition integer

開始插入文字的位置 (索引)。 如果有現有文字,則可以使用插入位置在現有文字內的特定位置插入。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

對 Java 元素執行動作

對 Java 元素執行可存取的動作。 您可以使用「取得 Java 元素的動作」動作來查詢特定元素的這些可存取動作。 一些常見的操作是按鈕的“單擊”或文本元素的“全選”。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

行動
Action True string

要執行的動作,例如「按一下」。 動作名稱通常區分大小寫。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

展開 Java 選取元素

展開或摺疊 Java 元素 (通常是功能表/下拉式項目)。 如果項目已經展開,則不會發生任何動作。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

展開
Expand boolean

如果設定為 'True'(預設值),則元素將被展開。 如果設定為 'False',則元素將會摺疊。

驗證元素狀態
VerifyElementState boolean

如果設定為 'True',則 IA-Connect 代理程式稍後會驗證元素狀態,以檢查 'Expanded' 狀態是否符合預期狀態,並在不符合時引發例外狀況。 例如,如果展開元素,則 'IsExpanded' 屬性應該為 true。 如果設定為 'False',則不會驗證元素狀態。

等待狀態變更的秒數
SecondsToWaitForStateChange double

展開或收合後等待狀態變更的秒數。 依預設,此值會設定為 0.05 (20 毫秒)。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

從元素句柄獲取 Java 角色 CSV

將指定元素控制碼下方的元素角色樹狀結構傳回為 CSV。 此動作只會用於開發目的,並提供應用程式元素的概觀,這對於視覺化應用程式結構和最佳化元素搜尋非常有用。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

CSV 中的縮排角色
IndentRoleInCSV boolean

CSV 輸出中的子元素角色應該縮排嗎? 這可能有助於更好地視覺化 Java 元素樹中的父子關係。 根據預設,此設定為「True」。

在 CSV 中包含說明
IncludeDescriptionInCSV boolean

元素描述是否應該包含在 CSV 輸出中? 根據預設,此設定為「True」。

在 CSV 中包含維度
IncludeDimensionsInCSV boolean

元素尺寸(高度、寬度和邊界邊緣)是否應該包含在 CSV 輸出中? 根據預設,此設定為「True」。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
找到元素
ElementFound boolean

如果找到輸入句柄所指定的元素,則傳回 true,如果找不到,則傳回 false。

搜尋的元素數
ElementsSearched integer

在父元素下搜尋的元素數。

角色CSV
RoleCSV string

CSV 輸出,其中包含父元素下每個元素的角色。

從元素搜尋取得 Java 角色 CSV

執行 Java 元素搜尋,並將所搜尋元素的詳細資料 (直到找到元素為止) 輸出為 CSV。 此動作只會用於開發目的,並提供應用程式元素的概觀,這對於視覺化應用程式結構和最佳化元素搜尋非常有用。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

CSV 中的縮排角色
IndentRoleInCSV boolean

CSV 輸出中的子元素角色應該縮排嗎? 這可能有助於更好地視覺化 Java 元素樹中的父子關係。 根據預設,此設定為「True」。

在 CSV 中包含說明
IncludeDescriptionInCSV boolean

元素描述是否應該包含在 CSV 輸出中? 根據預設,此設定為「True」。

在 CSV 中包含維度
IncludeDimensionsInCSV boolean

元素尺寸(高度、寬度和邊界邊緣)是否應該包含在 CSV 輸出中? 根據預設,此設定為「True」。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
找到元素
ElementFound boolean

如果找到搜尋元素,則傳回 true,如果找不到,則傳回 false。

搜尋的元素數
ElementsSearched integer

在找到搜尋元素之前,在父元素下搜尋的元素數。

角色CSV
RoleCSV string

CSV 輸出,其中包含在搜尋中找到的每個元素的角色。

按 Java 元素

按下 Java 元素 (通常是按鈕)。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

按下元素的次數
NumberOfTimesToPressElement integer

按下元素的次數,預設為 1。

按下之間等待的秒數
SecondsToWaitBetweenPresses double

按下之間等待的秒數,預設為 0.05 (20 毫秒)。

自動偵測動作名稱
AutoDetectActionName boolean

如果設定為 true (預設值),則 IA-Connect 代理程式將嘗試自動偵測非英文地區設定中的「按一下」動作名稱。 如果元素有兩個以上的可能動作,則會使用「覆寫動作名稱」。 如果設定為 false IA-Connect 則代理程式將不會嘗試偵測非英文地區設定中的「按一下」動作名稱,除非提供「覆寫動作名稱」值,否則動作可能會失敗。

覆寫動作名稱
OverrideActionName string

非英語地區設定中「點擊」動作的名稱,例如 'cliquer' 或 'hacer clic'。 這可以從動作「取得 Java 元素的動作」的輸出中判斷,而且通常區分大小寫。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

是 Java 視窗

傳回 UIA 視窗是否為 Java 元素。

參數

名稱 機碼 必要 類型 Description
父視窗控點
ParentWindowHandle True integer

父 UIA 視窗控制碼可作為搜尋的起點。 這可以透過使用 UIA 動作 (例如「等待桌面元素」或「等待元素」) 的檢查來發現。

搜尋元素名稱
SearchElementName string

要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋元素類別名稱
SearchElementClassName string

要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋元素自動化識別碼
SearchElementAutomationId string

要搜尋的選擇性 UIA 元素自動化識別碼 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋元素當地語系化控制項類型
SearchLocalizedControlType string

要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋 UIA 子樹狀結構
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
是 Java 視窗
IsJavaWindow boolean

如果找到的 UIA 元素是 Java 視窗,則傳回 true,如果不是,則傳回 false。

檢查 Java 元素

將元素的狀態 (通常是核取方塊或選項方塊) 設定為已核取或未核取。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

檢查元素
CheckElement boolean

該元素應該被選中 (true) 還是未選中 (false)?

自動偵測動作名稱
AutoDetectActionName boolean

如果設定為 true (預設值),則 IA-Connect 代理程式將嘗試自動偵測非英文地區設定中的「按一下」動作名稱。 如果元素有兩個以上的可能動作,則會使用「覆寫動作名稱」。 如果設定為 false IA-Connect 則代理程式將不會嘗試偵測非英文地區設定中的「按一下」動作名稱,除非提供「覆寫動作名稱」值,否則動作可能會失敗。

覆寫動作名稱
OverrideActionName string

非英語地區設定中「點擊」動作的名稱,例如 'cliquer' 或 'hacer clic'。 這可以從動作「取得 Java 元素的動作」的輸出中判斷,而且通常區分大小寫。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

焦點 Java 元素

聚焦 Java 元素,使其成為鍵盤焦點的作用中元素,視應用程式而定,可能會將元素視窗帶到前景。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

等待 Java 桌面元素

等待 Java 桌面元素(通常是視窗)存在。

參數

名稱 機碼 必要 類型 Description
搜尋 UIA 元素名稱
SearchUIAElementName string

要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋 UIA 元素類別名稱
SearchUIAElementClassName string

要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋 UIA 元素當地語系化控制項類型
SearchUIAElementLocalizedControlType string

要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋程序識別碼
SearchProcessID integer

執行中進程的進程識別碼。 這可以作為「執行處理程序」動作的輸出擷取。

搜尋子元素
SearchChildElements boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

等待秒數
SecondsToWait True double

等待元素存在的秒數上限。

包含子程序
IncludeChildProcesses boolean

如果設定為 true 並指定「搜尋程序 ID」,則該程序 ID 的子程序會包含在搜尋中。 這對於 Java 來說很常見,因為啟動器 EXE 通常會運行一個子 'Java(w).exe' 進程。 如果設定為 false,則只會傳回符合確切「搜尋程式 ID」的程式。

如果找不到元素,則引發例外狀況
RaiseExceptionIfElementNotFound boolean

如果等待期過後 Java 元素不存在,IA-Connect 是否應該引發異常?

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素存在
ElementExists boolean

如果元素存在,則傳回 true,如果不存在,則傳回 false。

元素 JAB 控點
ElementJABHandle integer

如果找到搜尋元素,這會保留數值元素句柄,可用於進一步的動作,以作為進一步搜尋的「父」句柄 (,也就是尋找相對於此句柄的元素) 。

元素名稱
ElementName string

所定位元素的 Java 名稱。

元素描述
ElementDescription string

所定位元素的 Java 描述 (如果有的話)。

元素角色
ElementRole string

定位元素(如果有)的 Java 角色(例如框架或面板)。

等待Java元素

等待 Java 元素 (通常是視窗中的個別元素,例如按鈕或文字輸入區域) 存在。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

等待秒數
SecondsToWait True double

等待元素存在的秒數上限。

如果找不到元素,則引發例外狀況
RaiseExceptionIfElementNotFound boolean

如果等待期過後 Java 元素不存在,IA-Connect 是否應該引發異常?

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素存在
ElementExists boolean

如果元素存在,則傳回 true,如果不存在,則傳回 false。

元素 JAB 控點
ElementJABHandle integer

如果找到搜尋元素,這會保留數值元素句柄,可用於進一步的動作,以作為進一步搜尋的「父」句柄 (,也就是尋找相對於此句柄的元素) 。

元素名稱
ElementName string

所定位元素的 Java 名稱。

元素描述
ElementDescription string

所定位元素的 Java 描述 (如果有的話)。

元素角色
ElementRole string

定位元素(如果有)的 Java 角色(例如框架或面板)。

等待Java元素不存在

等待 Java 元素(通常是視窗中的個別元素,例如按鈕或文字輸入區域)不再存在。

參數

名稱 機碼 必要 類型 Description
父元素 JAB 控制碼
SearchParentElementJABHandle True integer

Java 元素控點,是您所搜尋之元素的母項。 這可能是您之前使用「等待 Java 桌面元素」找到的視窗。

搜尋 Java 元素名稱
SearchElementJABName string

要搜尋之元素的選用 Java 名稱。 這可以透過檢查來發現。

搜尋Java元素描述
SearchElementJABDescription string

要搜尋之元素的選用 Java 元素說明。 這可以透過檢查來發現。

搜尋 Java 元素角色
SearchElementJABRole string

要搜尋之元素的選用 Java 元素角色。 這可以透過檢查來發現。

搜尋子元素
SearchSubTree boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

最大相對深度
MaxRelativeDepth integer

從父元素搜尋子元素的最大相對深度。 直接子元素的深度值為 0。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

區分大小寫的搜尋
CaseSensitiveSearch boolean

元素搜尋應該區分大小寫嗎? 當設定為 True 時,只會傳回符合確切字串/文字搜尋的元素。 依預設,此設定為 false。

僅搜尋可見元素
OnlySearchVisibleElements boolean

應該只搜尋可見元素嗎? 依預設,此設定為 true。

僅搜尋顯示元素
OnlySearchShowingElements boolean

應該只搜尋顯示元素嗎? 顯示元素通常是顯示在替代索引標籤或摺疊功能表中的項目。 依預設,此設定為 true。

不周遊的元素角色
ElementRolesNotToTraverse string

以逗號分隔的角色清單,在搜尋時不會遍歷 (逐步進入)。 搜尋仍會檢查元素是否符合搜尋條件,但不會搜尋任何子元素。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

要搜尋的元素數目上限
MaximumElementsToSearch integer

尋找目標元素時要搜尋的最大元素數,將搜尋限制為只檢查Java樹狀結構中找到的前N個元素。 依預設,此值會設定為 2000。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

每個節點要搜尋的子元素數目上限
MaximumChildElementsToSearchPerNode integer

尋找目標元素時,要在每個元素中搜尋的子元素數目上限,限制搜尋僅檢查Java樹狀結構中每個元素找到的前N個子元素。 依預設,此值會設定為 200。 此參數可用於優化元素搜尋。 只有在「搜尋子元素」輸入參數設定為「True」時才會使用此功能。

等待秒數
SecondsToWait True double
如果元素仍然存在,則引發例外狀況
RaiseExceptionIfElementStillExists boolean

如果等待期過後 Java 元素仍然存在,IA-Connect 是否應該引發異常?

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素在等待之前存在
ElementExistsBeforeWait boolean

如果元素在等待之前存在,則傳回 true,如果沒有,則傳回 false。

元素在等待後存在
ElementExistsAfterWait boolean

如果元素在等待後存在,則傳回 true,如果沒有,則傳回 false。

等待Java桌面元素不存在

等待 Java 桌面元素(通常是視窗)不再存在。

參數

名稱 機碼 必要 類型 Description
搜尋 UIA 元素名稱
SearchUIAElementName string

要搜尋的選擇性 UIA 元素名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋 UIA 元素類別名稱
SearchUIAElementClassName string

要搜尋的選擇性 UIA 元素類別名稱 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋 UIA 元素當地語系化控制項類型
SearchUIAElementLocalizedControlType string

要搜尋的選擇性 UIA 元素當地語系化控制項類型 (從父視窗控制碼開始) 。 這可以透過檢查來發現。

搜尋程序識別碼
SearchProcessID integer

執行中進程的進程識別碼。 這可以作為「執行處理程序」動作的輸出擷取。

搜尋子元素
SearchChildElements boolean

如果設定為 true,則會搜尋父視窗句柄下方的整個樹狀結構。 這更徹底,但可能需要更長的時間。 如果設定為 false,則只會搜尋樹狀結構中父視窗控點正下方的元素。

匹配索引
MatchIndex integer

如果多個元素符合搜尋,則應比對哪個元素(從 1 開始)。 可與「依列排序」結合使用,以選擇比對的排序順序。

搜尋篩選
SearchFilter string

選用的進階篩選器,可進一步限制使用條件運算子和任何元素欄位的搜尋。 範例 1:[寬度] < 200。 範例 2:[名稱] 如 'Document*' 和 [Role] 如 'Label*'。 如需更多範例,請參閱文件。

依欄名稱排序
SortByColumn string

如果多個元素符合搜尋,這可讓您指定要排序的元素屬性。 這將與「比對索引」結合使用,以挑選所需的元素。 例如:如果「依列名稱排序」是 [TopEdge],而「比對索引」是 1,則會比對最接近螢幕頂端的相符元素。

比對索引是遞增的
MatchIndexAscending boolean

如果多個元素符合搜尋,則「比對索引」應該從排序清單的頂端 (true) 或排序清單的底部 (false) 相符。

等待秒數
SecondsToWait True double

等待元素不存在的最大秒數。

包含子程序
IncludeChildProcesses boolean

如果設定為 true 並指定「搜尋程序 ID」,則該程序 ID 的子程序會包含在搜尋中。 這對於 Java 來說很常見,因為啟動器 EXE 通常會運行一個子 'Java(w).exe' 進程。 如果設定為 false,則只會傳回符合確切「搜尋程式 ID」的程式。

如果元素仍然存在,則引發例外狀況
RaiseExceptionIfElementStillExists boolean

如果等待期過後 Java 元素仍然存在,IA-Connect 是否應該引發異常?

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
元素在等待之前存在
ElementExistsBeforeWait boolean

如果元素在等待之前存在,則傳回 true,如果沒有,則傳回 false。

元素在等待後存在
ElementExistsAfterWait boolean

如果元素在等待後存在,則傳回 true,如果沒有,則傳回 false。

連線至 Java Access Bridge

啟動 IA-Connect Java 子系統 (IA-JavaAccessBridge),並將它連接至指定的 Java Access Bridge DLL(或留空以搜尋一個)。 您必須先執行此步驟,才能將 Java 應用程式自動化。 此動作也會啟用 Java Access Bridge,在執行任何 Java 應用程式之前,必須先啟用該橋接器。

參數

名稱 機碼 必要 類型 Description
Windows Access Bridge DLL 搜尋資料夾
WindowsAccessBridgeDLLSearchFolder string

在執行代理程式的工作階段中指定包含 Windows Access Bridge DLL (Java 執行階段元件) 的資料夾,或輸入 Windows Access Bridge DLL 的完整檔名以強制使用該特定 DLL。 如果您未提供路徑,則會使用標準 Windows 搜尋路徑。

IA-JavaAccessBridge DLL 路徑
IAJavaAccessBridgePath string

如果您需要將 IA-JavaAccessBridge.dll COM DLL (IA-Connect 代理程式的內建元件) 裝載至 EXE (,可能是因為安全性允許清單) 的位置。 這可以是完整路徑,也可以是相對於 IA-Connect 代理位置的路徑。 例如,如果代理程式和 IA-JavaAccessBridge.dll COM DLL 都位於同一個資料夾中,則只需傳遞 DLL 的檔案名稱即可。

是 64 位 Windows Access Bridge DLL
Is64BitJABDLL boolean

Windows Access Bridge DLL 是否使用 64 位?

將 COM 用於 64 位 IA-JavaAccessBridge DLL
UseCOMFor64BitJABDLL boolean

如果您嘗試載入的 Windows 存取橋接器 DLL 是 64 位,則應該透過跨進程 COM DLLSurrogate 執行,而不是直接從 IA-Connect 呼叫 (記憶體中) 。 根據預設,此設定為「True」。 如果 IA-JavaAccessBridge DLL 被阻止,您可以嘗試取消選中此選項。

啟用 Java Access Bridge
EnableJavaAccessBridge boolean

是否應該啟用 Java Access Bridge? 根據預設,此設定為「True」。

協助工具檔案路徑
AccessibilityFilepath string

.accessibility.properties 檔案的路徑,可控制是否啟用 Java Access Bridge。 如果您未提供路徑,則預設為 %USERPROFILE%.accessibility.properties。

命令超時時間(秒)
CommandTimeoutInSeconds integer

等待 IA-Connect 連線至 Java 存取橋接器的秒數上限。 依預設,這是 20 秒。

Workflow
Workflow True string

在此處新增下列運算式:workflow()

傳回

名稱 路徑 類型 Description
載入的 Windows 存取橋接器 DLL
LoadedWindowsAccessBridgeDLL string

已載入之 Windows Access Bridge DLL 的完整檔名。

重設所有 Java 元素控點

重設 IA-Connect 目前儲存的所有 Java 元素控點,如果您已識別大量元素且儲存了大量元素控點,這會很有用。 在元素句柄數量極多 (100,000+) 的案例中,此動作也可用於釋放 RAM 使用量。

參數

名稱 機碼 必要 類型 Description
Workflow
Workflow True string

在此處新增下列運算式:workflow()