ターミナル エミュレーション アクション

Power Automate は、ターミナル エミュレーション アクションを通じてターミナル エミュレーターとの統合を提供します。 これらのアクションにより、端末とメインフレームを処理し、カーソルの移動、テキストの設定と取得、キーの送信などの操作を実行できます。

ターミナル アクションを展開する前に、ターミナル セッションを開く アクションを使用してインストールされたプロバイダーとの新しい接続を開きます。

重要

ターミナル セッションに接続する前に、実際のターミナル セッションがマシンですでに開いていることを確認してください。

マシンに Micro Focus Reflection をインストールした場合は、アクションの プロバイダー プロパティを作成し、必要な構成を設定します。

別のプロバイダーをインストールした場合は、ほとんどの端末エミュレーションプロバイダーで機能する HLLAPI を選択します。

使用しているプロバイダーに応じて、インストール フォルダーにある適切な HLLAPI DLL ファイルを選択します。 次のリストに、いくつかの一般的なターミナル エミュレーション プロバイダーの HLLAPI DLL ファイル名を示します。

• RocketSoftware BlueZone: ehlapi64.dll
• IBM Personal Communications: EHLAPI32.dll
• MicroFocus Rumba: System/ehlapi32.Dll
• Cybelesoft zScope: zHllap32.dll

メモ

Windows HLLAPI DLL (WinHLLAPI) は現在サポートされていません。

ターミナルセッションを開き、必要なすべての操作を完了したら、ターミナルセッションを閉じる アクションを使用して接続を終了します。 接続を閉じないと、一部のプロバイダーは、ソフトウェアまたは接続を再起動せずに、すでに開いているセッションに再度接続することを許可しません。

ターミナル セッションを開きます

新しいターミナル セッションを開きます。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Provider	N/A	Micro focus reflection、HLLAPI	Micro Focus Reflection	使用するターミナル エミュレーションです
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	いいえ	フォルダー		ユーザーのファイル システム上にあるプロバイダーのアプリケーションのインストール パスです
構成	N/A	既存のプロファイル、接続の指定	既存のプロファイル	「既存のプロファイル」を選択して、あらかじめ設定されたターミナル エミュレーション接続を含むファイルを選択します。 「接続の指定」を選択して、接続のタイプ、ホスト アドレス、ポートを指定します。
Session name	いいえ	テキスト値		接続先のセッション名。 HLLAPI の短い名前であり、ホスト セッションの一意識別子です。 これは、ターミナル エミュレーターの構成設定で確認できます。
Host type	N/A	IBM 3270、IBM 5250	IBM 3270	接続のホストの種類です
Profile	いいえ	ファイル		事前に構成された接続を含むファイルです
Host address	いいえ	テキスト値		接続先のホスト アドレスです
Port	いいえ	数値		この接続に使用するポートです
Attach to running session	N/A	ブール値	無効	現在開かれている、または実行されている、ターミナル セッションに接続するかどうかを指定します

生成された変数

引数	タイプ	説明設定
TerminalSession	ターミナル セッション	後のターミナル エミュレーション コマンドで使用する特定のターミナル セッションです

例外

例外	内容
エミュレーターとの通信中にエラーが発生しました	エミュレーターへの接続に問題があることを示します
プロファイル エラーです	プロファイル エラーです

ターミナル セッションを閉じます

開かれているターミナル セッションを閉じます。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Terminal session to close	いいえ	ターミナル セッション		以前に開かれたターミナル セッションです

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
エミュレーターとの通信中にエラーが発生しました	エミュレーターへの接続に問題があることを示します

ターミナル セッションでカーソルを移動します

ターミナルのカーソルを指定された位置に移動します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Terminal session	いいえ	ターミナル セッション		使用するターミナル セッションです
Row	いいえ	数値		画面上でのカーソルの垂直位置です
Column	いいえ	数値		画面上でのカーソルの水平位置です

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
画面の位置が範囲外です	画面の位置が範囲外であることを示します
位置コマンドがエミュレーターでサポートされていません	使用する位置コマンドがエミュレーターでサポートされていないことを示します
操作はこのセッションの種類には使用できません	操作はこのセッションの種類には使用できないことを示します
エミュレーターとの通信中にエラーが発生しました	エミュレーターへの接続に問題があることを示します

ターミナル セッションからテキストを取得します

ターミナル セッションからテキストを取得します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Terminal session	いいえ	ターミナル セッション		使用するターミナル セッションです
Get text from	N/A	フィールド、画面全体、カーソル位置、特定の位置	フィールド	テキストの取得元の場所です
Get field by	N/A	ラベル、インデックス、位置	Label	フィールドを検索する方法を指定します
Label	いいえ	テキスト値		検索するフィールドのラベルです
Index	いいえ	数値		検索するフィールドのインデックスです
Text length	いいえ	数値		受信するテキストの長さです
Row	いいえ	数値		画面上でのフィールドの垂直位置です
Column	いいえ	数値		画面上でのフィールドの水平位置です

生成された変数

引数	タイプ	説明設定
TerminalText	Text 値	ターミナル セッションから取得したテキストです

例外

例外	内容
エミュレーターとの通信中にエラーが発生しました	エミュレーターへの接続に問題があることを示します
フィールド インデックスが範囲外です	フィールド インデックスが範囲外であることを示します
フィールド ラベルが見つかりません	フィールド ラベルが存在しないことを示します
画面の位置が範囲外です	画面の位置が範囲外であることを示します
指定された位置にフィールドが見つかりませんでした	指定された位置にフィールドが存在しないことを示します
ターミナル画面が初期化されていません	ターミナル画面が初期化されていないことを示します
位置コマンドがエミュレーターでサポートされていません	使用する位置コマンドがエミュレーターでサポートされていないことを示します
操作はこのセッションの種類には使用できません	操作はこのセッションの種類には使用できないことを示します

ターミナル セッションにテキストを設定します

ターミナル セッションにテキストを設定します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Terminal session	いいえ	ターミナル セッション		使用するターミナル セッション
テキスト	いいえ	直接暗号化された入力またはテキスト値		指定された場所に設定するテキスト
テキストを設定	N/A	カーソル位置、フィールド	フィールド	テキストの設定先の場所です
Get field by	N/A	ラベル、インデックス、位置	Label	フィールドの検索方法を指定します
Label	いいえ	テキスト値		検索するフィールドのラベルです
Index	いいえ	数値		画面上でのフィールドのインデックスです
Row	いいえ	数値		画面上でのフィールドの垂直位置です
Column	いいえ	数値		画面上でのフィールドの水平位置です
Treat @ character as literal	N/A	ブール値	False	'@' 文字をリテラルで送信するには、このボックスをオンにします。 このオプションを無効のままにし、特殊文字として送信します

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
エミュレーターとの通信中にエラーが発生しました	エミュレーターへの接続に問題があることを示します
フィールド インデックスが範囲外です	フィールド インデックスが範囲外であることを示します
フィールド ラベルが見つかりません	フィールド ラベルが存在しないことを示します
画面の位置が範囲外です	画面の位置が範囲外であることを示します
指定された位置にフィールドが見つかりませんでした	指定された位置にフィールドが存在しないことを示します
ターミナル画面が初期化されていません	ターミナル画面が初期化されていないことを示します
位置コマンドがエミュレーターでサポートされていません	使用する位置コマンドがエミュレーターでサポートされていないことを示します
操作はこのセッションの種類には使用できません	操作はこのセッションの種類には使用できないことを示します
入力テキストが拒否されました	入力テキストが拒否されたことを示します

ターミナル セッションにキーを送信

ターミナル セッションにコントロール キーを送信します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Terminal session	いいえ	ターミナル セッション		使用するターミナル セッションです
Control key	N/A	送信、Altカーソル、注意、バックスペース、戻るタブ、ブロックトグル、ブレーク、キャンセル、中央揃え、クリア、通信のクリア、表示のクリア、行のクリア、ページのクリア、パーティションのクリア、コマ、コマンドライン、コマンドウィンドウ、作成、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、カーソル点滅、カーソル選択、10進、削除、文字の削除、行の削除、単語の削除、破壊的なバックスペース、切断、実行、ダウン、ダウンダブル、Dup、Duplicate、Edit script、Key end、End of field、Erase EOF、Erase EOL、Erase EOP、Erase input、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、フィールド区切り文字、フィールド出口、フィールドマーク、フィールドマイナス、フィールドプラス、検索、ハードリセット、ヘルプ、16進数、16進数00、16進数01、16進数02、16進数03、16進数04、16進数05、16進数06、16進数07、16進数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、Hold、Hold clear、Hold set、Home、Home down、Home up、Insert、Insert char、Insert here、Insert line、Insertモード、無効なキー、KeyPad0、KeyPad1、KeyPad2、KeyPad3、KeyPad4、KeyPad5、KeyPad6、KeyPad7、KeyPad8、KeyPad9、左、左ダブル、ラインフィード、マイナス、モニタートグル、新しい行、次のページ、次の画面、次の単語、Nul、NumLock、PA1、PA2、PA3、ページ、ページダウン、ページアップ、左パン、右パン、パーティションジャンプ、PF1、PF2、PF3、PF4、Plus Cr、前の単語、PrevPage、PrevScreen、印刷、印刷行、印刷メッセージ、プレント画面、削除、置換、リセット、戻る、予約フィールド、右、右ダブル、ロールダウン、ロールアップ、Rile行、スクリプトの実行、スクロールダウン、スクロール左、右にスクロール、上にスクロール、選択、送信、回答の送信、削除の送信、行の送信、メッセージの送信、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、Soft reset、System request、Tab、Tekズーム、用語次ページ、用語前ページ、テスト、テキストアシスト開始太字、テキストアシスト開始行、テキストアシスト開始下線、テキストアシストキャリアリターン、テキストアシストセンター、テキストアシスト終了太字、テキストアシスト行の終わり、テキストアシストハーフインデックスダウン、テキストアシストハーフインデックスアップ、テキストアシスト挿入記号、テキストアシスト次の停止、テキストアシスト次のテキスト列、テキストアシストページの終わり、テキストアシスト必要なスペース、テキストアシスト必要タブ、テキストアシスト停止、テキストアシストテキストタブアドバンス、テキストアシストページ上部e、テキストアシストワードアンダースコア、Trace Toggle、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、Up、Up double	送信	セッションに送信するキーです

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
エミュレーターとの通信中にエラーが発生しました	エミュレーターへの接続に問題があることを示します
キーがサポートされていません	キーがサポートされていないことを示します

ターミナル セッションでテキストを待機

ターミナル セッションで特定のテキストが表示されるまで待機します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Terminal session	いいえ	ターミナル セッション		以前に開かれたターミナル セッションです
Text to wait for	いいえ	テキスト値		ターミナル画面または指定されたフィールドに表示されるまで待機する、テキストまたは正規表現です
Regular expression	N/A	ブール値	無効	通常のテキストではなく正規表現を待機するかどうかを指定します
Wait for text location	N/A	スクリーン、フィールド	スクリーン	テキストが表示されるまで待機する場所です
Get field by	N/A	ラベル、インデックス、位置	Label	フィールドの検索方法を指定します
Label	いいえ	テキスト値		検索するフィールドのラベルです
Index	いいえ	数値		検索するフィールドのインデックスです
Row	いいえ	数値		画面上でのフィールドの垂直位置です
Column	いいえ	数値		画面上でのフィールドの水平位置です
Timeout	はい	数値	12	待機する時間の最大値です

Note

Power Automate の正規表現エンジンは .NET です。 正規表現に関する詳細については、正規表現言語 - クイック リファレンス を参照してください。

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
エミュレーターとの通信中にエラーが発生しました	エミュレーターへの接続に問題があることを示します
フィールド インデックスが範囲外です	フィールド インデックスが範囲外であることを示します
フィールド ラベルが見つかりません	フィールド ラベルが存在しないことを示します
画面の位置が範囲外です	画面の位置が範囲外であることを示します
指定された位置にフィールドが見つかりませんでした	指定された位置にフィールドが存在しないことを示します
ターミナル画面が初期化されていません	ターミナル画面が初期化されていないことを示します
位置コマンドがエミュレーターでサポートされていません	使用する位置コマンドがエミュレーターでサポートされていないことを示します
操作はこのセッションの種類には使用できません	操作はこのセッションの種類には使用できないことを示します
タイムアウトの期限が切れました	タイムアウトが期限切れになったことを示します

ターミナル セッションのテキストを検索する

ターミナル セッションにおける特定のテキストのすべての出現回数を検索する

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Terminal session	いいえ	ターミナル セッション		以前に開かれたターミナル セッションです
検索するテキスト	いいえ	テキスト値		ターミナル画面で検索するテキストまたは正規表現
Regular expression	N/A	ブール値	False	通常のテキストではなく正規表現を検索するかどうかを指定します
列のサイズ	いいえ	数値	80	ターミナル画面に表示される列の数

注意

Power Automate の正規表現エンジンは .NET です。 正規表現に関する詳細については、正規表現言語 - クイック リファレンス を参照してください。

生成される変数

引数	タイプ	Description
FindResults	Datatable	ターミナル セッション画面から取得された結果を検索する

例外

例外	Description
エミュレーターとの通信中にエラーが発生しました	エミュレーターへの接続に問題があることを示します
テキストが見つかりません	検索しているテキストが見つからなかったことを示します
正規表現が無効です	使用された正規表現が無効であることを示します