Oracle Forms

Oracle Forms 6iからOracle Forms 12cへのアップグレード

12c (12.2.1)

E72538-01(原本部品番号:E57481-01)

2015年10月

Oracle Forms Oracle Forms 6iからOracle Forms 12cへのアップグレード 12c (12.2.1)

E72538-01

Copyright © 2015, Oracle and/or its affiliates.All rights reserved.

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクル社までご連絡ください。

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

このソフトウェアもしくはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアもしくはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアもしくはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、オラクル社およびその関連会社は一切の責任を負いかねます。

OracleおよびJavaはOracle Corporationおよびその関連企業の登録商標です。その他の名称は、それぞれの所有者の商標または登録商標です。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

目次

タイトルおよび著作権情報

はじめに

- 対象読者

- ドキュメントのアクセシビリティについて

- 関連ドキュメント

- 表記規則

1 アップグレードの理由

- 1.1 概要

- 1.2 Formsアプリケーションの12cリリース(12.2.1)へのアップグレードについて

- 1.3 Oracle Formsから削除されたForms 10gの機能

- 1.4 Oracle Formsから削除されたForms 6iの機能

- 1.5 削除された6i Developer製品スイートのコンポーネント

- 1.6 Forms 6iアプリケーションのアップグレード時における廃止項目タイプの扱い

- 1.7 廃止機能の移行用に用意されているツール

2 Oracle Forms Migration Assistantの使用

- 2.1 Oracle Forms Migration Assistantの機能

- 2.1.1 複数ログのサポート

- 2.2 converter.propertiesファイルの編集

- 2.3 search_replace.propertiesファイルの編集

- 2.3.1 検索と置換を行う文字列の追加

- 2.3.2 廃止されたビルトインに関する警告の変更

- 2.4 Oracle Forms Migration Assistantの起動

- 2.4.1 バッチ・モードのMigration Assistantについて

- 2.4.2 バッチ・モードでのMigration Assistantの起動

- 2.4.2.1 Windowsでのバッチ・モードによるMigration Assistantの起動

- 2.4.2.2 UNIXでのバッチ・モードによるMigration Assistantの起動

- 2.4.3 Forms Migration Assistantのウィザード・バージョンの実行

- 2.4.3.1 Forms Migration Assistantのウィザード・バージョンの起動

- 2.4.3.2 コンバータの拡張オプションの設定

3 Forms 6i FMTのOracle Forms FMBへの変換

- 3.1 Forms 6i FMTのOracle Forms FMBへの変換

4 ビルトイン、パッケージ、定数、構文

- 4.1 廃止されたメニュー・ビルトイン

- 4.2 廃止されたその他のビルトイン

- 4.3 廃止されたビルトイン・パッケージ

- 4.4 廃止された定数

- 4.5 廃止された構文

5 トリガー

- 5.1 廃止されたトリガー

- 5.2 トリガーの適用ルールの厳格化

6 プロパティ

- 6.1 廃止されたプロパティ

7 クライアント/サーバー・デプロイとFormsランタイムに対する変更

- 7.1 概要

- 7.2 Formsデプロイへの影響

- 7.3 廃止されたFormsランタイムのコマンドライン・オプション

- 7.4 廃止されたキャラクタ・モード・ランタイム

8 アイテム・タイプ

- 8.1 廃止された項目タイプ

- 8.2 オペレーティング・システム固有の項目タイプ

9 論理属性とGUI属性

- 9.1 論理属性とGUI属性にかわる可視属性の使用

- 9.2 廃止された論理属性とGUI属性

10 値リスト(LOV)

- 10.1 廃止された値リスト(LOV)

11 ユーザー・イグジット

- 11.1 廃止されたV2のユーザー・イグジット

12 メニュー・パラメータ

- 12.1 事前定義済のメニュー・パラメータ

- 12.2 ユーザー定義のメニュー・パラメータ

13 Java関連の問題

- 13.1 Javaプラグ可能コンポーネントおよびその他のカスタムJavaの使用

- 13.2 JDKのバージョンとフォントのレンダリングに関する問題

14 Oracle Reportsとの統合

- 14.1 概要

- 14.2 Oracle Reportsとの統合について

- 14.2.1 Oracle FormsでのReportsの表示

- 14.2.2 例

- 14.2.3 例の説明

- 14.2.4 RUN_REPORT_OBJECTでのパラメータ・リストの使用

- 14.2.5 アップグレードの手順

15 Webへのクライアント/サーバー・アプリケーションのアップグレード

- 15.1 アップグレードのガイドライン

- 15.2 クライアント/サーバーベースのアーキテクチャについて

- 15.3 Webベースのアーキテクチャについて

16 Forms 6iより前のアプリケーションからOracle Formsへのアップグレード

- 16.1 フォームのアップグレード

- 16.2 データベースに保存されているファイルのアップグレード

- 16.3 以前のバージョンのPL/SQLとの互換性

- 16.4 Forms Developerのランタイム動作

はじめに

ようこそ。このマニュアルには、次の内容が記載されています。

- Forms DeveloperおよびForms Servicesから削除された機能

- Forms 6iアプリケーションをOracle Forms 12cに展開またはデプロイする際に自動的に発生するアップグレード・イベント。

- Oracle Forms Migration Assistant(アプリケーションの変換に役立つツール)

- FormsアプリケーションをForms 6iからOracle Forms 12cにアップグレードする際に、開発者、システム管理者およびデータベース管理者が実行する必要がある手順。

対象読者

このマニュアルは、Oracle Formsアプリケーションの開発およびデプロイに携わる開発者、システム管理者およびデータベース管理者を対象としています。

ドキュメントのアクセシビリティについて

Oracleのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracle Supportへのアクセス

サポートをご購入のOracleのお客様は、My Oracle Supportにアクセスして電子サポートを受けることができます。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info) か、聴覚に障害のあるお客様は (http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。

関連ドキュメント

詳細は、次のマニュアルおよびオンライン・ヘルプを参照してください。

- Oracle Forms and Reportsリリース・ノート

- 『Oracle Fusion Middleware Forms Services Deployment Guide』

- Oracle Forms Developerオンライン・ヘルプ(Oracle Forms Developerのヘルプ・メニューからアクセスできる)

また、ホワイト・ペーパーやその他の関連ドキュメントは、http://www.oracle.com/technetwork/developer-tools/forms/documentation/index.htmlにあります。

表記規則

このマニュアルでは次の表記規則を使用します。

規則

意味

太字

太字は、操作に関連するGraphical User Interface要素、または本文中で定義されている用語および用語集に記載されている用語を示します。

イタリック体

イタリックは、ユーザーが特定の値を指定するプレースホルダ変数を示します。

固定幅フォント

固定幅フォントは、段落内のコマンド、URL、サンプル内のコード、画面に表示されるテキスト、または入力するテキストを示します。

1 アップグレードの理由

この章は、次の項で構成されています。

- 第1.1項「概要」

- 第1.2項「Formsアプリケーションの12cリリース(12.2.1)へのアップグレードについて」

- 第1.3項「Oracle Formsから削除されたForms 10gの機能」

- 第1.4項「Oracle Formsから削除されたForms 6iの機能」

- 第1.5項「削除された6i Developer製品スイートのコンポーネント」

- 第1.6項「Forms 6iアプリケーションのアップグレード時における廃止項目タイプの扱い」

- 第1.7項「廃止機能の移行用に用意されているツール」

1.1 概要

Web上でのFormsアプリケーションの開発とデプロイを簡素化するために、Oracle Forms BuilderとOracle Forms Servicesがアップグレードされました。多数の機能が追加されています。また、Oracle Forms製品の再編成により、一部のレガシー機能が削除または縮小されています。今後は、3つのすべての層でJavaが統合されるため、JavaベースのWebユーザー・インタフェースが強化され、製品の開放性が広がります。

1.2 Formsアプリケーションの12cリリース(12.2.1)へのアップグレードについて

Oracle Formsアプリケーションをアップグレードするには、Forms 6iのソース・ファイル(FMB、MMB、PLLなど)をOracle Forms 12c (12.2.1)のビルダーで開き、保存してからコンパイルします。Forms 6iアプリケーションのアップグレードには、Oracle Forms Compilerも使用できます。

Forms Migration Assistantを使用すると、バッチのアップグレードを実行できます。詳細は、第2章「Oracle Forms Migration Assistantの使用」を参照してください。

注意:
Formsがこのライブラリに依存する場合は、rp2rro.pllをrp2rro.plxにコンパイルする必要があります。rp2rro.pllは、ORACLE_HOME/forms/rp2rro.pllにあります。生成されたplxは、FORMS_PATH内に置く必要があります。

1.3 Oracle Formsから削除されたForms 10gの機能

次の機能がOracle Forms 10gから削除されています。

- Graphicsの統合

- チャート項目

1.4 Oracle Formsから削除されたForms 6iの機能

次の機能がOracle Forms 9.0.2から削除されています。

- クライアント/サーバー・ランタイム

- キャラクタ・モード・ランタイム

- 各種のランフォーム・コマンドライン・オプション

- キャラクタ・モード・プロパティおよび論理属性

- オペレーティング・システム固有の項目タイプ

- 各種ビルトイン

- 各種プロパティ

- 次の各種メニュー機能

- キャラクタ・モード・メニュー・プロパティ

- メニュー項目コマンド・タイプ・プロパティから廃止されたタイプ

- メニュー・パラメータ

- メニュー・ビルトイン

- 全画面メニュー・スタイル

- バー(Lotus)メニュー・スタイル

- Formsバージョン2スタイルのトリガーおよび値リスト(LOV)

- グラフィック・チャート・ウィザード

また、トリガーの適用ルールがより厳しくなりました。

1.5 削除された6i Developer製品スイートのコンポーネント

次のコンポーネントが削除されています。

表1-1 Developerスイートから削除されたコンポーネント

廃止されたコンポーネント

アップグレードの注意点

Oracle Graphics

アプリケーションでGraphics Web CartridgeまたはOracle Graphics Runtimeを使用している場合、それらのアプリケーションをリライトして、他の方法(Java、Bi Beansを使用するなど)でグラフィックを再開発する必要があります。詳細は、http://www.oracle.com/technetwork/developer-tools/forms/downloadsのデモを参照してください。

Oracle Formsリスナーおよびロード・バランシング・コンポーネント

Formsリスナー・サーブレットを使用してWebでのFormsセッションを管理します。Formsリスナー・サーブレットには次の特徴があります。

- すべてのトラフィックが標準のWebサーバーHTTPポートまたはHTTPポート経由で転送され、余分なポートがファイアウォールを通して開かれないため、セキュリティが向上します。

- ロード・バランシング技術に使用可能な規格に準拠しています。

- 広範なファイアウォールとプロキシがサポートされます。

- リスナーとロード・バランシングのプロセスを管理する必要がないため、管理労力が軽減されます。

- Formsリスナー用の個別のWebサーバーSSL証明書が不要であるため、HTTPSのサポートが簡素化されます。

Oracle Forms ServerカートリッジとCGI

Formsサーブレットを使用します。Oracle Forms ServerカートリッジとCGIで使用できた機能は、Oracle Formsリリース6iパッチ・セット2から利用可能になったFormsサーブレットに組み込まれました。

Oracle Procedure Builder

ローカル側とサーバー側のPL/SQLコードを編集およびデバッグする場合は、Forms Developerの機能を使用します。Forms Developerはこのリリースで大幅に機能が向上しています。

Oracle Project Builder

アップグレード・パスまたはその代替機能はありません。

Oracle Translation Builder

TranslationHubを使用してFormsモジュール内のリソース文字列を翻訳し、モジュールを複数言語でデプロイします。

Oracle クエリー・ビルダー/Schema Builder

アップグレード・パスまたはその代替機能はありません。

Oracle Terminal

Webにデプロイされたフォームに使用されるリソース・ファイルはテキスト・ベースであるため、従来のテキスト・エディタを使用して編集できます。この結果、Oracle Terminalは不要になりました。

Open Client Adapters(OCA)

Oracle以外の広範なデータ・ソースにプラットフォームに依存せずにアクセスできるように、OCAのかわりにOracle Transparent GatewayおよびGeneric Connectivityソリューションを使用します。

Tuxedo統合

アップグレード・パスまたはその代替機能はありません。

Performance Event Collection Services(PECS)

アップグレード・パスはありません。『Oracle Fusion Middleware Forms Servicesデプロイメント・ガイド』に記載されているForms TraceおよびOracle Traceを使用します。

1.6 Forms 6iアプリケーションのアップグレード時における廃止項目タイプの扱い

Formsアプリケーションを開くと、「プロパティ・パレット」の「項目タイプ」ポップリストの後に、廃止された項目タイプのリストが表示されます。廃止された項目のプロパティ値は廃止値として示されます。たとえば、VBXのプロパティ値は「VBXコントロール(廃止)」と表示されます。

注意:
6iより前のリリースからアップグレードする場合は、10gにアップグレードしてから12cにアップグレードする必要があります。6i以降のリリースから移行する場合は、直接12cにアップグレードできます。詳細は、第16章「Forms 6iより前のアプリケーションからOracle Formsへのアップグレード」を参照してください。

第2章「Oracle Forms Migration Assistantの使用」で説明しているように、Oracle Forms Migration Assistantを使用すると、アップグレードに関する様々な問題を解決できます。

1.7 廃止機能の移行用に用意されているツール

Oracle Formsには、Forms 6iアプリケーションのアップグレードに役立つOracle Forms Migration Assistantが用意されています。詳細は、第2章「Oracle Forms Migration Assistantの使用」を参照してください。

2 Oracle Forms Migration Assistantの使用

この章は、次の項で構成されています。

- 第2.1項「Oracle Forms Migration Assistantの機能」

- 第2.2項「converter.propertiesファイルの編集」

- 第2.3項「search_replace.propertiesファイルの編集」

- 第2.4項「Oracle Forms Migration Assistantの起動」

2.1 Oracle Forms Migration Assistantの機能

Oracle Forms Migration Assistantは、PL/SQLコードの廃止された用法を更新することによって、Forms 6iアプリケーションをOracle Forms 12cにアップグレードできるようにします。このツールは、必要な変更を自動的に適用できない場合、警告を発行します。このツールには、コマンドラインとウィザード・バージョンがあります。Oracle Forms Migration Assistantでは、すべてのFormsモジュール・タイプ(オブジェクト・ライブラリとPL/SQLライブラリを含む)に次の処理が実行されます。

- 必要に応じて、次のようにPL/SQLコードを更新します。

- Reportsのコールに使用する場合に、RUN_PRODUCTをRUN_REPORT_OBJECTビルトインに更新します。

- CHANGE_ALERT_MESSAGEをSET_ALERT_PROPERTYビルトインに更新します。

- 廃止されたコードの用法をリストとして表示します。これには、アップグレードできる同等のコードがないためにツールで変更できないコードも含まれます。その場合、次のような処理も行います。

- ITEM_ENABLEDなどの廃止されたビルトインが実行時に使用されると、警告を発行します。

注意:
Oracle Forms Migration Assistantはビルトインを置換し、コードのコメント内に存在するビルトインに関する警告を発行します。

- 廃止された項目タイプがコードに含まれている場合など、廃止された機能が見つかった場合に警告を発行します。

- 不適切なレベルで定義されているトリガーについての警告を発行します。

- 単純に1対1で対応するコード文字列を置換します(たとえば、OHOSTをHOSTに、
MENU_CLEAR_FIELDをCLEAR_ITEMに、MENU_FAILUREを
FORM_FAILUREに置換します)。

- より複雑な置換を実行します(たとえば、CHANGE_ALERT_
MESSAGEをSET_ALERT_PROPERTYビルトインに、DISABLE_ITEMを
SET_MENU_ITEM_PROPERTYビルトインに、ITEM_ENABLEDをGET_
ITEM_PROPERTYビルトインに、ENABLE_ITEMをSET_MENU_ITEM_
PROPERTYビルトインに置換します)。

- V2スタイルのトリガーが
見つかった場合に、Formモジュールのログに警告を記録します。

- 廃止されたオブジェクト・タイプに関連するビルトイン(VBX.FIRE_EVENT、VBX.GET_
PROPERTY、VBX.GET_VALUE_PROPERTYなど)が見つかった場合に、Formモジュールのログに警告を記録します。

Oracle Forms Migration Assistantはバッチ・モードで実行します。必要に応じてユーティリティを再入力すると、アップグレード・プロセスをFormsアプリケーションで複数回実行できます。Migration Assistantのウィザード・バージョンを使用して、複数のモジュールをアップグレードすることもできます。

converter.propertiesファイルを編集すると、バッチ移行を開始する前にオプションを設定できます。search_replace.propertiesファイルを編集すると、Oracle Forms Migration Assistantで検索して置換する文字列を指定すると共に、廃止されたビルトインが見つかった場合に発行する警告を編集できます。

このツールではログ・ファイルが作成されるので、アプリケーション内で問題のある領域に移動して、手動で修正を加えることができます。

2.1.1 複数ログのサポート

Forms Migration Assistantでは、すべてのログ情報を1つのログ・ファイルに書き込むことも、複数のログ・ファイルにわたって書き込むこともできます。Forms Migration Assistantのログ・ファイルが複数にわたる場合、処理されるモジュールごとに個別のログ・ファイルが生成されます。

Forms Migration Assistantでログ・ファイルの書込みに使用されるディレクトリを指定する必要があります。生成されるログ・ファイルの名前はmodulename_moduletype.logです。

たとえば、test.fmbという名前のモジュールを処理する場合、ログ・ファイルの名前はtest_fmb.logになります。アップグレード対象としてtest.fmbとtest.mmbを選択しても、Formsの移行ウィザードでログ・ファイルが上書きされることはありません。ただし、2つの異なるディレクトリから2つのtest.fmbモジュールを選択して変換した場合、ログ・ファイルは上書きされます。Forms Migration Assistantでは、test_fmb.logとtest_mmb.logの2つのログ・ファイルが生成されます。

2.2 converter.propertiesファイルの編集

アップグレード・オプションを変更するには、テキスト・エディタでconverter.propertiesファイルを編集します。次のアップグレード・オプションを設定できます。

表2-1 Oracle Forms Migration Assistantのconverter.propertiesファイルのオプション

オプション

説明

Log File Name(default.logfilename)

ログ情報を格納するファイル名と場所を指定します。

Reports Queue Table Installed(default.usequeuetables)

ここで指定するキュー表は、Webベースのレポートを使用する際に、キューに格納されたレポートおよび処理されたレポートの監視に使用されます。このキュー表をOracle Forms Migration Assistantで使用すると、アプリケーション・スキーマへのインストール時に詳細なエラー・メッセージが発行されます。(たとえば、PL/SQLがコンパイルされていないためにレポートを実行できない場合、キュー表を使用して、すべてのエラー・メッセージの問合せを行うことができます。)生成されたレポートは自動的に印刷されます。Reportsのキュー表の詳細は、Reports Servicesのドキュメントを参照してください。

Reports Servlet Directory(default.servletdir)

Web上でレポートを実行するときに使用するReportsサーブレットについて、その仮想パスに対して定義されている名前を指定します。この設定は、Run_ProductコールをRun_Report_Objectに変換するときに必要です。

Reports Servlet Name(default.servletname)

Web上でレポートを実行するときに使用するReportsサーブレットの名前を指定します。この設定は、Run_ProductコールをRun_Report_Objectに変換するときに必要です。

Reports Server Host(default.reports_servername)

Reportsサーバーを実行するシステムの名前またはIPアドレス。この設定は、Run_ProductコールをRun_Report_Objectに変換するときに必要です。

DESTYPE(default.destype)

レポート出力を受信するデバイスのタイプ。詳細は、Oracle Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイドを参照してください。

DESFORMAT(default.desformat)

DESTYPEがFILEである場合に使用されるプリンタ・ドライバ。詳細は、『Oracle Fusion Middleware Reports Services Publishing Reports to the Web』を参照してください。

DESNAME(default.desname)

レポート出力の送信先であるファイル、プリンタ、電子メールIDまたは配信リストの名前。詳細は、Oracle Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイドを参照してください。

Reports Server Host(default.reportshost)

Reportsサーバーを実行するシステムの名前またはIPアドレス。この設定は、Run_ProductコールをRun_Report_Objectに変換するときに必要です。

2.3 search_replace.propertiesファイルの編集

search_replace.propertiesファイルには、Oracle Forms Migration Assistantで検索して置換する文字列が含まれます。また、警告の対象となる廃止されたビルトインのリストも含まれます。

2.3.1 検索と置換を行う文字列の追加

検索と置換を行う独自の文字列を追加するには、次の手順でこのファイルを編集します。

1. テキスト・エディタでsearch_replace.propertiesファイルを開きます。

2. 検索と置換を行う文字列のリストの末尾に移動します。

3. 次の構文を使用して、検索と置換を行う文字列を追加します。

SearchString|ReplaceString

4. search_replace.propertiesファイルを保存します。

2.3.2 廃止されたビルトインに関する警告の変更

ビルトインに関する警告には、次の構文が使用されます。

<class>.Message=<WarningMessage>
<class>.Warning1=<BuiltIn1>
<class>.Warning2=<BuiltIn2>
<class>.Warning3=<BuiltIn3>
etc.

たとえば、obsoleteMenuParamクラスの場合、警告は次のようにコーディングされます。

obsoleteMenuParam.Message=Menu Parameters are no longer supported, the parameter and usage of %s should be replaced using a Forms parameter or global variable.
obsoleteMenuParam.Warning1=MENU_PARAMETER
obsoleteMenuParam.Warning2=QUERY_PARAMETER
obsoleteMenuParam.Warning3=TERMINATE

<class>は、共通の警告を持つビルトインのグループです。<WarningMessage>には、変数文字列(%s)を1つ含めることができます。

Oracle Forms Migration Assistantでは、警告の発行が必要なビルトインが見つかった場合、その警告がログに記録され、変数文字列(%s)がビルトイン名に置換されます。

search_replace.propertiesファイルには次のクラスが含まれます。

- obsoleteItemTypeBuiltin

- obsoleteBuiltin

- obsoleteMenuParam

- obsoleteItemTypeConstantProp

- obsoleteConstantProp

- obsoleteConstant

- obsoleteHardCodedUserExit

- obsoleteComplexBuiltin

- DataParameterWithReports

- NoErrorOrWarningFromForms

既存のクラスにビルトインの警告を追加する場合、およびクラスと警告を作成する場合は、次の手順を使用します。

1. テキスト・エディタでsearch_replace.propertiesファイルを開きます。

2. 警告メッセージのリストの末尾に移動します。

3. 既存のクラスに警告を追加するか、または前述の構文を使用してクラスと警告を作成します。

4. search_replace.propertiesファイルを保存します。

注意:
search_replace.propertiesファイルの最後の2つのコマンドは削除しないでください。

2.4 Oracle Forms Migration Assistantの起動

Formsの基礎となる共通のモジュールをアップグレードして、Migration Assistantを実行する前にこれらがFORMS_PATHで使用できるようにする必要があります。FMAを使用して、次のものをこの順序でアップグレードする必要があります。

- olb

- .pll

- .mmb

- .fmb

注意:
UNIXの場合、Oracle Forms Migration Assistantを実行するにはxterm表示が必要となります。

注意:
RUN_PRODUCTをRUN_REPORT_OBJECTに変換するには、forms\rp2rro.pllファイルおよびforms\EnableDisableItem.pllファイルをFORMS_PATHに含める必要があります。
UNIXでは、FORMS_PATH変数を、
setenv FORMS_PATH $ORACLE_HOME/formsなどに設定します。

表2-2 Oracle Forms Migration Assistantのコマンドライン・パラメータ

パラメータ

説明

module(バッチ・モードでのみ必須)

アップグレードするモジュールを指定します。モジュール名パラメータに指定できる値は1つだけです。一度に複数のモジュールをアップグレードする場合の詳細は、「Forms Migration Assistantのウィザード・バージョンの実行」を参照してください。

log(オプション)

アップグレード結果を書き込むログ・ファイルを指定します。指定しない場合は、converter.propertiesファイルのデフォルト値が使用されます。

mode(オプション)

このオプションには値が2つあります(batchおよびwizard)。Migration Assistantをバッチ・モードで実行する場合はmode=batchを、ウィザードを実行する場合はmode=wizardを使用します。

アップグレード・プロセスの進捗情報が画面に表示されます。これは、converter.propertiesファイルで指定したログ・ファイルにも保存されます。(アップグレード・オプションを変更する場合は、「converter.propertiesファイルの編集」を参照してください。)

ログ・ファイルをチェックし、ツールで変更されなかった必須のアップグレード手順に関する情報を確認します。それらの変更を手動でアプリケーションに加えます。

2.4.1 バッチ・モードのMigration Assistantについて

複数のアプリケーションを変換するには、コマンドラインからバッチ・モードでForms Migration Assistantを実行します。バッチ・モードは、複数のFormsアプリケーションを変換するのに有用です。たとえば、Windowsで次の内容のバッチ・ファイル(upgrade.batなど)を作成します。

for %%f in (%1) do frmplsqlconv module=%%f userid=<connect_string>

次に、このバッチ・ファイルを次のように実行します。

upgrade *.fmb

または

upgrade foo*.mmb

UNIXでは、次の内容のシェル・スクリプト(upgrade.shなど)を作成します。

for file in $*

do

frmplsqlconv.sh module=$ff

done

次に、このシェル・スクリプトを次のように実行します。

または

upgrade.sh foo*.mmb

2.4.2 バッチ・モードでのMigration Assistantの起動

WindowsおよびUNIXコンピュータでは、バッチ・モードでMigration Assistantを実行できます。

2.4.2.1 Windowsでのバッチ・モードによるMigration Assistantの起動

コマンド・ウィンドウで、次のコマンドを発行します。

frmplsqlconv mode=batch module=<filename> log=<logname>

注意:
変換前にファイルをバックアップすることを推奨するダイアログ・ウィンドウが表示されます。この警告を今後も表示するには、「今後もメッセージを表示する」ボックスを選択します。

<filename>は、変換するファイルの名前です。<logname>は、生成するログ・ファイルの名前です。

Forms Migration Assistantは、d:\tempディレクトリでtest.fmbファイルを検索し、生成したログ・ファイルにtest.logという名前を付けてd:\tempディレクトリに配置します。ログ・ファイルには、任意の名前と場所を指定できます。デフォルトでは、ログ・ファイルはORACLE_HOME\binに書き込まれます。モジュール・パラメータに指定できる値は1つだけです。

次に例を示します。

frmplsqlconv mode=batch module=d:\temp\test.fmb log=d:\temp\test.log

変換の結果が画面に表示されます。これは、デフォルトのログ・ファイルにも保存されます。バッチ・モードでは、すべてのコンバータ・オプションがconverter.propertiesファイルから取り込まれることに注意してください。コンバータ・オプションを変更する場合は、「converter.propertiesファイルの編集」を参照してください。

2.4.2.2 UNIXでのバッチ・モードによるMigration Assistantの起動

UNIXシェルで、次のコマンドを発行します。

frmplsqlconv.sh mode=batch module=<filename> log=<logname>

変換の結果が画面に表示されます。これは、デフォルトのログ・ファイルにも保存されます。バッチ・モードでは、すべてのコンバータ・オプションがconverter.propertiesファイルから取り込まれることに注意してください。コンバータ・オプションを変更する場合は、「converter.propertiesファイルの編集」を参照してください。

2.4.3 Forms Migration Assistantのウィザード・バージョンの実行

Forms Migration Assistantのウィザード・バージョンを実行して、コンバータ・オプションを編集できます。

2.4.3.1 Forms Migration Assistantのウィザード・バージョンの起動

この項では、WindowsおよびUNIXコンピュータでForms Migration Assistantを起動する方法を説明します。

1. Windowsコンピュータでは、次のようにFORMS_PATH環境変数を設定します。
SET FORMS_PATH=%ORACLE_HOME%\forms

UNIXコンピュータでは、次の例のようにFORMS_PATH変数を設定します。

setenv FORMS_PATH $ORACLE_HOME/forms

2. Windowsコンピュータでは、「スタート」メニューから「ORACLE_HOME」→「Forms Developer」→「Oracle Forms Migration Assistant(GUI Mode)」を選択するか、コマンドラインでfrmplsqlconv.bat mode=wizardと入力して変換ユーティリティを起動します。
UNIXでは、frmplsqlconv.sh mode=wizardと入力します。

変換ウィザードの「ようこそ」ダイアログが表示されます。

注意:
コマンドの後に-hを入力すると(例: frmplsqlconv -h)、ヘルプが表示されます。

3. 「次へ」をクリックします。

4. 「モジュール」ダイアログで、「モジュールの追加」ボタンをクリックします。

5. 変換するモジュールを選択します。

6. 「次へ」をクリックします。

7. 「Options」ダイアログで、生成するログ・ファイルの場所と名前を入力します。場所の選択には参照ボタンを使用できます。

8. レポートが埋め込まれているFormsの場合、残りのフィールドを入力します。それ以外の場合、残りのフィールドは無視してかまいません。

9. レポートの各フィールドの詳細は、Oracle Fusion Middleware Oracle Reports ServicesレポートWeb公開ガイドを参照してください。コンバータの拡張オプションの詳細は、「コンバータの拡張オプションの設定」を参照してください。

10. 「次へ」をクリックします。

11. 「終了」ダイアログに、選択したモジュールのリストが表示されます。「終了」をクリックして、変換を開始します。

12. 「ログ」ウィンドウに進捗状況が表示されます。(ログ出力は、「オプション」ダイアログで指定するログ・ファイル名で保存されます。オプションの設定については、後続の項を参照してください。)

13. ログ・ファイルをチェックし、ツールで変更されなかった必須の変換手順に関する情報を確認します。それらの変更を手動でアプリケーションに加えます。

2.4.3.2 コンバータの拡張オプションの設定

注意:
converter.propertiesファイルの設定については、「converter.propertiesファイルの編集」を参照してください。

ウィザードを実行する前に、次の手順で変換オプションを設定できます。

1. 「Options」ダイアログ(ウィザードの手順2)で、「拡張オプション」をクリックします。

2. ダイアログの左の列にコンバータ・プロパティが表示されます。表2-3「コンバータ・プロパティ」の説明に従って、プロパティ値を必要に応じて編集します。

表2-3 コンバータ・プロパティ

プロパティ値

説明

バックアップ警告の表示

アプリケーションの起動時にファイルをバックアップするための警告ダイアログを表示するかどうかを指定します。

ログ・ファイル名

単一ログ・モードでのログ・ファイル名を指定します。

ログ・ディレクトリ

複数ログモードでのログ・ファイルの書込み先となるディレクトリ。

Reportsサーブレット仮想ディレクトリ

Reports Servletを定義する仮想パスに対して定義されている名前を指定します。Web上でのレポートの実行に使用されます。この設定は、Run_ProductコールをRun_Report_Objectに変換するときに必要です。

Reportsサーブレット

Web上でレポートを実行するときに使用するReportsサーブレットの名前を指定します。この設定は、Run_ProductコールをRun_Report_Objectに変換するときに必要です。

Reportsサーバー

Reportsサーバーを実行するシステムの名前またはIPアドレス。この設定は、Run_ProductコールをRun_Report_Objectに変換するときに必要です。

Default DESFORMAT

DESTYPEがPRINTERである場合に使用されるプリンタ・ドライバ(XML、HTML、HTMLCSS、PDF、RTF、デリミタ付き)。

Default DESTYPE

レポート出力を受信するデバイスのタイプ(キャッシュ、プリンタ、ファイル)。

Default DESNAME

レポート出力の送信先であるファイル、プリンタ、電子メールID、または配信リストの名前。

Default Browser

UNIXの場合は、Migration Assistantのヘルプの表示に使用するブラウザ。設定値は、firefox、iexplorer、chromeのいずれかです。Windowsの場合は、システムのデフォルト・ブラウザが使用されます。

3. 「OK」をクリックして構成を保存します。データがconverter.propertiesファイルに保存され、指定した設定が現行および今後のユーティリティ・セッションに使用されます。

3 Forms 6i FMTのOracle Forms FMBへの変換

一部のプロパティはOracle Formsで廃止されているため、Forms Developerを使用してForms 6i FMTとMMTを直接Oracle Forms FMBとMMBに変換できません。

3.1 Forms 6i FMTのOracle Forms FMBへの変換

Forms 6i FMTまたはMMTをOracle Forms 12c FMBまたはMMBに変換する手順は、次のとおりです。

1. Forms 6i BuilderまたはCompilerを使用して、Forms 6i FMTまたはMMTをForms 6i FMBまたはMMBに変換します。

2. 次に、Forms Developerを使用して、Forms 6i FMBまたはMMBをOracle Forms FMBまたはMMBに変換します。Forms 6iのソース・ファイルをOracle Forms Builderで開き、それらを保存してから再コンパイルするか、Oracle Forms Compilerを使用します。

4 ビルトイン、パッケージ、定数、構文

使用可能なツールを合理化し、Web用のFormsアプリケーションを構築する開発プロセスを簡素化するために、Webデプロイに適用できないビルトイン、定数、パッケージおよび構文が削除されています。

この章は、次の項で構成されています。

- 第4.1項「廃止されたメニュー・ビルトイン」

- 第4.2項「廃止されたその他のビルトイン」

- 第4.3項「廃止されたビルトイン・パッケージ」

- 第4.4項「廃止された定数」

- 第4.5項「廃止された構文」

4.1 廃止されたメニュー・ビルトイン

全画面表示とキャラクタ・モードに関連付けられているメニューは削除されています。これらのビルトインを含むコードはコンパイルされないため再コーディングが必要ですが、例外もあるので次の表に示します。また、廃止されたビルトインと同等のビルトインもこの表に示します。

表4-1 廃止されたメニュー・ビルトイン

廃止されたメニュー・ビルトイン

アップグレードの注意点

Application_Menu

アップグレード・パスまたはその代替機能はありません。

Application_Parameter

アップグレード・パスまたはその代替機能はありません。第12章「メニュー・パラメータ」を参照してください。

Background_Menu<n>

アップグレード・パスまたはその代替機能はありません。

Debug_Mode

アップグレード・パスまたはその代替機能はありません。このビルトインを含むコードはコンパイルされますが、機能しません。

Disable_Item

SET_MENU_ITEM_PROPERTY()を使用します。

Enable_Item

SET_MENU_ITEM_PROPERTY()を使用します。

Exit_Menu

アップグレード・パスまたはその代替機能はありません。

Hide_Menu

アップグレード・パスまたはその代替機能はありません。

Item_Enabled

GET_MENU_ITEM_PROPERTY(<name>, ENABLED)を使用します。Item_EnabledはOracle Formsで動作しますが、今後のリリースでは削除される予定です。

Main_Menu

アップグレード・パスまたはその代替機能はありません。

Menu_Clear_Field

CLEAR_ITEMを使用します。

Menu_Failure

FORM_FAILUREフラグを使用します。

Menu_Help

アップグレード・パスまたはその代替機能はありません。

Menu_Message

MESSAGEを使用します。

Menu_Next_Field

NEXT_ITEMを使用します。

Menu_Parameter

アップグレード・パスまたはその代替機能はありません。第12章「メニュー・パラメータ」を参照してください。

Menu_Previous_Field

PREVIOUS_ITEMを使用します。

Menu_Redisplay

アップグレード・パスまたはその代替機能はありません。

Menu_Show_Keys

SHOW_KEYSを使用します。この変更はアップグレード・プロセスで自動的に適用されます。

Menu_Success

FORM_SUCCESSフラグを使用します。

New_Application

アップグレード・パスまたはその代替機能はありません。

New_User

LOGOUTおよびLOGONを使用します。

Next_Menu_Item

アップグレード・パスまたはその代替機能はありません。

OS_Command

HOSTを使用します。

OS_Command1

HOSTを使用します。

Previous_Menu

アップグレード・パスまたはその代替機能はありません。

Previous_Menu_Item

アップグレード・パスまたはその代替機能はありません。

Query_Parameter

アップグレード・パスまたはその代替機能はありません。第12章「メニュー・パラメータ」を参照してください。

Set_Input_Focus

アップグレード・パスまたはその代替機能はありません。

Show_Background_Menu

アップグレード・パスまたはその代替機能はありません。

Show_Menu

アップグレード・パスまたはその代替機能はありません。

Terminate

アップグレード・パスまたはその代替機能はありません。第12章「メニュー・パラメータ」を参照してください。

Where_Display

アップグレード・パスまたはその代替機能はありません。

4.2 廃止されたその他のビルトイン

削除されたビルトインは次の表のとおりです。これらのビルトインを含むコードはコンパイルされないため再コーディングが必要ですが、例外もあるので次の表に示します。また、廃止されたビルトインと同等のビルトインもこの表に示します。

表4-2 廃止されたその他のビルトイン

廃止されたビルトイン

アップグレードの注意点

BLOCK_MENU

アップグレード・パスまたはその代替機能はありません。

BREAK

DEBUG.SUSPENDにアップグレードします。

CALL

CALL_FORMを使用します。

CHANGE_ALERT_MESSAGE

SET_ALERT_PROPERTY(..., ALERT_MESSAGE_TEXT,...);を使用します。

DISPATCH_EVENT

OLEアイテムとOCXアイテムにのみ適用されます。したがって、アップグレード・パスまたはその代替機能はありません。

(FORMS_OLE.)ACTIVATE_SERVER

(FORMS_OLE.)CLOSE_SERVER

(FORMS_OLE.)EXEC_VERB

(FORMS_OLE.)FIND_OLE_VERB

(FORMS_OLE.)GET_INTERFACE_POINTER

(FORMS_OLE.)GET_VERB_COUNT

(FORMS_OLE.)GET_VERB_NAME

(FORMS_OLE.)INITIALIZE_CONTAINER

(FORMS_OLE.)SERVER_ACTIVE

アップグレード・パスまたはその代替機能はありません。

MACRO

アップグレード・パスまたはその代替機能はありません。

OHOST

HOSTを使用します。

PLAY_SOUND

アップグレード・パスまたはその代替機能はありません。

READ_SOUND_FILE

アップグレード・パスまたはその代替機能はありません。

ROLLBACK_FORM

CLEAR_FORM(NO_COMMIT,FULL_ROLLBACK)

ROLLBACK_NR

CLEAR_FORM(NO_COMMIT,FULL_ROLLBACK)

ROLLBACK_RL

CLEAR_FORM(NO_COMMIT,FULL_ROLLBACK)

ROLLBACK_SV

CLEAR_FORM(NO_COMMIT,FULL_ROLLBACK)

RUN_PRODUCT

Oracle Graphicsとの統合においてのみ有効です。Oracle Reportsとの統合にはRUN_REPORT_OBJECTを使用します。それ以外の用途の場合、コードはコンパイルされますが、ランタイム・エラーが発生します。

UPDATE_CHART

アップグレード・パスまたはその代替機能はありません。

VBX.FIRE_EVENT

VBX.GET_PROPERTY

VBX.GET_VALUE_PROPERTY

VBX.INVOKE_METHOD

VBX.SET_PROPERTY

VBX.SET_VALUE_PROPERTY

アップグレード・パスまたはその代替機能はありません。

WRITE_SOUND_FILE

アップグレード・パスまたはその代替機能はありません。

4.3 廃止されたビルトイン・パッケージ

削除されたビルトイン・パッケージは次の表のとおりです。これらのパッケージを含むコードはコンパイルされないため再コーディングが必要ですが、例外もあるので次の表に示します。また、廃止されたパッケージと同等のパッケージもこの表に示します。

表4-3 廃止されたビルトイン・パッケージ

廃止されたパッケージ

アップグレードの注意点

DEBUG

新規のデバッガがあるため、アップグレード・パスも代替機能もありません。DEBUG.ATTACHおよびDEBUG.SUSPENDは引き続きサポートされます。

PECS

アップグレード・パスはありません。『Oracle Fusion Middleware Forms Servicesデプロイメント・ガイド』に記載されているForms TraceおよびOracle Traceを使用します。

4.4 廃止された定数

GET_ITEM_PROPERTYビルトインおよびSET_ITEM_PROPERTYビルトインに使用されていた次の定数が削除されています。これらの定数を含むコードはコンパイルされないため再コーディングが必要ですが、例外もあるので次の表に示します。

表4-4 廃止された定数

廃止された定数

アップグレードの注意点

DATE_FORMAT_COMPATIBILITYモード

GET_APPLICATIONプロパティおよびSET_APPLICATIONプロパティで使用されていました。この定数は無視されます。

COMPRESSION_OFF

COMPRESSION_ON

HIGHEST_SOUND_QUALITY

HIGH_SOUND_QUALITY

LOW_SOUND_QUALITY

LOWEST_SOUND_QUALITY

MEDIUM_SOUND_QUALITY

MONOPHONIC

ORIGINAL_QUALITY

ORIGINAL_SETTING

アップグレード・パスまたはその代替機能はありません。

POPUPMENU_CUT_ITEM

POPUPMENU_COPY_ITEM

POPUPMENU_DELOBJ_ITEM

POPUPMENU_INSOBJ_ITEM

POPUPMENU_LINKS_ITEM

POPUPMENU_OBJECT_ITEM

POPUPMENU_PASTE_ITEM

POPUPMENU_PASTESPEC_ITEM

SHOW_FAST_FORWARD_BUTTON

SHOW_PLAY_BUTTON

SHOW_POPUPMENU

アップグレード・パスまたはその代替機能はありません。

SHOW_RECORD_BUTTON

SHOW_REWIND_BUTTON

SHOW_SLIDER

SHOW_TIME_INDICATOR

SHOW_VOLUME_CONTROL

STEREOPHONIC

アップグレード・パスまたはその代替機能はありません。

4.5 廃止された構文

NAME_IN()と同等の機能であるアンパサンド(&)の使用は廃止されました。

5 トリガー

使用可能なツールを合理化し、Web用のFormsアプリケーションを構築する開発プロセスを簡素化するために、Webデプロイに適用できないトリガーが削除されています。また、一部のトリガーの機能がより厳しく制限されるようになりました。

5.1 廃止されたトリガー

表5-1 廃止されたトリガー

廃止されたトリガー

アップグレードの注意点

ON-DISPATCH-EVENT

OLEアイテムとOCXアイテムにのみ適用されます。したがって、アップグレード・パスまたはその代替機能はありません。

すべてのV2スタイルのトリガー

V2スタイルのトリガーを含むFMBを開くと、それらのトリガーが削除され、削除されたトリガーの名前を示す警告メッセージが表示されます。このリリースにアップグレードする前に、Forms 6iでV2スタイルのトリガーをPL/SQLに再コーディングする必要があります。

When-Mouse-Move、When-Mouse-Enter、When-Mouse-Leaveトリガー

これらのトリガーは、ネットワーク・トラフィックの量が多くなる可能性があるため、Web上での実行時には無視されます。

5.2 トリガーの適用ルールの厳格化

次のトリガーの使用は、従来より厳しく制限されます。これらのトリガーは、使用方法が正しくないと実行されません。

表5-2 使用制限のあるトリガー

トリガー

制限された使用方法

WHEN-CLEAR-BLOCK

WHEN-CREATE-RECORD

WHEN-DATABASE-RECORD

WHEN-NEW-RECORD-INSTANCE

WHEN-REMOVE-RECORD

ブロック・レベルとフォーム・レベルでのみ使用可能です。項目レベルでは使用できなくなりました。

WHEN-NEW-FORM-INSTANCE

フォーム・レベルでのみ使用可能です。ブロック・レベルと項目レベルでは使用できなくなりました。

6 プロパティ

使用可能なツールを合理化し、Web用のFormsアプリケーションを構築する開発プロセスを簡素化するために、Webデプロイに適用できないプロパティが削除されています。

6.1 廃止されたプロパティ

キャラクタ・モードとメニューに関連付けられたプロパティなど、多数のプロパティが削除されています。これらのプロパティを含むフォームを開くと、プロパティは無視され、Oracle Formsには表示されません。注意事項に記載されているものを除き、ランタイムにこれらのプロパティを使用しようとするコードはエラーになります。詳細は、表6-1「廃止されたプロパティ」を参照してください。

表6-1 廃止されたプロパティ

廃止されたプロパティ

適用

アップグレードの注意点

文字モードの論理属性

項目、キャンバスなど

コマンド・タイプ

メニュー項目

注意: このプロパティは部分的に廃止されています。有効な値は、Null、PL/SQLおよびMenuだけです。

無効になったPlus、FormまたはMacroをメニュー・モジュールに使用している場合、これらの値は「コマンド・テキスト」プロパティの次のPL/SQLコードに置換されます。

Plus: /* HOST('sqlplus <old_code>'); */ null;

Form: /* CALL_FORM(<old_code>); */ null;

Macro: /* MACRO: <old_code> ; */ null;

<old_code>は、アップグレード前の「コマンド・テキスト」プロパティの値です。元のコードを新しいPL/SQLコードに置換できるように、置き換えるPL/SQLコードにはコメントが付いています。

データ・ブロックの記述

ブロック

固定長

項目

フォーマット・マスクを該当する数のプレースホルダと共に使用して、項目に入力するデータの長さを制限または制御します。

ヘルプの説明

メニュー項目

データ・ブロック・メニューにリスト済

ブロック

リスト・タイプ

値リスト

すべての値リストがレコード・グループに基づくようになったため、このプロパティは廃止されました。

メニュー・ソース

フォーム

値「データベース」は無効になりました。

このプロパティの有効な値は「ファイル」のみです。したがって、ランタイムにFormsではMMXファイルを探すために標準の検索パスが使用されます。

ランタイム互換性モード

フォーム

ランタイムに無視されます。常に5.0の動作が適用されます (ランタイム動作については、Forms Developerのオンライン・ヘルプを参照してください)。

NULL項目に対してWHEN-VALIDATE-ITEMを実行できるようにするには、DEFER_REQUIRED_ENFORCEMENTプロパティに4.5を指定します。

(Formsアプリケーションで「ランタイム互換性モード」プロパティが4.5に設定されている場合、Oracle Forms Migration Assistantは「必須の実施を遅延」プロパティを自動的に4.5に設定します。)

トリガー・スタイル

トリガー

すべてのトリガーがPL/SQLトリガーになりました。

白黒

項目、キャンバスなど

7 クライアント/サーバー・デプロイとFormsランタイムに対する変更

この項は、次のトピックで構成されています。

- 第7.1項「概要」

- 第7.2項「Formsデプロイへの影響」

- 第7.3項「廃止されたFormsランタイムのコマンドライン・オプション」

- 第7.4項「廃止されたキャラクタ・モード・ランタイム」

7.1 概要

Forms DeveloperおよびForms Servicesでクライアント/サーバー・ランタイムが廃止されました。

Forms Developerを使用している場合は、アップグレード・プロセスの一環として、FormsアプリケーションをWebベースのデプロイ用にアップグレードします。

クライアント/サーバー・デプロイとWebベース・デプロイの違いについては、第15章「Webへのクライアント/サーバー・アプリケーションのアップグレード」を参照してください。

7.2 Formsデプロイへの影響

クライアント/サーバー・デプロイは廃退傾向にありますが、それによるFormsアプリケーションのデプロイとデバッグへの影響は、ほとんどありません。コードは、あらかじめWebにデプロイしなくても、引き続きForms Developerで実行できます。one-button-run*機能を使用すると、WebにデプロイされたフォームがTrue WYSIWYGで表示されます。

PL/SQLデバッガが機能拡張され、3層環境でのデバッグが可能になりました。

*One-button RunはForms Builderのみ以外のインストールでのみ使用できます。

7.3 廃止されたFormsランタイムのコマンドライン・オプション

Runformの次のコマンドライン・オプションは、廃止された機能に関連しているため、削除されました。

- OptimizeSQL

- OptimizeTP

- Keyin

- Keyout

- Output_file

- インタラクティブ

- Block_menu

- 統計

7.4 廃止されたキャラクタ・モード・ランタイム

UNIXプラットフォームおよびVMSプラットフォームでのみ使用できたキャラクタ・モード・ランタイムは使用できなくなりました。キャラクタ・モードのすべてのサポートがForms DeveloperおよびForms Servicesから削除されました。詳細は、第6章「プロパティ」および第9章「論理属性とGUI属性」を参照してください。

8 項目タイプ

使用可能なツールを合理化し、Web用のFormsアプリケーションを構築する開発プロセスを簡素化するために、Webデプロイに適用できない項目タイプが削除されています。

8.1 廃止された項目タイプ

次の項目タイプがForms DeveloperとForms Servicesで廃止されています。

表8-1 廃止された項目タイプ

項目タイプ

アップグレードの注意点

チャート項目

アップグレード・パスまたはその代替機能はありません。

8.2 オペレーティング・システム固有の項目タイプ

オペレーティング・システム固有の次の項目タイプは、Forms DeveloperとForms Servicesで廃止されています。これらの項目は、アップグレード・プロセスでは削除されません。ただし、これらの項目を含むモジュールはコンパイルされません。同等の機能を提供するJavaBeansおよびプラガブルJavaコンポーネントを使用します。

表8-2 廃止されたオペレーティング・システム固有の項目タイプ

項目タイプ

アップグレードの注意点

VBX

16ビットのWindowsプラットフォームにのみ適用されていました。アップグレード・パスまたはその代替機能はありません。

OLEコンテナ

Windowsプラットフォームにのみ適用されていました。プログラム的なOLE相互作用が中間層の外部OLEサーバーでサポートされています。

OCX/ActiveXコントロール

Windowsプラットフォームにのみ適用されていました。JavaBeanのサポートにより、類似機能が提供されます。

サウンド

アップグレード・パスはありません。JavaBeansで同等の機能が提供されます。

9 論理属性とGUI属性

使用可能なツールを合理化し、Web用のFormsアプリケーションを構築する開発プロセスを簡素化するために、Webデプロイに適用できない論理属性とGUI属性が削除されています。

9.1 論理属性とGUI属性にかわる可視属性の使用

Webにデプロイされるフォームには、論理属性とGUI属性のかわりに可視属性を使用して、動的項目の外観を定義できます。

9.2 廃止された論理属性とGUI属性

SET_ITEM_PROPERTY、SET_FIELDまたはDISPLAY_ITEMに含まれる次の論理属性とGUI属性は廃止されました。これらの属性への参照は、対応する可視属性に置換されます。

表9-1 廃止された論理属性とGUI属性

廃止された属性

使用場所およびアップグレードの注意点

アラート

警告テキスト

AlertBackground

警告の背景

AlertIcon

警告ウィンドウのアイコン

AlertMessage

警告ウィンドウのメッセージ・テキスト

Boilerplate

定数テキスト

Bold

すべての項目(チェック・ボックスを含む)を太字にします。

Bold-inverse

すべての項目の太字を解除します。

Bold-text

定型挿入文

Button-current

現在のボタン

Button-non-current

現在のボタン以外のボタン

Field-current

現在のテキスト項目の色

Field-non-current

現在選択されていないテキスト項目の色

Field-Queryable

問合せ入力モードでの問合せ可能フィールド

Field-selected-current

現在選択されているテキスト項目

Field-selected-non-current

現在選択されていないテキスト項目

Full-screen-title

画面のタイトル

ItemQueryDisabled

ブロックが問合せ入力モードになると、問合せ可能項目以外の項目がこの属性セットを継承します。

ListItemNonSelect

テキスト・リストで選択されていない項目

ListItemSelect

テキスト・リストで選択されている項目

ListPrefix

リストの接頭辞

Listtitle

値リスト(LOV)のタイトル

Menu

選択されているメニュー

Menu-bottom-title

メニューの下に表示される現在のタイトル

MenuItemDisabled

無効なメニュー項目

MenuItemDisableMnemonic

無効なメニュー項目のニーモニック

MenuItemEnable

現在のメニュー項目ではない有効なメニュー項目

MenuItemEnableMnemonic

有効なメニュー項目のニーモニック

MenuItemSelect

現在のメニュー項目

MenuItemSelectMnemonic

現在のメニュー項目のニーモニック

Menu-subtitle

現在のメニューのサブタイトル

Menu-title

現在のメニューのタイトル

Normal

テキスト項目

NormalAttribute

ウィンドウの通常の背景

PushButtonDefault

デフォルト・ボタンまたは現在のボタン

PushButtonNonDefault

デフォルト・ボタンではないボタン

Scroll-bar-fill、Inverse、Inverse-underline、Bold-underline、Bold-inverse-underline

これらの論理属性はForms Developer固有のものではありません。このため、これらの属性はウィンドウ・マネージャで定義される可視属性によって上書きされる可能性があります。

ScrollThumb

スクロールバーのエレベータ・ボックス

Status-Empty

空白のステータス行の外観を制御します。

Status-Hint

ステータス行に表示される項目のヒントのフォントを制御します。

Status-Items

LOVランプやレコード・カウントなどを含むオペレータ情報領域の外観を制御します。

Status-Message

ステータス行に表示されるメッセージのフォントを制御します。

Sub-menu

選択されているサブメニュー

TextControlCurrent

現在のフィールドまたはテキスト・エディタ

TextControlFailValidation

項目が妥当性チェックに合格しなかった場合に、この属性セットが設定されます。

TextControlNonCurrent

無効な、または現在以外のフィールドまたはテキスト・エディタ

TextControlSelect

有効なフィールドまたはテキスト・エディタで選択されているテキスト

ToolkitCurrent

一般属性

ToolkitCurrentMnemonic

一般属性

ToolkitDisabled

一般属性

ToolkitDisabledMnemonic

一般属性

ToolkitEnabled

一般属性

ToolkitEnabledMnemonic

一般属性

Underline

すべての項目に下線を付けます。

WindowTitleCurrent

アクティブ・ウィンドウのタイトル

10 値リスト(LOV)

使用可能なツールを合理化し、Web用のFormsアプリケーションを構築する開発プロセスを簡素化するために、Webデプロイに適用できない値リスト(LOV)が削除されています。

10.1 廃止された値リスト(LOV)

レコード・グループに基づいた値リストは引き続き有効です。ただし、古いスタイルの値リスト(V2.3スタイルの値リスト)はOracle Formsで廃止されています。

古いスタイルの値リストを含むフォームをForms Developerにアップグレードする場合、表と列(EMP.ENAMEなど)を参照する古いスタイルの値リストの「古い値リスト・テキスト」プロパティは、問合せに基づくレコード・グループを作成することにより、新しいスタイルの値リストに変換されます(<table>から<column>を選択)。新しいスタイルの値リストは、新しいレコード・グループに基づきます。

11 ユーザー・イグジット

古いスタイル(V2)のトリガーが削除されたため、V2のユーザー・イグジットも削除されました。

11.1 廃止されたV2のユーザー・イグジット

V2トリガー機能へのハードコーディングされたコールバックである次のユーザー・イグジットは、削除されています。このため、削除されたユーザー・イグジットをコールした場合、組込みのユーザー・イグジットではなく、ユーザー定義のユーザー・イグジットをコールしていると想定されます。

PL/SQLに対する次のコールバックを使用するコードは、いずれも再コーディングする必要があります。

- COPY

- ERASE

- HOST

- EXEMACRO

- EZ_GOREC

- EZ_CHKREC

12 メニュー・パラメータ

使用可能なツールを合理化し、FormsアプリケーションをWeb用に構築するための開発プロセスを簡素化するために、Webデプロイに適用できないメニュー・パラメータが削除されています。

Oracle Formsにアップグレードする際に、すべてのメニュー・パラメータがアプリケーションから削除されます。

12.1 事前定義済のメニュー・パラメータ

事前定義されているメニュー・パラメータには、UNやPWなどの名前が付いています。これらのメニュー・パラメータを使用すると、:UNや:PWなど、メニュー項目に添付されているPL/SQLコードのバインド変数を参照できました。

以前のバージョンのFormsからアップグレードする際は、次の表の廃止された事前定義済メニュー・パラメータのかわりに、推奨されるビルトインを使用してください。

表12-1 廃止された事前定義済メニュー・パラメータ

廃止されたパラメータ

推奨されるビルトイン

:UN

GET_APPLICATION_PROPERTY(USERNAME)

:PW

GET_APPLICATION_PROPERTY(PASSWORD)

:LN

GET_APPLICATION_PROPERTY(USER_NLS_LANG)

:AD

GET_FORM_PROPERTY(NAME_IN('SYSTEM.CURRENT_FORM'),FILE_NAME)

:SO

:SYSTEM.TRIGGER_MENUOPTION

:TT

キャラクタ・モード環境にのみ関連します。このパラメータの代替はありません。

12.2 ユーザー定義のメニュー・パラメータ

ユーザー定義のメニュー・パラメータは、Oracle Formsで廃止されています。MENU_PARAMETERビルトインまたはAPPLICATION_PARAMETERビルトインをコールするメニュー項目では、メニュー・パラメータの値を定義できました。

実行時に、カスタマイズ不可能な「問合せパラメータ」ダイアログ・ボックスを使用すれば、メニュー項目の検査または変更が可能でした。「問合せパラメータ」ダイアログ・ボックスに関連付けられているビルトイン(TERMINATEなど)も廃止されています。詳細は、第4章「ビルトイン、パッケージ、定数、構文」を参照してください。

したがって、廃止されたユーザー定義のパラメータを置き換えるために、これらを手動でグローバル変数(:GLOBAL)として再定義します。パラメータの初期値プロパティをエミュレートするには、メニュー起動コードで代替のグローバル変数を初期化します。

MENU_PARAMETERビルトインを使用してポップアップ表示するダイアログ・ボックスなどの機能については、代替機能はありません。ただし、Formsを使用してダイアログを作成すれば、この機能をエミュレートできます。

13 Java関連の問題

この章では、FormsアプリケーションでJava関連のコンポーネントを使用している場合のアップグレード手順について説明します。

13.1 Javaプラグ可能コンポーネントおよびその他のカスタムJavaの使用

プラガブルJavaコンポーネント(PJC)およびJavaBeansでは、oracle.ewtフレームワークの一部であるクラスが使用されます。Swingクラスまたはoracle.ewtクラスを使用するために、Oracleが提供するサンプルのPJCとJavaBeansが再コーディングされます。Oracle Formsにアップグレードするときは、同等の機能を確保するために実行する必要がある手順があります。

- Oracle Forms Jarファイル(frmall.jar)には、Forms Javaクライアントに必要なEWTクラスのみが含まれています。したがって、Forms 6iで使用できたクラスが見つからないため、Forms 6iで使用されていたPJCは、Oracle Formsでの実行時に動作しない可能性があります。見つからないoracle.ewtクラスは、Oracle JDeveloperで提供されるewt.jarで使用可能になっています。

- すべてのクライアント側Java Jarファイルには、信頼できる証明書で署名する必要があります。これには、カスタムPJC、Java Beansまたはその他のユーザー提供のカスタム・リソース(イメージ、オーディオ、ライブラリなど)用に作成されたJarが含まれますが、これに限定されません。

13.2 JDKのバージョンとフォントのレンダリングに関する問題

FormsアプリケーションをJDK 1.1からJDK 1.3以降にアップグレードする場合、フォントの高さが変更されることがあります。これは、フォントをレンダリングするコードがJDK 1.1からJDK 1.3への移行で大幅に変更されているためです。これらの変更の結果、同じサイズの論理フォントの高さがJDK 1.3では大きくなっています。たとえば、サイズが12ポイントのダイアログ・フォントの高さは、JDK 1.1では15ポイントですが、JDK 1.3では17ポイントになります。

Formsアプリケーションでは、フォント・サイズの変更がラベルに影響して、テキスト・フィールドでオーバーラップする可能性があります。対応策の1つとして、次のアプレット・パラメータを"yes"に設定する方法があります。

<PARAM NAME = "mapFonts" VALUE = "yes" >

この変更を行った後で、フォント・サイズの表示をチェックして、適切であるかどうかを確認します。この対応策で適切なフォント・サイズにならなかった場合は、フォームを修正します。詳細は、『Oracle Fusion Middleware Forms Servicesデプロイメント・ガイド』を参照してください。

別の対応策として、フォントが指定されていない場合に、Registry.datのデフォルトのフォント名とサイズを使用する方法があります。registry.datのデフォルトのフォントは、サイズが900のDialogです。このフォントのサイズは、registry.datファイルでさらに小さい値に修正できます。フォントが指定されていない場合は、フォームを修正せずに問題に対処できます。ただし、この方法を使用するとアプリケーション全体のフォント・サイズが変更されるため、注意が必要です。

14 Oracle Reportsとの統合

この章は、次の項で構成されています。

- 第14.1項「概要」

- 第14.2項「Oracle Reportsとの統合について」

14.1 概要

バージョン9.0.2以降のOracle Formsには、Oracle Graphics6iが付属しなくなりました。また、チャート・ウィザードもFormsから削除されています。12c以降は、Graphicsのランタイム統合も削除されています。この章では、既存のReportsアプリケーションをフォームからコールする方法を説明します。

14.2 Oracle Reportsとの統合について

Oracle Forms 12cにアップグレードされたフォームに新規および既存のReportsアプリケーションを埋め込むことができます。

Reportsクライアントのランタイム・エンジンを使用してReportsをWebに出力できなくなりました。Forms 5.0以降は、統合されたレポート機能を実行するために、RUN_REPORT_OBJECTビルトインがForms Developerに用意されています。統合されたOracle ReportsをOracle FormsのRUN_PRODUCTを使用して実行する方法は、このリリースではサポートされません。12cでは、このビルトインを使用するとコンパイル・エラーが発生します。

バージョン9.0.2以降のOracle FormsおよびOracle ReportsはWebベース専用になったため、クライアント/サーバーのランタイム・エンジンは提供されません。したがって、Oracle Formsアプリケーションの統合レポートは、RUN_REPORT_OBJECTビルトインおよびOracle Fusion Middleware Reports Servicesを使用するように再コーディングする必要があります。

Oracle FormsとOracle Reportsの統合の詳細は、Oracle Technology Network (http://www.oracle.com/technetwork/developer-tools/forms)でOracleAS FormsとOracleAS Reportsの統合を参照してください。

14.2.1 Oracle FormsでのReportsの表示

フォームにOracle Reportsアプリケーションが埋め込まれている場合、そのフォームをOracle Formsにアップグレードするには、Oracle Reportsへの統合されたコールを、次のビルトインを使用するように変更します。

- RUN_REPORT_OBJECTビルトイン(RUN_PRODUCTビルトインを使用してReportsをコールしないでください)

- WEB.SHOW_DOCUMENTビルトイン

統合されたOracle ReportsをOracle FormsのRUN_PRODUCTを使用して実行する方法は、このリリースではサポートされません。12cでは、このビルトインを使用するとコンパイル・エラーが発生します。RUN_REPORT_OBJECTを使用するようにアプリケーションをアップグレードするためのツールとして、Migration Assistantが提供されています。詳細は、第2章「Oracle Forms Migration Assistantの使用」を参照してください。

14.2.2 例

次の例では、RUN_REPORT_OBJECTビルトインを使用してレポートを実行します。ここでは、Oracle Formsに定義されているreport_objectノードを"report_node1"と仮定します。ユーザー定義のReportsパラメータ"p_deptno"が、"dept.deptno"フィールドの値を使用してFormsから渡されます。Reportsパラメータ・フォームは抑止されます。この例で使用されているロジックの詳細は、「例の説明」を参照してください。

/* The following example runs a report using the RUN_REPORT_OBJECT Built-in. The
report_object node defined in Forms Developer is assumed to be "report_node1". A
user-defined Reports parameter "p_deptno" is passed by Forms using the value in
the "dept.deptno" field. The Reports parameter form is suppressed */

DECLARE
v_report_id              Report_Object;
vc_report_job_id                  VARCHAR2(100);  /* unique id for each Report      request */
vc_rep_status                    VARCHAR2(100);           /* status of the Report job */

BEGIN
/* Get a handle to the Report Object itself. */
v_report_id:= FIND_REPORT_OBJECT('report_node1');
SET_REPORT_OBJECT_PROPERTY(v_report_id,REPORT_COMM_MODE, SYNCHRONOUS);
SET_REPORT_OBJECT_PROPERTY(v_report_id,REPORT_DESTYPE,CACHE);

/* Define the Report output format and the name of the Reports Server as well as
a user-defined parameter, passing the department number from Forms to the Report.
The Reports parameter form is suppressed by setting  paramform  to "no". */
SET_REPORT_OBJECT_PROPERTY(v_report_id,REPORT_DESFORMAT, '<HTML|HTMLCSS|PDF|RTF|XML|DELIMITED>');
/* replace <ReportServerTnsName> with the name of the Reports Services as defined
in your tnsnames.ora file */
SET_REPORT_OBJECT_PROPERTY(v_report_id,REPORT_SERVER, '<ReportServerTnsName>');
SET_REPORT_OBJECT_PROPERTY(v_report_id,REPORT_OTHER, 'p_deptno='||:dept.deptno||'paramform=no');
/* finally, run the report and retrieve the Reports job_id as a handle to the
Reports process */
vc_report_job_id:=RUN_REPORT_OBJECT(report_id);

/*The report output is not delivered automatically to the client, which is okay
because the Web is a request model. Thus the next step is to check if the report
finished. */

vc_rep_status := REPORT_OBJECT_STATUS(vc_report_job_id);
IF vc_rep_status='FINISHED' THEN
/* Call the Report output to be displayed in a separate browser window. The URL
for relative addressing is only valid when the Reports Server is on the same host
as the Forms Server. For accessing a Remote Reports Server on a different
machine, you must use the prefix http://hostname:port/ */
web.show_document ('/<virtual path>/<reports cgi or servlet name>/getjobid='||
vc_report_job_id ||'?server='|| '<ReportServerTnsName>','_blank');
ELSE
message ('Report failed with error message '||rep_status);
END IF;
END;

14.2.3 例の説明

- レポートを同期式でコールすると、サーバーでレポートが処理されている間、待機する必要があります。長時間実行するReportsでは、REPORT_COMM_MODEプロパティを非同期に設定し、REPORT_EXECUTION_MODEをバッチに設定して、レポートを非同期式で開始することをお薦めします。
SET_REPORT_OBJECT_PROPERTY(report_id,REPORT_EXECUTION_MODE,BATCH);

SET_REPORT_OBJECT_PROPERTY(report_id,REPORT_COMM_MODE,ASYNCHRONOUS);

- RUN_REPORT_OBJECTビルトインをコールした後に、タイマーを作成し、When-Timer-Expiredトリガーを使用して現在のREPORT_OBJECT_STATUSを頻繁にチェックする必要があります。パフォーマンス上の理由により、このタイマーは1分間に5回以上実行しないでください。レポートが生成された後、When-Timer-ExpiredトリガーによってWEB.SHOW_DOCUMENTビルトインがコールされ、一意のjob_idで識別されるReports出力ファイルがクライアントのブラウザにロードされます。

注意:
タイマーは、不要になったら必ず削除してください。

次の例は、Report_Object_StatusをチェックするWhen-Timer-Expiredトリガーを示しています。

(...)
/* :global.vc_report_job_id needs to be global because the information about
the Report job_id is shared between the trigger code that starts the Report
and the When-Trigger-Expired trigger that checks the current Report status. */
vc_rep_status:= REPORT_OBJECT_STATUS(:global.vc_report_job_id);
IF vc_rep_status='FINISHED' THEN
web.show_document ('/<virtual path>/<reports cgi or servlet name>/getjobid='||
vc_report_job_id ||'?server='|| '<ReportServerTnsName>','_blank');
ELSIF vc_rep_status not in ('RUNNING','OPENING_REPORT','ENQUEUED') THEN
message (vc_rep_status||'  Report output aborted');
END IF;
(...)

14.2.4 RUN_REPORT_OBJECTでのパラメータ・リストの使用

クライアント/サーバー・モードのときにRUN_PRODUCTで使用されていたパラメータ・リストは、Oracle Fusion Middleware Reports ServicesをコールするRUN_REPORT_OBJECTでも使用できます。システム・パラメータをSet_Report_Object_Propertyを使用して設定する必要があります。RUN_REPORT_OBJECTでパラメータ・リストを使用するための構文は、次のとおりです。

report_job_id:=run_report_object(report_id,paramlist_id);

paramlist_idは、RUN_PRODUCTで使用されるIDと同じIDです。

パラメータ設定には次のものを使用できます。

- REPORT_COMM_MODE: Batch、Runtime

- REPORT_EXECUTION_MODE: Synchronous、Asynchronous

- REPORT_DESTYPE: FILE、PRINTER、MAIL、CACHE、PREVIEW、FTP、FAX、WEBDAV、ORACLEPORTAL、ORACLEWIRELESS、SECUREPDF、BLOBDESTINATION

- REPORT_FILENAME: レポートのファイル名(CACHEと一緒には使用しません)

- REPORT_DESNAME: レポートの宛先名 (CACHEと一緒には使用しません)

- REPORT_DESFORMAT: レポートの宛先のフォーマット

- REPORT_SERVER: レポートのサーバー名

その他の設定は次のとおりです。

- Reports CGI名は、"rwcgi.sh"(UNIX)および"rwcgi.exe"(Windows)です。

- Reportsサーブレットのデフォルト名は"rwservlet"です。

- Reportsサーブレットの仮想パスは/reports/です。

14.2.5 アップグレード手順

第2章「Oracle Forms Migration Assistantの使用」で説明しているように、Forms Migration Assistantを使用すると、統合されたReportsコールをOracle Formsモジュール内で変更できます。Migration Assistantは、Run_ProductコールをReportsにリダイレクトしてRun_Report_ObjectビルトインとReports Servicesが使用されるようにするコードをアプリケーション・モジュールに追加します。変換後は、Forms 6iでRun_Productおよびランタイム・エンジンを使用する場合と同じ品質が提供されます。

Oracle FormsでReportsを手動でアップグレードする手順は次のとおりです。

1. Run_Productのすべての状態変化を検索します。

2. これらのコールに使用されているパラメータ・リストを特定し、検索します。

3. desnameやdestypeなど、Reportsのすべてのシステム・パラメータ設定をパラメータ・リストから削除します。

4. Oracle FormsまたはForms 6i Builderに定義されているReportsノード名のReportsノードIDを検索します。

5. PL/SQLで、DESNAME、REPORT_SERVER、DESFORMAT、DESTYPE、COMM_MODEおよびEXECUTION_MODEにSet_Report_Object_Propertyコードを作成します。

6. Run_Report_Object(report_node_id, paramlist_id)を使用して、Run_Product用に作成されているパラメータ・リストを再利用します。

注意:
Run_Report_Objectを使用するようにForms 6iのOracle Reportsへのコールを変更する方法については、http://www.oracle.com/technetwork/developer-tools/forms/documentation/index.htmlにあるホワイトペーパーを参照してください。

15 Webへのクライアント/サーバー・アプリケーションのアップグレード

この章では、クライアント/サーバー・アプリケーションをWebにアップグレードする場合のガイドラインについて説明します。

この章は、次の項で構成されています。

- 第15.1項「アップグレードのガイドライン」

- 第15.2項「クライアント/サーバーベースのアーキテクチャについて」

- 第15.3項「Webベースのアーキテクチャについて」

http://www.oracle.com/technetwork/developer-tools/forms/documentation/index.htmlにあるホワイトペーパーやその他の関連ドキュメントも参照してください。

15.1 アップグレードのガイドライン

アプリケーションをクライアント/サーバー・デプロイからWebにアップグレードするときは、Webベースのアプリケーションについて、次の点に留意してください。

- サポートされるイメージ・タイプがJPEGとGIFのみであるため、既存のイメージをこれらの形式に変換してください。

- ファイル転送には、圧縮されたJAR(Java Archive)ファイルの使用がサポートされます。ファイル転送に使用するPJCまたはJavaBeansは必ずJARにしてください。アプリケーション機能の一部としてクライアントからFormsサーバーにファイルを転送する場合は、ファイルをJARにする必要はありません。

- ActiveX、OCX、OLE、VBXの各コントロールはユーザー・インタフェースでサポートされません。かわりに、JavaBeansを使用して、機能をユーザー・インタフェースに複製してください。Microsoft Windowsのユーザー・インタフェースに依存する他の機能も、JavaBeansで置換する必要があります。これらの機能の中には、WebUtilを使用してリストアできるものもあります。

- MouseMoveトリガー(When-Mouse-Enter、When-Mouse-Leave、When-Mouse-Moveなど)はサポートされません。

- クライアント・ハード・ドライブへの書込み権限が自動的にはサポートされません。この権限は、Oracle Forms Webutilライブラリを使用して取得できます。

- サポートされるフォントがJavaフォントのみであるため、アプリケーションで使用されているフォント・タイプのチェックが必要です。必要に応じてJavaフォントに切り替えてください。Javaでは、Registry.datファイルにあるフォント・エイリアス・リストが使用されます。サポートされるフォント・エイリアスについては、表15-1を参照してください。

表15-1 Webベースのアプリケーションでサポートされるフォント

Javaフォント

Windowsフォント

XWindowsフォント

Macintoshフォント

Courier

Courier New

adobe-courier

Courier

Dialog

MS San Serif

b&h-lucida

Geneva

DialogInput

MS San Serif

b&h-lucidatypewriter

Geneva

Helvetica

Arial

adobe-helvetica

Helvetica

Times Roman

Times New Roman

adobe-times

Times Roman脚注 1

脚注 1 Javaフォントの詳細はhttps://docs.oracle.com/javase/tutorial/2d/text/fonts.htmlにあります。

- 次のビルトインおよびパッケージは、アプリケーション・サーバーでのみ実行され、クライアント・ブラウザでは実行されません。

- TEXT_IO

- HOST

- ORA_FFI

- GET_FILE_NAME*

- READ_IMAGE_FILE

- WRITE_IMAGE_FILE

*GET_FILE_NAMEビルトインを使用するモジュールは正常にコンパイルおよび生成されますが、このビルトインへのコールでは何も実行されません(NULLが返されます)。これらのビルトインおよびパッケージの機能がクライアントに必要な場合は、WebUtilを使用してください。

15.2 クライアント/サーバーベースのアーキテクチャについて

図15-1に示すクライアント/サーバーベースの実装では、Forms Serverランタイム・エンジンとすべてのアプリケーション・ロジックがユーザーのデスクトップ・マシンにインストールされます。ユーザー・インタフェースとトリガーの処理は、一部のアプリケーションに含まれるデータベースサーバー側のトリガーとロジックを除いて、すべてそのクライアントで発生します。

図15-1 Oracle Formsのクライアント/サーバー・アーキテクチャ

15.3 Webベースのアーキテクチャについて

図15-2に示すWebベースの実装では、Forms Servicesランタイム・エンジンとすべてのアプリケーション・ロジックが、クライアント・マシンではなく、アプリケーション・サーバーにインストールされます。トリガー処理はいずれもデータベース・サーバーとアプリケーション・サーバーで発生しますが、ユーザー・インタフェース処理はユーザーのシステム上にあるFormsクライアントで発生します。

図15-2 Oracle FormsのWebアーキテクチャ

16 Forms 6iより前のアプリケーションからOracle Formsへのアップグレード

Forms Developerは、バージョン3.0、4.0、4.5および5.0を含め、以前のバージョンのOracle Formsと上位互換性があります。

注意:
Forms 6iより前のFormsリリースからOracle Forms 12cにアップグレードする場合は、まずアプリケーションをForms 10g(10.1.2)にアップグレードし、その後でOracle Forms 12cにアップグレードする必要があります。

注意:
フォームやメニューを変換する前に、すべてのファイルのバックアップ・コピーを作成することをお薦めします。モジュールは、いったんアップグレードすると、前のバージョンのForms Developerでオープンできなくなります。

16.1 フォームのアップグレード

バージョン4.xまたは5.xのFormsアプリケーションをForms 10g(10.1.2)にアップグレードする手順は、次のとおりです。

1. Forms 10g(10.1.2)を起動します。

2. 「ファイル」→「開く」を選択して、ファイルを表示します。

3. アップグレードするモジュールを選択します。

4. 「OK」をクリックします。

5. 「プログラム」→「PL/SQLのコンパイル」→「すべて」を選択し、アップグレードするモジュールのPL/SQLコードをコンパイルします。

6. 「ファイル」→「保存」を選択します。

注意:
フォーム・モジュールとライブラリはすべてアップグレードして再コンパイルする必要があります。

16.2 データベースに保存されているファイルのアップグレード

使用可能なツールを合理化し、Formsアプリケーションを構築する開発プロセスを簡素化するために、データベースにファイルを保存する際のオプションが削除されています。Forms 6iでは、モジュールをデータベースに保存できました。6iより後のすべてのリリースでは、データベースに保存していたモジュール・ファイルをファイル・システムに保存する必要があります。

1. 以前のバージョンのFormsを開きます。

2. モジュール・ファイルをローカルのファイル・システムに保存します。

3. 第16.1項「フォームのアップグレード」の説明に従って、ファイルをアップグレードします。

16.3 以前のバージョンのPL/SQLとの互換性

クライアント側のプログラム・ユニットがPL/SQL V1またはV2で記述されている場合、コードを新しいレベルに変換する必要があります。

ストアド・プログラム・ユニットでは、クライアント側のPL/SQLで使用可能なすべてのPL/SQL機能を使用できます。特定のPL/SQL機能(指定されたDBMS_LOBルーチンや、プラグマ・インタフェース(C、C++など)として指定されたDBMSパッケージなど)は、クライアント側のPL/SQLから直接コールできません。まずFormsプログラムからストアド・プロシージャをコールし、次にストアド・プロシージャから該当するルーチンをコールする必要があります。

16.4 Forms Developerのランタイム動作

Forms 5.0から6iで作成されたフォームのデフォルトのランタイム動作は、Forms 4.5のランタイム動作とは異なっていました。フォーム・レベルの「ランタイム互換性モード」プロパティを「4.5」に設定すると、Formsリリース4.5の動作が提供されました。(これは、Formsリリース4.5からアップグレードした場合のデフォルトでした。)

Forms Developer以降は、5.0の動作がすべてのケースに適用され、フォーム・レベルの「ランタイム互換性モード」プロパティは無視されます。

4.5の動作を指定するフォームをOracle Formsにアップグレードする場合は、4.5の動作と5.0の動作の違いが反映されるように、必要に応じてロジックを変更する必要があります。「ランタイム互換性モード」プロパティ、および4.5の動作と5.0の動作の違いについては、オンライン・ヘルプを参照してください。

オラクルの法律上の注意点について

コピーライトについて

Copyright © 1994-2016, Oracle and/or its affiliates.All rights reserved.

ライセンス制約の保証と結果的に生じる損害の免責

このソフトウェアおよび関連ドキュメントの使用と開示は、ライセンス契約の制約条件に従うものとし、知的財産に関する法律により保護されています。ライセンス契約で明示的に許諾されている場合もしくは法律によって認められている場合を除き、形式、手段に関係なく、いかなる部分も使用、複写、複製、翻訳、放送、修正、ライセンス供与、送信、配布、発表、実行、公開または表示することはできません。このソフトウェアのリバース・エンジニアリング、逆アセンブル、逆コンパイルは互換性のために法律によって規定されている場合を除き、禁止されています。

保証免責

ここに記載された情報は予告なしに変更される場合があります。また、誤りが無いことの保証はいたしかねます。誤りを見つけた場合は、オラクルまでご連絡ください。

制限付権利について

このソフトウェアまたは関連ドキュメントを、米国政府機関もしくは米国政府機関に代わってこのソフトウェアまたは関連ドキュメントをライセンスされた者に提供する場合は、次の通知が適用されます。

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations.As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs.No other rights are granted to the U.S. Government.

危険な用途への使用について

このソフトウェアまたはハードウェアは様々な情報管理アプリケーションでの一般的な使用のために開発されたものです。このソフトウェアまたはハードウェアは、危険が伴うアプリケーション(人的傷害を発生させる可能性があるアプリケーションを含む)への用途を目的として開発されていません。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用する際、安全に使用するために、適切な安全装置、バックアップ、冗長性(redundancy)、その他の対策を講じることは使用者の責任となります。このソフトウェアまたはハードウェアを危険が伴うアプリケーションで使用したことに起因して損害が発生しても、Oracle Corporationおよびその関連会社は一切の責任を負いかねます。

商標と登録商標について

OracleおよびJavaはオラクルおよびその関連会社の登録商標です。その他の社名、商品名等は各社の商標または登録商標である場合があります。

Intel、Intel Xeonは、Intel Corporationの商標または登録商標です。すべてのSPARCの商標はライセンスをもとに使用し、SPARC International, Inc.の商標または登録商標です。AMD、Opteron、AMDロゴ、AMD Opteronロゴは、Advanced Micro Devices, Inc.の商標または登録商標です。UNIXは、The Open Groupの登録商標です。

第三者のコンテンツ、製品、サービスに対する免責事項

このソフトウェアまたはハードウェア、そしてドキュメントは、第三者のコンテンツ、製品、サービスへのアクセス、あるいはそれらに関する情報を提供することがあります。適用されるお客様とOracle Corporationとの間の契約に別段の定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスに関して一切の責任を負わず、いかなる保証もいたしません。適用されるお客様とOracle Corporationとの間の契約に定めがある場合を除いて、Oracle Corporationおよびその関連会社は、第三者のコンテンツ、製品、サービスへのアクセスまたは使用によって損失、費用、あるいは損害が発生しても一切の責任を負いかねます。

アルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが試作版の場合:

このドキュメントは試作版であり、デモおよび暫定使用のみを目的としたものです。このソフトウェアを使用するハードウェアに限定するものではありません。Oracle Corporationおよびその関連会社は、このドキュメントに関して一切の責任を負わず、いかなる保証もいたしません。また、このドキュメントを使用したことによって損失、費用、あるいは損害が発生しても、一切の責任を負いかねます。

非公開のアルファ版およびベータ版ドラフト・ドキュメントについて

このドキュメントが非公開の試作版の場合:

このドキュメントに含まれる情報は、情報の共有のみを目的としたものであって、顧客諮問委員会(Customer Advisory Board)のメンバーとしてのお客様の立場でのみ、またはお客様のベータ・トライアル契約のみに従って検討されるべきものとします。マテリアル、コード、または機能の提供をお約束するものではなく、購入決定を行う際の判断材料とすべきではありません。このドキュメントに記載されている特徴または機能の開発、リリースおよび時期については、オラクルの裁量により決定されます。

このドキュメントには、ソフトウェアまたは印刷物などの形式を問わず、オラクルが独占的な権利を有する財産的情報が含まれています。この機密資料へのアクセスと使用は、お客様とオラクルとの間で締結され、お客様が遵守に同意した、Oracle Master Agreement、Oracle License and Oracle Services Agreement (オラクル・ライセンスおよびサービスに関する契約書)、Oracle PartnerNetwork Agreement、Oracle Distribution Agreementまたはその他のライセンス契約の条件に従うものとします。このドキュメントとその内容の開示、コピー、複製および配布には、オラクルによる事前の承諾を必要とします。このドキュメントはライセンス契約の一部となるものではなく、オラクルおよびその子会社や関連会社との契約を構成するものではありません。

ドキュメントのアクセシビリティについて

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイトhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc を参照してください。

Oracle Supportへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=infoか、聴覚に障害のあるお客様はhttp://www.oracle.com/pls/topic/lookup?ctx=acc&id=trsを参照してください。