HCL Z and I Emulator: ホストファンクションキーの外部操作
2022/10/28 - 読み終える時間: 3 分
HANDLING HOST FUNCTION KEYS EXTERNALLY の翻訳版です。
ホストファンクションキーの外部操作
2022年10月27日
著者: Mahaswathi K / Software Engineer
はじめに
ZIE (HCL Z and I Emulator) for Web-Clientは、カスタマイズされた方法でホストファンクションキーを処理するための追加機能を提供します。この機能により、ユーザーは要件に応じてホストファンクションキーに対するさまざまなアクションを処理または提供することができます。
前提条件
ユーザーは、以下の手順でカスタムテンプレートのパスを設定する必要があります。
- ZIE for Web公開/非公開ディレクトリのweb.propertiesファイルにあるパラメータ「templateURL」を使用する。
- もう1つの方法は、ZIE for Web-Clientの管理コンソールでカスタムテンプレート・パスを設定する方法です。
この機能を利用するための簡単な操作
- まず最初に、管理者はまたは外部スクリプト・ファイル内のカスタム・テンプレートで、パラメータ「isHandleKeyExternaly」をtrueに設定する必要があります。
- そして、カスタマイズされた方法でホストファンクションキーを処理するために、関数 "handledKeyExternally(keyPressed, data, TEXT_PLANE, sessionName)" を利用します。
keyPressed は、現在の画面におけるホストファンクションキー（ニーモニック）を与えます。
data: 現在のスクリーンの 'text, startRow, startCol' を保持する配列。
TEXT_PLANE - 現在の画面の行と列のデータを保持する2次元配列。
sessionName: キーが押された現在のセッション名を保持します。
- 上記は、trueかfalseのどちらかを返すBoolean型でなければならない。
- もし関数がfalseを返した場合、return文の前にあるカスタムスクリプトのアクションを実行し、キー/コマンドをホストに送信します。
- 関数がtrueを返した場合、このキーにマッピングされたカスタムスクリプトのアクションが実行され、キー/コマンドはホストに送信されません。
- また、セッションマネージャAPIのように、グリーンスクリーンのコンテンツにアクセスするための追加のAPIメソッドを提供しており、外部でキーを扱うのにかなり役立つと思われます。
- そのメソッドのいくつかを紹介します。
- function Sync_getString4 (String sessionName, int row, int col, int length)
- function Sync_sendKeys2(String sessionName, String text)
(利用可能なメソッドの詳細については、HCL Knowledge Center -ZIE for Web-Clientを参照してください。）
- All these API methods must be enclosed within the handledKeyExternally method in the custom JavaScript file.
- Code snippet:
<script src=”https://<IP_of_ZIEWeb_Server>:<port>/<ZIEWeb_ALIAS>/customscriptfile.js”>
Option 1:
function handledKeyExternally(keyPressed,data,TEXT_PLANE,sessionName){
for(n in data){
textEntered=data[n].text.trim ();
if(keyPressed==”[pf3]”){
if(textEntered===”SAMPLE”){
var url=”https://www.google.com”;
parent.window.open(url,’_blank’);
return true;
}
}
}
}Option 2:
function handledKeyExternally(keyPressed,data,TEXT_PLANE,sessionName){
if(keyPressed==”[pf3]”){
if(Sync_getString4(“3270 Display-A”,2,1,6)===” SAMPLE “){
var url=”https://www.google.com”;
parent.window.open(url,’_blank’);
return false;
}
}
}制限事項
カスタムスクリプトファイルは、Z and I Emulator for Web公開ディレクトリに配置し、カスタムテンプレートにパスを指定する必要があります。
この機能は、ホスト機能のPFキーのみを扱うものであり、文字やカスタムファンクションキーには適用されません。