プロジェクトを移行するためには、次の手順を実行します。
1. 作業領域を移行する前に、該当する作業領域のバックアップ・コピーを作成します。
2. 第E.3項「旧リリースからのユーザー設定の移行」で説明したようにデータベース接続を 自動的に移行していない場合は、データベース接続を移行してから作業を進めてください。
Oracle JDeveloper10gでは、接続ナビゲータを表示し、「データベース」を右クリックし
て、「接続のインポート接続のインポート接続のインポート接続のインポート」を選択します。
必ずこの手順を完了してから、Oracle9i JDeveloper(9.0.4)からの接続を使用する
BIDesignerを開いてください。
3. JDeveloperでプロジェクトを移行できるようにします。
Oracle9i JDeveloper(9.0.4)で作成された作業領域、またはこれからOracle
JDeveloper10gの作業領域に追加しようとしているOracle9i JDeveloper(9.0.4)で作成さ
れたプロジェクトを移行する必要があります。Oracle JDeveloper10gを起動して、Oracle9i
JDeveloper(9.0.4)のBI Beans作業領域を開くと、移行ウィザードが表示されます。この
ウィザードでは、多くの移行手順を自動的に実行できます。たとえば、Oracle
JDeveloper10gの正確なバージョンに作業領域を更新できます。最新のUIXインストール
可能コンポーネントやHTMLアプリケーションのデータ・バインディング構文など、他の
ウィザードでは、すべてのローカル・カタログが自動的に移行されるようにしてください。
また、移行前にカタログをバックアップするかどうか指定することもできます。特定の ローカル・カタログを移行しない場合は、ウィザードで選択を解除できます。リモート・
カタログのアップグレードの詳細は、第E.2項「BI Beansカタログの移行」を参照してく ださい。
4. 自動アップグレードが完了したら、コンパイラ・オプションの警告をオンにし、アプリ ケーション・コードをコンパイルして置換が必要な推奨されないクラスまたはタグを識別 し、確認されたエラーを修正します。
5. プロジェクト設定を編集し、次の行を削除してこのオプションが設定されていないことを 確認します。このオプションが設定されている場合、JDeveloperでは新規のバージョンで はなく古いバージョンのJDBCが使用されます。
-Djava.ext.dirs=C:¥Jdev¥JDev904_2.7.5.32.1¥jdev¥lib¥patches
6. アプリケーションにプレゼンテーションが含まれており、シンQueryBuilderを使用してそ のプレゼンテーションを編集する場合は、「開始」ページで何も選択されていないことがあ ります。この問題を解決するには、次の手順を実行します。
a. JDeveloperでプレゼンテーションを編集します。
b. プレゼンテーション・エディタの「アイテムアイテムアイテムアイテム」パネルを使用して、「OK」または「適適適適 用
用 用
用」をクリックします。
c. アプリケーションを設計時カタログからランタイム・カタログに再デプロイします。
7. 所有しているアプリケーションの種類に応じて、次の項で説明している手順を実行します。
■ 第E.4.1項「BI Beans JSPアプリケーションの手動による移行手順」
■ 第E.4.2項「BI Beans UIXアプリケーションの手動による移行手順」
■ 第E.4.3項「BI Beans Javaクライアント・クラス・アプリケーションの手動による移行
手順」
■ 第E.4.4項「BI Beans Javaサーブレット・アプリケーションの手動による移行手順」
E.4.1 BI Beans JSP アプリケーションの手動による移行手順 アプリケーションの手動による移行手順 アプリケーションの手動による移行手順 アプリケーションの手動による移行手順
JSPアプリケーションを手動で移行するには、次の各項で説明する手順を実行します。
E.4.1.1 ネームスペースの更新 ネームスペースの更新 ネームスペースの更新 ネームスペースの更新
各ページのコードの最初の行でネームスペースを編集します。次の例に示すように、既存の ネームスペースに「/jsp」を追加します。
編集前:
<%& taglib uri="http://xmlns.oracle.com/bibeans" prefix="orabi" %>
編集後:
<%& taglib uri="http://xmlns.oracle.com/bibeans/jsp" prefix="orabi" %>
E.4.1.2 新規の 新規の 新規の 新規の BI JSP タグ機能へのアクセス タグ機能へのアクセス タグ機能へのアクセス タグ機能へのアクセス
このリリースのBI Beansの新機能であるJSPタグ機能にアクセスする場合は、次の手順を実行 する必要があります。
1. 移行済アプリケーションのすべてのJSPページの最上部に、次のテキストを追加します。
<%@ taglib uri="http://java.sun.com/jstl/core" prefix="c"%>
ヒント ヒント ヒント
ヒント: 手動による移行手順の最新情報は、『Oracle Business Intelligence
Toolsリリース・ノート』を参照してください。
BI Beans作業領域の移行
2. 次の手順を実行して、JSTLタグ・ライブラリがプロジェクト内にあることを確認します。
a. <project>¥public_html¥WEB-INF¥libディレクトリにstandard.jarファイ ルが含まれているか確認します。含まれていない場合は、手順b.およびc.を実行しま す。
b. 移行済プロジェクトで任意のJSPページを開きます。コンポーネント・パレットで、
「JSTL Core」を選択します。このページにoutタグをドラッグします。タグ・エディ
タで「OK」を選択します。
c. JSPページで、<c:out></c:out>タグを探して削除します。
<project>¥public_html¥WEB-INF¥libディレクトリを再度確認します。
standard.jarファイルが存在します。
E.4.1.3 <body> タグの更新 タグの更新 タグの更新 タグの更新
BIThinSessionタグを含む各ページで、HTML <body>タグを更新します。ネームスペースの編
集後は、BIBodyタグおよびInitBITagsタグを更新する必要があります。BIBodyタグは、ペー
ジ上でビジュアル・エディタに表示されているときにドラッグ・アンド・ドロップできます。
InitBITagsタグは、フォームの最初の子としてドラッグ・アンド・ドロップできます。
ドラッグ・アンド・ドロップ技術が効果的でない場合は、次の手順で説明するように、タグを 手動で編集できます。
1. <body>タグを削除して、同じ場所に必要なBIタグ(BIBody(HTML <form>タグの前)
とInitBITags(HTML <form>タグの後)を挿入します。
2. <form>のaction属性を、JSPページの名前に設定します。
3. method属性をPOSTに設定します。
4. InitBITagsのparentForm属性を、<form>の名前に設定します。
次のコードは、biexplorerdetail1.jspというページの、これらのタグの例です。
<orabi:BIBody>
<form name="BIForm" method="POST" action="biexplorerdetail1.jsp" >
<orabi:InitBITags parentForm="BIForm"/>
注意 注意 注意
注意: JSPページの名前の指定には、スラッシュを含めないでください。また、終了タグ
</body>を</orabi:BIBody>に置き換えます。
E.4.1.4 プレゼンテーションにアクセスするコードの更新 プレゼンテーションにアクセスするコードの更新 プレゼンテーションにアクセスするコードの更新 プレゼンテーションにアクセスするコードの更新
アプリケーションのJSPページにスクリプトレットが含まれている場合や、IDを利用してプレ ゼンテーションにアクセスし、ThinDataviewCommonにキャストするJavaコードが含まれて いる場合は、プレゼンテーションBeanにキャストしてBeanからデータ・ビューを取得する必 要があります。
これを実現するには、次に示すようなコードの行を変更します。
ThinDataviewCommon dataView = (ThinDataViewCommon)pageContext.findAttribute ("biuntitled1_pres1");
次のようにします。
ThinDataviewCommon tdvc = null;
Presentation p = (Presentation)pageContext.findAttribute ("biuntitled1_pres1");
if (p != null)
tdvc = p.getView();
新しいプレゼンテーションBeanにアクセスするために、次のインポートを追加します。
oracle.dss.thin.beans.dataView.Presentation;
E.4.1.5 SaveButton JSP タグの更新 タグの更新 タグの更新 タグの更新
SaveButton JSPタグは、SaveLinkタグに置き換えられました。アプリケーションで
SaveButton JSPタグを使用している場合は、次の手順でアプリケーションを更新できます。
1. BIThinSessionで、次のようなSaveButtonタグを探します。
<orabi:SaveButton id="analyze1_SaveButton1"
presentationId="analyze1_Presentation1"
saveConfirmationPage="saveconf1.jsp"
saveConfirmationId="saveconf1_SaveConfirmation1" />
次の例に示すように、SaveButtonタグを、SaveLinkタグを使用するように変更します。
<orabi:SaveLink id="analyze1_SaveButton1" mode="Save"
presentationId="analyze1_Presentation1" />
2. RenderタグをSaveButtonタグに変更します。たとえば、次のようなRenderタグがあると
します。
<orabi:Render targetId="analyze1_SaveButton1" parentForm="BIForm"/>
Renderタグを、次のように編集します。
<orabi:Button text="Save" onClick="${analyze1_SaveButton1_data.showDialog}"/>
「保存保存保存保存」ボタンをクリックすると、内部のsaveページが表示されます。
E.4.2 BI Beans UIX アプリケーションの手動による移行手順 アプリケーションの手動による移行手順 アプリケーションの手動による移行手順 アプリケーションの手動による移行手順
UIXアプリケーションを手動で移行するには、次の各項で説明する手順を実行します。この手
順では、BI Beansによって生成されたUIXアプリケーションをカスタム・アプリケーションの
基礎として使用したことを前提としています。
E.4.2.1 イメージのパスの更新 イメージのパスの更新 イメージのパスの更新 イメージのパスの更新
作業領域にイメージが含まれている場合は、次の手順で説明するように、そのイメージをコ ピーして、BIPageTemplate UITファイルとログインUIXファイルでイメージのパスを更新する 必要があります。
1. BIPageTemplate UITファイルおよびログインUIXページで、すべてのイメージのソース・
パスを更新します。Oracle9i JDeveloper(9.0.4)では、イメージはpublic_
html¥cabo¥images¥<app_name>ディレクトリに格納されます。Oracle JDeveloper10g では、イメージはpublic_html¥<app_name>ディレクトリに格納されます。
たとえば、このディレクトリは、UITファイルでは次のようなタグで指定されます。
<images source="cabo¥images¥<app_name>¥required.gif">
このタグを次のように変更します。
<images source="<app_name>¥required.gif">
2. アプリケーションでカスタム・イメージを使用している場合は、そのイメージを、手順1
に示したOracle JDeveloper10gの適切なディレクトリにコピーします。
E.4.2.2 エラー・ページの更新 エラー・ページの更新 エラー・ページの更新 エラー・ページの更新
移行中に、UIXアプリケーションのエラー・ページの問題を説明するメッセージが表示される 場合があります。この問題を解決するには、次いずれかを実行できます。
■ BI Beans 10.1.2で自動的に提供されるデフォルトのエラー・ページを使用する場合は、既
存のエラー・ページを削除してから、プロジェクトをBI Beans 10.1.2へ移行します。