Cover Image

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キーのみを扱うものであり、文字やカスタムファンクションキーには適用されません。

このブログについて

HCL Japan の Software 部門の複数担当者で HCL Software 全般について記しています。

Tags

Academy Accelerate Accelerator Ambassador AoC AppDev Pack AppScan ASoC beta BigFix BigFix 9.5 BigFix_Wiki BigFix Workspace branding CAA Client Applicatin Access cloud Cloud Apps Cloud Native Commerce Common Local License Server community companion Compass compliance Connections Connections 6.5 ConnectionsDocs Connnections CVE-2021-44228 developerWorks DevOpes Velocity DevOps DevOps Code ClearCase DevOps Code RealTime DevOps Deploy DevOps.Launch.AppScan DevOps Model RealTim DevOps Plan DevOps Test DevOps Velocity Digital Experience Discover document Doino Volt Domino Domino AppDev Pacl Domino Leap Domino Volt Domino管理者アップデート認定試験対策 DQL DRYiCE dW dx Enterprise Integrator event fix fix_list fixlist forum General guide HCAA HCL Ambassador HCL Ambassadors HCL Domino REST API HCL OneTest Embedded HCL Z and I Emulator HCL Z and I Emulator for Transformation HCLSoftware U hints_and_tips history HTMO IBM_i iControl ID_Vault iNotes ios ios13 ipad iPhone IZSAM KEEP Launch Launch.DevOps Leap Link logo MarvelClient mobile mui nds2019 ndv12beta News Noets/Domino Nomad Nomad Mobile Nomad Web Notes Notes/Domino Notes/Domino 10 Notes/Domino 11 notes-domino-9-10-limited-supportability-as-of-202204 Notes/Domino V12 Notes/Domion Notes/Domno notescons Now on_premises OneDB OneTest OnTime osaka press_release relay REST RTist SafeLinx Sametime Sametime 11 SoFy support survey system_requirement techtek Traveler Traveler 10 Traveler for Microsoft Outlook traveler.zip Unica Unica Discover Unica Interact UrbanCode Deploy UrbanCode Velocity v11 V12 Verse Verse Mobile Verse On-Premises VersionVault Volt Volt MX Volt MX Go Volt MX サンプルアプリ Webinar win7 Wordload Automation Workload Automation youtube Z Z Abend Investigator Z and I Emulator Z and I Emulator for Transformation Z and I Emulator for Web Z and I Emulator for Web Client Z Asset Optimizer Z Data Tools Z Software Asset Manager ZAI ZAO ZIE ZIE for Transformation ZIE for Web ZIE for Windows ZIET ZIETrans ZIEWeb うるう年 イベント ウェビナー ガイド クラウド クラウド終了 サイジング サポート サポート技術情報 サポート期間 サポート終了 セキュリティ セキュリティー セキュリティー脆弱性 セミナー ダイバーシティー ダウンロード テクてく テクてく Lotus 技術者夜会 ニュース ノーツコンソーシアム バージョンアップ パフォーマンス パートナー ベータ ポートフォリオ ライセンス 九州地区 Notes パートナー会 互換性 出荷日 各種ご案内資料 研修