Oracle ADF Desktop Integrationについて
目的
このチュートリアルでは、Oracle ADF Desktop Integration（Oracle ADFdi）で作成されたページ定義を使用してMicrosoft Excelワークシートを作成します。
90分
このチュートリアルでは、以下のトピックについて説明します。
スクリーンショットの表示
このアイコンの上にカーソルを置くと、すべてのスクリーンショットがロード
し、表示されます。（警告：すべてのスクリーンショットが同時にロードされるため、ご使用のインターネット接続によってはレスポンス・タイムが遅くなる場
合があります。）
注：各手順に関連したスクリーンショットのみを表示する場合は、それぞれの手順にあるアイコンの 上にカーソルを置いてください。スクリーンショットをクリックすると、非表示になります。
このチュートリアルでは、Oracle JDeveloperとOracle ADF Desktop Integrationを使用して、Oracle ADFのバインディング・コンポーネントを含むExcelワークシートを作成する方法について説明します。
シナリオ
始めに、Excelワークブックに必要なビジネス・コンポーネン トとページ定義バインディングがあらかじめ定義されたOracle JDeveloperのアプリケーションを使用します。次に、このアプリケーションのためのセキュリティを定義します。Oracle ADFdiに準拠したワークブックを開き、Oracle ADFマッピングを使用して読取り専用表を含むOracle ADFdiのコンポーネントを作成します。次に、Excelのダウンロード表機能を設定します。さらに、別のページ定義を使用して、LOV機能と挿入/更 新機能を含んだワークシートを定義します。
Oracle JDeveloperのアプリケーションを実行してWebLogicサーバーにデプロイしてから、Excelワークブックで設計したアプリケーションを実 行します。
最後に、このワークブックを公開します。
このチュートリアルを始める前に、次のことを確認してください。
| 1. |
Oracle JDeveloper 11g 11.1.1.2.0にアクセスできるか、またはインストール済みであること。この製品は、OTN ダウンロード・ページからダウンロードできます。任意のディレクトリにファイルをインストールしてください。このチュートリアルでは、このディレ クトリをJDEVELOPER_HOMEと呼びます。
|
| 2. |
Microsoft Office 2007にアクセスできるか、またはインストール済みであること。
|
| 3. |
こ ちらのリンクを右クリックして「対象をファイルに保存」を選択したら、任意のディレクトリ（Tempなど）にADFdi_BC.zipファ イルを保存します。
|
| 4. | 選択したディレクトリにADFdi_BC.zipファイルを 解凍します。 |
コンポーネントを作成する前に、Oracle ADFdiをサポートするように各種ソフトウェアの構成を行う必要があります。以下の手順を実行します。
以下の手順を初めて実行する場合、コンピュータの再起動が必要に なる場合があります。
 |
Oracle ADFdiのためのOracle JDeveloperの構成 | |
|
Microsoft .NET Programmability Supportの有効化 | |
|
統合されたExcelワークブックを実行 するためのExcelの構成 | |
Microsoft .NET Programmability Supportの有効化
Microsoft .NET Programmability Supportを有効にするには、以下の手順を実行します。
| 1. |
デスクトップで「スタート」ボタンをクリックします。
|
| 2. |
スタート・メニューから「コントロールパネル」を選択します。
「OK」をクリックします。
|
| 3. |
コントロールパネル・ウィンドウで、「プログラムの追加と削除」オプションをダブルクリックしま す。
|
| 4. |
インストールされているプログラムのリストが表示されたら、下方向にスクロールして「Microsoft Office Standard 2007」を選択します。
|
| 5. |
「変更」ボタンをクリックします。
|
| 6. |
「機能の追加と削除」を選択します。
「次へ」をクリックします。
|
| 7. |
「Microsoft Office」→「Microsoft Office Excel」の順にノードを開きます。「.NET Programmability Support」 を選択します。
「次へ」をクリックします。
|
| 8. |
設定が完了するまで待ちます。
「閉じる」ボタンをクリックします。
|
| 9. |
プログラムの追加と削除ウィンドウを閉じます。
|
| 10. |
コントロールパネル・ウィンドウを閉じます。
|
| 11. |
これで、Excelに対して.NET Programmability Supportが追加されました。 |
Oracle ADFdiのためのOracle JDeveloperの構成
Oracle ADFdiコンポーネントをインストールするには、以下の手順を実行します。
| 1. |
Windowsエクスプローラを開き、<JDEVELOPER_HOME>フォルダへ 移動します。
|
| 2. |
<JDEVELOPER_HOME>\jdeveloper\adfdi\bin\excel\clientフォ ルダを開き、「setup.exe」ファイルをダブルクリックします。
|
| 3. |
インストール・プロセスが開始されると、Microsoft Office Customization Installerウィンドウが表示されます。インストール前のチェック中に最初の処理が実行されます。
|
| 4. |
「Install」をクリックして、インストール・プロセスを開始します。インストールされている ソフトウェアによっては、前提条件にある別のソフトウェアをインストールするよう指示される場合があります。また、コンピュータの再起動が必要になる場合 もあります。
終了したら、「Close」をクリックします。 |
統合されたExcelワークブックを実行するためのExcelの構成
統合されたExcelワークシートを実行できるようにExcelを構成するには、以下の手順を実行します。
| 1. |
デスクトップで「スタート」ボタンをクリックします。
|
| 2. |
スタート・メニューから「すべてのプログラム」→「Microsoft Office」→「Microsoft Office Excel 2007」を選択します。
|
| 3. |
Microsoft Excelが起動されたら、「Office」ボタンをクリックします。
|
| 4. |
Officeウィンドウで、「Excel Options」ボタンをクリックします。
|
| 5. |
Excel Optionsウィンドウで「Trust Center」タブを選択し、「Trust Center Settings」ボタンをクリックします。
|
| 6. |
Trust Centerウィンドウで「Macro Settings 」タブを選択し、「Trust access to the VBA project object model」チェック・ボックスを選択します。
「OK」をクリックします。
|
| 7. |
Excel Optionsウィンドウに戻り、「OK」をクリックします。
|
| 8. |
Excelに戻ったら、アプリケーションを閉じます。
|
ModelコンポーネントとViewControllerコンポーネントを含む起動用のFusion Webアプリケーションをアップロードします。
| 1. |
「スタート」→「すべてのプログラム」 →「Oracle Fusion Middleware 11.1.1.2.0」→「JDeveloper Studio 11.1.1.2.0」を選択して、Oracle JDeveloperを起動します。
Migrate User Settingsダイアログ・ボックスが開いたら、「NO」 をクリックします。 ロールを設定するよう尋ねられたら、「Default Role」 を選択します。
Tip of the Dayウィンドウを閉じます。 JDeveloper IDEが表示されます。
|
| 2. |
「Open Application」リンクをクリックします（または、メイン・メニューから「File」 →「Open」の順に選択します）。
|
| 3. |
Openダイアログで、ADFdi_BC.zipファイルを解凍したフォルダを開き、「ADFdi_BC.jws」 ファイルを選択します。
「Open」をクリックします。以前のバージョンからアプリケーションを移行するよう指示された ら、承諾して処理を続行します。
|
| 4. |
ロードが終了したら、アプリケーション・ナビゲータに2つのプロジェクトが表示されます。アプリケーション・ナビゲータは、次のように 表示されます。
|
| 5. |
アプリケーション・ナビゲータで「ViewController」プロジェクトを右クリックし、コ ンテキスト・メニューから「Project Properties」を選択します。
|
| 6. |
Project Propertiesダイアログで「Technology Scope」ノードを選択したら、Move
ボタン「
「OK」をクリックします。これで、ViewControllerプロジェクトはADF Desktop Integrationをサポートできるようになりました。
|
| 7. | JDeveloperメニュー・バーのSave Allアイコン「 」をクリックするか、メニューから「File」
→「Save All」を選択します。 |
」を使用してProject
TechnologiesのAvailableペインからSelectedペイン
へと次のテクノロジーを移動します。ワークブックに必要な定義済みビジネス・コンポーネントに対して、データベース接続を確認または作成するには、 以下の手順を実行します。
| 1. |
「Model」プロジェクトを右クリックし、コンテキスト・メニューから「Project Properties」を選択します。
|
||||||||||||||||||
| 2. |
Project Propertiesウィンドウで「Business Components」ノードを選択したら、接続フィールドの横にある「Edit」アイコンをク リックします。
|
||||||||||||||||||
| 3. |
Edit Database Connectionダイアログで、以下の値を入力します。
|
||||||||||||||||||
| 4. |
「Test Connection」ボタンをクリックして、接続パラメータの設定が成功したことを 確認します。
「OK」をクリックします。
|
||||||||||||||||||
| 5. |
「Model」プロジェク・ノードを開き、既存のビジネス・コンポーネントをすべて表示します。ア プリケーション・ナビゲータは、次のように表示されます。
|
||||||||||||||||||
| 6. |
「AppModule」ノードを右クリックし、コンテキスト・メニューから「Run」 を選択します。
|
||||||||||||||||||
| 7. |
Business Component Browserウィンドウが表示されます。
|
||||||||||||||||||
| 8. |
「DepartmentsView1」ノードをダブルクリックし、Departmentsデータを 表示します。
各部門を順に表示するには、右矢印をクリックします。
|
||||||||||||||||||
| 9. |
AppModuleブラウザ・ウィンドウを閉じます。
|
||||||||||||||||||
| 10. |
JDeveloperメニュー・バーのSave Allアイコン「 |
Oracle ADFdiワークブックを実行するには、認証ステップを使用する必要があるため、アプリケーションを保護する必要があります。アプリケーションを保護する には、以下の手順を実行します。
| 1. |
ExcelでOracle ADFdiを実行できるようにするには、アプリケーションを保護する必要があります。メイン・メニューから「Application」 →「Secure」→「Configure ADF Security」の順に選 択します。
|
| 2. |
Enable ADF Securityダイアログで、「ADF Authentication」 を選択します。
「Next」をクリックします。
|
| 3. |
Select Authentication typeページで、「HTTP Basic Authentication」を選択します。
「Next」をクリックし、もう一度「Next」をクリックし ます。
|
| 4. |
Summaryページで、「Finish」をクリックします。
|
| 5. |
Security Infrastructure Createdウィンドウで「OK」をクリック します。
|
| 6. |
アプリケーション・ナビゲータは、次のように表示されます。
アプリケーション・ナビゲータのweblogic.xmlエントリにセキュリティ・ロールの割当て プロパティが表示されていることを確認します。
|
| 7. | JDeveloperメニュー・バーのSave Allアイコン「」をクリックするか、メニューから「File」
→「Save All」を選択します。 |
DepartmentListワークシートを作成するには、以下の手順を実行します。
| 1. |
Windowsエクスプローラで、アプリケーションが格納されているフォルダ（C:|JDeveloper\mywork\ADFdi_BC\ViewController \public_html）を開き、Excelという名前の新規フォルダを 作成します。
|
| 2. |
<JDEVELOPER_HOME>\jdeveloper\adfdi\bin\excel\clientフォ ルダにあるadfdi-client.xlsxファイルをコピーします。
先ほど作成したExcelフォルダにこのファイルを貼り付けます。
|
| 3. |
adfdi-client.xlsxからDepartmentsList.xlsxへ と名前を変更します。
|
| 4. |
もう一度adfdi-client.xlsxファイルをExcelディレクトリにコピーし、EditDept_LOVと いう名前に変更します（このファイルは後ほど使用します）。
|
| 5. |
JDeveloperで「ViewController」ノードを選択し、Refreshアイコン
「
|
| 6. |
これで、DepartmentsList.xlsxとEditDept_LOV.xlsxの 両方のファイルがアプリケーション・ナビゲータに表示されました。
|
」をクリックします。 DepartmentPage.jspxバインディングに基づいて読取り専用表のワークブック・バインディング を定義するには、以下の手順を実行します。
| 1. |
アプリケーション・ナビゲータで「DepartmentsList.xlsx」をダブルクリック し、Microsoft Excelで開きます。
|
| 2. |
Excelが開くと、Oracle ADF Desktop Integrationがロードされ ます。
|
| 3. |
Page Definitionダイアログで「ADFdi_view_DepartmentPagePageDef」 ページ定義を選択します。
「OK」をクリックします。
|
| 4. |
Excel内にDocument Actionsウィンドウが開き、ページ定義から利用できるバイ ンディングが表示されます。
|
| 5. |
ワークブック内の任意のセルを選択し、Bindingsタブか ら「DepartmentsView1」を選択して「Insert Binding」 をクリックします。
|
| 6. |
Select Componentダイアログで「ADF Read-only Table」を選択 します。
「OK」をクリックします。
|
| 7. |
Insert Component: ADF Read-only Tableダイアログで、「OK」 をクリックしてデフォルト値を受け入れます。
|
| 8. |
Excelワークブックは次のように表示されます。
|
| 9. |
「Save」アイコンをクリックしてワークブックを保存します。
保存する際、次の警告メッセージが表示される場合があります。"プライバシーに関する注意：このドキュメントには、マ
クロ、ActiveXコントロール、XML拡張パック・・・が含まれています。"
|
| 10. |
Oracle JDeveloperに戻り、「ViewController」プロジェクトを右ク リックし、コンテキスト・メニューから「Project Properties」を選択します。
|
| 11. |
Project Propertiesダイアログに戻り、「Java EE Application」 ノードを選択したら、Java EE Web Application NameフィールドとJava EE Web Context RootフィールドにADFdi_BCと入力します。
「OK」をクリックします。
|
| 12. |
Excelに戻り、Document Actionsペインで「Workbook Properties」 リンクをクリックします。
|
| 13. |
Edit Workbook PropertiesダイアログのWebAppRootフィールドの横に、http://127.0.0.1:7101/ADFdi_BCと 入力します。
|
| 14. |
WebPagesFolderの横のmoreボタン「
「OK」をクリックします。
|
| 15. |
「Login」セクションを開き、「ProtectedWebPage」フィールド
をクリックします。ProtectedWebPageフィールドのmoreボタン「
|
| 16. |
Browse For Folderダイアログで「ADFdi_BC」→「ViewController」 →「public_html」の順に選択します。
「OK」をクリックします。
|
| 17. |
Select Pageダイアログでは、ページの接頭辞として/facesがあらかじめ指定されて います。ページの選択で、「/StarterPage.jspx」を選択します。
「OK」をクリックします。StarterPageは、アプリケーションを起動するための空のペー ジです。
|
| 18. |
ワークブックのプロパティは次のように表示されます。
「OK」をクリックして、Edit Workbook Propertiesダイアログを閉じます。
|
| 19. |
Document Actionsペインで「Worksheet Properties」リンクを クリックします。
|
| 20. |
Eventsフィールドの横のmoreボタン「
|
| 21. |
WorksheeetEvent Collection Editorダイアログで、「Add」ボ
タンをクリックしてStartupメンバーを追加します。「ActionSet」ノードを開き、Actionsフィー
ルドの横のmoreボタン「
|
| 22. |
Action Collection Editorダイアログで、「Add」ボタンをクリックして ドロップダウン・リストから「ComponentAction」を選択します。
|
| 23. |
Actionフィールドの横のmoreボタン「
|
| 24. |
Choose Component Actionダイアログで「Download」を選択します。
「OK」をクリックします。 スクリーンショットの表ID（ROT564951997）は実際のIDとは異なります。
|
| 25. |
WorksheeetEvent Collection Editorダイアログで、ActionsのAnnotationフィー ルドにDownLoad_Dataと入力します。
「OK」をクリックします。Edit Worksheet Propertiesダイアログに戻り、「OK」をクリックします。
|
| 26. |
「Add-Ins」ボタンをクリックして、Oracle ADFdiカスタム・ツールバーを表示します。
|
| 27. |
ここで作成したワークブックはBook1.xlsxを変換したワークシートをベースとしています が、それぞれのOracle ADFdiワークシートには一意の識別子が必要であるため、「Tools」→「Reset WorkbookID」の順に選択して新しい識別子を作成します。
|
| 28. |
Reset WorkbookID警告ダイアログで「Yes」をクリックしてIDをリセットしま す。
Reset WorkbookIDの情報ダイアログで、「OK」をクリックします。
|
| 29. |
Excelワークブックを保存します。
|
| Excelを終了します。 |
」をクリックします。Browse
For Folderダイアログで「ADFdi_BC」→「ViewController」→「public_html」
の順に選択します。ページをテストするには、以下の手順を実行してください。
| 1. |
Oracle JDeveloperに戻り、「StarterPage.jspx」ノードを右ク リックしてコンテキスト・メニューから「Run」を選択します。
|
| 2. |
WebLogicサーバーが起動し、ブラウザ・ウィンドウが開くまで待ちます。Authentication Requiredダイアログで、User nameフィールドにweblogicを、Passwordフィールドにweblogic1を 入力します。
「OK」をクリックします。
|
| 3. |
起動ページがロードされ、Starter Pageというテキストが表示されます。
|
| 4. |
これでWebLogicサーバーへのページのデプロイは完了しました。次に、Excelワークブックを実行します。 JDeveloperに戻ります。「DepartmentList.xlsx」ノードをダブルクリックして、 Microsoft Excelで開きます。
|
| 5. |
ページにワークブックがロードされます。「Add-Ins」ボタンをクリックします。
|
| 6. |
カスタム・ツールバーで、Runアイコン「
|
| 7. |
Loginの警告ダイアログで「Yes」をクリックして接続を開始します。
|
| 8. |
Connectダイアログで、User nameフィールドにweblogicを、 Passwordフィールドにweblogic1を入力します。
|
| 9. |
DepartmentListの値が返され、ワークシートに表示されます。
|
| 10. |
必要に応じて、レイアウトを見やすくするためにワークシート・セルの配置を変更します。
|
| 11. |
Oracle ADFdiツールバーの「Stop」ボタンをクリックします。
|
| 12. |
Excelアプリケーションを保存せずに終了します。ここまでで、データベース表から自動的にデー タをダウンロードする基本的なExcelワークシートの作成が完了しました。 |
」をクリックします。更新可能な表のワークブック・バインディングを定義するには、以下の手順を実行します。
| 1. |
アプリケーション・ナビゲータで「EditDept_LOV.xlsx」をダブルクリックし、 Microsoft Excelで開きます。
|
| 2. |
Excelが開くと、Oracle ADF Desktop Integrationがロードされ ます。
|
| 3. |
Page Definitionダイアログで、「ADFdi_view_EditTable_LOVPageDef」 ページ定義を選択します。
「OK」をクリックします。
|
| 4. |
Excel内にDocument Actionsウィンドウが開き、ページ定義から利用できるバイ ンディングが表示されます。
|
| 5. |
ワークブック内の任意のセルを選択し、Bindingsタブか ら「DepartmentsView1」を選択して「Insert Binding」 をクリックします。
|
| 6. |
Select Componentダイアログで「ADF Table」を選択します。
「OK」をクリックします。
|
| 7. |
Insert Component: ADF Tableダイアログで、「OK」をクリックしてデ フォルト値を受け入れます。
|
| 8. |
Excelワークブックは次のように表示されます。
更新可能な表であるため、情報を表示するために最初の3列が自動的に生成されています。
|
| 9. |
「Add-Ins」ボタンをクリックして、Oracle ADFdiカスタム・ツールバーを表示します。
|
| 10. |
このワークブックもBook1.xlsxを変換したワークシートをベースとしていますが、それぞれ のOracle ADFdiワークシートには一意の識別子が必要であるため、「Tools」→「Reset WorkbookID」の順に選択して新しい識別子を作成します。
|
| 11. |
Reset WorkbookID警告ダイアログで「Yes」をクリックしてIDをリセットしま す。
Reset WorkbookIDの情報ダイアログで、「OK」をクリックします。
|
| 12. |
Saveアイコン「 |
」をクリックしてワークブックを保存しま
す。 EditDept_LOVワークブックに定義するワークブック・プロパティは、上述の項で DepartmentsList.xlsxワークブックに定義したものと同じです。したがって、DepartmentsList.xlsxでワークブッ ク・プロパティを定義した直後にファイルを別名で保存しておくと、この手順を繰り返す必要がなくなります。
ワークブック・プロパティを定義するには、以下の手順を実行します。
| 1. |
Document Actionsペインで「Workbook Properties」リンクをク リックします。
|
| 2. |
Edit Workbook PropertiesダイアログのWebAppRootフィールドの 横に、http://127.0.0.1:7101/ADFdi_BCと 入力します。
|
| 3. |
WebPagesFolderの横のmoreボタン「
「OK」をクリックします。
|
| 4. |
「Login」セクションを展開し、「ProtectedWebPage」
フィールドをクリックします。ProtectedWebPageフィールドのmoreボタン「
|
| 5. |
Browse For Folderダイアログで「ADFdi_BC」→「ViewController」 →「public_html」の順に選択します。
「OK」をクリックします。
|
| 6. |
Select Pageダイアログでページの接頭辞として/facesがあらかじめ指定されていま す。ページの選択で、「/StarterPage.jspx」を選択します。
「OK」をクリックします。
|
| 7. |
ワークブックのプロパティは次のように表示されます。
「OK」をクリックして、Edit Workbook Propertiesダイアログを閉じます。 |
表のプロパティを定義するには、以下の手順を実行します。
| 1. |
Excelワークシートに表示された表の左端のセル（B2など）を選択し、カスタム・ツールバーのプロパティ･アイコン「
|
||||||
| 2. |
Edit Component: ADF Tableダイアログで、Unique Attributeフィー
ルドの横にあるmoreボタン「
|
||||||
| 3. |
Select Tree Binding Attributeダイアログで「DepartmentsView1 (tree)」→「DepartmentsView」→「DepartmentId」 の順に選択します。
「OK」をクリックします。
|
||||||
| 4. |
「RowActions」ノードを開き、DeleteRowActionIdフィー
ルドの横のmoreボタン「
Select Bindingダイアログで「Delete」アクションを選択します。
「OK」をクリックします。
|
||||||
| 5. |
InsertBeforeRowActionIdフィールドに対して前の手順を繰り返し、「CreateInsert」 アクションを選択します。
|
||||||
| 6. |
RowActionsセクションで次の値を設定します。
RowActionsプロパティは次のように表示されます。
|
||||||
| 7. |
BatchOptionsセクションで、CommitBatchActionIDにCommitを 設定します。
|
||||||
| 8. |
Edit Componentダイアログで、Columnsフィールドの隣にあるmoreボ
タン「
|
||||||
| 9. |
「Add」をクリックして新規列を追加してから、HeaderLabelフィー
ルドの横にあるmoreボタン「
|
||||||
| 10. |
Edit Expressionダイアログで、「bindings」→「DepartmentsView1」 →「DepartmentsView」→「hints」→「LocationId」 →「label」の順に開き、「Insert Into Expression」 ボタンをクリックします。
「OK」をクリックします。
|
||||||
| 11. |
UpdateComponentフィールドの横のmoreボタ
ン「
|
||||||
| 12. |
Select subcomponent to createダイアログで、「TreeNodeList」 を選択して「OK」をクリックします。
|
||||||
| 13. |
「UpdateComponent」ノードを開き、Listフィー
ルドの横のmoreボタン「
|
||||||
| 14. |
Select Tree Binding Attributeで、「LocationId」を選択 して「OK」をクリックします。
|
||||||
| 15. |
6列目を選択したら、「Remove」ボタンをクリックして元 のLocationId列を削除します。次に、LOV機能をサポートしている新規列で置き換えます。
|
||||||
| 16. |
3列目（DepartmentId）を選択し、「UpdateComponent」 ノードを開きます。ReadOnlyプロパティにTrueと入力します。
「OK」をクリックします。「OK」をクリックして、Edit Componentダイアログを閉じます。
|
||||||
| 17. |
Excelワークブックを保存します。
|
」をクリックします。 ここでは、以下のボタンを定義して追加のバインディング･プロパティを設定します。
|
ダウンロード・ボタンの定義 | |
|
削除ボタンの定義 | |
|
アップロード・ボタンの定義 | |
ダウンロード・ボタンの定義
ここでは、ワークシートを実行すると自動的にデータをダウンロードする代わりに、問合せアクションを実行するボ タンを追加します。ボタン・プロパティを定義するには、以下の手順を実行します。
| 1. |
Document Actionsペインで「Components」タブをクリックし、ワークシー トのセル（A1など）を選択したら、「ADF Button」コンポーネントを選択して「Insert Component」をクリックします。
|
| 2. |
Insert Component: ADF Buttonで「ActionOptions」ノー
ドを開き、Actionsフィールドの横のmoreボタン「
|
| 3. |
Action Collection Editorダイアログで、「Add」ボタンをクリックして ドロップダウン・リストから「ADFmAction」を選択します。
|
| 4. |
ActionIDフィールドの横のmoreボタン「
|
| 5. |
Select Bindingダイアログで「Execute」アクションを選択します。
「OK」をクリックします。
|
| 6. |
「OK」をクリックしてAction Collection Editorへ戻り、DesignのAnnotationフィー ルドにExecuteと入力します。
|
| 7. |
Action Collection Editorダイアログで、「Add」ボタンをクリックして ドロップダウン・リストから「ComponentAction」を選択します。
|
| 8. |
Actionフィールドの横のmoreボタン「
|
| 9. |
Choose Component Actionダイアログで「Download」を選択します。
「OK」をクリックします。
|
| 10. |
Action Collection Editorへ戻り、DesignのAnnotationフィー ルドにDownloadと入力します。
「OK」をクリックします。
|
| 11. |
Insert Component: ADF Buttonに戻り、LabelフィールドにQueryと 入力します。
「OK」をクリックします。
|
| 12. |
Excelワークブックを保存します。
|
行削除ボタンのためのプロパティの 定義
確認ダイアログ付きの行削除ボタン用にプロパティを定義するには、以下の手順を実行します。
| 1. |
ボタンを配置するセル（C1など）をワークシートで選択したら、Componentsペインで「ADF Button」を選択して「Insert Component」ボタンをクリックします。
|
||||||||
| 2. |
Insert Componentで「ClickActionSet」→「ActionOptions」
の順に開き、Actionsフィールドの横のmoreボタン「
|
||||||||
| 3. |
「Add」ボタンをクリックし、ドロップダウン・リストから「Confirmation」 を選択します。
|
||||||||
| 4. |
Dataセクションに次の値を入力します。
|
||||||||
| 5. |
「Add」ボタンをクリックし、ドロップダウン・リストから「ComponentAction」 を選択します。
|
||||||||
| 6. |
ComponentActionプロパティでActionフィールドの横のmoreボ
タン「
|
||||||||
| 7. |
Choose Component Actionダイアログで「DeleteFlaggedRows」 を選択します。
「OK」をクリックします。再度「OK」をクリックします。
|
||||||||
| 8. |
Insert Component: ADF Buttonで、LabelフィールドにDelete Flaggedと 入力します。
「OK」をクリックします。 |
アップロード・ボタンのためのプロ パティの定義
データベースへの変更をコミットするアップロード・ボタン用のプロパティを定義するには、以下の手順を実行しま す。
| 1. |
ボタンを配置するセル（E1など）をワークシートで選択したら、Componentsペインで「ADF Button」を選択して「Insert Component」ボタンをクリックします。
|
| 2. |
Insert Componentで「ClickActionSet」→「ActionOptions」
の順に開き、Actionsフィールドの横のmoreボタン「
|
| 3. |
「Add」ボタンをクリックし、ドロップダウン・リストから「ComponentAction」 を選択します。
|
| 4. |
ComponentActionプロパティでActionフィールドの横のmoreボ
タン「
|
| 5. |
Choose Component Actionダイアログで「Upload」を選択します。
「OK」をクリックします。再度「OK」をクリックします。
|
| 6. |
Insert Component: ADF Buttonで、LabelフィールドにUploadと 入力します。
「OK」をクリックします。
|
| 7. |
ワークシートは次のように表示されます。
|
| 8. |
「Save」アイコンをクリックしてワークブックを保存します。
|
| Excelを終了します。 |
これでWebLogicサーバーへのアプリケーションのデプロイは完了したので、次の手順を実行して、ワーク シートでLOV機能の編集とテストを行います。
| 1. |
デフォルト・サーバーが実行中のままであることを確認したらOracle JDeveloperに戻り、「EditDept_LOV.xlsx」 をダブルクリックしてもう一度Excelで開きます。
|
| 2. |
Excelにワークシートが表示されます。
|
| 3. |
「Add-Ins」メニュー・オプションをクリックして、ADFdiカスタム・ ツールバーを表示します。
|
| 4. |
カスタム・ツールバーの「Run」ボタンをクリックします。
|
| 5. |
ログインの情報ダイアログで「Yes」をクリックします。
User nameフィールドとPasswordフィールドにアカウントを入力します（weblogic/weblogic1）。
「OK」をクリックします。
|
| 6. |
ADFコンポーネントを表示したワークシートがロードされますが、データはまだ表示されていません。
|
| 7. |
見出し行のセル・サイズを再設定し、「Query」ボタンをク リックします。
問合せ処理が開始されます。
|
| 8. |
取得されたデータが表示されます。
|
| 9. |
ワークシートの最下部へ移動したら、最後の行の1つ上のセルを右クリックし、「Insert」→「Entire row」を選択します。
新しいDepartmentNameの値を入力し、ドロップダウン・リストから都 市を選択します。
この行のChanged列には、自動的にフラグが付きます。もう1行追加し ます。
|
| 10. |
既存の行に対して、ドロップダウン・リストを使用してロケーションを変更してみます。
|
| 11. |
「Upload」ボタンをクリックし、変更を検証します。
Upload Optionsで「Download all rows after successful upload」を選択します。
「OK」をクリックします。フラグが削除され、新しい行のDepartmentIdの 値が生成されていることを確認します。
Status列から、更新処理が成功したことが分かります。
|
| 12. |
Flagged列（Status列の左）で、先ほど追加した2行をクリックします。
「Delete Flagged」ボタンをクリックします。
先ほど作成したDelete Confirmationダイアログで、「Yes」をクリックしま す。
|
| 13. |
ワークシートが更新されています。
|
| 14. |
「Stop」ボタンをクリックしてデザイン・モードに戻ります。
|
問合せ、削除、アップロード機能を持ったADFボタンの作成と同じ方法で、ワークシートにメニュー項目を作成で きます。問合せアクションのメニュー・オプションを作成するには、以下の手順を実行します。
| 1. |
Document Actionsペインで「Worksheet Properties」リンクを クリックします。
|
| 2. |
Edit Worksheet Propertiesで、MenuItemsフィールドの横にあるmoreボ
タン「
|
| 3. |
WorksheetMenuItem Collection Editorで、「Add」ボタンを クリックしてWorksheetMenuItemを追加します。
|
| 4. |
「SelectActionSet」→「ActionOptions」
の順にノードを開き、Actionsフィールドの横のmoreボタン「
|
| 5. |
Action Collection Editorダイアログで、「Add」ボタンをクリックして ドロップダウン・リストから「ADFmAction」を選択します。
|
| 6. |
ActionIDフィールドの横のmoreボタン「
|
| 7. |
Select Bindingダイアログで「Execute」アクションを選択します。
「OK」をクリックします。
|
| 8. |
「OK」をクリックしてAction Collection Editorへ戻り、DesignのAnnotationフィー ルドにExecuteと入力します。
|
| 9. |
Action Collection Editorダイアログで、「Add」ボタンをクリックして ドロップダウン・リストから「ComponentAction」を選択します。
|
| 10. |
Actionフィールドの横のmoreボタン「
|
| 11. |
Choose Component Actionダイアログで「Download」を選択します。
「OK」をクリックします。
|
| 12. |
Action Collection Editorへ戻り、DesignのAnnotationフィー ルドにDownloadと入力します。
「OK」をクリックします。
|
| 13. |
WorlsheetMenuItem Collection Editorに戻り、LabelフィールドにQueryと 入力します。
「OK」をクリックします。再度、「OK」をクリックします。
|
| 14. |
「Save」ボタンをクリックしたら、Runアイコン「
|
| 15. |
ログインの入力を指示されたら「Yes」をクリックします。
|
| 16. |
Connectダイアログで、デフォルトのユーザー名とパスワード（weblogic/weblogic1） を入力します。
|
| 17. |
「Oracle ADF 11g Desktop Integration」メニュー・オプション をクリックし、「Query」を選択します。
|
| 18. |
Queryボタンを使用した場合と同じようにデータが表示されます。
その他のボタンについても同じ手順を繰り返すことで、残りのメニュー項目のエントリを作成できます。
|
| 19. |
「Stop」ボタンをクリックしてデザイン・モードに戻ります。
|
| 20. |
変更を保存します。
|
| Excelを終了します。 |
ワークブックを公開するには、以下の手順を実行します。
| 1. |
Oracle JDeveloperに戻り、「DepartmentList.xlsx」ノードを ダブルクリックしてExcelで開きます。
|
| 2. |
「Office Button」をクリックします。
|
| 3. |
Officeダイアログで、「Excel Options」ボタンをクリックします。
|
| 4. |
Excel Optionsで、「Trust Center 」ボタンをクリックします。
|
| 5. |
Trust Centerページで「Trust Center Settings」ボタンをクリッ クします。
|
| 6. |
Trust Center Settingsで「Trusted Locations」タブをク リックします。
|
| 7. |
「Allow Trusted Locations on my network」チェック・ボッ クスを選択し、「Add New Location」ボタンをクリックします。
|
| 8. |
Microsoft Office Trusted Locationダイアログで、WebAppRootのURL（例：http://localhost:7101/ADFdi_BC） を入力します。「Subfolders」オプションを選択します。
「OK」をクリックします。再度「OK」をクリックして Excel Optionsを終了します。
|
| 9. |
DepartmentListワークブックで「Add-ins」メニュー・オプションを選択してか ら、Oracle ADFdiツールバーの「Publish」アイコンをクリックします。
|
| 10. |
Publish Workbookダイアログが開き、現在のExcelフォルダが表示されます。「create directory」アイコンをクリックして、公開するワークブック専用のロケーションを作成します。
|
| 11. |
フォルダ名としてDeployed_XLSを入力したら、「Open」 ボタンをクリックします。
|
| 12. |
ファイル名にDepartmentList_dpdと入力したら、「Save」 をクリックします。
|
| 13. |
Publish Workbookダイアログで「Yes」をクリックします。
|
| 14. |
Publish Workbookの情報ダイアログで「OK」をクリックします。
|
| 15. |
Saveアイコン「
|
| 16. |
Excelを終了します。これでワークブックの公開が完了し、アプリケーションとともに WebLogicサーバーへデプロイする準備が整いました。 |
これで、Oracle ADFdiの概要についての学習が完了しました。
このチュートリアルでは、Oracle JDeveloperとOracle ADFdiの使用方法について学習し、以下のタスクを実行しました。
|
Oracle JDeveloper ADFdiをサポートする環境の構成 |
|
Oracle ADFdiをサポートするための.xlsxワークシートの変換 |
|
起動用のFusion Webアプリケーションのロード |
|
アプリケーションの保護 |
|
ビジネス・コンポーネントに対する接続の確認 |
|
DepartmentListワークブックの作成 |
|
ワークブック・バインディングの定義 |
|
ページのデプロイとワークブックのテスト |
|
EditDept_LOVワークシートの定義 |
|
ワークブックのプロパティの設定 |
|
ワークシートのプロパティの設定 |
|
表のプロパティの設定 |
|
ワークシートへのボタンの追加 |
|
EditDept_LOVワークシートの実行 |
|
ワークシートへのメニュー項目の追加 |
|
ワークシートの公開 |
このアイコンの上にカーソルを置くと、すべてのスクリーンショットが非表示になります。