この章の構成は、次のとおりです。
以前のリリースのOracle Formsでは、Forms外部の限られた数のイベント型と対話するためにOLEおよびDDEを実装する必要がありました。その後のバージョンのFormsで、外部アプリケーション・ソースとのインタフェースを実現するためにweb.show_document
およびJavaの統合が提供されました。
ただし、Formsが表示されるWebページへのコールに関しては、簡単なソリューションがありませんでした。また、HTMLフォームから取得した値を更新する場合などに、WebページからFormsをコールすることもできませんでした。
Oracle Forms 12cでは、JavaScriptの統合により、JavaScriptイベントからのFormsのコールやFormsによるJavaScriptイベントの実行が可能になっています。次の図は、JavaScriptとOracle Formsが連携する仕組みを示しています。図の左側で、FormsアプレットがホストされているページでJavaScriptが実行されます。Oracle Formsには、ネイティブのビルトインを使用してJavaScript機能をコールできる機能が加わりました。また、JavaScript機能は、提供されている新しいAPIを使用してOracle Formsトリガーを起動できるようになりました。
web
組込みパッケージには、次の2つの新しいコールが提供されています。
web.javascript_eval_expr
web.javascript_eval_function
最初のコールweb.javascript_eval_expr
は、式とターゲットの2つの引数を使用するプロシージャです。引数のデータ型はどちらもvarchar2
です。この有効なJavaScript式は、Formsアプレットが埋め込まれているWebページで解釈されます。この式は、ターゲット・ページで定義されている関数のコール、またはターゲット・ページで実行できる有効なJavaScript式(たとえばdocument.bgColor='red'.
)です。この式は、LiveConnectのJSObject.eval()メソッドを使用して、ターゲット引数に指定されたページまたはフレームのコンテキストで実行されます。ターゲット引数がNullの場合は、Formsアプレットが埋め込まれているページまたはフレームで式が実行されます。
2番目のコールweb.javascript_eval_function
は関数であり、varchar2値を返します。web.javascript_eval_expr
とweb.javascript_eval_function
の機能は、javascript_eval_expr
がFormsクライアントからForms Servicesに戻り値を送信しない点を除いて同じです。アプリケーションが戻り値を必要としない場合は、web.javascript_eval_expr
を使用してください。FormsクライアントからForms Servicesに戻り値を渡す場合に必要となる余分なネットワーク送信を省くことができます。
IDがoutside_field_id
であるHTMLテキスト項目の値を、inside
というFormsフィールドの値に設定するには、次のPL/SQLコードを記述します。
web.javascript_eval_expr(' document.getElementById("outside_field_id").value=' ||:inside );
JavaScriptでは一重引用符と二重引用符を自由に使用できますが、PL/SQL文字列には一重引用符を使用する必要があるので注意してください。式の内部で二重引用符を使用する場合は、エスケープ・シーケンスを使用する必要はありません。Webページ内で関数を記述することもできます。
<SCRIPT> function set_field(field_id, myvalue){ document.getElementById(field_id).value=myvalue; }; </SCRIPT>
outsideフィールドの値を取得してinsideフィールドに割り当てるには、次のPL/SQLコードを記述します。
:inside:=web.javascript_eval_function(' document.getElementById("outside_field_id").value ');
FormsアプレットをホストするWebページでJavaScriptを使用して、JavaScriptからOracle Formsをコールすることもできます。
DOM (Document Object Model)ツリー内の埋め込まれたFormsオブジェクトに新しい機能が提供されています。JavaScriptを使用して次の処理を行います。
document.forms_applet.raiseEvent(event_name, payload);
ここでは、ID構成変数をforms_applet
に設定していたことを前提としています。
周囲のWebページがこのJavaScriptコードを実行すると、Oracle FormsがWHEN-CUSTOM-JAVASCRIPT-EVENT
という新しいタイプのトリガーを起動します。このトリガーには、system.javascript_event_value
とsystem.javascript_event_name
の2つの有効なシステム変数があります。これらの変数に含まれているペイロードとイベント名は、raiseEvent
メソッドを通じてFormsに渡されたものです。raiseEvent
メソッドがコールされると、WHEN-CUSTOM-JAVASCRIPT-EVENT
という名前のトリガーがサーバー側で起動されます。
declare event_val varchar2(300):= :system.javascript_event_value; begin if (:system.javascript_event_name='show') then handleShowEvent(event_val); elsif(:system.javascript_event_name='grab') then handleGrabEvent(event_val); else null; end if; end;
このPL/SQLコードは、showとgrabの2つのイベントを認識します。それ以外の名前は無視されます。
この項では、Oracle FormsアプリケーションでJavaScriptを統合する例について説明します。
注意:
Forms Builderのオンライン・ヘルプも参照してください
Oracle FormsアプリケーションでJavaScriptを統合するには、次の手順を実行します。
WHEN-CUSTOM-JAVASCRIPT-EVENT
トリガーで:system.javascript_event_name
および:system.javascript_event_value
を使用します。このモジュールをコンパイルします。test.html
など)。このファイルを、Formsの構成ディレクトリ $ORACLE_INSTANCE/config/FormsComponent/forms/server
にコピーします。$DOMAIN_HOME/servers/WLS_FORMS/tmp/_WL_user/formsapp_12.2.1/<random_string2>/war/
ディレクトリにコピーしますjs.html
など)を作成します。 enableJavascriptEvent
を有効にします。baseHTMLjpiをtest.html
に設定します。default.env
ファイルを編集して、Formsアプリケーションを保存したディレクトリを環境変数FORMS_PATH
に追加します。http://<localhost>:9001/forms/js.html
を指定して、アプリケーションを実行します。 Java Web StartまたはFormsスタンドアロン・ランチャを使用している場合、JavaScriptを使用してOracle FormsアプリケーションをWebページと統合できるようになりました。
JavaScriptを使用してFormsアプリケーションをWebページを統合する機能は、Oracle Forms 11g R2で導入されました。この機能を使用すると、開発者はFormsアプリケーションとHTMLベースのWebアプリケーションを調和することができました。FormsアプリケーションがHTMLページと通信できるため、アプリケーションの設計がよりクリエイティブになりました。以前のOracle Forms 12cのリリースでは、Java Web StartまたはFormsスタンドアロン・ランチャを使用している場合、JavaScriptを使用した統合の機能は使用できませんでした。これは、その構成に親ブラウザが含まれておらず、したがって、2つのテクノロジ間をつなぐ方法が公開されていないためです。
Oracle Forms 12c (12.2.1.3.0)以降、Java Web StartまたはFormsスタンドアロン・ランチャを使用しているときに、実行中のFormsアプリケーションに親ブラウザが含まれていなくても、ブラウザのHTMLコンテンツと再度通信することが可能です。きわめて軽量なWebリスナーであるEclipse/Jettyを利用して、Formsアプリケーションでは、Webソケット接続を介してWebページと通信できるようになっています。
この機能には、EclipseからのJetty (9.4.5.v20170502)のダウンロードおよび署名が必要となります。jarファイルをMaven Centralからダウンロードします(http://central.maven.org/maven2/org/eclipse/jetty/aggregate/jetty-all/9.4.5.v20170502/jetty-all-9.4.5.v20170502-uber.jar)。
Formsアプリケーションの管理者は、formsweb.cfg
のパラメータenableJavascriptEvent
をtrueまたはfalseに設定することによってJavaScript統合を有効または無効にすることができます。
enableJavascriptEvent
がtrueに設定されていない場合、JavaScriptからのコールは無視されます。document.<applet_name>を介してFormsアプレットを参照するには、applet_nameパラメータをHTML開発者によって使用される値に設定する必要があります。
また、管理者はformsweb.cfg
のJavaScriptBlocksHeartBeat
(デフォルト値: false)をtrueに設定する必要があります。これにより、JavaScriptの実行中にFormのHEARTBEAT
がブロックされます。FORMS_TIMEOUTの時間内にJavaScriptが実行全体をコールする場合、JavaScriptBlocksHeartBeatをtrueに設定すると追加のネットワーク・メッセージを回避でき、パフォーマンスが向上します。
JavaScriptBlocksHeartBeatをtrueに設定した場合は、JavaScriptの実行に要する時間がFORMS_TIMEOUTの値を超えるとFormsが異常終了します。