Oracle® Fusion Middleware Oracle Application Development Frameworkデスクトップ統合開発者ガイド 11gリリース1 (11.1.1.9.0) B66694-04 |
|
![]() 前 |
![]() 次 |
この章では、ADFデスクトップ統合Summitサンプル・アプリケーションの概要を説明します。ADFデスクトップ統合のSummitサンプル・アプリケーションには、サンプルのFusion Webアプリケーションと統合されたいくつかのMicrosoft Excelワークブックが含まれています。
この章の内容は次のとおりです。
ADFデスクトップ統合のSummitサンプル・アプリケーションは、ADFデスクトップ統合の主な機能を説明する、サンプルのデモンストレーションのセットです。各サンプルには、開発者ガイドでも確認することができる、特定の機能が含まれています。サンプルはすべて同じ基礎となるデータベース・スキーマを使用します。これにより簡単にソース・コードにアクセスでき、スタンドアロン方式で実行時の動作を経験できます。
ADFデスクトップ統合のSummitサンプル・アプリケーションをダウンロードおよび実行する前に、第3章「開発環境の設定」での説明のとおり開発環境を設定します。
ADFデスクトップ統合のSummitサンプル・アプリケーションを実行するには、次の手順を実行する必要があります。
2.2.1項「アプリケーション・リソースのダウンロード方法」の説明に従って、アプリケーション・リソースをダウンロードします。
2.2.2項「Summit ADFスキーマのインストール方法」の説明に従って、Summit ADFスキーマをインストールします。
2.2.3項「ADFデスクトップ統合のSummitサンプル・アプリケーションの実行方法」の説明に従って、Summitサンプル・アプリケーションを実行します。
Oracle Technology Networkからアプリケーション・リソースをダウンロードします。
始める前に:
Summitサンプル・アプリケーションの設定と実行に必要な手順の概要を理解しておくと役立ちます。詳細は、2.2項「ADFデスクトップ統合のSummitサンプル・アプリケーションの設定と実行」を参照してください。
アプリケーション・リソースをダウンロードする手順:
Oracle JDeveloperリリース11gをダウンロードおよびインストールします。詳細は、『Oracle JDeveloperインストレーション・ガイド』を参照してください。
ADFデスクトップ統合をインストールします。詳細は3.4項「ADFデスクトップ統合のインストール」を参照してください。
Oracle Technology NetworkからSummit ADFスキーマをダウンロードおよびインストールします。
http://www.oracle.com/technetwork/developer-tools/jdev/learnmore/adf11gsamples-1969708.html
詳細は、2.2.2項「Summit ADFスキーマのインストール方法」を参照してください。
Oracle Technology Networkから、ADFデスクトップ統合のSummitサンプル・アプリケーションのZIPファイルをダウンロードおよびインストールします。
http://www.oracle.com/technetwork/developer-tools/jdev/learnmore/adf11gsamples-1969708.html
詳細は、2.2.3項「ADFデスクトップ統合のSummitサンプル・アプリケーションの実行方法」を参照してください。
Summit ADFスキーマをインストールするには、スキーマ・ファイルを解凍し、データベース接続を構成して、build_summit_schema.sql
スクリプトをJDeveloperで実行します。
始める前に:
Summitサンプル・アプリケーションの設定と実行に必要な手順の概要を理解しておくと役立ちます。詳細は、2.2項「ADFデスクトップ統合のSummitサンプル・アプリケーションの設定と実行」を参照してください。
Summit ADFスキーマをデータベースにインストールするには:
Summit ADFスキーマ・アーカイブ・ファイルをダウンロードした場所に移動し、それを解凍します。
JDeveloperを起動し、メイン・メニューから「ファイル」→「開く」を選択します。
「開く」ダイアログで、SummitADF_Schema
ディレクトリのZIPファイルを開いた場所へ移動し、Summit_Schema.jws
アプリケーション・ワークスペースを選択して「開く」をクリックします。
「アプリケーション・ナビゲータ」ウィンドウで、「アプリケーション・リソース」パネルを開きます。
「接続」を右クリックし、「新規接続」→「データベース」を選択します。
「データベース接続の作成」ダイアログで、表2-1のように、各自の環境に合せてプロパティを変更します。ダイアログのヘルプを参照するには、[F1]を押すか「ヘルプ」をクリックします。
表2-1 Summit ADFサンプル・アプリケーションのインストールに必要なプロパティ
プロパティ | 説明 |
---|---|
接続名 |
接続のわかりやすい名前。この名前は、 |
ユーザー名 |
データベースのシステム・ユーザー。例:
|
パスワード |
システム・ユーザーのパスワード。 |
ドライバ |
データベースのJDBCドライバ。ドロップダウン・メニューから値を選択します。デフォルトはthinで、これは、Oracle Database XEおよびOracle Call Interface (OCI)を使用しない他のOracleデータベースの場合に指定するデフォルト値でもあります。 |
ホスト名 |
Oracleデータベースを実行しているサーバーの名前。IPアドレスまたはTCP/IPによって解決可能なホスト名を使用します。デフォルト値は |
SID |
Oracle Databaseインスタンスの一意のシステム識別子(SID)。デフォルトは |
JDBCポート |
データベースのポート。デフォルト値は、 |
注意: サーバーがリモート・マシンに存在する場合は、スキーマを作成するスクリプトも変更する必要が生じることがあります。スクリプトを開くには、「build_summit_schema.sql」 を右クリックして、「開く」を選択します。 |
図2-1は完成した「データベース接続の作成」ダイアログを示しています。この例では、ローカル・マシンに存在するOracle Database XEインスタンスへの接続が確立されています。
「接続のテスト」をクリックして、稼働中の接続があることを確認します。
「OK」をクリックして接続を作成し、ダイアログを終了します。
アプリケーション・ナビゲータの「プロジェクト」パネルで、「データベース」を展開し、「リソース」を展開します。
「build_summit_schema.sql」
を右クリックし、「SQL*Plusで実行」、接続名の順に選択します。
表示された接続名は、手順6で構成されたものです。
「SQL*Plus接続」ダイアログで、情報が手順6で指定した構成に一致することを確認し「OK」をクリックします。
「SQL*Plusの場所」ダイアログで、「参照」をクリックしデータベース用の実行可能ファイルsqlplus.exe
を見つけます。
通常、実行可能ファイルは$ORACLE_HOME
の下のBIN
ディレクトリにインストールされます。$ORACLE_HOME
はOracleデータベース・インストールへのパスを表しています。
「開く」をクリックして実行可能ファイル「sqlplus.exe」
を選択し、次に「OK」を選択してダイアログを終了します。
「SQL*Plus」ウィンドウで、手順6で指定したシステム・ユーザーのパスワードを入力します。
パスワードを入力すると、Antビルド・スクリプトがSummit ADFサンプル・アプリケーション・ユーザーを作成し、Summit ADFスキーマの表に移入します。メッセージ - ログ・ウィンドウに、一連のSQLスクリプトが表示され、最終的に次のようになります。
Commit complete. Commit complete. SQL>
SQLプロンプトで、quit
と入力し「SQL*Plus」ウィンドウを終了します。
JDeveloperでメイン・メニューから「アプリケーション」→「閉じる」を選択し、Summit ADFスキーマ・アプリケーションを閉じます。
Summitサンプル・アプリケーションを実行するには、zipファイルの内容を抽出し、JDeveloperで.JWS
ファイルを開きます。
始める前に:
Summitサンプル・アプリケーションの設定と実行に必要な手順の概要を理解しておくと役立ちます。詳細は、2.2項「ADFデスクトップ統合のSummitサンプル・アプリケーションの設定と実行」を参照してください。
ADFデスクトップ統合のSummitサンプル・アプリケーションを実行するには:
サンプル・アプリケーションを格納するzipファイルの内容をローカル・ディレクトリに抽出します。
JDeveloperでSummitADFdi.jws
ファイルを開きます。
このファイルはSummit_ADFDI
ディレクトリにあります。
アプリケーション・ナビゲータで、「モデル」プロジェクトをクリックして開きます。
「モデル」→「アプリケーション・ソース」→「oracle.summitdi.model」→Model.jpxファイルを開きます。
「一般」タブで「接続」グループを展開し、「追加」アイコンをクリックして、データベース接続を作成します。
「データベース接続の作成」ダイアログで、表2-2のように、各自の環境に合せて接続情報を追加します。
表2-2 ADFデスクトップ統合のSummitサンプル・アプリケーションのデータベース接続プロパティ
プロパティ | 説明 |
---|---|
ユーザー名 |
|
パスワード |
|
ホスト名 |
データベースのホスト名。 例:
|
JDBCポート |
データベースのポート。 例:
|
SID |
データベースのSID。 例:
|
「接続テスト」をクリックして接続を確認し、「OK」をクリックしてダイアログを閉じます。
Model.jpx
ファイルを保存します。
ViewControllerプロジェクトを選択して、JDeveloperのメイン・メニューの「実行」ボタンをクリックします。
ADFデスクトップ統合のSummitサンプル・アプリケーションのFusion Webアプリケーションにより、エンド・ユーザーは統合Excelワークブックをダウンロードできます。
エンド・ユーザーがJDeveloperでADFデスクトップ統合のSummitサンプル・アプリケーションを実行すると、デフォルトのブラウザでアプリケーションのホーム・ページが開きます。エンド・ユーザーは、ホーム・ページから様々な統合Excelワークブックをダウンロードできます。
ADFデスクトップ統合のSummitサンプル・アプリケーションでは、異なる要件を満たすために、様々な統合Excelワークブックが提供されます。エンド・ユーザーは、アプリケーションのMainPage.jsf
から、様々なワークブックをナビゲートおよびダウンロードできます。
表2-3に、メニュー・オプションと、ダウンロードされる統合Excelワークブックを示します。
ADFデスクトップ統合のSummitサンプル・アプリケーションには、EditCustomers.xlsx
、EditWarehouses.xlsx
、EditCustomerSearch.xlsx
およびWarehouseLocations.xlsx
統合Excelワークブックが用意されています。
EditCustomers.xlsx
ワークブックは、一般的に使用されるADFデスクトップ統合のADF表コンポーネント機能を示します。データをダウンロード、挿入、更新およびコミットできます。これは、選択リストから値を選択する複数の方法も示します。
EditWarehouseInventory.xlsx
ワークブックは、詳細な表を含むコンポーネントからADFデスクトップ統合を使用する方法を示します。マスター・フォームおよびその詳細表のデータをダウンロードおよび更新できます。このサンプルは、ワークブック・パラメータを使用してワークブックの初期化を制御する方法も示します。
EditAllInventory.xlsx
ワークブックは、非正規化されたマスター/詳細の関係を含む、編集可能な表を作成する方法を示します。これは、日付ピッカーの使用方法、列のグループ化の方法、および既存のデータ・レコードの削除方法も示します。
EditCustomerSearch.xlsx
ワークブックは、読取り専用として構成されたADF表コンポーネントにデータをダウンロードする前に、検索の実行にカスタムWebページをどのように使用できるかを示します。
この章の次の項では、ワークブックの機能の詳細な情報と実装の詳細への参照を提供します。
実行時に、ADFデスクトップ統合のSummitサンプル・アプリケーションの統合Excelワークブックは、エンド・ユーザーがFusion Webアプリケーションにログオンするのに使用できる、Excelのリボン・タブをレンダリングします。図2-3は、EditCustomers.xlsx
ワークブックのリボンの「顧客」実行時タブを示します。
EditCustomers.xlsx
ワークブックなどの一部のワークブックでは、ADF表コンポーネントを使用して、Fusion Webアプリケーションから情報をダウンロードします。このコンポーネントを使用して、エンド・ユーザーは行を編集し、変更した行をFusion Webアプリケーションにアップロードできます。
次の項では、ダウンロード機能の実装方法の詳細を説明します。
Fusion Webアプリケーションに統合するそれぞれのワークシートには、関連するページ定義ファイルが必要です。
たとえば、EditCustomers.xlsx
ワークブックのCustomers
ワークシートは、ページ定義ファイルExcelCustomers.xml
ページ定義ファイルと関連付けられています。JDeveloperでこのファイルを見るには、アプリケーション・ナビゲータで次のノードを展開します。
ViewController > 「アプリケーション・ソース」 > oracle.summitdi.view > pageDefs
ページ定義ファイルの構成方法の詳細は、4.2項「統合Excelワークブックのページ定義ファイルの使用」を参照してください。
ADF表コンポーネントDownload
アクションは、Fusion Webアプリケーションからワークシートにデータをダウンロードします。このアクションの起動方法の詳細は、7.4項「ADF表コンポーネントへのデータのダウンロード」を参照してください。
EditCustomers.xlsx
ワークブックでは、ワークシートStartup
イベントはADF表コンポーネントDownload
アクションを含むアクション・セットを起動します。ワークシート・イベントの構成の詳細は、9.2.4項「ワークシート・イベントからアクション・セットを起動する方法」を参照してください。
EditCustomers.xlsx
およびEditWarehouseInventory.xlsx
ワークブックを使用して、エンド・ユーザーは、ADF表コンポーネントおよびフォーム・コンポーネントによりFusion Webアプリケーションからダウンロードされた顧客および倉庫情報を編集できます。UpdateComponent
プロパティが構成されている実行時ADF表コンポーネントの列を使用して、エンド・ユーザーは値を変更したり、変更をFusion Webアプリケーションにアップロードできます。たとえば、エンド・ユーザーはEditCustomers.xlsxのName、PhoneおよびAddress
列に表示される値を変更できます。
StatusやChangedなど他の列は、ADF表コンポーネントに表示されて、アップロード操作や変更された列のステータス情報を提供します。
次の項では、この機能の実装方法の詳細を説明します。
ADF表コンポーネントの挿入の詳細は、7.3項「ExcelワークシートへのADF表コンポーネントの挿入」を参照してください。
StatusやChangedなど特殊な列の詳細は、7.12項「ADF表コンポーネント内の特殊な列」を参照してください。
アクション・セットの詳細は、第9章「統合Excelワークブックへの対話性の追加」を参照してください。
値リストの作成の詳細は、第8章「値リストの使用」を参照してください。
統合ワークブックを使用すると、エンド・ユーザーはADF表コンポーネントの変更済データをFusion Webアプリケーションにアップロードできます。アクション・セットが、ADF表コンポーネントのUpload
アクションを起動する「アップロード」実行時リボン・コマンド用に構成されています。この機能の実装の詳細は、7.8項「ADF表コンポーネントからの変更のアップロード」を参照してください。