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 |
| 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() |