6.3 WEBEVENTフォームを管理するWAMコンテナー・フォーム

WEBEVENTフォームを呼び出す主な手段は、HandleEvent()というJavaScript関数です。WAMフォームからWEBEVENTフォームを呼び出すためのJavaScriptベースの手段として、それとよく似たHandleWebEvent()という関数も用意されています。

WAMフォームからWEBEVENTフォームを呼び出すには、以下のようにします。

1.  提供されているHandleWebEvent()という名前のJavaScript関数を使用します。

     この関数を呼び出す方法は、HandleEvent()関数を呼び出す方法と同じです。

2.  (Webroutineを呼び出す場合とは異なり) ウェブレットにはWEBEVENTを呼び出すための追加のプロパティはありません。HandleWebEvent()は、ほとんどのウェブレットのpresubmit_jsプロパティから、またはユーザー定義のJavaScriptによって呼び出せます。例えば、onclick属性の値を設定することでJavascriptを直接実行することが可能です。

      document.LANSA.SEARCH.onclick = "HandleWebEvent('MYPROC', 'MYFUNC', null, 'WEFrame', 'ASURNAME', 'ASTDRENTRY')"

3.  パラメータは、HandleWebEvent(Process, Webevent, Form, Target, "ASURNAME", "ASTDRENTRY", ...)のようになっていて、各フィールドに対応する可変数のパラメータの値をWEBEVENTに渡すことができます。Form以外のすべてのパラメータは文字列であり、Formは、実際のフォームDHTMLオブジェクト(document.MYFORMなど)にします。ここでフィールド名の前に接頭辞を1文字付けることが重要です。この接頭辞は、Alphanumericフィールドの場合はA、Packedフィールドの場合はP、Signedフィールドの場合はS、RDMLXフィールドの場合はQです。この接頭辞は必須で、これにより呼び出し対象のWEBEVENTが渡されるフィールド値を交換できるようになります。

     JavaScript関数のTargetパラメータは必須です。指定できる値は、中に組み込むNavigation panel (std_nav_panel) ウェブレットの名前、ウィンドウの名前、独自のHTMLエレメントである<iframe>または<frame>の名前のいずれかです。

4.  このJavaScript関数は、指定のFormパラメータ (またはFormがnullの場合は省略値の"LANSA"フォーム) からフィールドの値を取得し、一時的なフォームを作成して、URLに送信されるこのフォームにフィールドと値を挿入します。そして、URLに対するHTTP postを実行します。HandleWebEvent()にパラメータとして渡すフィールド名にはすべて、フィールドのタイプを示す1文字の接頭辞を付ける必要があることに注意してください。WAMフィールド参照は接頭辞を必要としませんが、WEBEVENTファンクションは必要とします。したがって、このJavaScriptコードは、WAMフォームから指定のフィールド値を取得するときには1文字の接頭辞なしで取得しますが、WEBEVENTファンクションにフィールド名を送信するときには接頭辞付きで送信します。

5.  その結果、指定のフィールド値が渡されたWEBEVENT LANSAファンクションが実行され、WEBEVENTページが宛先のNavigation panel (std_nav_panel) ウィンドウに表示されるか、独自のHTMLエレメントである<iframe>または<frame>に表示されます。

WAMフォームからWEBEVENTフォームを開始し、情報を渡す方法

このSearch WAMフォームは、Browse WEBEVENTを呼び出し、入力されたSURNAMEフィールドの値を渡し、検索ボタンの下のNavigation panel (std_nav_panel) に結果を表示するとします。

1.  LANSAエディターで、下のようにNavigation panel (std_nav_panel) ウェブレットをページにドラッグ・アンド・ドロップし、nameプロパティに'WEFrame'と入力します。size_panel_to_contentプロパティでは"yes"を選択します。これで、呼び出し対象のWEBEVENTページのサイズいっぱいになるようサイズが調整されます。

2.  検索ボタンをクリックして、検索ボタンのpresubmit_jsプロパティに次を入力します。'HandleWebEvent("MYPROC", "MYFUNC", null, "WEFrame", "ASURNAME", "ASTDRENTRY"); return false;'

3.  このページをブラウザーで実行して検索ボタンをクリックすると、WEBEVENTが呼び出され、同じページのNavigation panel (std_nav_panel) ウェブレットにこのWEBEVENTページが表示されます。