IA-Connect 網頁瀏覽器
IA-Connect 是一個機器人流程自動化“RPA”平台，它將 RPA 功能從雲添加到本地虛擬機或通過 Citrix 或 Microsoft 遠程桌面“RDS”連接。 這是 Web 瀏覽器自動化的模組。
此連接器適用於以下產品和區域：
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域， 但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部 （DoD） |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| Power Automate（自動化服務） | 進階 | 除下列區域外的所有 Power Automate 區域 ： - 美國政府 （GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部 （DoD） |
| 連絡人 | |
|---|---|
| 名稱 | 創世紀實驗室 |
| URL | https://www.ultima.com/ultima-labs |
| IAConnect@ultima.com |
| 連接器中繼資料 | |
|---|---|
| Publisher | 創世紀商業 |
| 網站 | https://www.ultima.com/ultima-labs |
| 隱私策略 | https://www.ultima.com/privacy-policy |
| 類別 | IT運營;生產力 |
IA-Connect 是一個機器人流程自動化 （RPA） 平台，可將 RPA 功能從 Power Automate 雲端流程新增至內部部署虛擬機器，或透過 Citrix 或 Microsoft 遠端桌面 （RDS） 連線。 IA-Connect 連接器提供超過 800 個動作，可讓您直接從 Power Automate 雲端流程自動化每種類型的內部部署應用程式。 所有 IA-Connect 動作都可以直接從 Power Automate 雲端流程取得，從而在雲端型應用程式和內部部署應用程式之間輕鬆整合，並能夠在 RPA 流程中利用現有的 Power Automate 條件、迴圈、動態內容、運算式和例外狀況處理。 利用 IA-Connect Connectors 還可以從 Flow 執行歷史記錄中提供完整的執行歷史記錄和可審計性，同時也無需使用單獨的應用程式/控制台/工作室來開發 RPA 流程。
先決條件
若要使用任何 IA-Connect 連接器，您必須安裝 IA-Connect 軟體。 這是 30 天的免費測試，之後您將需要 IA-Connect 許可證。
IA-Connect 軟體由兩個主要組件組成：
IA-Connect Orchestrator，這是 Azure WebApp，您將在自己的 Azure 租用戶中裝載。 這會處理 RPA 流程到一或多個內部部署或雲端虛擬機器的路由和安全性。
IA-Connect 代理程式和導向器，安裝在可存取您要自動化軟體的虛擬機器上。 此外，IA-Connect 代理程式可以在 Citrix 或 Microsoft 遠端桌面服務 （RDS） 工作階段內執行，其中 RPA 命令會透過虛擬通道傳遞到遠端工作階段中以執行。 IA-Connect 代理程式可以從網路共用執行，而且不需要安裝。
可用的 IA-Connect 連接器
可用的 IA-Connect 連接器包括：
- IA-Connect 動態程式碼
- IA-Connect 爪哇
- IA-Connect JML
- IA-Connect 大型主機
- IA-Connect Microsoft辦公室
- IA-Connect SAP GUI
- IA-Connect 場
- IA-Connect 使用者介面
- IA-Connect 網頁瀏覽器
如何取得認證
為了獲得您的許可證並開始您的 30 天免費試用，請在我們的網站上提交請求 （https://www.ultima.com/IA-Connect/Power-Automate）。
收到試用請求後，我們將透過提供的電子郵件地址與您聯繫，以協助設定 IA-Connect 軟體並為您提供試用授權。 這是一個功能齊全的試用版，可讓您在試用期內測試自己環境中所有 9 個 IA-Connect Connector 的 800 個動作中的任何一個。
開始使用連接器
提交 IA-Connect 試用請求後，您將能夠下載包含 IA-Connect 軟件以及涵蓋安裝和設置的文件的 ZIP 文件。 我們還將根據需要與您聯繫，在安裝過程中提供支援和指導。
Support
在試用期間，您可以聯絡 Ultima Labs （IAConnect@ultima.com） 尋求支援和協助。
購買 IA-Connect 許可證後，您將收到支持代幣，這些代幣可以兌換 Ultima 位於英國的技術服務中心 （TSC） 的定制培訓或支持。
已知問題、常見錯誤和常見問題
我們的知識庫包含許多文章，涵蓋任何已知問題、使用 IA-Connect 連接器時可能發生的常見錯誤以及常見問題。 這可在 IA-Connect 試 https://support.ultima.com/ultimalabs 用期間和購買 IA-Connect 許可證時訪問，並提供訪問這些資源的帳戶。
正在建立連線
連接器支援下列驗證類型：
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用：所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 金鑰 | securestring | 此 API 的 API 金鑰 | 對 |
| IA-Connect Orchestrator 位址 | 字串 | 指定不含 HTTP（S） 元件的 IA-Connect Orchestrator 位址 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
|
Java |
透過告訴瀏覽器的 JavaScript 引擎執行左鍵單擊來模擬滑鼠操作。 這是「模擬滑鼠左鍵單擊元素」操作的替代方案，通常足以讓網頁按預期做出反應。 |
|
上傳新的 Chrome |
將新版本的 ChromeDriver 從本機系統 （數位工作者） 上傳至 IA-Connect Agent 工作階段，以與 Google Chrome 搭配使用。 |
| 上傳新的 Chromium Edge 驅動程式 |
將新版本的 ChromiumEdgeDriver 從本機系統 （數位背景工作者） 上傳至要與 Chromium Edge 搭配使用的 IA-Connect 代理程式工作階段。 |
| 以像素捲動瀏覽器視窗 |
將瀏覽器視窗捲動指定的像素數。 |
| 全局鼠標右鍵單擊 Web 元素 |
將滑鼠移至 HTML 元素的中心，然後按下滑鼠右鍵。 在元素預期滑鼠在您按下元素之前位於元素上的情況下，有時會使用這來代替「點擊元素」。 |
| 全局鼠標左鍵單擊 Web 元素 |
將滑鼠移至 HTML 元素的中心，然後按下滑鼠左鍵。 在元素預期滑鼠在您按下元素之前位於元素上的情況下，有時會使用這來代替「點擊元素」。 |
| 全螢幕作用中瀏覽器 |
將網頁瀏覽器設定為全螢幕，使網站佔據整個螢幕（隱藏瀏覽器導覽工具列、網址列、開始列等）。 |
| 切換至網頁根框架 |
將 IA-Connect 代理切換為控制網頁內的根框架或與之互動。 |
| 切換至網頁框架 |
將 IA-Connect 代理切換為控制瀏覽器頁面中的替代框架或與之互動。 |
| 切換至網頁父框架 |
將 IA-Connect 代理切換為控制網頁內目前框架的父框架或與之互動。 |
| 列印目前網頁 |
列印目前網頁。 |
|
取得 Chrome |
取得與目前 Chrome EXE 版本搭配使用的 ChromeDriver 版本的 ChromeDriver 資料夾路徑。 這是由「開啟 Chrome」操作使用的，您不太可能需要直接呼叫此操作。 |
| 取得多個網頁元素屬性 |
傳回符合搜尋準則之所有 HTML 元素的屬性。 搜尋是相對於文件的根目錄 （父元素控點 = 0） 或先前找到的元素 （父元素控點 > 0）。 |
| 取得瀏覽器父視窗詳細資料 |
傳回 IA-Connect Agent 目前正在與之互動的瀏覽器父視窗的屬性。 |
| 取得目前網頁框架視窗像素座標 |
傳回目前 HTML 框架的圖元座標，相對於瀏覽器文件視窗 （顯示網頁的區域）。 |
| 取得網頁元素子屬性 |
傳回符合搜尋條件之主文件 （「父元素」控點 = 0） 或先前找到的元素 （「父元素」控點 > 0） 的直接子元素 （搜尋子樹狀結構 = false） 或所有子項 （搜尋子樹 = true） 的屬性。 |
| 取得網頁元素屬性 |
取得 HTML 元素的屬性。 |
| 取得網頁元素屬性作為清單 |
將 Web 元素的屬性傳回為單行清單 （單行集合/資料表） ，而不是個別項目，這可能會有用，視您打算如何使用資料而定。 |
| 取得網頁元素父屬性 |
取得相符 HTML 元素的父元素屬性。 |
| 取得網頁元素畫面邊界矩形 |
傳回 HTML 元素的左、右、上、下邊緣相對於工作階段畫面的圖元座標。 |
| 取得網頁元素邊界矩形 |
傳回 HTML 元素的左、右、上和下邊緣相對於瀏覽器文件視窗 （顯示網頁的區域） 的圖元座標。 |
| 取得網頁文字 |
選取整個瀏覽器頁面，將它複製到執行 IA-Connect Agent 的工作階段中的剪貼簿，然後傳回剪貼簿內容，以取得目前頁面上的所有文字。 |
| 取得網頁瀏覽器索引標籤 |
傳回瀏覽器視窗中開啟的目前索引標籤。 |
| 取得網頁表格內容 |
傳回 HTML 表格元素的內容。 |
| 取得網頁選取清單屬性 |
傳回選取 HTML 元素的所有選項及其屬性。 |
| 取消選取網頁選取清單中的所有項目 |
取消選取支援多重選取的選取元素中目前選取的所有選項。 |
| 取消選取網頁選取清單項目 |
取消選取所選 HTML 元素上的選項，依 Text、Value 或 Index。 您可以使用「取得選取範圍屬性」動作來探索選取範圍中每個選項的文字、值或索引。 |
| 在 Web 元素上按 Enter 鍵 |
在 HTML 元素上按 Enter 鍵。 這可用於提交元素或在某些情況下與按鈕互動。 |
| 在活動瀏覽器中刷新當前網頁 |
重新整理目前的瀏覽器頁面。 |
| 在瀏覽器文件視窗座標處取得網頁元素 |
傳回位於指定瀏覽器文件視窗座標的網頁元素。 此座標以相對於瀏覽器文件視窗或框架左上角的像素為單位 （如果 IA-Connect 已逐步進入框架）。 |
|
在網頁中執行Java |
在網頁中執行提供的JavaScript程式碼。 |
| 在網頁元素上全選 |
選取 HTML 元素的所有內容 （通常是文字欄位）。 |
|
在網頁元素上執行Java |
在選取的 HTML 元素上執行提供的 JavaScript 程式碼。 |
| 在網頁元素上複製選取的文字 |
將目前選取的所有文字從網頁元素複製到剪貼簿。 |
| 在網頁元素中輸入密碼 |
將密碼輸入 HTML 元素 （通常是文字輸入欄位），取代現有值或將新值附加至任何現有值。 |
| 在網頁元素周圍繪製矩形 |
在 HTML 元素的周邊繪製矩形，以協助識別找到的元素是必要的元素。 矩形會在 5 秒後自動移除。 |
| 在螢幕座標處取得網頁元素 |
傳回位於指定螢幕座標的網頁元素。 這些將映射到瀏覽器文檔窗口和框架坐標以獲取元素。 |
| 將使用中的瀏覽器導覽至 URL |
將瀏覽器導覽至提供的 URL。 IA-Connect 將等待頁面載入後再返回。 |
| 將使用中的瀏覽器降到最低 |
將目前控制的網頁瀏覽器最小化（使用瀏覽器「開啟」動作開啟的最後一個瀏覽器）。 |
| 將文字輸入到多個網頁元素中 |
將文字輸入到多個 HTML 元素（通常是文字輸入欄位）中，取代現有文字或將新值附加到任何現有值。 |
| 將文字輸入到網頁元素中 |
將文字輸入 HTML 元素 （通常是文字輸入欄位），取代現有文字或將新值附加至任何現有值。 |
| 將瀏覽器視窗捲動至像素 |
將瀏覽器視窗捲動至指定的圖元座標。 |
| 將網頁儲存至檔案 |
將目前的 HTML 頁面儲存到磁碟上的檔案。 |
| 將網頁元素捲動至檢視 |
向上、向下、向左或向右捲動網頁，直到 HTML 元素出現在螢幕上。 |
| 建立父 Web 元素的控點 |
建立 HTML 元素父系的控點。 |
| 建立網頁元素的控點 |
建立 HTML 元素的控點。 此句柄可用來自動化子 HTML 元素。 |
| 從 Internet 下載合適的 Chromium Edge 驅動程序 |
在執行 IA-Connect Agent 的工作階段中，判斷哪個版本的 Chromium Edge 驅動程式適合已安裝的 Chromium Edge 瀏覽器版本，檢查是否已下載合適的版本，如果沒有，則嘗試從 Chromium Edge 驅動程式網頁下載合適的版本。 |
|
從互聯網下載合適的 Chrome |
在執行 IA-Connect Agent 的工作階段中，判斷哪個版本的 ChromeDriver 適合已安裝的 Google Chrome 版本，檢查是否已下載合適的版本，如果沒有，則嘗試從 Google 的 ChromeDriver 網際網路網頁下載合適的版本。 |
| 從文件中獲取 Chromium Edge EXE 版本 |
取得執行代理程式的工作階段中安裝的 Chromium Edge 版本。 |
| 從文件獲取 Google Chrome EXE 版本 |
取得執行代理程式的工作階段中安裝的 Google Chrome 版本。 |
| 按 CTRL 網頁元素上的鍵 |
在 HTML 元素上按 CTRL 鍵。 這可以與“Control 鍵”參數一起使用，以執行快捷鍵，例如 Ctrl-a（全選）、Ctrl-c（複製）、Ctrl-x（剪切）或 Ctrl-v（粘貼）。 |
| 按一下網頁元素 |
按一下網頁瀏覽器中的元素 （通常是按鈕或超連結）。 |
| 提交網頁元素 |
提交 HTML 元素。 這通常會在表單元素中的任何輸入元素上執行，並會導致表單提交。 |
|
是否有合適的遠端 Chrome |
在執行 IA-Connect Agent 的工作階段中，搜尋適合已安裝 Google Chrome 版本的 ChromeDriver 版本。 |
| 是否有合適的遠端 Chromium Edge 驅動程式可用 |
在執行代理程式的工作階段中，針對已安裝的 Chromium Edge 版本搜尋合適的 ChromiumEdgeDriver 版本。 |
| 最大化使用中的瀏覽器 |
最大化目前控制的網頁瀏覽器 （使用瀏覽器「開啟」動作開啟的最後一個瀏覽器）。 |
| 模擬滑鼠右鍵點擊網頁元素 |
透過告訴瀏覽器已執行滑鼠右鍵動作來模擬滑鼠動作。 這通常足以讓網頁如預期般做出反應。 如果失敗，請考慮使用「全局滑鼠右鍵單擊元素」，它以與使用者完全相同的方式移動滑鼠和點擊。 |
| 模擬鼠標左鍵單擊網頁元素 |
透過告訴瀏覽器已執行滑鼠左鍵動作來模擬滑鼠動作。 這通常足以讓網頁如預期般做出反應。 如果失敗，請考慮使用「全局滑鼠左鍵單擊元素」，它會以與使用者完全相同的方式移動滑鼠和點擊。 |
| 檢查多個網頁元素 |
檢查/勾選多個 HTML 元素（通常是核取方塊或選項框）。 |
| 檢查網頁元素 |
檢查/勾選 HTML 元素（通常是核取方塊或選項框）。 |
| 正常化作用中瀏覽器 |
將視窗大小調整為提供的維度，並將視窗移至提供的座標，以正規化瀏覽器視窗。 |
| 清除所有網頁元素文字 |
清除網頁元素中的所有現有文字。 |
| 瀏覽器執行個體是否開啟 |
報告 IA-Connect 代理程式是否正在執行瀏覽器執行個體。 |
| 焦點網頁元素 |
聚焦 HTML 元素。 這會讓元素成為鍵盤焦點的作用中元素，並可能將元素帶到前景。 |
| 獲取 Chromium Edge 驅動程序文件夾 |
取得與目前 Chromium Edge EXE 版本搭配使用的 ChromiumEdgeDriver 版本的 ChromiumEdgeDriver 資料夾路徑。 這是由“打開 Chromium Edge”操作使用的，您不太可能需要直接調用它。 |
| 等待 Web 元素存在 |
等候指定的 Web 元素存在。 |
| 等待網頁元素不存在 |
等候指定的 Web 元素不再存在。 |
| 網頁元素存在嗎 |
報告 HTML 元素目前是否存在。 此動作不會等待 HTML 元素。 |
| 設定使用中的瀏覽器視窗位置 |
將瀏覽器視窗移至指定的像素座標。 |
| 設定使用中的瀏覽器視窗大小 |
將瀏覽器視窗調整為指定的寬度和高度尺寸。 |
| 設定瀏覽器逾時 |
設定 IA-Connect 與網頁瀏覽器互動時使用的內部逾時。 |
| 設定網頁瀏覽器索引標籤 |
設定作用中索引標籤，並切換 IA-Connect 代理程式以控制此索引標籤，以便與其互動。 |
| 貼到網頁元素中 |
將剪貼簿的內容貼到 HTML 元素 （通常是文字輸入欄位） 中。 |
| 選擇網頁選擇清單項目 |
選取選取 HTML 元素上的選項，依 [文字]、[值] 或 [索引]。 您可以使用「取得選取範圍屬性」動作來探索選取範圍中每個選項的文字、值或索引。 |
| 重設所有 Web 元素控點 |
重設 IA-Connect Agent 目前保留的所有 Web 元素控點。 此動作通常用於記憶體清理，而且只建議用於大型複雜進程，這會導致儲存大量元素句柄 （10,000+）。 |
| 重設瀏覽器網頁框架堆疊 |
重設瀏覽器框架堆疊。 只有在獲得 Ultima 技術支援的批准後才應使用此功能。 |
| 開啟 Chromium Edge 瀏覽器 |
開啟 Chromium Edge 網頁瀏覽器，允許使用此 IA-Connect 模組中的動作將其自動化。 如果 Web 瀏覽器是由其他應用程式手動開啟，或使用「執行處理程序」動作開啟，則只能使用 UIA 動作來自動化，而不能使用此 IA-Connect 模組中的動作來自動化。 |
| 開啟 Google Chrome 瀏覽器 |
開啟 Google Chrome 網頁瀏覽器，允許使用此 IA-Connect 模組中的動作將其自動化。 如果 Web 瀏覽器是由其他應用程式手動開啟，或使用「執行處理程序」動作開啟，則只能使用 UIA 動作來自動化，而不能使用此 IA-Connect 模組中的動作來自動化。 |
| 開啟 Internet Explorer 瀏覽器 |
開啟 Internet Explorer Web 瀏覽器，允許使用此 IA-Connect 模組中的動作將其自動化。 如果 Web 瀏覽器是由其他應用程式手動開啟，或使用「執行處理程序」動作開啟，則只能使用 UIA 動作來自動化，而不能使用此 IA-Connect 模組中的動作來自動化。 |
| 開啟新的網頁瀏覽器索引標籤 |
在瀏覽器視窗中開啟新索引標籤。 在 Internet Explorer 中，此動作會開啟一個新視窗，但新視窗的行為就像索引標籤一樣，並且可以與具有「取得瀏覽器索引標籤」或「設定瀏覽器索引標籤」動作的索引標籤相同的方式進行互動。 |
| 關閉 Chromium Edge 瀏覽器 |
關閉使用「開啟 Chromium Edge」動作開啟的 Chromium Edge 瀏覽器。 |
| 關閉 Google Chrome 瀏覽器 |
關閉使用「開啟 Chrome」動作開啟的 Google Chrome 網頁瀏覽器。 |
| 關閉 Internet Explorer 瀏覽器 |
關閉使用「開啟 Internet Explorer」動作開啟的 Internet Explorer 瀏覽器。 |
| 關閉作用中的網頁瀏覽器索引標籤 |
關閉目前使用中的瀏覽器標籤。呼叫此動作後，預設情況下，IA-Connect 代理將不會切換到新的活動標籤。 若要重新附加至另一個分頁，您必須先呼叫「設定瀏覽器分頁」動作，然後再嘗試與頁面互動。 |
JavaScript模擬點擊網頁元素
透過告訴瀏覽器的 JavaScript 引擎執行左鍵單擊來模擬滑鼠操作。 這是「模擬滑鼠左鍵單擊元素」操作的替代方案，通常足以讓網頁按預期做出反應。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
上傳新的 ChromeDriver
將新版本的 ChromeDriver 從本機系統 （數位工作者） 上傳至 IA-Connect Agent 工作階段，以與 Google Chrome 搭配使用。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
本機 ChromeDriver 檔案路徑
|
LocalChromeDriverFilePath | True | string |
在 Chrome 瀏覽器主要版本的本機工作階段 （執行 IA-Connect Director 的位置） 中 ChromeDriver.exe 的檔案路徑。 這會上傳到 IA-Connect 代理程式工作階段，並且只有在 Citrix 或 RDP 工作階段中執行 IA-Connect 代理程式時才應使用。 |
|
壓縮
|
Compress | boolean |
上傳時是否應該壓縮 ChromeDriver？ |
|
|
Chrome EXE 主要版本
|
ChromeBrowserMajorVersion | integer |
執行 IA-Connect Agent 的工作階段中安裝的 Chrome 瀏覽器的主要版本 （例如 91）。 |
|
|
ChromeDriver 遠端家長儲存資料夾
|
ChromeDriverRootSaveFolder | string |
應在 IA-Connect Agent 工作階段中儲存 ChromeDriver 的資料夾的檔案路徑。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
上傳新的 Chromium Edge 驅動程式
將新版本的 ChromiumEdgeDriver 從本機系統 （數位背景工作者） 上傳至要與 Chromium Edge 搭配使用的 IA-Connect 代理程式工作階段。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
本機 ChromiumEdgeDriver 檔案路徑
|
LocalChromiumEdgeDriverFilePath | True | string |
在 Chromium Edge 瀏覽器主要版本的本機會話 （執行 IA-Connect Director 的位置） 中 msedgedriver.exe 的檔案路徑。 這會上傳到 IA-Connect 代理程式工作階段，並且只有在 Citrix 或 RDP 工作階段中執行 IA-Connect 代理程式時才應使用。 |
|
壓縮
|
Compress | boolean |
上傳時是否應該壓縮 ChromiumEdgeDriver？ |
|
|
Chromium Edge EXE 主要版本
|
ChromiumEdgeBrowserMajorVersion | integer |
Chromium Edge 瀏覽器的主要版本（例如 91）安裝在執行 IA-Connect Agent 的工作階段中。 |
|
|
ChromiumEdgeDriver 遠端父儲存資料夾
|
ChromiumEdgeDriverRootSaveFolder | string |
應在 IA-Connect Agent 工作階段中儲存 ChromiumEdgeDriver 的資料夾的檔案路徑。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
以像素捲動瀏覽器視窗
將瀏覽器視窗捲動指定的像素數。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
X 像素
|
X | double |
要捲動視窗的 X 像素數。 正數的像素將向右滾動，負數將向左滾動。 |
|
|
Y 像素
|
Y | double |
捲動視窗的 Y 像素數。 正數的像素將向下滾動，負數將向上滾動。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
全局鼠標右鍵單擊 Web 元素
將滑鼠移至 HTML 元素的中心，然後按下滑鼠右鍵。 在元素預期滑鼠在您按下元素之前位於元素上的情況下，有時會使用這來代替「點擊元素」。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
按一下偏移 X
|
ClickOffsetX | integer |
以像素為單位的選用值，用於偏移相符元素中心點按的次數。 若要進一步按一下右側，請提供正值，若要進一步按一下左側，請提供負值。 依預設，此值會設定為 0。 |
|
|
按一下偏移 Y
|
ClickOffsetY | integer |
以像素為單位的選用值，用於偏移相符元素中心點按的次數。 若要進一步向下按一下，請提供正值，若要進一步向上按一下，請提供負值。 依預設，此值會設定為 0。 |
|
|
焦點第一
|
FocusFirst | boolean |
在嘗試點擊之前，是否應該先聚焦 HTML 元素？ |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
全局鼠標左鍵單擊 Web 元素
將滑鼠移至 HTML 元素的中心，然後按下滑鼠左鍵。 在元素預期滑鼠在您按下元素之前位於元素上的情況下，有時會使用這來代替「點擊元素」。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
按一下偏移 X
|
ClickOffsetX | integer |
以像素為單位的選用值，用於偏移相符元素中心點按的次數。 若要進一步按一下右側，請提供正值，若要進一步按一下左側，請提供負值。 依預設，此值會設定為 0。 |
|
|
按一下偏移 Y
|
ClickOffsetY | integer |
以像素為單位的選用值，用於偏移相符元素中心點按的次數。 若要進一步向下按一下，請提供正值，若要進一步向上按一下，請提供負值。 依預設，此值會設定為 0。 |
|
|
焦點第一
|
FocusFirst | boolean |
在嘗試點擊之前，是否應該先聚焦 HTML 元素？ |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
全螢幕作用中瀏覽器
將網頁瀏覽器設定為全螢幕，使網站佔據整個螢幕（隱藏瀏覽器導覽工具列、網址列、開始列等）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
切換至網頁根框架
將 IA-Connect 代理切換為控制網頁內的根框架或與之互動。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
切換至網頁框架
將 IA-Connect 代理切換為控制瀏覽器頁面中的替代框架或與之互動。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
切換至網頁父框架
將 IA-Connect 代理切換為控制網頁內目前框架的父框架或與之互動。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
列印目前網頁
列印目前網頁。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
取得 ChromeDriver 資料夾
取得與目前 Chrome EXE 版本搭配使用的 ChromeDriver 版本的 ChromeDriver 資料夾路徑。 這是由「開啟 Chrome」操作使用的，您不太可能需要直接呼叫此操作。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
ChromeDriver 父資料夾
|
DirectoryPath | True | string |
父資料夾，其中包含 ChromeDriver 資料夾 （本身包含 Chrome 主要版本的 ChromeDriver.exe）。 |
|
Chrome EXE 主要版本
|
ChromeMajorVersion | integer |
安裝在執行代理程式的工作階段中的 Chrome 瀏覽器的主要版本（例如 91）。 |
|
|
Chrome EXE 路徑
|
ChromeBrowserEXE | string |
Chrome.exe的可選路徑，如果未安裝在預設位置（或您使用的是Dev或Canary版本的Chrome）。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ChromeDriver 資料夾
|
ChromeDriverFolder | string |
包含 Chrome 瀏覽器主要版本正確版本 ChromeDriver.exe 的資料夾路徑。 |
取得多個網頁元素屬性
傳回符合搜尋準則之所有 HTML 元素的屬性。 搜尋是相對於文件的根目錄 （父元素控點 = 0） 或先前找到的元素 （父元素控點 > 0）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
取得 HTML 程式碼
|
GetHTMLCode | boolean |
是否應該傳回元素的 HTML 程式碼 （內部和外部） ？ |
|
|
建立控點
|
CreateHandle | boolean |
IA-Connect 應該傳回任何相符元素的元素句柄嗎？ 這可用作對此元素採取進一步動作的輸入。 |
|
|
返回值
|
ReturnValue | boolean |
IA-Connect 應該傳回每個相符元素的 HTML 值嗎？ |
|
|
傳回文字
|
ReturnText | boolean |
IA-Connect 應該傳回每個相符元素的 HTML 文字值嗎？ |
|
|
最大值長度
|
MaxValueLength | integer |
要傳回的 HTML 值中字元數上限。 這對於限制 HTML 元素具有長值時傳回的資料量非常有用。 如果設定為 0，則會傳回整個值。 |
|
|
文字長度上限
|
MaxTextLength | integer |
要傳回的 HTML 文字值中的字元數上限。 如果 HTML 元素具有長文字值，這對於限制傳回的資料量非常有用。 如果設定為 0，則會傳回整個文字值。 |
|
|
顯示返回
|
ReturnIsDisplayed | boolean |
IA-Connect 是否應該傳回是否顯示每個相符的元素？ |
|
|
返回座標
|
ReturnCoordinates | boolean |
IA-Connect 應該傳回每個相符元素的座標嗎？ |
|
|
返回尺寸
|
ReturnDimensions | boolean |
IA-Connect 應該傳回每個匹配元素的高度和寬度嗎？ |
|
|
傳回子元素計數
|
ReturnChildElementCount | boolean |
IA-Connect 應該傳回每個相符元素的子元素計數嗎？ |
|
|
傳回父標籤
|
ReturnParentTag | boolean |
IA-Connect 應該傳回每個相符元素的父項的 HTML 標籤嗎？ |
|
|
第一個要退貨的商品
|
FirstItemToReturn | integer |
要傳回的第一個項目的索引，從 1 開始。 |
|
|
退貨項目上限
|
MaxItemsToReturn | integer |
要傳回的元素數目上限，或所有元素的 0。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
找到的元素數量
|
NumberOfElementsFound | double |
找到符合搜尋條件的元素數目。 |
|
元素屬性
|
ElementProperties | array of object |
符合搜尋準則之所有元素的清單。 |
|
items
|
ElementProperties | object | |
|
更多可用元素
|
MoreElementsAvailable | boolean |
符合搜尋條件但未傳回的其他元素數量 （例如，搜尋受到「傳回項目數目上限」參數的限制）。 |
取得瀏覽器父視窗詳細資料
傳回 IA-Connect Agent 目前正在與之互動的瀏覽器父視窗的屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
瀏覽器進程標識符
|
BrowserPID | integer |
執行中瀏覽器處理程序的選擇性處理程序識別碼。 如果未指定此參數，則 IA-Connect 會使用上次啟動的瀏覽器處理程序的處理程序 ID。 |
|
|
搜尋文件元素類別名稱
|
SearchDocumentElementClassName | string |
瀏覽器文件元素的選擇性 UIA 元素類別名稱。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
瀏覽器父視窗元素名稱
|
MainWindowElementName | string |
瀏覽器父視窗元素的 HTML 名稱。 |
|
瀏覽器父視窗元素類別名稱
|
MainWindowElementClassName | string |
瀏覽器父視窗元素的 HTML 類別名稱。 |
|
瀏覽器父視窗元素左 X 像素
|
MainWindowLeftXPixels | integer |
瀏覽器父視窗元素左邊緣的 X 座標，以像素為單位。 |
|
瀏覽器父視窗元素前 Y 像素
|
MainWindowTopYPixels | integer |
瀏覽器父視窗元素頂部邊緣的 Y 座標 （以像素為單位）。 |
|
瀏覽器父視窗元素寬度像素
|
MainWindowWidthPixels | integer |
瀏覽器父視窗元素的寬度 （以像素為單位）。 |
|
瀏覽器父視窗元素高度像素
|
MainWindowHeightPixels | integer |
瀏覽器父視窗元素的高度 （以像素為單位）。 |
|
瀏覽器文件元素名稱
|
DocumentElementName | string |
瀏覽器文件元素的 HTML 名稱。 |
|
瀏覽器文件元素類別名稱
|
DocumentElementClassName | string |
瀏覽器文件元素的 HTML 類別名稱。 |
|
瀏覽器文件元素左 X 像素
|
DocumentLeftXPixels | integer |
瀏覽器文件元素左邊緣的 X 座標，以像素為單位。 |
|
瀏覽器文件元素前端 Y 像素
|
DocumentTopYPixels | integer |
瀏覽器文件元素上緣的 Y 座標 （以像素為單位）。 |
|
瀏覽器文件元素寬度像素
|
DocumentWidthPixels | integer |
瀏覽器文件元素的寬度（以像素為單位）。 |
|
瀏覽器文件元素高度像素
|
DocumentHeightPixels | integer |
瀏覽器文件元素的高度（以像素為單位）。 |
取得目前網頁框架視窗像素座標
傳回目前 HTML 框架的圖元座標，相對於瀏覽器文件視窗 （顯示網頁的區域）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
X
|
X | integer |
目前 HTML 框架左上角相對於瀏覽器文件視窗的 X 座標 （以像素為單位）。 |
|
是
|
Y | integer |
目前 HTML 框架左上角相對於瀏覽器文件視窗的 Y 座標 （以像素為單位）。 |
|
寬度
|
Width | integer |
目前 HTML 框架的寬度。 |
|
高度
|
Height | integer |
目前 HTML 框架的高度。 |
取得網頁元素子屬性
傳回符合搜尋條件之主文件 （「父元素」控點 = 0） 或先前找到的元素 （「父元素」控點 > 0） 的直接子元素 （搜尋子樹狀結構 = false） 或所有子項 （搜尋子樹 = true） 的屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
Unused. 此動作會在內部使用 XPath 來執行子項或子項搜尋，因此會忽略此輸入。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
取得 HTML 程式碼
|
GetHTMLCode | boolean |
是否應該傳回元素的 HTML 程式碼 （內部和外部） ？ |
|
|
建立控點
|
CreateHandle | boolean |
IA-Connect 應該傳回子元素的元素句柄嗎？ 這可用作對此元素採取進一步動作的輸入。 |
|
|
搜尋子樹狀結構
|
SearchSubTree | boolean |
如果設定為 true，則會搜尋父元素句柄下方的整個 HTML 樹狀結構。 這更徹底，但可能需要更長的時間。 如果設定為 false，則只會搜尋 HTML 樹狀結構中父元素句柄正下方的元素。 |
|
|
返回值
|
ReturnValue | boolean |
IA-Connect 應該傳回每個相符元素的 HTML 值嗎？ |
|
|
傳回文字
|
ReturnText | boolean |
IA-Connect 應該傳回每個相符元素的 HTML 文字值嗎？ |
|
|
最大值長度
|
MaxValueLength | integer |
要傳回的 HTML 值中字元數上限。 這對於限制 HTML 元素具有長值時傳回的資料量非常有用。 如果設定為 0，則會傳回整個值。 |
|
|
文字長度上限
|
MaxTextLength | integer |
要傳回的 HTML 文字值中的字元數上限。 如果 HTML 元素具有長文字值，這對於限制傳回的資料量非常有用。 如果設定為 0，則會傳回整個文字值。 |
|
|
顯示返回
|
ReturnIsDisplayed | boolean |
IA-Connect 是否應該傳回是否顯示每個相符的元素？ |
|
|
返回座標
|
ReturnCoordinates | boolean |
IA-Connect 應該傳回每個相符元素的座標嗎？ |
|
|
返回尺寸
|
ReturnDimensions | boolean |
IA-Connect 應該傳回每個匹配元素的高度和寬度嗎？ |
|
|
傳回子元素計數
|
ReturnChildElementCount | boolean |
IA-Connect 應該傳回每個相符元素的子元素計數嗎？ |
|
|
傳回父標籤
|
ReturnParentTag | boolean |
IA-Connect 應該傳回每個相符元素的父項的 HTML 標籤嗎？ |
|
|
第一個要退貨的商品
|
FirstItemToReturn | integer |
要傳回的第一個項目的索引，從 1 開始。 |
|
|
退貨項目上限
|
MaxItemsToReturn | integer |
要傳回的元素數目上限，或所有元素的 0。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
找到的元素數量
|
NumberOfElementsFound | double |
為符合搜尋準則的元素找到的子元素數目。 |
|
元素屬性
|
ElementProperties | array of object |
符合搜尋準則之元素之所有子元素的清單。 |
|
items
|
ElementProperties | object | |
|
更多可用元素
|
MoreElementsAvailable | boolean |
符合搜尋條件但未傳回的元素的其他子元素數量 （例如，搜尋受到「要傳回的項目數上限」參數的限制）。 |
取得網頁元素屬性
取得 HTML 元素的屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
取得 HTML 程式碼
|
GetHTMLCode | boolean |
是否應該傳回元素的 HTML 程式碼 （內部和外部） ？ |
|
|
傳回元素控點
|
ReturnElementHandle | boolean |
IA-Connect 應該傳回任何相符元素的元素句柄嗎？ 這可用作對此元素採取進一步動作的輸入。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素名稱
|
ElementName | string |
相符元素的 HTML 名稱。 |
|
元素 ID
|
ElementID | string |
相符元素的 HTML ID。 |
|
元素標籤名稱
|
ElementTagName | string |
相符元素的 HTML 標籤名稱。 |
|
元素類別名稱
|
ElementClassName | string |
相符元素的 HTML 類別名稱。 |
|
元素值
|
ElementValue | string |
相符元素的 HTML 值。 |
|
元素文字
|
ElementText | string |
相符元素的 HTML 文字值。 |
|
元素已啟用
|
ElementEnabled | boolean |
如果已啟用相符元素，則傳回 true，如果未啟用，則傳回 false。 |
|
顯示的元素
|
ElementDisplayed | boolean |
如果顯示相符元素，則傳回 true，如果未顯示，則傳回 false。 |
|
元素 X 座標
|
ElementXCoordinate | double |
相符元素左上角的 X 座標 （以像素為單位）。 |
|
元素 Y 座標
|
ElementYCoordinate | double |
相符元素左上角的 Y 座標 （以像素為單位）。 |
|
元素寬度
|
ElementWidth | double |
元素寬度 （以像素為單位）。 |
|
元素高度
|
ElementHeight | double |
元素高度（以像素為單位）。 |
|
選取的元素
|
ElementSelected | boolean |
如果選取相符元素，則傳回 true，如果未選取，則傳回 false。 |
|
項目類型
|
ElementType | string |
相符元素的 HTML 類型。 |
|
內部HTML
|
InnerHTML | string |
相符元素的內部HTML程式碼，包含所有直接子元素。 只有在「取得 HTML 程式碼」參數設定為 true 時，才會傳回此屬性。 |
|
外部 HTML
|
OuterHTML | string |
匹配元素的外部HTML程式碼，包含所有直接子元素和匹配元素程式碼。 只有在「取得 HTML 程式碼」參數設定為 true 時，才會傳回此屬性。 |
|
子元素計數
|
ChildElementCount | double |
為相符元素找到的直接子元素數目。 |
|
父標籤名稱
|
ParentTagName | string |
相符元素的父元素的 HTML 標籤名稱。 |
|
元素控點
|
ElementHandle | double |
相符元素的控制碼。 這可用作作用於此元素的進一步動作的輸入。 |
取得網頁元素屬性作為清單
將 Web 元素的屬性傳回為單行清單 （單行集合/資料表） ，而不是個別項目，這可能會有用，視您打算如何使用資料而定。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
元素控點
|
ElementHandle | True | integer |
目標 Web 元素的控制碼。 |
|
取得 HTML 程式碼
|
GetHTMLCode | boolean |
是否應該傳回元素的 HTML 程式碼 （內部和外部） ？ |
|
|
返回值
|
ReturnValue | boolean |
IA-Connect 應該傳回元素的HTML值嗎？ |
|
|
傳回文字
|
ReturnText | boolean |
IA-Connect 應該傳回元素的 HTML 文字值嗎？ |
|
|
最大值長度
|
MaxValueLength | integer |
要傳回的 HTML 值中字元數上限。 如果 HTML 元素具有長值，這對於限制傳回的資料量非常有用。 如果設定為 0，則會傳回整個值。 |
|
|
文字長度上限
|
MaxTextLength | integer |
要傳回的 HTML 文字值中的字元數上限。 如果 HTML 元素具有長文字值，這對於限制傳回的資料量非常有用。 如果設定為 0，則會傳回整個文字值。 |
|
|
返回座標
|
ReturnCoordinates | boolean |
IA-Connect 應該傳回元素的座標嗎？ |
|
|
傳回父標籤
|
ReturnParentTag | boolean |
IA-Connect 應該傳回元素父項的 HTML 標籤嗎？ |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
找到的元素數量
|
NumberOfElementsFound | integer |
找到的元素數目。 |
|
傳回的元素數目
|
NumberOfElementsReturned | integer |
傳回的元素數目。 |
|
元素屬性 JSON
|
ElementPropertiesJSON | string |
Web 元素的屬性，採用 JSON 格式。 |
取得網頁元素父屬性
取得相符 HTML 元素的父元素屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
取得 HTML 程式碼
|
GetHTMLCode | boolean |
是否應該傳回元素的 HTML 程式碼 （內部和外部） ？ |
|
|
建立控點
|
CreateHandle | boolean |
IA-Connect 應該傳回父元素的元素句柄嗎？ 這可用作對此元素採取進一步動作的輸入。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
找到的元素數量
|
NumberOfElementsFound | double |
為符合搜尋準則的元素找到的父元素數目。 |
|
元素屬性
|
ElementProperties | array of object |
符合搜尋準則之元素之所有父元素的清單。 |
|
items
|
ElementProperties | object |
取得網頁元素畫面邊界矩形
傳回 HTML 元素的左、右、上、下邊緣相對於工作階段畫面的圖元座標。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素畫面左側像素
|
ElementScreenLeftPixels | double |
元素左邊緣的座標 （以像素為單位），相對於工作階段畫面。 |
|
元素螢幕右圖元
|
ElementScreenRightPixels | double |
元素右邊緣的座標，以像素為單位，相對於工作階段畫面。 |
|
元素螢幕頂端像素
|
ElementScreenTopPixels | double |
元素頂部邊緣的座標，以像素為單位，相對於工作階段畫面。 |
|
元素螢幕底部像素
|
ElementScreenBottomPixels | double |
元素底部邊緣的座標 （以像素為單位），相對於工作階段畫面。 |
|
元素螢幕中心 X 像素
|
ElementScreenCenterXPixels | double |
元素中心的 X 座標 （以像素為單位），相對於工作階段畫面。 |
|
元素螢幕中心 Y 像素
|
ElementScreenCenterYPixels | double |
元素中心的 Y 座標 （以像素為單位），相對於工作階段畫面。 |
|
元素在螢幕上
|
ElementIsOnscreen | boolean |
如果元素目前在螢幕上，則傳回 true，如果沒有，則傳回 false。 |
|
螢幕外方向
|
OffscreenDirection | string |
如果元素目前不在螢幕上，則會傳回螢幕外方向 （上、下、左或右）。 |
取得網頁元素邊界矩形
傳回 HTML 元素的左、右、上和下邊緣相對於瀏覽器文件視窗 （顯示網頁的區域） 的圖元座標。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素左像素
|
ElementLeftPixels | double |
元素左邊緣的座標 （以像素為單位），相對於父瀏覽器視窗。 |
|
元素右圖元
|
ElementRightPixels | double |
元素右邊緣的座標，以像素為單位，相對於父瀏覽器視窗。 |
|
元素頂部像素
|
ElementTopPixels | double |
元素頂部邊緣的座標（以像素為單位），相對於父瀏覽器視窗。 |
|
元素底部像素
|
ElementBottomPixels | double |
元素底部邊緣的座標 （以像素為單位），相對於父瀏覽器視窗。 |
|
元素中心 X 像素
|
ElementCenterXPixels | double |
元素中心的 X 座標 （以像素為單位），相對於父瀏覽器視窗。 |
|
元素中心 Y 像素
|
ElementCenterYPixels | double |
元素中心的 Y 座標 （以像素為單位），相對於父瀏覽器視窗。 |
取得網頁文字
選取整個瀏覽器頁面，將它複製到執行 IA-Connect Agent 的工作階段中的剪貼簿，然後傳回剪貼簿內容，以取得目前頁面上的所有文字。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
頁面文字
|
PageText | string |
傳回目前頁面上的所有文字。 |
取得網頁瀏覽器索引標籤
傳回瀏覽器視窗中開啟的目前索引標籤。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
索引標籤數目
|
NumberOfTabs | integer |
目前在瀏覽器視窗中開啟的索引標籤數目。 |
|
目前的索引標籤控點
|
CurrentTabHandle | string |
內部瀏覽器索引標籤控點字串。 |
|
瀏覽器索引標籤作為 JSON
|
BrowserTabsJSON | string |
開啟的瀏覽器索引標籤的屬性，採用 JSON 格式。 |
取得網頁表格內容
傳回 HTML 表格元素的內容。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
從資料列建立資料行名稱
|
CreateColumnNamesFromRow | double |
包含要用於輸出的直欄標頭之列的索引號碼 （從 1 開始）。 如果沒有一列是標頭，則設定為 0，導致 IA-Connect 使用欄標頭 'Column 1'， 'Column 2'， ... ， 'Column N'。 在大部分情況下，請輸入 0 或 1。 |
|
|
合併子資料表
|
MergeChildTables | boolean |
是否應該將任何子表合併到輸出中？ |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
列數
|
NumberOfRows | double |
HTML 表格中的列數。 |
|
欄數
|
NumberOfColumns | double |
HTML 表格中的欄數。 |
|
表格內容JSON
|
TableContentsJSON | string |
HTML 表格的內容，採用 JSON 格式。 |
取得網頁選取清單屬性
傳回選取 HTML 元素的所有選項及其屬性。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
選取的選項文字
|
SelectedOptionText | string |
目前所選選項的文字值。 |
|
選取的選項值
|
SelectedOptionValue | string |
目前所選選項的值。 |
|
選項數量
|
NumberOfOptions | double |
可選取的選項數目。 |
|
選取選項
|
SelectionOptions | array of object |
包含所有可用選項值的集合，以及目前是否已選取選項。 |
|
items
|
SelectionOptions | object |
取消選取網頁選取清單中的所有項目
取消選取支援多重選取的選取元素中目前選取的所有選項。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
取消選取網頁選取清單項目
取消選取所選 HTML 元素上的選項，依 Text、Value 或 Index。 您可以使用「取得選取範圍屬性」動作來探索選取範圍中每個選項的文字、值或索引。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
要取消選取的值
|
ValueToDeselect | string |
要取消選取的選取選項值。 |
|
|
要取消選取的文字
|
TextToDeselect | string |
要取消選取的選取選項的文字值。 |
|
|
要取消選取的索引
|
IndexToDeselect | double |
要取消選取的選取選項的索引。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
在 Web 元素上按 Enter 鍵
在 HTML 元素上按 Enter 鍵。 這可用於提交元素或在某些情況下與按鈕互動。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
在活動瀏覽器中刷新當前網頁
重新整理目前的瀏覽器頁面。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
在瀏覽器文件視窗座標處取得網頁元素
傳回位於指定瀏覽器文件視窗座標的網頁元素。 此座標以相對於瀏覽器文件視窗或框架左上角的像素為單位 （如果 IA-Connect 已逐步進入框架）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
瀏覽器文件視窗 X 座標
|
XCoord | integer |
瀏覽器文件視窗 X 座標值 （相對於瀏覽器文件視窗或框架的像素），應搜尋 Web 元素。 |
|
|
瀏覽器文件視窗 Y 座標
|
YCoord | integer |
瀏覽器文件視窗 Y 座標值 （相對於瀏覽器文件視窗或框架的左上角），其中應搜尋 Web 元素。 |
|
|
如果找不到元素，則引發例外狀況
|
RaiseExceptionIfElementNotFound | boolean |
如果 Web 元素不在指定位置，IA-Connect 應該引發例外狀況嗎？ |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果 Web 元素存在，則傳回 true，如果不存在，則傳回 false。 |
|
元素控點
|
ElementHandle | double |
已定位 Web 元素的控制碼。 這可用作對此 Web 元素執行的進一步動作的輸入。 如果找不到 Web 元素，則此輸出將設定為 0。 |
|
元素標籤名稱
|
ElementTagName | string |
所在元素的 HTML 標籤名稱。 |
在網頁中執行JavaScript
在網頁中執行提供的JavaScript程式碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
JavaScript程式碼
|
JavaScriptCode | True | string |
要在網頁中執行的JavaScript程式碼。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
JavaScript 回應
|
JavaScriptResponse | string |
執行程式碼後收到的JavaScript回應訊息。 |
在網頁元素上全選
選取 HTML 元素的所有內容 （通常是文字欄位）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
在網頁元素上執行JavaScript
在選取的 HTML 元素上執行提供的 JavaScript 程式碼。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
JavaScript程式碼
|
JavaScriptToExecute | True | string |
要在相符元素上執行的 JavaScript 程式碼。 若要參考 JavaScript 中的元素，請使用 arguments[0]。 範例：為元素賦值：arguments[0].value='test';讀取元素值：return arguments[0].value;聚焦元素：arguments[0].focus（）;。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
JavaScript 回應
|
JavaScriptResponse | string |
執行程式碼後收到的JavaScript回應訊息。 |
在網頁元素上複製選取的文字
將目前選取的所有文字從網頁元素複製到剪貼簿。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
在網頁元素中輸入密碼
將密碼輸入 HTML 元素 （通常是文字輸入欄位），取代現有值或將新值附加至任何現有值。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
輸入密碼
|
PasswordToInput | True | password |
要輸入到相符元素中的密碼值。 如果「重設現有值」參數設定為 true，則元素中的任何現有文字都會被覆寫。 如果「重設現有值」參數設定為 false，則會附加至現有文字。 |
|
重設現有值
|
ResetExistingValue | boolean |
是否應該刪除匹配元素中的任何現有文本？ 依預設，此設定為 true。 |
|
|
密碼包含儲存的密碼
|
PasswordContainsStoredPassword | boolean |
如果密碼包含 （或完全） IA-Connect 儲存的密碼識別碼 （格式為 {IAConnectPassword：StoredPasswordIdentifier}） 或 IA-Connect Orchestrator 一般認證 （格式為 {OrchestratorCredential：FriendlyName}），則設定為 true。 例如，此儲存的密碼可能是由「產生密碼」動作產生，或由 IA-Connect Orchestrator 保留。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
在網頁元素周圍繪製矩形
在 HTML 元素的周邊繪製矩形，以協助識別找到的元素是必要的元素。 矩形會在 5 秒後自動移除。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
筆顏色
|
PenColour | string |
要繪製的矩形的顏色（例如紅色、綠色、藍色、黃色、紫色或橙色）或字符串十六進制代碼（例如 #FF0000）。 |
|
|
手寫筆粗細像素
|
PenThicknessPixels | integer |
醒目提示矩形框線的粗細 （以像素為單位）。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
在螢幕座標處取得網頁元素
傳回位於指定螢幕座標的網頁元素。 這些將映射到瀏覽器文檔窗口和框架坐標以獲取元素。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
X 座標
|
XCoord | integer |
應搜尋網頁元素的螢幕 X 座標值 （以像素為單位）。 |
|
|
Y 座標
|
YCoord | integer |
應搜尋網頁元素的螢幕 Y 座標值 （以像素為單位）。 |
|
|
如果找不到元素，則引發例外狀況
|
RaiseExceptionIfElementNotFound | boolean |
如果 Web 元素不在指定位置，IA-Connect 應該引發例外狀況嗎？ |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果 Web 元素存在，則傳回 true，如果不存在，則傳回 false。 |
|
元素控點
|
ElementHandle | double |
已定位 Web 元素的控制碼。 這可用作對此 Web 元素執行的進一步動作的輸入。 如果找不到 Web 元素，則此輸出將設定為 0。 |
|
元素標籤名稱
|
ElementTagName | string |
所在元素的 HTML 標籤名稱。 |
將使用中的瀏覽器導覽至 URL
將瀏覽器導覽至提供的 URL。 IA-Connect 將等待頁面載入後再返回。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
URL
|
URL | True | string |
要導覽至的頁面 URL。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
頁面標題
|
PageTitle | string |
載入後頁面的標題。 |
|
頁面網址
|
PageURL | string |
載入頁面後的 URL。 |
將使用中的瀏覽器降到最低
將目前控制的網頁瀏覽器最小化（使用瀏覽器「開啟」動作開啟的最後一個瀏覽器）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
將文字輸入到多個網頁元素中
將文字輸入到多個 HTML 元素（通常是文字輸入欄位）中，取代現有文字或將新值附加到任何現有值。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
輸入元素為 JSON
|
InputElementsJSON | True | string |
要輸入文字的 HTML 元素屬性，採用 JSON 格式。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
將文字輸入到網頁元素中
將文字輸入 HTML 元素 （通常是文字輸入欄位），取代現有文字或將新值附加至任何現有值。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
要輸入的文字
|
TextToInput | string |
要輸入到相符元素中的文字值。 如果「重設現有值」參數設定為 true，則元素中的任何現有文字都會被覆寫。 如果「重設現有值」參數設定為 false，則會附加至現有文字。 |
|
|
重設現有值
|
ResetExistingValue | boolean |
是否應該刪除匹配元素中的任何現有文本？ 依預設，此設定為 true。 |
|
|
插入位置
|
InsertPosition | integer |
開始插入文字的位置 （索引）。 如果有現有文字，且「重設現有值」設定為 false，則可以使用插入位置在現有文字內的特定位置插入。 使用值 -1 （預設值） 插入結尾。 使用值 0 插入開頭。 值 1 或更高的值將插入現有文字中指定的位置之後。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
先前的值
|
PreviousValue | string |
輸入文字之前相符元素的先前值。 |
將瀏覽器視窗捲動至像素
將瀏覽器視窗捲動至指定的圖元座標。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
X 像素
|
X | double |
要將目前視窗捲動至的 X 圖元，其中 0 是最左邊的邊緣。 |
|
|
Y 像素
|
Y | double |
要將目前視窗捲動至的 Y 圖元，其中 0 是最上端的邊緣。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
將網頁儲存至檔案
將目前的 HTML 頁面儲存到磁碟上的檔案。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
檔名
|
SaveFilename | True | string |
要將目前 HTML 頁面儲存到的完整檔案路徑。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
將網頁元素捲動至檢視
向上、向下、向左或向右捲動網頁，直到 HTML 元素出現在螢幕上。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
建立父 Web 元素的控點
建立 HTML 元素父系的控點。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素控點
|
ElementHandle | double |
相符元素的控制碼。 這可用作作用於此元素的進一步動作的輸入。 |
|
元素標籤名稱
|
ElementTagName | string |
相符元素的 HTML 標籤名稱。 |
建立網頁元素的控點
建立 HTML 元素的控點。 此句柄可用來自動化子 HTML 元素。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素控點
|
ElementHandle | double |
相符元素的控制碼。 這可用作作用於此元素的進一步動作的輸入。 |
|
元素標籤名稱
|
ElementTagName | string |
相符元素的 HTML 標籤名稱。 |
從 Internet 下載合適的 Chromium Edge 驅動程序
在執行 IA-Connect Agent 的工作階段中，判斷哪個版本的 Chromium Edge 驅動程式適合已安裝的 Chromium Edge 瀏覽器版本，檢查是否已下載合適的版本，如果沒有，則嘗試從 Chromium Edge 驅動程式網頁下載合適的版本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Chromium Edge EXE 路徑
|
ChromiumEdgeBrowserEXE | string |
如果未安裝在預設位置 （或您使用的 Chromium Edge 的 Dev 或 Canary 版本） ，則 msedge.exe 的選擇性路徑。 |
|
|
Chromium Edge 驅動程式下載父資料夾
|
ChromiumEdgeDriverDownloadParentFolder | True | string |
儲存或下載所有 Chromium Edge 驅動程式的父資料夾。 每個 Chromium Edge 驅動程式都儲存在版本化子資料夾中，以符合 Chromium Edge 瀏覽器的主要版本。 將檢查此資料夾結構是否有合適的 Chromium Edge 驅動程序，如果找不到，則會從 Internet 下載到此資料夾中。 |
|
Chromium Edge 驅動程式根網頁 URL
|
ChromiumEdgeDriverRootWebPageURL | string |
根網頁 URL，其下的所有 Chromium Edge 驅動程式都可供下載。 這預設為 Chromium Edge 驅動程式網站的正確根網頁，但如果存在替代位置，您可以變更此設定。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
合適的 Chromium Edge 驅動程式路徑
|
SuitableChromiumEdgeDriverPath | string |
適用於執行代理程式的工作階段中已安裝版本的 Chromium Edge 驅動程式的適當版本的 Chromium Edge 驅動程式路徑。 這要麼已經存在於下載資料夾中，要麼已經下載。 |
從互聯網下載合適的 ChromeDriver
在執行 IA-Connect Agent 的工作階段中，判斷哪個版本的 ChromeDriver 適合已安裝的 Google Chrome 版本，檢查是否已下載合適的版本，如果沒有，則嘗試從 Google 的 ChromeDriver 網際網路網頁下載合適的版本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Chrome EXE 路徑
|
ChromeBrowserEXE | string |
Chrome.exe的可選路徑，如果未安裝在預設位置（或您使用的是Dev或Canary版本的Chrome）。 |
|
|
ChromeDriver 下載父資料夾
|
ChromeDriverDownloadParentFolder | True | string |
所有 ChromeDriver 都儲存在本機磁碟上的父資料夾。 每個 ChromeDriver 都儲存在版本化子資料夾中，以符合 Google Chrome 的主要版本。 將檢查此資料夾結構是否有合適的 ChromeDriver，如果找不到，則會從 Internet 下載到此資料夾中。 |
|
嘗試透過 XML 索引尋找 URL
|
AttemptToLocateChromeDriverURLViaXMLIndex | boolean |
設為 true 以嘗試使用 XML 索引來尋找要下載的相關 ChromeDriver。 系統會使用「ChromeDriver 根網頁網址」（ChromeDriverRootWebPageURL） 來決定要使用的網址。 從 Google Chrome 版本 115 開始，Google 已停止更新 XML 索引，改用 JSON 索引。 |
|
|
ChromeDriver 根網頁網址
|
ChromeDriverRootWebPageURL | string |
根網頁網址，其中包含 XML 索引，可用來尋找相關的 ChromeDriver 以供下載。 這預設為 Google ChromeDriver 網站上正確的 XML 索引 URL，但如果需要替代位置（例如，如果 Google 更改地址，或者您決定自己託管它），您可以更改此位置。 從 Google Chrome 版本 115 開始，Google 已停止更新 XML 索引，而是使用 JSON 索引，除非您擁有舊版本的 Google Chrome（或使用替代 XML 索引），否則此選項是多餘的。 |
|
|
嘗試透過 JSON 索引尋找 URL
|
AttemptToLocateChromeDriverURLViaJSONIndex | boolean |
設為 true 可嘗試使用 JSON 索引來尋找要下載的相關 ChromeDriver。 系統會使用「ChromeDriver JSON 索引網頁網址」（ChromeDriverJSONIndexWebPageURL） 來決定要使用的網址。 JSON 索引用於 Google Chrome 115 版和更新版本。 |
|
|
ChromeDriver JSON 索引網頁網址
|
ChromeDriverJSONIndexWebPageURL | string |
網頁 JSON 索引的網址，可用來尋找要下載的相關 ChromeDriver。 這預設為 Google Chrome 測試網站上正確的 JSON 索引網址，但如果需要替代位置 （例如，如果 Google 變更了地址，或者您決定自行託管），您可以變更此網址。 JSON 索引僅用於 Google Chrome 115 版以上版本。 |
|
|
首選 64 位 ChromeDriver
|
Prefer64bitChromeDriver | boolean |
設定為 true 以嘗試下載 64 位元 ChromeDriver （如果存在）。 如果 32 位 ChromeDriver 不可用，則將下載 64 位 ChromeDriver。 請注意，32 位 ChromeDriver 適用於 32 位和 64 位版本的 Google Chrome 瀏覽器。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
合適的 ChromeDriver 路徑
|
SuitableChromeDriverPath | string |
在執行代理程式的工作階段中，適用於已安裝 Google Chrome 版本的 ChromeDriver 的適當版本的路徑。 這要麼已經存在於下載資料夾中，要麼是從網際網路下載的。 |
從文件中獲取 Chromium Edge EXE 版本
取得執行代理程式的工作階段中安裝的 Chromium Edge 版本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Chromium Edge EXE 路徑
|
ChromiumEdgeBrowserEXE | string |
如果未安裝在預設位置 （或您使用的 Chromium Edge 的 Dev 或 Canary 版本） ，則 msedge.exe 的選擇性路徑。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Chromium Edge EXE 檔案版本
|
ChromiumEdgeBrowserFileVersion | string |
執行 IA-Connect Agent 之工作階段中安裝的 msedge.exe 檔案版本。 |
|
Chromium Edge EXE 主要版本
|
ChromiumEdgeBrowserMajorVersion | integer |
Chromium Edge 瀏覽器的主要版本（例如 91）安裝在執行 IA-Connect Agent 的工作階段中。 |
從文件獲取 Google Chrome EXE 版本
取得執行代理程式的工作階段中安裝的 Google Chrome 版本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Chrome EXE 路徑
|
ChromeBrowserEXE | string |
Chrome.exe的可選路徑，如果未安裝在預設位置（或您使用的是Dev或Canary版本的Chrome）。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Chrome EXE 檔案版本
|
ChromeBrowserFileVersion | string |
執行 IA-Connect Agent 之工作階段中安裝的 Chrome.exe 檔案版本。 |
|
Chrome EXE 主要版本
|
ChromeBrowserMajorVersion | integer |
執行 IA-Connect Agent 的工作階段中安裝的 Chrome 瀏覽器的主要版本 （例如 91）。 |
按 CTRL 網頁元素上的鍵
在 HTML 元素上按 CTRL 鍵。 這可以與“Control 鍵”參數一起使用，以執行快捷鍵，例如 Ctrl-a（全選）、Ctrl-c（複製）、Ctrl-x（剪切）或 Ctrl-v（粘貼）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
控制鍵
|
ControlKey | True | string |
可與 CTRL 鍵搭配使用以執行快速鍵的可選鍵，例如 'a' （全選）、'c' （影印）、'x' （剪下） 或 'v' （貼上）。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
按一下網頁元素
按一下網頁瀏覽器中的元素 （通常是按鈕或超連結）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
提交網頁元素
提交 HTML 元素。 這通常會在表單元素中的任何輸入元素上執行，並會導致表單提交。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
是否有合適的遠端 ChromeDriver 可用
在執行 IA-Connect Agent 的工作階段中，搜尋適合已安裝 Google Chrome 版本的 ChromeDriver 版本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Chrome 驅動程式父資料夾
|
ChromeDriverFolder | string |
父資料夾，其中包含 ChromeDriver 資料夾 （本身包含 Chrome 主要版本的 ChromeDriver.exe）。 |
|
|
Chrome EXE 路徑
|
ChromeBrowserEXE | string |
Chrome.exe的可選路徑，如果未安裝在預設位置（或您使用的是Dev或Canary版本的Chrome）。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Chrome EXE 檔案版本
|
ChromeBrowserFileVersion | string |
執行 IA-Connect Agent 之工作階段中安裝的 Chrome.exe 檔案版本。 |
|
Chrome EXE 主要版本
|
ChromeBrowserMajorVersion | integer |
執行 IA-Connect Agent 的工作階段中安裝的 Chrome 瀏覽器的主要版本 （例如 91）。 |
|
提供合適的 ChromeDriver
|
SuitableChromeDriverAvailable | boolean |
如果在執行代理程式的工作階段中，可以找到適合已安裝 Google Chrome 版本的 ChromeDriver 版本，則傳回 true。 |
|
合適的 ChromeDriver 路徑
|
SuitableChromeDriverPath | string |
適用於執行代理程式的工作階段中已安裝 Google Chrome 版本的適當 ChromeDriver 版本的檔案路徑。 |
是否有合適的遠端 Chromium Edge 驅動程式可用
在執行代理程式的工作階段中，針對已安裝的 Chromium Edge 版本搜尋合適的 ChromiumEdgeDriver 版本。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Chromium Edge 驅動程式父資料夾
|
ChromiumEdgeDriverFolder | string |
父資料夾，其中包含 msedgedriver 資料夾 （本身包含 Chromium Edge 主要版本的 msedgedriver.exe）。 |
|
|
Chromium Edge EXE 路徑
|
ChromiumEdgeBrowserEXE | string |
如果未安裝在預設位置 （或您使用的 Chromium Edge 的 Dev 或 Canary 版本） ，則 msedge.exe 的選擇性路徑。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Chromium Edge EXE 檔案版本
|
ChromiumEdgeBrowserFileVersion | string |
執行 IA-Connect Agent 之工作階段中安裝的 msedge.exe 檔案版本。 |
|
Chromium Edge EXE 主要版本
|
ChromiumEdgeBrowserMajorVersion | integer |
Chromium Edge 瀏覽器的主要版本（例如 91）安裝在執行 IA-Connect Agent 的工作階段中。 |
|
提供合適的 ChromiumEdgeDriver
|
SuitableChromiumEdgeDriverAvailable | boolean |
如果在執行代理程式的工作階段中，針對已安裝的 Chromium Edge 版本找到合適的 ChromiumEdgeDriver 版本，則傳回 true。 |
|
適合的 ChromiumEdgeDriver 路徑
|
SuitableChromiumEdgeDriverPath | string |
適用於執行代理程式的工作階段中已安裝 Chromium Edge 版本的 ChromiumEdgeDriver 適當版本的檔案路徑。 |
最大化使用中的瀏覽器
最大化目前控制的網頁瀏覽器 （使用瀏覽器「開啟」動作開啟的最後一個瀏覽器）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
模擬滑鼠右鍵點擊網頁元素
透過告訴瀏覽器已執行滑鼠右鍵動作來模擬滑鼠動作。 這通常足以讓網頁如預期般做出反應。 如果失敗，請考慮使用「全局滑鼠右鍵單擊元素」，它以與使用者完全相同的方式移動滑鼠和點擊。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
焦點第一
|
FocusFirst | boolean |
在嘗試點擊之前，是否應該先聚焦 HTML 元素？ |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
模擬鼠標左鍵單擊網頁元素
透過告訴瀏覽器已執行滑鼠左鍵動作來模擬滑鼠動作。 這通常足以讓網頁如預期般做出反應。 如果失敗，請考慮使用「全局滑鼠左鍵單擊元素」，它會以與使用者完全相同的方式移動滑鼠和點擊。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
焦點第一
|
FocusFirst | boolean |
在嘗試點擊之前，是否應該先聚焦 HTML 元素？ |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
檢查多個網頁元素
檢查/勾選多個 HTML 元素（通常是核取方塊或選項框）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
輸入元素為 JSON
|
InputElementsJSON | True | string |
要檢查的 HTML 元素屬性，採用 JSON 格式。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
檢查網頁元素
檢查/勾選 HTML 元素（通常是核取方塊或選項框）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
檢查元素
|
CheckElement | boolean |
設定為 true 以勾選/勾選元素，或設定為 false 以取消勾選/取消勾選。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
正常化作用中瀏覽器
將視窗大小調整為提供的維度，並將視窗移至提供的座標，以正規化瀏覽器視窗。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
X
|
X | integer |
瀏覽器視窗左上角的 X 座標 （以像素為單位）。 |
|
|
是
|
Y | integer |
瀏覽器視窗左上角的 Y 座標 （以像素為單位）。 |
|
|
寬度
|
Width | integer |
瀏覽器視窗的寬度。 |
|
|
高度
|
Height | integer |
瀏覽器視窗的高度。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
清除所有網頁元素文字
清除網頁元素中的所有現有文字。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
先前的值
|
PreviousValue | string |
清除之前相符元素的先前值。 |
瀏覽器執行個體是否開啟
報告 IA-Connect 代理程式是否正在執行瀏覽器執行個體。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
瀏覽器執行個體是否開啟
|
IsBrowserInstanceOpen | boolean |
True，如果 IA-Connect 代理程式正在控制瀏覽器。 |
|
瀏覽器名稱
|
BrowserName | string |
由 IA-Connect 代理程式控制的瀏覽器名稱。 |
|
瀏覽器主要版本
|
BrowserMajorVersion | integer |
由 IA-Connect 代理程式控制的瀏覽器的主要版本。 |
焦點網頁元素
聚焦 HTML 元素。 這會讓元素成為鍵盤焦點的作用中元素，並可能將元素帶到前景。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
獲取 Chromium Edge 驅動程序文件夾
取得與目前 Chromium Edge EXE 版本搭配使用的 ChromiumEdgeDriver 版本的 ChromiumEdgeDriver 資料夾路徑。 這是由“打開 Chromium Edge”操作使用的，您不太可能需要直接調用它。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Chromium Edge 驅動程式父資料夾
|
DirectoryPath | True | string |
父資料夾，其中包含 msedgedriver 資料夾 （本身包含 Chromium Edge 主要版本的 msedgedriver.exe）。 |
|
Chromium Edge EXE 主要版本
|
ChromiumEdgeMajorVersion | integer |
Chromium Edge 瀏覽器的主要版本（例如 91）安裝在執行代理程式的會話中。 |
|
|
Chromium Edge EXE 路徑
|
ChromiumEdgeBrowserEXE | string |
如果未安裝在預設位置 （或您使用的 Chromium Edge 的 Dev 或 Canary 版本） ，則 msedge.exe 的選擇性路徑。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ChromiumEdgeDriver 資料夾
|
ChromiumEdgeDriverFolder | string |
包含 Chromium Edge 瀏覽器主要版本正確版本 msedgedriver.exe 的資料夾路徑。 |
等待 Web 元素存在
等候指定的 Web 元素存在。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
等待秒數
|
SecondsToWait | True | integer |
等待 Web 元素存在的最大秒數。 |
|
如果找不到 Web 元素，則引發例外狀況
|
RaiseExceptionIfElementNotFound | boolean |
如果 Web 元素在等待期間後不存在，IA-Connect 應該引發例外狀況嗎？ |
|
|
如果可能，請使用明確的等待條件
|
UseExplicitWaitConditionsIfPossible | boolean |
如果設定為 true，IA-Connect 會嘗試使用明確的等候條件來等候元素，如果適合所選的搜尋屬性。 如果設定為 false，IA-Connect 一律會執行等待迴圈。 這是進階設定，會影響 IA-Connect 代理程式所採用的程式碼路徑。 |
|
|
等待搜尋元素顯示
|
WaitForSearchElementToBeDisplayed | boolean |
如果設定為 true，IA-Connect 還會等候搜尋元素的顯示。 顯示表示元素已在瀏覽器文件中繪製，並不指它在螢幕上是否可見（例如，它可以從螢幕底部捲動，但仍被視為已顯示）。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果 Web 元素存在，則傳回 true，如果不存在，則傳回 false。 |
|
元素控點
|
ElementHandle | double |
相符 Web 元素的控點。 這可用作對此 Web 元素執行的進一步動作的輸入。 如果找不到 Web 元素，則此輸出將設定為 0。 |
等待網頁元素不存在
等候指定的 Web 元素不再存在。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
等待秒數
|
SecondsToWait | True | integer |
等待 Web 元素不存在的秒數上限。 |
|
如果 Web 元素仍然存在，則引發例外狀況
|
RaiseExceptionIfElementStillExists | boolean |
如果 Web 元素在等待期間後仍然存在，IA-Connect 應該引發例外狀況嗎？ |
|
|
必須顯示搜尋元素
|
SearchElementMustBeDisplayed | boolean |
如果設定為 true，則只有在顯示元素時，IA-Connect 才會認為該元素存在。 一旦元素未顯示，它將被視為不存在，因此符合等待條件。 顯示表示元素已在瀏覽器文件中繪製，並不指它在螢幕上是否可見（例如，它可以從螢幕底部捲動，但仍被視為已顯示）。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素在等待之前存在
|
ElementExistsBeforeWait | boolean |
如果 Web 元素在等待之前存在，則傳回 true，如果沒有，則傳回 false。 |
|
元素在等待後存在
|
ElementExistsAfterWait | boolean |
如果 Web 元素在等待後存在，則傳回 true，如果沒有，則傳回 false。 |
網頁元素存在嗎
報告 HTML 元素目前是否存在。 此動作不會等待 HTML 元素。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
元素存在
|
ElementExists | boolean |
如果相符元素存在，則傳回 true，如果不存在，則傳回 false。 |
設定使用中的瀏覽器視窗位置
將瀏覽器視窗移至指定的像素座標。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
X
|
X | True | integer |
要將瀏覽器視窗設定為的 X 像素座標。 |
|
是
|
Y | True | integer |
要將瀏覽器視窗設定為的 Y 像素座標。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
設定使用中的瀏覽器視窗大小
將瀏覽器視窗調整為指定的寬度和高度尺寸。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
寬度
|
Width | True | integer |
瀏覽器視窗的寬度（以像素為單位）。 |
|
高度
|
Height | True | integer |
瀏覽器視窗的高度（以像素為單位）。 |
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
設定瀏覽器逾時
設定 IA-Connect 與網頁瀏覽器互動時使用的內部逾時。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
元素等待逾時秒數
|
ElementWaitTimeoutSeconds | double |
IA-Connect 將等待元素可見的秒數。 |
|
|
頁面載入逾時秒數
|
PageLoadTimeoutSeconds | double |
IA-Connect 將等待頁面完成載入的秒數。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
設定網頁瀏覽器索引標籤
設定作用中索引標籤，並切換 IA-Connect 代理程式以控制此索引標籤，以便與其互動。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
索引標籤名稱
|
TabName | string |
要切換至的內部索引標籤名稱。 這可以從「取得瀏覽器索引標籤」動作擷取。 |
|
|
索引標籤索引
|
TabIndex | integer |
要切換至的索引標籤索引標籤索引。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
貼到網頁元素中
將剪貼簿的內容貼到 HTML 元素 （通常是文字輸入欄位） 中。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
選擇網頁選擇清單項目
選取選取 HTML 元素上的選項，依 [文字]、[值] 或 [索引]。 您可以使用「取得選取範圍屬性」動作來探索選取範圍中每個選項的文字、值或索引。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
父元素控點
|
ParentElementHandle | double |
父元素控制碼可作為搜尋的起點。 這可以透過「檢查」使用「建立元素的控點」等動作來發現。 如果未提供任何值或 0，則會搜尋整個頁面 DOM 結構。 |
|
|
搜尋元素控點
|
SearchElementHandle | double |
目標元素的元素控制碼。 這可以使用“獲取多個元素屬性”或其他返回元素句點的搜索來定位。 如果在此欄位中輸入句柄值 （值為 1 或更高），則會忽略所有其他搜尋準則，因為此句柄會唯一識別元素，因此不需要其他詳細資料。 依預設，不會使用任何值 （或 0） 來指定未提供元素控點。 |
|
|
搜尋元素名稱
|
SearchElementName | string |
要搜尋之元素的選用 HTML 名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素識別碼
|
SearchElementID | string |
要搜尋之元素的選用 HTML ID。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素標籤名稱
|
SearchElementTagName | string |
要搜尋之元素的選用 HTML 標籤名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 XPath
|
SearchElementXPath | string |
用於識別元素的選用 XPath 查詢。 支援萬用字元。 |
|
|
搜尋元素類別名稱
|
SearchElementClassName | string |
要搜尋之元素的選用 HTML 類別名稱。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素 CSS 選取器
|
SearchElementCSSSelector | string |
用於識別元素的選用 CSS 選擇器。 支援萬用字元。 |
|
|
搜尋元素索引
|
SearchElementIndex | double |
如果多個元素符合搜尋，則應比對哪個元素（從 1 開始）。 |
|
|
搜尋元素比對值
|
SearchElementMatchValue | string |
要搜尋之元素的選用 HTML 值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素比對文字
|
SearchElementMatchText | string |
要搜尋之元素的選用 HTML 文字值。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素類型
|
SearchElementType | string |
要搜尋之元素的選用 HTML 型別。 這可以通過檢查發現。 此參數不支援萬用字元，但可以改為 XPath 或 CSS 選取器的一部分。 |
|
|
搜尋元素最小寬度
|
SearchElementMinimumWidth | double |
要傳回的元素選擇性最小寬度。 根據預設，此值會設定為 1，以避免傳回通常寬度為 0 的隱藏元素。 |
|
|
搜尋元素最小高度
|
SearchElementMinimumHeight | double |
要傳回的元素的選擇性最小高度。 根據預設，此值會設定為 1，以避免傳回通常高度為 0 的隱藏元素。 |
|
|
搜尋元素邊界框左側
|
SearchElementBoundingBoxLeft | double |
邊界方塊左側的選用 HTML 文件座標值，其中應可找到搜尋元素。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊右側
|
SearchElementBoundingBoxRight | double |
邊界方塊右側的選用 HTML 文件座標值，其中應找到搜尋元素。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊頂端
|
SearchElementBoundingBoxTop | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊頂端。 依預設，此設定為 -99999 以傳回所有元素。 |
|
|
搜尋元素邊界方塊底部
|
SearchElementBoundingBoxBottom | double |
選擇性 HTML 文件座標值，適用於應在其中找到搜尋元素的邊界方塊底部。 依預設，此設定為 99999 以傳回所有元素。 |
|
|
只有左上方的元素需要位於邊界框中
|
OnlyElementTopLeftNeedsToBeInBoundingBox | boolean |
應該只在邊界框中找到搜尋元素的左上角，或整個元素。 依預設，此設定為 false。 |
|
|
要選取的值
|
ValueToSelect | string |
要選取的選取選項值。 |
|
|
要選取的文字
|
TextToSelect | string |
要選取的選取選項的文字值。 |
|
|
要選取的索引
|
IndexToSelect | double |
要選取的選取選項的索引。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
重設所有 Web 元素控點
重設 IA-Connect Agent 目前保留的所有 Web 元素控點。 此動作通常用於記憶體清理，而且只建議用於大型複雜進程，這會導致儲存大量元素句柄 （10,000+）。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
重設瀏覽器網頁框架堆疊
重設瀏覽器框架堆疊。 只有在獲得 Ultima 技術支援的批准後才應使用此功能。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
開啟 Chromium Edge 瀏覽器
開啟 Chromium Edge 網頁瀏覽器，允許使用此 IA-Connect 模組中的動作將其自動化。 如果 Web 瀏覽器是由其他應用程式手動開啟，或使用「執行處理程序」動作開啟，則只能使用 UIA 動作來自動化，而不能使用此 IA-Connect 模組中的動作來自動化。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Chromium Edge 驅動程式資料夾
|
ChromiumEdgeDriverFolder | string |
資料夾路徑包含 IA-Connect Agent 工作階段中 Chromium Edge 瀏覽器主要版本的正確 msedgedriver.exe 版本。 |
|
|
使用者資料目錄
|
UserDataDir | string |
用於瀏覽器工作階段的持續性 Chromium Edge 使用者資料目錄的選擇性路徑。 此輸入預設為空白，並導致 IA-Connect 代理程式對每個瀏覽器工作階段使用新的臨時瀏覽器設定檔，確保每個工作階段都是乾淨的。 如果您輸入使用者資料目錄的路徑，瀏覽器會將其用作在瀏覽器工作階段之間維護的持續性設定檔。 例如：%LOCALAPPDATA%\Microsoft\Edge\AutomationProfile。 |
|
|
殺死現有的 Chromium Edge 驅動程序
|
KillExistingChromiumEdgeDriver | boolean |
開啟 Chromium Edge 時，是否應該終止任何現有的 msedgedriver.exe 實例？ |
|
|
列印至預設印表機
|
PrintToDefaultPrinter | boolean |
Chromium Edge 是否應該在 IA-Connect 代理程式會話中自動列印到預設印表機，而不顯示列印對話框？ 可以使用 IA-Connect 環境/工作階段動作中的「設定預設印表機」動作來變更預設印表機。 |
|
|
預設下載目錄
|
DefaultDownloadDirectory | string |
預設下載目錄的可選路徑，所有下載都會儲存到該目錄。 |
|
|
下載 PDF 而不是開啟
|
DownloadPDFInsteadOfOpening | boolean |
PDF 檔案應該自動下載而不是開啟嗎？ |
|
|
Chromium Edge 驅動程式記錄檔名
|
ChromiumEdgeDriverLogFilename | string |
儲存 msedgedriver 記錄檔位置的選擇性路徑。 |
|
|
本機 Chromium Edge 驅動程式資料夾
|
LocalChromiumEdgeDriverFolder | string |
本機會話 （執行 IA-Connect Director 的位置） 中資料夾路徑，以包含 Chromium Edge 瀏覽器主要版本正確版本的 msedgedriver.exe 資料夾。 這會自動上傳至 IA-Connect Agent 工作階段，且只有在 Citrix 或 RDP 工作階段中執行 IA-Connect Agent 時才應使用。 |
|
|
隱藏瀏覽器正在自動發送消息
|
HideBrowserIsBeingAutomatedMessage | boolean |
是否應該隱藏 Chromium Edge 顯示的“瀏覽器正在自動化”消息？ |
|
|
Chromium Edge EXE 路徑
|
ChromiumEdgeBrowserEXE | string |
如果未安裝在預設位置 （或您使用的 Chromium Edge 的 Dev 或 Canary 版本） ，則 msedge.exe 的選擇性路徑。 |
|
|
忽略憑證錯誤
|
IgnoreCertificateErrors | boolean |
Chromium Edge 應該忽略網頁憑證錯誤嗎？ |
|
|
其他引數
|
AdditionalArguments | string |
可選的空格分隔清單，其中包含要傳送至瀏覽器的其他命令列選項/引數或使用者設定檔偏好設定。 指令行選項的格式為 --Option，而使用者設定檔偏好設定的格式為 UserProfilePreference：Preference=Value。 在每個單獨選項之間放置一個空格，除非需要，否則不要在選項中使用空格。 如果選項中必須包含空格，請在選項周圍加上雙引號。 例如：下列會啟用 In-Private 模式 （透過引數） ，並關閉自動儲存密碼 （透過使用者設定檔喜好設定）： --InPrivate UserProfilePreference：credentials_enable_service=false。 |
|
|
如果 Chromium Edge 實例已開啟，則不執行任何動作
|
DoNothingIfChromiumEdgeInstanceAlreadyOpen | boolean |
如果設定為 true，且 IA-Connect 代理程式已在執行 Chromium Edge 瀏覽器執行個體，則不會採取任何動作，且此動作會成功回應。 如果設定為 false （預設值），IA-Connect 代理程式將一律執行新的 Chromium Edge 執行個體 （如果要求，會關閉現有執行個體）。 如果您想要重複使用現有的瀏覽器，通常會使用此輸入。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ChromiumEdgeDriver 進程識別碼
|
ChromiumEdgeDriverPID | integer |
已啟動之 msedgedriver 進程的進程識別碼。 |
|
ChromiumEdgeDriver TCP 連接埠
|
ChromiumEdgeDriverTCPPort | integer |
msedgedriver 正在接聽以接收來自 IA-Connect 代理程式的要求的 TCP 埠。 |
|
Chromium Edge 進程標識碼
|
ChromiumEdgePID | integer |
已啟動的 Chromium Edge 進程的進程識別碼。 |
|
Chromium Edge TCP 連接埠
|
ChromiumEdgeTCPPort | integer |
Chromium Edge DevTools 正在接聽的 TCP 埠，以接收來自 msedgedriver 的要求。 |
|
Chromium Edge 執行個體使用者資料目錄
|
ChromiumEdgeInstanceUserDataDir | string |
Chromium Edge 所使用的使用者資料目錄路徑，例如 'C：\Users\Robot1\AppData\Local\Microsoft\Edge\User Data'。 |
|
Chromium Edge 執行個體已開啟
|
ChromiumEdgeInstanceAlreadyOpen | boolean |
如果輸入「如果 Chromium Edge 執行個體已開啟，則不執行任何動作」設定為 true，且 Chromium Edge 執行個體已由 IA-Connect Agent 控制，則此輸出將設定為 true，並報告未執行任何動作 （因為 Chromium Edge 已受到控制）。 |
開啟 Google Chrome 瀏覽器
開啟 Google Chrome 網頁瀏覽器，允許使用此 IA-Connect 模組中的動作將其自動化。 如果 Web 瀏覽器是由其他應用程式手動開啟，或使用「執行處理程序」動作開啟，則只能使用 UIA 動作來自動化，而不能使用此 IA-Connect 模組中的動作來自動化。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Chrome 驅動程式資料夾
|
ChromeDriverFolder | string |
資料夾路徑包含 IA-Connect Agent 工作階段中 Chrome 瀏覽器主要版本的正確 ChromeDriver.exe 版本。 |
|
|
殺死現有的 ChromeDriver
|
KillExistingChromeDriver | boolean |
開啟 Chrome 時是否應該終止任何現有的 ChromeDriver.exe 實例？ |
|
|
使用者資料目錄
|
UserDataDir | string |
用於瀏覽器工作階段的永久性 Google Chrome 使用者資料目錄的選擇性路徑。 此輸入預設為空白，並導致 IA-Connect 代理程式對每個瀏覽器工作階段使用新的臨時瀏覽器設定檔，確保每個工作階段都是乾淨的。 如果您輸入使用者資料目錄的路徑，瀏覽器會將其用作在瀏覽器工作階段之間維護的持續性設定檔。 例如：%LOCALAPPDATA%\Google\Chrome\AutomationProfile。 |
|
|
列印至預設印表機
|
PrintToDefaultPrinter | boolean |
Chrome 是否應該在 IA-Connect 代理程式工作階段中自動列印到預設印表機而不顯示列印對話方塊？ 可以使用 IA-Connect 環境/工作階段動作中的「設定預設印表機」動作來變更預設印表機。 |
|
|
預設下載目錄
|
DefaultDownloadDirectory | string |
預設下載目錄的可選路徑，所有下載都會儲存到該目錄。 |
|
|
下載 PDF 而不是開啟
|
DownloadPDFInsteadOfOpening | boolean |
PDF 檔案應該自動下載而不是開啟嗎？ |
|
|
Chrome 驅動程式記錄檔名
|
ChromeDriverLogFilename | string |
ChromeDriver 記錄檔儲存位置的選用路徑。 |
|
|
本機 Chrome 驅動程式資料夾
|
LocalChromeDriverFolder | string |
本機工作階段 （執行 IA-Connect Director 的位置） 中資料夾路徑，以顯示包含 Chrome 瀏覽器主要版本正確版本 ChromeDriver.exe 的資料夾。 這會自動上傳至 IA-Connect Agent 工作階段，且只有在 Citrix 或 RDP 工作階段中執行 IA-Connect Agent 時才應使用。 |
|
|
Chrome EXE 路徑
|
ChromeBrowserEXE | string |
Chrome.exe的可選路徑，如果未安裝在預設位置（或您使用的是Dev或Canary版本的Chrome）。 |
|
|
忽略憑證錯誤
|
IgnoreCertificateErrors | boolean |
Chrome 應該忽略網頁憑證錯誤嗎？ |
|
|
其他引數
|
AdditionalArguments | string |
可選的空格分隔清單，其中包含要傳送至瀏覽器的其他命令列選項/引數或使用者設定檔偏好設定。 指令行選項的格式為 --Option，而使用者設定檔偏好設定的格式為 UserProfilePreference：Preference=Value。 在每個單獨選項之間放置一個空格，除非需要，否則不要在選項中使用空格。 如果選項中必須包含空格，請在選項周圍加上雙引號。 舉例來說：下列內容會啟用無痕模式 （透過引數） ，並關閉自動儲存密碼 （透過使用者設定檔偏好設定）： --Incognito UserProfilePreference：credentials_enable_service=false。 |
|
|
如果 Chrome 實例已開啟，則不執行任何動作
|
DoNothingIfChromeInstanceAlreadyOpen | boolean |
如果設定為 true，且 IA-Connect 代理程式已在執行 Chrome 瀏覽器執行個體，則不會採取任何動作，且此動作會成功回應。 如果設定為 false （預設值），IA-Connect Agent 將一律執行新的 Chrome 執行個體 （如有要求，會關閉現有執行個體）。 如果您想要重複使用現有的瀏覽器，通常會使用此輸入。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
ChromeDriver 進程 ID
|
ChromeDriverPID | integer |
已啟動的 ChromeDriver 程序的程序 ID。 |
|
ChromeDriver TCP 連接埠
|
ChromeDriverTCPPort | integer |
ChromeDriver 監聽以接收來自 IA-Connect Agent 的要求的 TCP 連接埠。 |
|
Chrome 進程 ID
|
ChromePID | integer |
已啟動的 Chrome 進程的進程 ID。 |
|
Chrome TCP 連接埠
|
ChromeTCPPort | integer |
Chrome DevTools 正在監聽的 TCP 連接埠，用於接收來自 ChromeDriver 的要求。 |
|
Chrome 執行個體使用者資料目錄
|
ChromeInstanceUserDataDir | string |
Chrome 使用的使用者資料目錄路徑，例如「C：\Users\Robot1\AppData\Local\Google\Chrome\User Data」。 |
|
Chrome 實例已開啟
|
ChromeInstanceAlreadyOpen | boolean |
如果輸入「如果 Chrome 執行個體已開啟，則不執行任何動作」設定為 true，且 Chrome 執行個體已由 IA-Connect Agent 控制，則此輸出會設定為 true，並報告未執行任何動作 （因為 Chrome 已受到控制）。 |
開啟 Internet Explorer 瀏覽器
開啟 Internet Explorer Web 瀏覽器，允許使用此 IA-Connect 模組中的動作將其自動化。 如果 Web 瀏覽器是由其他應用程式手動開啟，或使用「執行處理程序」動作開啟，則只能使用 UIA 動作來自動化，而不能使用此 IA-Connect 模組中的動作來自動化。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Internet Explorer 驅動程式資料夾
|
IEDriverFolder | string |
此引數可讓您為包含 IEDriver.dll的資料夾指定替代位置。 預設情況下，IA-Connect 會自動處理此問題，因此您只需在 Ultima 技術支援指示時使用此參數。 |
|
|
殺死現有的 IEDriverServer
|
KillExistingIEDriver | boolean |
在啟動新的 Internet Explorer 實例之前，是否應該終止任何現有的 IEDriverServer.exe （舊版） 實例，或是否應該卸載任何現有的 IEDriver？ 除非 Ultima 技術支持指示，否則這應該保持錯誤。 |
|
|
殺死現有的 IE
|
KillExistingIE | boolean |
在啟動新實例之前，是否應該終止任何現有的 Internet Explorer 會話？ |
|
|
乾淨的工作階段
|
CleanSession | boolean |
Internet Explorer 應該啟動乾淨的會話嗎？ 這將在啟動之前清除所有瀏覽歷史記錄和其他臨時文件。 |
|
|
啟用原生事件
|
EnableNativeEvents | boolean |
是否應該啟用原生事件？ 這通常更可靠，並且更好地模擬使用者互動。 如果設定為 false，則 JavaScript 事件會模擬使用者互動。 |
|
|
Web 驅動程式記錄檔
|
WebDriverLogFile | string |
儲存 Web 驅動程式記錄檔位置的選擇性檔案路徑。 |
|
|
Web 驅動程式記錄層級
|
WebDriverLogLevel | string |
選擇性數字，以指出 Web 驅動程式記錄的層級，如所示：嚴重 （1）、錯誤 （2）、警告 （3）、資訊 （4）、偵錯 （5） 或追蹤 （6）。 |
|
|
停用 IE 首次執行自訂
|
DisableIEFirstRunCustomise | boolean |
是否應該隱藏首次執行自訂對話方塊？ 這些對話方塊通常會中斷自動化程序。 |
|
|
其他引數
|
AdditionalArguments | string |
啟動時要傳遞給 Internet Explorer 的其他命令列引數。 例如：-private 將以私人（隱身）模式開啟瀏覽器。 使用此選項的風險由您自行承擔，因為自訂引數的使用未經過廣泛測試或支援。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
開啟新的網頁瀏覽器索引標籤
在瀏覽器視窗中開啟新索引標籤。 在 Internet Explorer 中，此動作會開啟一個新視窗，但新視窗的行為就像索引標籤一樣，並且可以與具有「取得瀏覽器索引標籤」或「設定瀏覽器索引標籤」動作的索引標籤相同的方式進行互動。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
URL
|
URL | string |
要在新索引標籤中開啟的頁面 URL。 |
|
|
將控制切換到新選項卡
|
SwitchControlToNewTab | boolean |
如果設定為 true，IA-Connect 會將控制切換到新分頁。如果設定為 false，控制項將保留在目前索引標籤中。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
新索引標籤名稱
|
NewTabName | string |
新索引標籤的內部索引標籤名稱。 |
|
新索引標籤索引
|
NewTabIndex | integer |
新索引標籤的索引標籤索引。 |
關閉 Chromium Edge 瀏覽器
關閉使用「開啟 Chromium Edge」動作開啟的 Chromium Edge 瀏覽器。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
清除動態使用者資料目錄
|
PurgeDynamicUserDataDir | boolean |
關閉 Chromium Edge 時是否應該清除動態使用者資料目錄？ 默認情況下，這設置為 true，因為當 Chromium Edge 不使用特定用戶配置文件時生成動態用戶數據目錄，並且專為一次性使用而設計。 |
|
|
清除靜態使用者資料目錄
|
PurgeStaticUserDataDir | boolean |
關閉 Chromium Edge 時是否應該清除靜態使用者資料目錄？ 預設情況下，此值設定為 false，因為當 Chromium Edge 使用特定使用者設定檔時會使用靜態使用者資料目錄，並且可以在 Chromium Edge 會話之間重複使用。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
關閉 Google Chrome 瀏覽器
關閉使用「開啟 Chrome」動作開啟的 Google Chrome 網頁瀏覽器。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
清除動態使用者資料目錄
|
PurgeDynamicUserDataDir | boolean |
關閉 Chrome 時是否應該清除動態用戶數據目錄？ 根據預設，此設定會設定為 true，因為 Chrome 未使用特定使用者設定檔時會產生動態使用者資料目錄，且專為一次性使用而設計。 |
|
|
清除靜態使用者資料目錄
|
PurgeStaticUserDataDir | boolean |
關閉 Chrome 時是否應該清除靜態用戶數據目錄？ 根據預設，此設定會設為 false，因為 Chrome 使用特定使用者設定檔時會使用靜態使用者資料目錄，而且可以在 Chrome 工作階段之間重複使用。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
關閉 Internet Explorer 瀏覽器
關閉使用「開啟 Internet Explorer」動作開啟的 Internet Explorer 瀏覽器。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
卸載 IE 驅動程式
|
UnloadIEDriver | boolean |
當代理程式關閉 Internet Explorer 時 IA-Connect 應該卸載 IE 驅動程式嗎？ 這通常是不必要的，只有在獲得 Ultima 技術支援的批准後才應使用。 |
|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |
關閉作用中的網頁瀏覽器索引標籤
關閉目前使用中的瀏覽器標籤。呼叫此動作後，預設情況下，IA-Connect 代理將不會切換到新的活動標籤。 若要重新附加至另一個分頁，您必須先呼叫「設定瀏覽器分頁」動作，然後再嘗試與頁面互動。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
Workflow
|
Workflow | True | string |
在此處新增下列運算式：workflow（） |