終端模擬動作
Power Automate 能夠過終端模擬動作提供與終端模擬器的整合。 這些動作讓您能夠處理終端和主機，並執行如移動滑鼠、設定和取得文字，以及發送金鑰等動作。
在部署任何終端動作前，請使用開啟終端工作階段動作，打開與已安裝提供程式的新連接。
重要
在嘗試連線至終端工作階段前，請確保實際的終端工作階段已在您的電腦上開啟。
如果您已經在電腦上安裝了 Micro Focus Reflection，請在動作的 Provider 參數中選擇相應的選項，並填入所需的設定。
如果您安裝了其他提供程式，請選擇適用於大多數終端模擬提供程式的 HLLAPI。
根據您使用的提供程式，選擇位於其安裝資料夾中的相應 HLLAPI DLL 檔案。 在下方的列表中，您可以看到一些熱門的終端模擬提供程式的 HLLAPI DLL 檔案名稱：
- RocketSoftware BlueZone：ehlapi64.dll
- IBM 個人通訊：EHLAPI32.dll
- MicroFocus Rumba：System/ehlapi32.Dll
- Cybelesoft zScope：zHllap32.dll
附註
目前不支援 Windows HLLAPI DLL (WinHLLAPI)。
打開終端工作階段並完成所有必要作業後，使用關閉終端工作階段動作終止連線。 如果您不關閉連線，某些提供者將不允許您在不重新啟動軟體或連接的情況下，再次連接到已經開啟的對話。
開啟終端工作階段
開啟新的終端工作階段。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Provider | 無法使用 | 微焦點反射、HLLAPI | 微焦點反射 | 要使用的終端模擬 |
| HLLAPI DLL path | 否 | 檔案 | 提供者的 HLLAPI DLL。 RocketSoftware BlueZone 預設名稱：'ehlapi64.dll'。 IBM Personal Communications 預設名稱：'EHLAPI32.dll'。 MicroFocus Rumba 預設路徑：'System/ehlapi32.Dll'。 Cybelesoft zScope 預設名稱：'zHllap32.dll'。 在安裝資料夾中提供 HLLAPI DLL 的任何其他提供程序。 | |
| Installation path | 否 | 資料夾 | 提供者的應用程式在使用者檔案系統上的安裝路徑 | |
| Configuration | 無法使用 | 現有設定檔、指定連線 | 現有設定檔 | 選擇 [現有設定檔] 以選取包含預先設定終端模擬連線的檔案。 選擇 [指定連線] 以指定連線類型、主機位址和連接埠。 |
| Session name | 否 | 文字值 | 要與其連線的工作階段名稱。 HLLAPI 的簡稱，它是主機工作階段的唯一識別碼。 可以在終端模擬器的配置設定中找到它。 | |
| Host type | 無法使用 | IBM 3270、IBM 5250 | IBM 3270 | 連線的主機類型 |
| Profile | 否 | 檔案 | 包含預先設定連線的檔案 | |
| Host address | 否 | 文字值 | 要與其連線的主機位址 | |
| Port | 否 | 數值 | 要用於此連線的連接埠 | |
| Attach to running session | 無法使用 | 布林值 | 否 | 指定是否附加至目前開啟/執行中的終端工作階段 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| TerminalSession | 終端工作階段 | 與稍後的終端模擬命令一起使用的特定終端工作階段 |
例外狀況
| 例外 | 描述 |
|---|---|
| 與模擬器通訊時發生錯誤 | 表示連線至模擬器時發生問題 |
| 設定檔錯誤 | 設定檔錯誤 |
關閉終端工作階段
關閉已開啟的終端工作階段。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Terminal session to close | 否 | 終端工作階段 | 先前開啟的終端工作階段 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 與模擬器通訊時發生錯誤 | 表示連線至模擬器時發生問題 |
在終端工作階段上移動游標
將終端的游標移至指定位置。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Terminal session | 否 | 終端工作階段 | 要處理的終端工作階段 | |
| Row | 否 | 數值 | 畫面上游標的垂直位置 | |
| Column | 否 | 數值 | 畫面上游標的水平位置 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 畫面位置超出範圍 | 表示畫面位置超出範圍 |
| 模擬器不支援位置命令 | 表示模擬器不支援使用的位置命令 |
| 作業不適用於此工作階段類型 | 表示此作業不適用於此工作階段類型 |
| 與模擬器通訊時發生錯誤 | 表示連線至模擬器時發生問題 |
從終端工作階段擷取文字
從終端工作階段擷取文字。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Terminal session | 否 | 終端工作階段 | 要處理的終端工作階段 | |
| Get text from | 無法使用 | 欄位、整個畫面、游標位置、特定位置 | 欄位 | 要從中擷取文字的位置 |
| Get field by | 無法使用 | 標籤、索引、位置 | Label | 指定如何查詢欄位 |
| Label | 否 | 文字值 | 要尋找的欄位標籤 | |
| Index | 否 | 數值 | 要尋找的欄位索引 | |
| Text length | 否 | 數值 | 要接收文字的長度 | |
| Row | 否 | 數值 | 畫面上欄位的垂直位置 | |
| Column | 否 | 數值 | 畫面上欄位的水平位置 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| TerminalText | 文字值 | 從終端工作階段擷取的文字 |
例外狀況
| 例外 | 描述 |
|---|---|
| 與模擬器通訊時發生錯誤 | 表示連線至模擬器時發生問題 |
| 欄位索引超出範圍 | 表示欄位索引超出範圍 |
| 找不到欄位標籤 | 表示欄位標籤不存在 |
| 畫面位置超出範圍 | 表示畫面位置超出範圍 |
| 在指定位置找不到欄位 | 表示在指定位置沒有任何欄位 |
| 終端畫面未格式化 | 表示終端畫面未格式化 |
| 模擬器不支援位置命令 | 表示模擬器不支援使用的位置命令 |
| 作業不適用於此工作階段類型 | 表示此作業不適用於此工作階段類型 |
在終端工作階段上設定文字
在終端工作階段上設定文字。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Terminal session | 否 | 終端工作階段 | 要處理的終端工作階段 | |
| 文字 | 否 | 直接加密文字輸入或文字值 | 要在指定位置設定的文字 | |
| 設定文字 | 無法使用 | 游標位置、欄位 | 欄位 | 要設定文字的位置 |
| Get field by | 無法使用 | 標籤、索引、位置 | Label | 指定尋找欄位的方式 |
| Label | 否 | 文字值 | 要尋找的欄位標籤 | |
| Index | 否 | 數值 | 畫面上欄位的索引 | |
| Row | 否 | 數值 | 畫面上欄位的垂直位置 | |
| Column | 否 | 數值 | 畫面上欄位的水平位置 | |
| Treat @ character as literal | 無法使用 | 布林值 | 誤判為真 | 核取此方塊以將 '@' 字元當做常值傳送。 讓此選項保持停用狀態，可將其當做特殊字元傳送 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 與模擬器通訊時發生錯誤 | 表示連線至模擬器時發生問題 |
| 欄位索引超出範圍 | 表示欄位索引超出範圍 |
| 找不到欄位標籤 | 表示欄位標籤不存在 |
| 畫面位置超出範圍 | 表示畫面位置超出範圍 |
| 在指定位置找不到欄位 | 表示在指定位置沒有任何欄位 |
| 終端畫面未格式化 | 表示終端畫面未格式化 |
| 模擬器不支援位置命令 | 表示模擬器不支援使用的位置命令 |
| 作業不適用於此工作階段類型 | 表示此作業不適用於此工作階段類型 |
| 輸入文字已遭拒 | 表示已拒絕輸入的文字 |
將按鍵傳送至終端工作階段
將控制金鑰傳送至終端工作階段。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Terminal session | 否 | 終端工作階段 | 要處理的終端工作階段 | |
| Control key | 無法使用 | 傳輸、Alt 游標、注意、退格鍵、Back tab、區塊切換、中斷、取消、置中、清除、清除命令、清除螢幕、清除行、清除頁面、清除分區、逗號、命令列、命令視窗、撰寫、Ctrl+F1、Ctrl+F2、Ctrl+F3、Ctrl+F4、Ctrl+F5、Ctrl+F6、Ctrl+F7、Ctrl+F8、Ctrl+F9、Ctrl+F10、Ctrl+F11、Ctrl+F12、Ctrl+Shift+F1、Ctrl+Shift+F2、Ctrl+Shift+F3、Ctrl+Shift+F4、Ctrl+Shift+F5、Ctrl+Shift+F6、Ctrl+Shift+F7、Ctrl+Shift+F8、Ctrl+Shift+F9、Ctrl+Shift+F10、Ctrl+Shift+F11、Ctrl+Shift+F12、游標閃爍、游標選取、小數點、刪除、刪除字元、刪除行、刪除字詞、破壞性退格、中斷連接、執行、下移、下移兩次、複製、重複、編輯指令、End 鍵、欄位結尾、清除 EOF、清除 EOL、清除 EOP、清除輸入、Escape、ExtGr、F1、F2、F3、F4、F5、F6、F7、F8、F9、F10、F11、F12、F13、F14、F15、F16、F17、F18、F19、F20、F21、F22、F23、F24、F25、F26、F27、F28、F29、F30、F31、F32、F33、F34、F35、F36、F37、F38、F39、F40、F41、F42、F43、F44、F45、F46、F47、F48、欄位分隔符號、欄位退出、欄位標記、欄位減、欄位加、尋找、硬重設、說明、Hex、Hex 00、Hex 01、Hex 02、Hex 03、Hex 04、Hex 05、Hex 06、Hex 07、Hex 08、Hex 09、Hex 0A、Hex 0B、Hex 0C、Hex 0D、Hex 0E、Hex 0F、Hex 10、Hex 11、Hex 12、Hex 13、Hex 14、Hex 15、Hex 16、Hex 17、Hex 18、Hex 19、Hex 1A、Hex 1B、Hex 1C、Hex 1D、Hex 1E、Hex 1F、Hex 7F、保留、保留清除、保留設定、首頁、首頁下移、首頁上移、插入、插入字元、在此處插入、插入行、插入模式、無效按鍵、KeyPad0、KeyPad1、KeyPad2、KeyPad3、KeyPad4、KeyPad5、KeyPad6、KeyPad7、KeyPad8、KeyPad9、左移、左移兩次、換行字元、減、監視器切換、新行、下一頁、下一個畫面、下一個字、Nul、NumLock、PA1、PA2、PA3、Page、Page down、Page up、向左平移、向右平移、分割區跳躍、PF1、PF2、PF3、PF4、Plus Cr、上一個字、上一頁、上一個畫面、列印、列印行、列印訊息、列印螢幕、移除、取代、重設、返回、保留欄位、右移、右移兩次、展開、縮合、對齊線、執行指令、向下捲動、向左捲動、向右捲動、向上捲動、選取、傳送、傳回答案、傳送刪除、傳送行、傳送訊息、Shift+Backspace、Shift+Delete、Shift+Down、Shift+F1、Shift+F2、Shift+F3、Shift+F4、Shift+F5、Shift+F6、Shift+F7、Shift+F8、Shift+F9、Shift+F10、Shift+F11、Shift+F12、Shift+F13、Shift+F14、Shift+F15、Shift F16、Shift+F17、Shift+F18、Shift+F19、Shift+F20、Shift+Home、Shift+Insert、Shift+Left、Shift+Print screen、Shift+Right、Shift+Up、軟重設、系統要求、Tab、Tek 縮放、終端機下一頁、終端機上一頁、測試、文字輔助開頭粗體、文字輔助行首、文字輔助開頭底線、文字輔助、文字輔助 歸位字元、文字輔助置中、文字輔助結尾粗體、文字輔助行尾、文字輔助一半向下指標、文字輔助一半向上指標、文字輔助插入符號、文字輔助下個停止點、文字輔助下個文字欄、文字輔助頁面結尾、文字輔助必要空格、文字輔助必要定位字元、文字輔助停止點、文字輔助文字定位字元前進、文字輔助頁面頂端、文字輔助文字底線、追蹤切換、Udk 10、Udk 6、Udk 7、Udk 8、Udk 9、Udk 11、Udk 12、Udk 13、Udk 14、Udk 15、Udk 16、Udk 17、Udk 18、Udk 19、Udk 20、上移、上移兩次 | 傳輸 | 要送出至工作階段的金鑰 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 與模擬器通訊時發生錯誤 | 表示連線至模擬器時發生問題 |
| 不支援金鑰 | 表示不支援該金鑰 |
在終端工作階段上等待文字
等待特定文字顯示在終端工作階段中。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Terminal session | 否 | 終端工作階段 | 先前開啟的終端工作階段 | |
| Text to wait for | 否 | 文字值 | 等待在終端畫面或指定欄位上顯示的文字或規則運算式 | |
| Regular expression | 無法使用 | 布林值 | 否 | 指定是否要等待規則運算式而不等待純文字 |
| Wait for text location | 無法使用 | 畫面、欄位 | 畫面 | 等待文字顯示的位置 |
| Get field by | 無法使用 | 標籤、索引、位置 | Label | 指定尋找欄位的方式 |
| Label | 否 | 文字值 | 要尋找的欄位標籤 | |
| Index | 否 | 數值 | 要尋找的欄位索引 | |
| Row | 否 | 數值 | 畫面上欄位的垂直位置 | |
| Column | 否 | 數值 | 畫面上欄位的水平位置 | |
| Timeout | 是 | 數值 | 12 | 最長等待時間 |
注意
Power Automate 的標準運算式引擎是 .NET。 如需有關規則運算式的詳細資訊，請移至規則運算式語言 - 快速參考資料。
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 與模擬器通訊時發生錯誤 | 表示連線至模擬器時發生問題 |
| 欄位索引超出範圍 | 表示欄位索引超出範圍 |
| 找不到欄位標籤 | 表示欄位標籤不存在 |
| 畫面位置超出範圍 | 表示畫面位置超出範圍 |
| 在指定位置找不到欄位 | 表示在指定位置沒有任何欄位 |
| 終端畫面未格式化 | 表示終端畫面未格式化 |
| 模擬器不支援位置命令 | 表示模擬器不支援使用的位置命令 |
| 作業不適用於此工作階段類型 | 表示此作業不適用於此工作階段類型 |
| 逾時已超過 | 表示已超過逾時 |
搜尋終端工作階段的文字
搜尋在終端工作階段中所有出現的特定文字
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| Terminal session | 否 | 終端工作階段 | 先前開啟的終端工作階段 | |
| 要搜尋的文字 | 否 | 文字值 | 要在終端畫面上搜尋的文字或規則運算式 | |
| Regular expression | 無法使用 | 布林值 | 誤判為真 | 指定是否要搜尋規則運算式而不是純文字 |
| 資料行大小 | 否 | 數值 | 80 | 終端畫面上的資料行數 |
注意
Power Automate 的標準運算式引擎是 .NET。 如需有關規則運算式的詳細資訊，請移至規則運算式語言 - 快速參考資料。
變數已產生
| 引數 | 類型 | 描述: |
|---|---|---|
| FindResults | 資料表 | 擷取自終端工作階段畫面的搜尋結果 |
例外狀況
| 例外狀況 | 描述: |
|---|---|
| 與模擬器通訊時發生錯誤 | 表示連線至模擬器時發生問題 |
| 找不到文字 | 表示找不到搜尋的文字 |
| RegEx 運算式無效 | 表示使用的規則運算式無效 |