Oracle® Fusion Middleware Oracle Application Development Frameworkデスクトップ統合開発者ガイド 11gリリース1(11.1.1.6.0) B66694-01 |
|
![]() 前 |
![]() 次 |
この章では、ADFデスクトップ統合のサンプル・アプリケーションであるMaster Price Listモジュールの概要を説明します。Master Price Listモジュールは、Fusion Order Demoアプリケーションのモジュールです。これには、Fusion Webアプリケーションに統合されたMicrosoft Excelワークブックがいくつか含まれています。
この章の内容は次のとおりです。
Master Price Listモジュールを使用すると、エンド・ユーザーはストアフロント・タイプのWebアプリケーションを通じて販売される電子機器に関する情報(製品名、価格など)をダウンロードできます。エンド・ユーザーはダウンロード可能な情報を検索したり、価格情報の変更、および変更された情報のFusion Webアプリケーションへのアップロードを行うことができます。
Master Price Listモジュールを設定して実行する前に、開発環境を設定する必要があります。開発環境を設定した後に、Master Price Listモジュールを含むFusion Order Demoアプリケーションをダウンロードできます。
Master Price Listモジュールを実行できるように、第3章「開発環境の設定」の説明に従って開発環境を設定します。
開発環境を設定したら、Master Price Listモジュールを含むFusion Order Demoアプリケーションをダウンロードします。Fusion Order Demoアプリケーションのダウンロードの詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』の「アプリケーション・リソースのダウンロード方法」の項を参照してください。
ダウンロードするFusion Order Demoアプリケーションには、Infrastructure
というディレクトリがあります。このディレクトリには、Fusion Order DemoアプリケーションとMaster Price Listモジュールが必要とするユーザーおよびデータを作成するスクリプトが含まれています。これらのスクリプトの実行方法の詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』の「Fusion Order Demoスキーマのインストール方法」の項を参照してください。
注意: 旧バージョンのADFデスクトップ統合がシステムにインストールされている場合、次の作業を行う必要があります。
|
Master Price Listモジュールを実行する手順
JDeveloperでMasterPriceList.jws
ファイルを開きます。
このファイルは、Fusion Order Demoアプリケーションの抽出先ディレクトリのMasterPriceList
サブディレクトリにあります。
アプリケーション・ナビゲータで、「アプリケーション・リソース」アコーディオン・タイトルをクリックしてウィンドウを展開します。
FOD接続を右クリックして、「プロパティ」を選択します。
「データベース接続の編集」ダイアログで、使用する環境の表2-1にある接続情報を変更します。
表2-1 Master Price Listモジュールのデータベース接続プロパティ
プロパティ | 説明 |
---|---|
ホスト名 |
データベースのホスト名。例:
|
JDBCポート |
データベースのポート。例:
|
SID |
データベースのSID。例:
|
ユーザー名とパスワードfod/fusionは変更しないでください。これらはそのままにしておく必要があります。「OK」をクリックします。
アプリケーション・ナビゲータで、「モデル」を右クリックしてModel.jprのリビルドを選択します。
アプリケーション・ナビゲータで、ViewController.jprを右クリックしてViewController.jprのリビルドを選択します。
アプリケーション・ナビゲータで、ViewControllerプロジェクトを展開して、login.jspxを右クリックし、「実行」を選択します。
login.jspx
ページが実行され、ログイン・フォームが表示されます。
管理者としてログオンするには、「ユーザー名」フィールドにsking
、「パスワード」フィールドにwelcome1
とそれぞれ入力します。マネージャとしてログオンするには、「ユーザー名」フィールドにahunold
、「パスワード」フィールドにwelcome1
とそれぞれ入力します。ユーザーの詳細は、2.4.1項「統合ExcelワークブックからのFusion Webアプリケーションへのログオン」を参照してください。
統合Excelワークブックを開いて、2.4章「Master Price Listモジュールでの統合Excelワークブックの概要」の説明にあるように、Master Price ListモジュールがデプロイされるFusion Webアプリケーションに接続できるようになりました。
Master Price ListモジュールのFusion Webアプリケーションを使用すると、エンド・ユーザーは製品のリストを編集して検索したり、製品の検索や統合Excelワークブックのダウンロード、列のソートおよび再順序付けなどが行えます。
エンド・ユーザーがJDeveloperでMaster Price List Fusion Webアプリケーションを実行する際、Master Price ListモジュールがOracle WebLogic Serverにデプロイされた後にデフォルトのブラウザでログイン・ページが開きます。
Master Price Listモジュールには、Fusion Webアプリケーションにログオンするための2つのユーザー・プロファイルがあります。表2-2は、両方のユーザー・プロファイルの概要です。
表2-2 Master Price Listモジュールのユーザー・プロファイル
ログイン名 | パスワード | ロール | 説明 |
---|---|---|---|
sking |
welcome1 |
管理者 |
情報にアクセスして変更できます。 |
ahunold |
welcome1 |
マネージャ |
情報にアクセスできますが、変更はできません。 |
ログインの資格証明が検証された後、エンド・ユーザーはMaster Price List Fusion Webアプリケーションのホーム・ページにリダイレクトされます。
Master Price List Fusion Webアプリケーションは、製品の検索、一致する製品、製品の詳細、アクティブなディスカウントの4つのウィンドウに分けられます。
製品の検索ウィンドウは、アプリケーション・リポジトリ内の製品を検索するタブがあります。製品の検索ウィンドウはアコーディオン型のウィンドウで、必要に応じて非表示にすることができます。検索機能の詳細は、2.3.4項「製品の検索」を参照してください。
一致する製品ウィンドウには、製品の検索ウィンドウで設定した検索条件に応じて、製品が表形式で表示されます。デフォルトではすべての製品が表示されます。エンド・ユーザーは、一致する製品ウィンドウのツールバーを使用して、統合Excelワークブックのダウンロードや、昇順または降順による列のソート、列を非表示にするなど、様々な処理を行えます。ツールバーの詳細は、2.3.3項「一致する製品ツールバーの使用」を参照してください。
製品の詳細ウィンドウには、一致する製品ウィンドウで選択した製品の詳細な情報が表示されます。表で使用可能な属性の情報や、製品の仕入先、製品の現在の在庫状況、グラフによる各月の製品の販売といった補足情報が含まれます。
アクティブなディスカウントウィンドウは、独立したウィンドウです。使用可能な製品のディスカウントやディスカウントのコード、割引率が表示されます。
一致する製品ウィンドウのツールバーを使用して、次のことができます。
変更の保存
統合Excelワークブックのダウンロード
列の表示または非表示
列のソート
一致する製品ウィンドウからの製品表の連結解除
列の固定または固定解除
列の再順序付け
列の値の折り返しまたは折り返し解除
Master Price Listモジュールには、異なる要件を満たすために様々な統合Excelワークブックが用意されています。エンド・ユーザーは、ツールバーのExcelメニューから統合Excelワークブックをダウンロードできます。
表2-3で各メニュー・オプションについて説明します。
表2-3 Excelダウンロード・メニューのオプション
メニュー・オプション | 説明 |
---|---|
読取り専用のスプレッドシートとしてエクスポート |
すべての製品表データをスプレッドシートにエクスポートします。このスプレッドシートは、統合Excelワークブックではありません。 エクスポートされたファイルは、 |
ライブ・スプレッドシートを使用して編集 |
共通データの編集および更新を可能にする統合Excelワークブックをダウンロードします。 ダウンロードされたファイルは、 |
拡張ライブ・スプレッドシートを使用して編集 |
すべてのデータの編集および更新を可能にする統合ワークブックをダウンロードします。 ダウンロードされたファイルは、 |
ライブ・スプレッドシートを使用して表示および問合せ |
すべての製品の表示、および必要に応じて製品の検索を可能にする統合ワークブックをダウンロードします。この統合Excelワークブックでは、データの編集や更新はできません。 ダウンロードされたファイルは、 |
Master Price Listモジュールでは、一致する製品ウィンドウの製品表の列に様々な操作を実行できます。「表示」メニューのオプションを使用して、エンド・ユーザーは列のソートや表示・非表示の切替え、要件に基づいた列の再順序付けが可能です。
列を表示または非表示にする手順:
一致する製品ウィンドウで、「表示」 > 「列」を選択します。
「列」サブメニューで、一致する製品の表で表示または非表示にする列名を選択します。すべての列を表示するには、「すべて表示」をクリックします。
列をソートする手順:
一致する製品ウィンドウで、ソートする表の名前を選択します。
ツールバーから「表示」 > 「ソート」を選択します。
選択した列を昇順でソートするには、「ソート」サブメニューで「昇順」を選択します。選択した列の値を降順でソートするには、「降順」を選択します。
ヒント: 昇順または降順で列をソートするには、列名のヘッダーの上向きまたは下向きの三角形をクリックすることもできます。 |
同じ値の複数の列を一度にソートするには、「詳細」を選択します。「拡張ソート」ダイアログで、必要な列を選択します。
列を再順序付けする手順:
「表示」メニューから、「並替え」をクリックして「列の並替え」ダイアログをクリックします。
このダイアログで、それぞれの列名をクリックして選択し、ナビゲーション・ボタンを使用して並べ替えます。
ヒント: 複数の列を並べ替えるには、対応するチェック・ボックスを選択してナビゲーション・ボタンを使用します。選択されたすべての列がグループとして移動します。 |
一致する製品ツールバーには、変更を保存したり、一致する製品ウィンドウから一致する製品表の連結解除、列の固定または固定解除、列の値の折り返しまたは折り返し解除を行うボタンがあります。
変更を保存するには、「保存」をクリックします。
一致する製品ウィンドウから一致する製品表を連結解除するには、「連結解除」をクリックします。
列を固定するには、列ヘッダーをクリックして列を選択し、「固定」をクリックします。列を固定解除するには、「固定」をもう一度クリックします。
列の値を折り返すには、列ヘッダーをクリックして列を選択し、「折返し」をクリックします。列の値の折り返しを解除するには、「折返し」をもう一度クリックします。
注意: Master Price List Fusion Webアプリケーションを使用すると、次の編集が可能です。
|
Master Price Listモジュールには、EditPriceList.xlsx
、AdvEditPriceList.xlsx
、ReadOnlyPriceList.xlsx
という統合Excelワークブックが用意されています。すべてのワークブックは、エンド・ユーザーが次のことを実行できるようにします。
ワークブックからのFusion Webアプリケーションへのログオン
製品価格に関するデータ行のダウンロード
ワークブックでの製品価格情報の検索
さらに、EditPriceList.xlsx
とAdvEditPriceList.xlsx
のワークブックを使用して、エンド・ユーザーは次のことができます。
Master Price ListモジュールのFusion Webアプリケーションでの製品および製品価格情報の検索
ワークブックでの製品価格情報の変更
Excel式を使用したADF表コンポーネント内の値の計算の実行
変更した製品価格情報のワークブックからMaster Price ListモジュールFusion Webアプリケーションへのアップロード
この章の次の項では、ワークブックの機能の詳細な情報と実装の詳細への参照を提供します。
実行時には、Master Price Listモジュールの統合Excelワークブックで、Excelリボン・タブがレンダリングされ、エンド・ユーザーはこれを使用してFusion Webアプリケーションにログオンできます。図2-6は、EditPriceList.xlsx
ワークブックのリボンにある実行時のFusion Order Demoタブを示します。
EditPriceList.xlsx
ワークブックでは、エンド・ユーザーが「ログイン」をクリックするか、Fusion Webアプリケーションへの接続が必要なアクションを起動すると、Fusion Webアプリケーションにログオンするようにプロンプトが表示されます。EditPriceList.xlsx
ワークブックのワークシートStartup
イベントはADF表コンポーネントのDownload
アクションを起動するため、エンド・ユーザーはEditPriceList.xlsx
ワークブックを起動した直後にログオンするよう求められます。
「ログイン」ボタンは、ワークブックのLogin
アクションを起動します。「ログイン」ボタン(および図2-6の他のボタン)の構成の詳細は、8.3項「実行時リボン・タブの構成」を参照してください。
ワークブックのLogin
アクションは、Fusion Webアプリケーションの認証プロセスを起動します。この機能の実装の詳細は、第11章「統合Excelワークブックの安全確保」を参照してください。
Master Price Listモジュールには、表2-2に示すように、アプリケーションにログインするための2つのユーザー・プロファイルがあります。
EditPriceList.xlsx
ワークブックでは、ADF表コンポーネントを使用して、Fusion Webアプリケーションからダウンロードされた製品価格情報をホストします。このコンポーネントを使用して、エンド・ユーザーは行を編集し、変更した行をFusion Webアプリケーションにアップロードできます。
次の項では、ダウンロード機能の実装方法の詳細を説明します。
Fusion Webアプリケーションに統合するそれぞれのワークシートには、関連するページ定義ファイルが必要です。EditPriceList.xlsx
ワークブックのPrice Listワークシートは、ページ定義ファイルExcelPriceListPageDef.xml
と関連付けられています。JDeveloperでこのファイルを見るには、アプリケーション・ナビゲータで次のノードを展開します。
ViewController > アプリケーション・ソース > oracle.foddemo.masterpricelist > 表示 > pageDefs
ページ定義ファイルの構成方法の詳細は、4.3項「統合Excelワークブックのページ定義ファイルの使用」を参照してください。
ADF表コンポーネントDownload
アクションは、Fusion Webアプリケーションからワークシートにデータをダウンロードします。このアクションを起動する方法の詳細は、7.6項「ADF表コンポーネントにデータをダウンロードするためのOracle ADFコンポーネントの構成」を参照してください。
EditPriceList.xlsx
ワークブックでは、ワークシートStartup
イベントはADF表コンポーネントDownload
アクションを含むアクション・セットを起動します。ワークシート・イベントの構成の詳細は、8.2.4項「ワークシート・イベントからアクション・セットを起動する方法」を参照してください。
ReadOnlyPriceList.xlsx
ワークブックでは、ADF読取り専用表コンポーネントを使用して、Fusion Webアプリケーションから製品価格情報をダウンロードします。エンド・ユーザーはこのデータを見ることはできますが、データを変更したり、変更をFusion Webアプリケーションに保存することはできません。
次の項では、ReadOnlyPriceList.xlsx
ワークブックのダウンロード機能を実装する方法の詳細を説明します。
ADF読取り専用表コンポーネントの作成の詳細は、7.16項「ADF読取り専用表コンポーネントの作成」を参照してください。
ADFボタン・コンポーネントは、ADF読取り表コンポーネントのDownload
アクションを含むアクション・セットを起動するために構成されています。ADFボタン・コンポーネントの作成の詳細は、6.2項「ADFボタン・コンポーネントの挿入」を参照してください。
統合Excelワークブックには、エンド・ユーザーに検索フォームを提供するために構成されたADFコンポーネントがあります。エンド・ユーザーはフォームに検索語句を入力して、Fusion Webアプリケーション上で問合せを起動し、結果をワークブックにダウンロードできます。図2-7は、EditPriceList.xlsx
ワークブックでのこれらのコンポーネントの実行時のビューを示します。
次の項では、EditPriceList.xlsx
ワークブックで使用可能な単純検索フォームの実装方法について説明します。
検索フォームの作成の詳細は、8.6項「統合Excelワークブックの拡張検索フォームの作成方法」を参照してください。
フォームの作成の詳細は、8.7項「統合Excelワークブックへのフォームの追加」を参照してください。
EditPriceList.xlsx
とAdvEditPriceList.xlsx
の各ワークブックには、構成済の検索機能があり、エンド・ユーザーはこれを使用してFusion Webアプリケーションからページを起動したり、検索条件の指定、または結果をワークブックのADF表コンポーネントにダウンロードすることができます。図2-8は、エンド・ユーザーが「拡張検索」ボタンをクリックすると起動できるFusion Webアプリケーションのページを示します。
EditPriceList.xlsx
ワークブックで拡張検索機能を実装する方法の詳細は、8.6項「統合Excelワークブックの拡張検索フォームの作成方法」を参照してください。
EditPriceList.xlsx
ワークブックおよびAdvEditPriceList.xlsx
ワークブックのエンド・ユーザーは、ADF表コンポーネントがFusion Webアプリケーションからダウンロードする製品価格情報を編集できます。UpdateComponent
プロパティが構成されている実行時ADF表コンポーネントの列を使用して、エンド・ユーザーは値を変更したり、変更をFusion Webアプリケーションにアップロードできます。たとえば、エンド・ユーザーはProductId、ProductName、CostPriceの列に表示される値を変更できます。
エンド・ユーザーは、他の列のセルに値を入力したり、表示される値を変更できます。ただし、ADF表コンポーネントはこれらの変更をFusion Webアプリケーションにアップロードしません。これは、これらの列のいくつかでは、Fusion Webアプリケーションからダウンロードされた値を使用してExcel式を評価した結果が表示されるためです。こうした列では、読取り専用形式を使用して、他の列と区別する必要があります。たとえば、Difference列にリスト価格から原価を差し引くExcel式の結果が表示される場合、読取り専用形式を使用して、他の入力列と簡単に区別できるようにします。
StatusやChangedなど他の列は、ADF表コンポーネントに表示されて、アップロード操作や変更された列のステータス情報を提供します。
次の項では、この機能の実装方法の詳細を説明します。
ADF表コンポーネントの挿入の詳細は、7.3項「ExcelワークシートへのADF表コンポーネントの挿入」を参照してください。
Excel式の使用の詳細は、8.10項「統合Excelワークブックでの計算済セルの使用」を参照してください。
StatusやChangedなど特殊な列の詳細は、7.11項「ADF表コンポーネント内の特殊な列」を参照してください。
EditPriceList.xlsx
ワークブックとAdvEditPriceList.xlsx
ワークブックを使用すると、エンド・ユーザーはADF表コンポーネントの変更済データをFusion Webアプリケーションにアップロードできます。アクション・セットが、ADF表コンポーネントのUpload
アクションを起動する実行時「変更の保存」ボタン用に構成されています。この機能の実装の詳細は、7.8項「ADF表コンポーネントから変更をアップロードするためのOracle ADFコンポーネントの構成」を参照してください。
ヒント: Fusion Order Demoタブのサーバーへのアップロードボタンを使用して、変更されたデータをアップロードすることもできます。 |