Webutil 導入ガイド

Size: px

Start display at page:

Download "Webutil 導入ガイド"

ちえこふじた
5 years ago
Views:

1 Oracle Forms リリース 10g Webutil 導入ガイド Creation Date: Jan 30, 2003 Last Update: Sep 13, 2005 Version 1.2

2 目次目次...1 はじめに...2 前提条件...2 確認した環境...2 注意事項...3 WebUtil 導入編...4 準備...4 開発環境に対する設定...6 実行環境に対する設定...6 WebUtil 適用のための基本ステップ...8 WebUtil 実装編 C/S Web 用の機能 WebUtil で新しく提供される機能...16 C/S Web ケーススタディ...18 その他のWebUtilのファンクション...20 制限事項...21 導入に関するトラブルシューティング...23 最後に...24 Oracle Forms - Webutil 導入ガイド - 1

3 はじめに Oracle Forms はその前身である Developer/2000 Forms のころから開発生産性の高い C/S アプリケーション開発ツールとして利用されてきました Forms は昨今の IT 環境の Web への移行に追従してほかには類を見ない旧来のアプリケーションファイルをそのまま Web へ移行できる仕組み Forms Server を提供し追加の開発コストとユーザーの教育コストを最小限にして Web での実行を可能にしてきましたしかしこの C/S Web の変化による環境やテクノロジーの違いのトレードオフとして旧来 C/S 環境の Forms アプリケーションで使用してきた機能のうちのいくつかに制限がかかってしまいましたそれはクライアントマシンへのアクセスなどの機能です C/S と Web のアーキテクチャの違いにより C/S 環境のアプリケーションでのクライアントマシンへのアクセスは Web 環境ではアプリケーションサーバーマシンへのアクセスとして機能しますまた C/S 時代の多くのクライアントマシンが Windows であるのに対し Web 環境ではアプリケーションサーバーマシンは必ずしも Windows ではありませんこういった理由から C/S 環境でのクライアントマシンへのアクセス機能がそのまま Web 環境で期待通りに動く保証はありませんこの制限を打開する解決策として新しく WebUtil という機能が提供されましたこの資料ではこの WebUtil によってもたらされる機能とその導入方法について説明します前提条件この資料は Forms の基本知識 ( 設計時および実行時のアーキテクチャなど ) を理解されている読者を対象として記述しています Oracle Forms の基本情報については下記のサイトを参照ください OTN( のOracle Formsの製品ページまた WebUtil の概要については WebUtil 概要資料を参照ください確認した環境本資料の作成にあたって使用した動作確認環境は以下のとおりです - Oracle Developer Suite 10g(9.0.4) for MS Windows - Oracle Developer Suite 10g(10.1.2) for MS Windows - Oracle Application Server 10g(10.1.2) Forms/Reports Standalone Server for Solaris Oracle Forms 10g(10.1.2) は 2005 年 9 月 27 日現在日本ではまだリリースされておりません日本では 2005 年 11 月以降リリースされる予定です Oracle Forms - Webutil 導入ガイド - 2

4 注意事項本資料におけるディレクトリ名実行ファイル名は Forms の環境に準じた記述にしてあります Forms の場合は以下に置き換えて読む必要があります Forms Forms <Oracle_Home> forms <Oracle_Home> forms90 frmcmp.sh f90cmp.sh frmcmp.exe if90cmp.exe forms.conf forms90.conf Oracle Forms - Webutil 導入ガイド - 3

5 WebUtil 導入編ここでは WebUtil の環境設定に関する情報を説明します準備開発環境に対する設定実行環境に対する設定準備以下の準備作業は開発環境実行環境に関係なく共通で必要な作業です必要なファイルのダウンロードと解凍 WebUtil 機能の導入にあたって次のファイルが必要になります WebUtil 本体 OTN-J よりダウンロード可能です (2005 年 8 月現在最新バージョンはです ) ダウンロードした zip ファイルを <Oracle_Home> forms 以下に解凍します OLE 連携用ファイルからファイルをダウンロードしますただしバージョン 1.8 のものをダウンロードしてください 1.9 以降のバージョンでは問題があることが報告されていますダウンロードしたzipファイルから jacob.jar を <Oracle_Home> forms java に jacob.dll を <Oracle_Home> forms webutil に解凍しますセキュリティ設定 <Oracle_Home> forms java frmwebutil.jar 内には oracle.forms.webutil.common.tusteddomains.txt というファイルが格納されていますこのファイルのエントリによって WebUtil 機能を利用可能なクライアントマシンを限定できますデフォルトでは * が記述されていますがここを *.yourdomain.com とするとこれにマッチするクライアントホスト以外では WebUtil 機能を利用できなくなります (WUC-27 エラーが発生します ) 補足 : この機能は WebUtil のファイルアップロード機能などの不正利用を防ぐために追加されました Oracle Forms - Webutil 導入ガイド - 4

6 Jar に対するデジタル署名 <Oracle_Home> forms webutil sign_webutil.bat( または UNIX の場合は sign_webutil.sh) をテキストエディタで開きますこのファイル内のエントリを適切に書き換えます次にコマンドラインで現行ディレクトリを <Oracle_Home> forms webutil に移動し次のコマンドを実行します > sign_webutil.bat.. java jacob.jar > sign_webutil.bat.. java frmwebutil.jar この一連のコマンドで jar ファイルに署名が行われます ( 署名される前の状態のファイルは ***.old という名前でバックアップされます ) 注意 1: jar ファイルのデジタル署名の有効期限は 360 日として設定されていますこの値を変更したい場合は sign_webutil.bat/sh 内の VALIDDAYS パラメータの数値を書き換えます注意 2: カスタムのプラッガブル Java コンポーネント (PJC) を作成利用している場合はその PJC を含む jar ファイルにも同じデジタル署名を行う必要がありますデータベースの準備 WebUtil によって提供される新しい機能 DB へのファイル転送の際に使用される PL/SQL パッケージを作成しますこのパッケージは DB へのファイル転送機能を使用しない場合は使用されないものですが以後の作業で行う pll ファイルのリコンパイルの際にパッケージの有無のチェックが行われますので使用しない場合でも作成しておく必要があります SQL*Plus を起動し適切な DB ユーザーで接続します以下のコマンドを入力 forms create_webutil_db.sql このコマンドにより DB ユーザーの所有物として WEBUTIL_DB という PL/SQL パッケージが作成されます webutil.pll のリコンパイル UNIX 環境では次のようにします cd $ORACLE_HOME/forms $ORACLE_HOME/bin/frmcmp.sh webutil.pll userid=<username/pass@tns> Module_Type=LIBRARY Compile_All=YES 実際に実行する際には 2 行目と 3 行目は続けて ( 一行のコマンドとして ) 実行してください UNIX 環境では事前に次の環境変数を正しく設定しておく必要があります ORACLE_HOME NLS_LANG DISPLAY Oracle Forms - Webutil 導入ガイド - 5

7 Windows 環境では次のようにします cd %ORACLE_HOME% forms frmcmp.exe webutil.pll Module_Type=LIBRARY Compile_All=YES 実際に実行する際には 2 行目と 3 行目は続けて ( 一行のコマンドとして ) 実行してください重要 : pll のリコンパイル作業は必ず実施してください pll が正しくリコンパイルされていないことに起因するトラブルが数多く報告されています開発環境に対する設定 Oracle Developer Suite がインストールされたマシンで開発時に WebUtil を利用できるように設定を行いますこの作業は Oracle Developer Suite 10g(10.1.2) では必要ありません環境変数の変更 Windows 環境の場合レジストリエディタを使って以下のキーの値を変更します : HKEY_LOCAL_MACHINE Software Oracle Home<n> FORMS90_BUILDER_CLASSPATH 値 :<Oracle_Home> forms90 java f90all.jar;<oracle_home> forms90 java frmwebutil.jar;<oracle_home> forms90 java jacob.jar;< 元の値 > UNIX 環境の場合は上記環境変数値を <Oracle_Home>/bin/f90desm.sh で設定しておくと便利です加えてテスト用の OC4J サーバーで WebUtil を利用可能にするために次の実行環境に対する設定の作業も行ってください実行環境に対する設定この作業は Oracle Application Server 10g(10.1.2) でも必要ですアプリケーションサーバー上に仮想ディレクトリを追加アプリケーションに対してブラウザからアクセスする場合に /forms/webutil のディレクトリが利用可能である必要があります A) Oracle Application Server に対して設定する場合 <Oracle_Home>/forms/server/forms.conf に以下を追加します Oracle Forms - Webutil 導入ガイド - 6

8 AliasMatch ^/forms/webutil/(..*) <Oracle_Home>/forms/webutil/$1" B) Oracle Developer Suite のテスト用 OC4J サーバーに対して設定する場合 <Oracle_Home> j2ee DevSuite application-deployments forms90 formsweb orion-web.xml に以下を追加します <virtual-directory virtual-path="/webutil" real-path="<oracle_home> forms90 webutil" /> <Oracle_Home>/forms/server/formsweb.cfg 以下のエントリを追加します webutilarchive=/forms/java/frmwebutil.jar,/forms/java/jacob.jar また次のエントリを変更します basehtmljinitiator=webutiljini.htm basehtmljpi=webutiljpi.htm basehtml=webutilbase.htm 注意 : 最後の 3 つのエントリを変更することによってこのアプリケーションサーバーから実行されるすべての Forms アプリケーションは以後 WebUtil のライブラリを ( 使う使わないに関係なく ) 要求するようになりますこの動作を制御したい (WebUtil 使用の Forms アプリケーションのみが WebUtil のライブラリを要求するようにしたい ) 場合は formsweb.cfg 内に WebUtil 用のセクションを用意し Forms アプリケーション実行時にそれを (envid ランタイムパラメータを使用して ) 指定します <Oracle_Home>/forms/server/default.env 以下のエントリを追加します WEBUTIL_CONFIG=<Oracle_Home>/forms/server/webutil.cfg また次のエントリを変更します CLASSPATH=<Oracle_Home>/forms/java/frmwebutil.jar:< 元の値 > 注意 : 上記例は UNIX 上のアプリケーションサーバーに対する設定例です Windows 環境の場合は CLASSPATH のエントリ区切り文字は : ではなく ; を使用してください Oracle Forms - Webutil 導入ガイド - 7

olb 内のオブジェクトクラスの適用 Forms Builder オブジェクトナビゲータのオブジェクトライブラリ以下の WEBUTIL を選択した状態で右クリックメニューからオブジェクトライブラリを選びますオブジェクトライブラリ

9 WebUtil 適用のための基本ステップ WebUtil を使用したフォームを構成するには次のステップを取ります 1. Forms Builder を起動し既存フォーム (fmb) を開きます 2. Forms Builder で webutil.olb を開きます Forms Builder オブジェクトナビゲータのオブジェクトライブラリに WEBUTIL が追加されます 3. webutil.olb 内のオブジェクトクラスの適用 Forms Builder オブジェクトナビゲータのオブジェクトライブラリ以下の WEBUTIL を選択した状態で右クリックメニューからオブジェクトライブラリを選びますオブジェクトライブラリウィンドウが開きますオブジェクトライブラリウィンドウに表示されているオブジェクトクラス WEBUTIL をフォーム内のオブジェクトグループツリー上にドラッグ & ドロップしますヒント : オブジェクトを追加する際にサブクラスにするかコピーを行うかの確認ダイアログが表示されます WebUtil の機能としてはどちらを選択してもかまいません Oracle Forms - Webutil 導入ガイド - 8

10 WebUtil のために必要なオブジェクト群がフォームに追加されます s 4. 連結ライブラリとして webutil.pll を追加する Forms Builder オブジェクトナビゲータの該当フォーム以下のツリーにある連結ライブラリを選択した状態でメニューから編集作成を選びます連結ライブラリダイアログが開きますここで webutil.pll を選択し連結を押します Oracle Forms - Webutil 導入ガイド - 9

11 ヒント : 連結の際に連結ライブラリのファイル位置に対するパスを削除するかどうかの確認ダイアログが表示されます通常ここでははいを選択しますこれによりフォームの実行時に FORMS_PATH などの環境変数で指定された場所から pll ファイルが検索されます逆にここでいいえを選択すると連結ライブラリの情報としてパスが含まれフォームに実行時にもまったく同じ絶対パス上の pll のみを参照することになります開発環境と実行環境の OS が異なるようなケースではここははいを選択する必要があります 5. コードの変更追加必要に応じて WebUtil で提供される機能を使用するようにトリガーコードまたはプログラムユニットのコードを変更します WebUtil で提供される機能とその利用方法については WebUtil 実装編を参照ください 6. コンパイル Forms Builder 上でコンパイルとテスト実行を行い期待通りに動作するかどうか確認しますまた実行するアプリケーションサーバーのプラットフォームが開発環境と異なる OS である場合には fmb ファイルをアプリケーションサーバーに配置した後その OS 上でリコンパイルする必要があります WebUtil を有効にした Forms アプリケーションをブラウザから実行すると最初に署名付きアプレットに対するセキュリティ警告ダイアログが立ち上がりますこの警告で許可を選択した後 WebUtil 機能を利用した Forms アプリケーションが動作します Oracle Forms - Webutil 導入ガイド - 10

12 WebUtil 実装編 WebUtil では大別して以下の機能が提供されます C/S 環境での Forms で使用されていたクライアントマシンへのアクセス機能の Web 環境版 (Host Text_IO Get_File_Name OLE2 TOOL_ENV D2KWUTIL Ora_ffi など ) Web アプリケーションとして要望の多い機能の新規提供 ( ファイルのアップロード / ダウンロードアプレット情報の取得など ) C/S Web 用の機能 C/S Web の機能は更に 2 つのタイプに分類されます置換機能既存ビルトインと完全に対となる機能が用意されていますファンクション / プロシージャ名を変更するだけで C/S 環境と同じ機能が Web 環境でも同様に利用できるようになります代替 / 拡張機能既存ビルトインのうち OS 依存なコードだったものや関連性が高いのにいくつかのパッケージに分散されていた機能は再構成されより洗練された形で WebUtil に用意されていますさらにいくつかの付加機能が追加されているものもありますここではこれらの機能の説明とそれぞれがどの既存ビルトインと対応するものかについて解説しますなお後のセクション ( C/S Web ケーススタディ ) では置換機能代替機能のそれぞれについて C/S Web の移行における PL/SQL コードの書き換えの例を紹介しています Oracle Forms - Webutil 導入ガイド - 11

13 置換機能この分類に該当する WebUtil の機能はその名前が Client_ で始まる形で用意されていますこれらの機能は既存の Forms ビルトイン機能の Web 対応版として移行しやすい形で提供されているものです既存の Forms ビルトイン機能と WebUtil の機能は次のように対応しています Forms ビルトイン関数対応する WebUtil 関数 STANDARD 拡張機能 HOST Client_HOST GET_FILE_NAME Client_GET_FILE_NAME READ_IMAGE_FILE Client_Image.READ_IMAGE_FILE WRITE_IMAGE_FILE Client_Image.WRITE_IMAGE_FILE OLE2 すべての機能 Client_OLE2.xxxx TEXT_IO すべての機能 Client_TEXT_IO.xxxx TOOL_ENV すべての機能 Client_TOOL_ENV.xxxx D2KWUTIL WIN_API_ENVIRONMENT Client_WIN_API_ENVIRONMENT 注意事項 1. Client_HOST でコールするコマンドは OS で正しく認識できる必要がありますここで Windows の DOS コマンドなどをコールする場合は注意してください DEL や COPY などのコマンドは単独の OS コマンドではありませんこれらを Client_HOST で実行させるためには CMD /c DEL ファイル名 ( または Windows 9x/ME であれば COMMAND /c DEL ファイル名 ) のようにコールする必要があります参照 : WebUtil User's Guide の Running HOST commands 2. Client_Image.READ_IMAGE_FILE / WRITE_IMAGE_FILE ではクライアントマシン上のイメージファイルをアプリケーションサーバーマシン上にアップロードする必要があるためこれらの機能を有効にするために WebUtil のファイル転送機能に関する設定がされている必要があります ( ファイル転送についてはファイル転送 (upload/download) を参照) 3. Client_OLE2 では Office97 インターフェースでの OLE2 連携のみがサポートされます ( Client_OLE2 に関する注意参照 ) Oracle Forms - Webutil 導入ガイド - 12

14 4. Client_TOOL_ENV はクライアントマシンが Windows の場合環境変数ではなくレジストリ変数の値を参照するように実装されています ( Client_TOOL_ENV に関する注意参照 ) 5. WebUtil には他にも Client_WIN_API*** という名前のパッケージが含まれていますがこれらは Client_WIN_API_ENVIRONMENT からの内部使用のために用意されています C/S 環境で D2KWUTIL の WIN_API.PRELOAD を使用していた場合これに対応する Client_WIN_API.PRELOAD のコールは使用せず単にコメントアウトするようにしてください Rre-Load 作業は Web 環境では不要になりました ( 逆に Pre-Load のコードがあるとエラーになる場合があります ) Oracle Forms - Webutil 導入ガイド - 13

15 代替 / 拡張機能この分類には以下の機能が該当します Webutil_C_API Webutil_File Webutil_Host Webutil_ClientInfo Webutil_C_API 既存ビルトイン関数である ORA_FFI の代替機能を提供しますつまりアプリケーションサーバー上で動作する Forms アプリケーションからクライアントマシン上の C 関数ファイルとの連携処理を行うことが可能になります Webutil_C_API でコールする C 関数ファイル (Windows で言えば DLL や EXE) はアプリケーションサーバーに配置しクライアントマシンにダウンロードして実行される仕組みになりますダウンロード対象となる C 関数ファイルは webtuil.cfg ファイルに次の書式で登録しておく必要があります Install.syslib.<osNumber>.<packageName>.<n>= <filename> <filesize> <versionnum> < ダウンロードダイアログの表示 > たとえば次のようになります install.syslib.0.user.1=d2kwut60.dll true ここに登録する C 関数ファイルはアプリケーションサーバー側ではクライアントにダウンロードできるように次の場所に配置します <Oracle_Home> forms webutil これにより登録されたファイル名とファイルサイズの情報に一致するファイルが自動的にダウンロードされるようになりますクライアント側ではダウンロードされた後 Forms Java クライアントが実行される JRE の bin ディレクトリ (Jinitiator を使用している場合は JInitiator の bin ディレクトリ ) に配置されますこのため Forms Java クライアントが実行される JRE の bin ディレクトリはクライアントマシンの PATH 環境変数内に含まれている必要があります参照 : WebUtil User's Guide の Installation Options 参考情報 : ( 英語 ) Oracle Forms - Webutil 導入ガイド - 14

16 Webutil_File Webutil_File は WebUtil によって提供されるファイル処理関連機能をまとめたパッケージですこれに含まれるいくつかの機能はこれまで D2KWUTIL 内のいくつかのパッケージに分散して提供されていたファイル操作機能をマルチプラットフォーム対応に対応にして洗練させたものです D2KWUTIL 内の機能 WIN_API_UTILITY.COPY_FILE WIN_API_UTILITY.DELETE_FILE WIN_API_UTILITY.MOVE_FILE WIN_API_UTILITY.CREATE_DIRECTORY WIN_API_UTILITY.DELETE_DIRECTORY WIN_API_FILE.FILE_SIZE WIN_API_DIALOG.OPEN_FILE WIN_API_DIALOG.SAVE_FILE WIN_API_DIALOG.OPEN_FILE / SAVE_FILE WIN_API_DIALOG.OPEN_FILEEX WIN_API_DIRECTROY_LIST FIRSTFILE NEXTFILE CLOSESEARCH 代替となりうる Webutil_File の機能 COPY_FILE DELETE_FILE RENAME_FILE CREATE_DIRECTORY DELETE_FILE FILE_SIZE FILE_OPEN_DIALOG FILE_SAVE_DIALOG FILE_SELECTION_DIALOG FILE_MULTI_SELECTION_DIALOG DIRECTORY_LIST DIRECTORY_ROOT_LIST DIRECTORY_FILTERED_LIST およびそれらの戻り値である FILE_LIST オブジェクトタイプ Webutil_File にはこれら以外にもファイル操作に関するいくつかの機能が用意されています参照 : WebUtil User's Guide の WebUtil_File Webutil_Host Webutil_Host は既存の HOST 関数の拡張機能を提供するパッケージです D2KWUTIL.WIN_API_SHELL の ShellExecute や WinExec を使って実行していた処理は WebUtil の Client_Host や Webutil_Host で置き換えてください Webutil_ClientInfo Webutil_ClientInfo はクライアントマシンの情報を取得する機能を提供しますこれはこれまで D2KWUTIL.WIN_API_ENVIRONMENT や TOOL_ENV などで実現していた機能をマルチプラットフォーム対応にして洗練させたものです今後クライアントマシン情報を取得したい場合はこのパッケージの機能を利用することをお勧めします Oracle Forms - Webutil 導入ガイド - 15

17 WebUtil で新しく提供される機能ファイル転送 (upload/download) Webutil_File_Transfer パッケージにはファイル転送用の機能が用意されていますこのファイル転送機能を利用可能な状態にするには webutil.cfg に以下のエントリを追加する必要があります # ファイル転送機能の使用の有無 transfer.database.enabled=true transfer.appsrv.enabled=true # App サーバー上へのファイルの書き込みの許可 transfer.appsrv.accesscontrol=true # App サーバー上の作業ディレクトリ transfer.appsrv.workarearoot=< 適当な位置を指定します > # 読み書きを許可する App サーバー上の物理ディレクトリ位置 transfer.appsrv.read.1=< 適当な位置を指定します > transfer.appsrv.write.1=< 適当な位置を指定します > Webutil_File_Transfer にはファイル転送元 / 先および進捗ダイアログの有無の選択に応じたファイル転送機能が用意されていますクライアントからの転送 (upload) 転送先通常版進捗ダイアログ付きアプリケーション Client_To_AS Client_To_AS_With_Progress サーバーマシン上へデータベースのデータ (BLOB) として Client_To_DB Client_To_DB_With_Progress クライアントへの転送 (download) 転送先通常版進捗ダイアログ付きアプリケーション AS_To_Client AS_To_Client_With_Progress サーバーマシン上からデータベースのデータ DB_To_Client DB_To_Client_With_Progress (BLOB) から指定された URL から URL_To_Client URL_To_Client_With_Progress 補足 :DB との間のファイル転送のために webutil.pll 内の Webutil_DB_Local およびデータベースの準備で作成した DB 上のパッケージ WEBUTIL_DB が使用されます Oracle Forms - Webutil 導入ガイド - 16

18 実行例 ( サンプルコード ) トリガーコードでは次のように記述します ( 下記は Client_To_AS の例です ): DECLARE result BOOLEAN; BEGIN result:= Webutil_File_Transfer. Client_To_AS( :filename, -- 転送元ファイルパス :as_location -- 転送先ファイルパス ); END; また Client_To_AS_With_Progress の場合は次のように記述します : DECLARE result BOOLEAN; BEGIN result:= Webutil_File_Transfer. Client_To_AS_With_Progress( :filename, -- 転送元ファイルパス :as_location -- 転送先ファイルパス ' アップロード ', -- 進捗ダイアログのタイトル ' ファイル転送中 ', -- 進捗ダイアログ上のメッセージ FALSE, -- 非同期処理を行うかどうか NULL - 非同期モード ( 上記パラメータがTRUE) の場合に - 処理の終わり時にコールするトリガー名 ); END; < 転送元 >_To_< 転送先 >_With_Progress ファンクションを使用すると次のような進捗ダイアログで転送状況を知らせてくれますこの他ファイル転送に関する情報を取得するためのファンクションがいくつか用意されています参照 : WebUtil User's Guide の The File transfer package タイムアウト処理 Webutil_Session パッケージの機能を使用するとタイムアウト時にリダイレクトする URL を設定できるようになります参照 : WebUtil User's Guide の WebUtil_Session Oracle Forms - Webutil 導入ガイド - 17

19 Forms Java クライアント連携 Webutil_Browser デフォルトもしくは SeparateFrame=false のランタイムパラメータを使用して Forms アプリケーションを実行すると Java Applet はブラウザ内部で実行されますこの場合に有効なユーティリティファンクションが含まれています Webutil_SeparateFrame SeparateFrame=true のランタイムパラメータを使用して Forms アプリケーションを実行すると Java Applet はブラウザ外部のウィンドウ上で実行されますこの場合に有効なユーティリティファンクションが含まれています C/S Web ケーススタディここでは実際のコードを例に挙げて C/S 環境の Forms アプリケーションで使用されていたトリガーコードをどのように Web 環境用に変換するのか見ていきます置換機能の移行例置換機能で紹介したビルトインは基本的にパッケージやプロシージャの名前を Web 用 (Client_xxx) に置き換える作業だけです TEXT_IO TOOL_ENV による例 C/S 環境でのコード DECLARE MYFILE TEXT_IO.FILE_TYPE; CUR_REC NUMBER; DIRNAME VARCHAR2(200); BEGIN GO_BLOCK('DEPT'); CUR_REC := :SYSTEM.CURSOR_RECORD; IF :SYSTEM.BLOCK_STATUS!= 'NEW' THEN FIRST_RECORD; -- ファイルのオープン TOOL_ENV.GETVAR('TEMP', DIRNAME); MYFILE :=TEXT_IO.FOPEN( DIRNAME :CTRL.FILENAME, 'W'); -- ファイルへの書き込み TEXT_IO.PUTF(MYFILE,'DEPTNO,DNAME,LOC'); TEXT_IO.NEW_LINE(MYFILE); LOOP TEXT_IO.PUTF(MYFILE, TO_CHAR(:DEPT.DEPTNO) ','); Oracle Forms - Webutil 導入ガイド - 18

20 TEXT_IO.PUTF(MYFILE, :DEPT.DNAME ','); TEXT_IO.PUTF(MYFILE, :DEPT.LOC ','); TEXT_IO.NEW_LINE(MYFILE); EXIT WHEN :SYSTEM.LAST_RECORD = 'TRUE'; NEXT_RECORD; END LOOP; -- ファイルのクローズ TEXT_IO.FCLOSE(MYFILE); END IF; GO_RECORD(CUR_REC); END; これを WebUtil を利用して移行すると次のようになります DECLARE MYFILE CLIENT_TEXT_IO.FILE_TYPE; CUR_REC NUMBER; DIRNAME VARCHAR2(200); BEGIN GO_BLOCK('DEPT'); CUR_REC := :SYSTEM.CURSOR_RECORD; IF :SYSTEM.BLOCK_STATUS!= 'NEW' THEN FIRST_RECORD; -- ファイルのオープン CLIENT_TOOL_ENV.GETVAR('TEMP', DIRNAME); MYFILE := CLIENT_TEXT_IO.FOPEN( DIRNAME :CTRL.FILENAME, 'W'); -- ファイルへの書き込み CLIENT_TEXT_IO.PUTF(MYFILE,'DEPTNO,DNAME,LOC'); CLIENT_TEXT_IO.NEW_LINE(MYFILE); LOOP CLIENT_TEXT_IO.PUTF(MYFILE, TO_CHAR(:DEPT.DEPTNO) ','); CLIENT_TEXT_IO.PUTF(MYFILE, :DEPT.DNAME ','); CLIENT_TEXT_IO.PUTF(MYFILE, :DEPT.LOC ','); CLIENT_TEXT_IO.NEW_LINE(MYFILE); EXIT WHEN :SYSTEM.LAST_RECORD = 'TRUE'; NEXT_RECORD; END LOOP; -- ファイルのクローズ CLIENT_TEXT_IO.FCLOSE(MYFILE); END IF; GO_RECORD(CUR_REC); END; ただし上記例では TOOL_ENV Client_TOOL_ENV の仕様変更に伴い Client_TOOL_ENV で取得したい変数を環境変数ではなく Windows レジストリ変数として設定しておく必要があります ( Client_TOOL_ENV に関する注意参照 ) Oracle Forms - Webutil 導入ガイド - 19

21 代替機能の移行例 WIN_API_DIALOG.SAVE_FILE の例 C/S 環境でのコード BEGIN :SFD_RESULT := WIN_API_DIALOG.SAVE_FILE( SampleName => NULL, Title => ファイルの保存, StartDirectory => C:, FileFilter => すべてのファイル (*.*) *.*, Modal => TRUE, RaiseExceptions => TRUE); END; これを WebUtil を利用して移行すると次のようになります BEGIN :SFD_RESULT := Webutil_File.File_Save_Dialog( C:, NULL, すべてのファイル (*.*) *.*, ファイルの保存 ); END; 引数の順番や数が異なることに注意してください Webutil_File ではエラーは必ず Exception を発生するようになっていますその他の WebUtil のファンクション WebUtil の PL/SQL ライブラリである webutil.pll にはここまでに紹介したもの以外にもいくつかのパッケージが用意されていますここではそれらについて解説しますエラー情報の取得 Webutil_Core パッケージは WebUtil の中核的なパッケージですそのほとんどはユーザーが直接使用することが許可されていませんが以下の機能だけは使用可能です IsError ErrorCode ErrorText ユーザーはこれらを利用して WebUtil 機能利用時のエラー情報を取得できます Oracle Forms - Webutil 導入ガイド - 20

22 ユーティリティパッケージ以下は他の機能をサポートするために用意されたユーティリティ機能です機能名概説 Show_Webutil_Information WebUtil のバージョン情報などの表示 Webutil_Util ブール値を Yes/No に変換するファンクション Delimstr 区切り文字列としてのデータの入出力 ## 主に内部目的で使用されています内部使用用途のパッケージ以下のパッケージは内部使用のためのものですユーザーが直接これらのパッケージを使用しないようにしてください java_appserv_reader java_file java_appserv_writer java_system java_exception 制限事項 WebUtil 機能の使用可能範囲 WebUtil によるクライアントマシンへのアクセスのためには Forms Java クライアント上で WebUtil の JavaBeans がインスタンス化されている必要があります逆にいうとインスタンス化される前や破棄された後は WebUtil 機能を利用できませんたとえば PRE-FORM WHEN-NEW-FORM-INSTANCE 最初のブロックの WEHN-NEW-BLOCK-INSTANCE POST-FORM などでは WebUtil 機能は利用できませんヒント : ただし Form 起動時の利用については最初のトリガーで Timer を設定し Timer の Expire トリガー (WHEN-TIMER-EXPIRE) を利用するなどすれば対応は可能です参照 : WebUtil User's Guide の 5.3 Adding WEBUTIL code Client_OLE2 に関する注意 Client_OLE2 は Office97 インターフェースでテストされていますまた Office95 インターフェースの OLE2 連携コードではうまく機能しない例が報告されています参照 : WebUtil User's Guide の 5.4 Using OLE Commands Oracle Forms - Webutil 導入ガイド - 21

23 Client_TOOL_ENV に関する注意 C/S 環境での TOOL_ENV はクライアントマシンで設定されている環境変数の値を取得していました WebUtil の Client_TOOL_ENV ではクライアントが Windows である場合には環境変数ではなく以下のキーに定義されたレジストリ変数の値を取得するように仕様が変更されています HKEY_LOCAL_MACHINE Software Oracle Windows Handle(hWnd) を引数とする C へのコール現在 hwnd を引数とする C ファンクションへのコールは WebUtil ではサポートされていませんこのような引数を使った連携のためにはクライアント JVM が J2SDK 1.4 以上である必要がありますが WebUtil では J2SDK 1.3 以上をサポートするためこの機能は実装されていません同じ理由により D2KWUTIL.WIN_API_SHELL.SendKeys は WebUtil に実装されていません WebUtil による置き換え対象ではない Forms C/S 機能 DDE 連携 DDE 連携機能は WebUtil では対応の予定がありません OLE2 連携のコードに置き換えた後 Client_OLE2 を使って Web 対応する必要があります VBX OCX 連携 C/S 環境で VBX および OCX コントロールをフォーム上に配置して実行する機能は Web 環境では利用できませんこれは Java Applet としての仕様です同等機能を実現する手段として VBX および OCX コントロールに相当するコンポーネントを JavaBeans として用意しそれを Beans 領域タイプの項目としてフォーム上に作成して利用する必要がありますその他 WebUtil 付属の Readme.html にもいくつかの既知の問題が記載されていますそちらにも必ず目を通しておく必要があります ( アプリケーションサーバーが Linux の場合や J2SDK のリビジョンに関する情報が記載されています ) また US-OTN の WebUtil FAQ にも有用な情報が記載されています Oracle Forms - Webutil 導入ガイド - 22

24 導入に関するトラブルシューティング実行時に FRM-40735/ORA-6508 が発生する webutil.pll がパスに入っていないまたは webutil.pll が正しくリコンパイルされていないことが原因である可能性があります "Forms セッション <n> 異常終了 : ランタイムプロセスとの通信ができませんでした " または ConnectionException.createConnectionException エラー webutil.pll が正しくリコンパイルされていないことが原因である可能性があります特に Windows 環境においてテスト用 OC4J 上で実行する場合は注意してください Forms Builder 上で webutil.pllのコンパイルをしても保存されていなければテスト用サーバーは保存前の状態の webutil.pll を参照してフォームの実行を行いますその結果として pll の不整合によって上記のようなエラーが発生しますまたフォーム自体の完全なリコンパイルが必要な場合もありますこの問題に直面した場合には次の作業を行うことをお勧めします webutil.pll をリコンパイルするコマンドで実行する場合は Compile_All=Yes のオプションでコンパイルします ( 準備の webutil.pll のリコンパイル参照 ) または Forms Builder 上でリコンパイルする場合はメニューからプログラム PL/SQL のコンパイルすべてを選択して実施し保存します対象のフォームをリコンパイルする Forms Builder 上で対象フォームを実行する際に実施されるコンパイルだけではエラー解決にならない場合があります明示的にメニューからプログラム選択のコンパイルを選択してフォーム全体のリコンパイルを実施します FRM エラーが出るこれは FORMS_PATH 上に webutil という名前のディレクトリと webutil.pll の両方が存在していて pll 検索時に先に webutil ディレクトリが検知されてしまう場合に発生します webutil.pll をきちんとコンパイルして webutil.plx を作成すればこの問題は発生しません Oracle Forms - Webutil 導入ガイド - 23

25 最後に WebUtil は Oracle Forms の拡張機能の効果的な利用方法を実現したひとつの形ですこれに代表されるように Oracle Forms には多くの拡張性が用意されておりそれによって既存のアプリケーション資産を無駄にすることなく新しいシステム要件のためのさまざまな要望に対応できます今後も Java テクノロジーを活用した拡張性やサーバー上の連携機能が強化されていく予定です Oracle Forms - Webutil 導入ガイド - 24

26 日本オラクル株式会社 Copyright 2005 Oracle Corporation Japan. All Rights Reserved. 無断転載を禁ずこの文書はあくまでも参考資料であり掲載されている情報は予告なしに変更されることがあります日本オラクル社は本書の内容に関していかなる保証もいたしませんまた本書の内容に関連したいかなる損害についても責任を負いかねます Oracle はオラクル社の登録商標です Oracle8 Oracle8i Oracle9i Net8 はオラクル社の商標または登録商標です他のすべての企業名と製品名は識別のためにのみ掲載されておりそれぞれの所有者の商標の場合があります Oracle Forms - Webutil 導入ガイド - 25

Microsoft PowerPoint - FormsUpgrade_Tune.ppt

Microsoft PowerPoint - FormsUpgrade_Tune.ppt Forms アップグレードに関する追加作業 - 工数見積もりサイジングチューニング - 必要な追加作業工数見積もりサイジングチューニング 2 1 C/S Web 工数見積もり工数見積もりの際に考慮すべき事項アップグレードによる一般的なコード修正テスト工数 C/S では使用できるが Web では廃止された機能に対する対策 USER_EXIT を使って Windows 上 DLL のファンクションをコールしている