デスクトップ統合の作業を開始する前に、Oracle ADF Desktop Integrationをサポートする各種ソフトウェアを構成する必要があります。このパートでは、各ステップを通じてこの方法を説明します。

このチュートリアルで説明しているステップを実行できるようにするには、起動用のFusion Webアプリケーションをロードして、アプリケーションがデータベースに正しく接続できることを確認する必要があります。

この作業についても、このパートで説明します。

Oracle ADF Desktop Integrationアドインは、JDeveloperまたは<JDEVELOPER_HOME>\jdeveloper\adfdi内に提供されているセットアップ・ツールからインストールできます。チュートリアルのこのパートでは、JDeveloperからアドインをインストールする方法について説明します。

1. 「スタート」→「すべてのプログラム」→「Oracle Fusion Middleware 12.1.2.0.0」→「JDeveloper Studio 12.1.2.0.0」を選択して、JDeveloperを起動します。

   Migrate User Settingsダイアログ・ボックスが開いたら、「NO」をクリックします。

2. ユーザー・ロールを設定するように指示されたら、「Studio Developer (All Features)」を選択します。

   
   

3. 「Close」をクリックして、Tip of the Dayウィンドウを閉じます。

4. JDeveloper IDEが表示されます。

   

5. 「Tools」メニューから「Install ADF Desktop Integration」を選択します。

   

6. ライセンス契約に同意します。

   

   Oracle ADF Desktop Integrationインストーラが起動します。

7. さまざまな検証チェックが実行され、準備の整っていることが確認されると、インストールを開始できる状態になります。まずは、Excel用のOracle ADF Desktop Integrationアドインの解凍が実行されます。

   

8. Oracle ADF Desktop Integrationアドインのインストールが開始されます。インストールされているソフトウェアによっては、前提条件にある別のソフトウェアをインストールするよう指示される場合があります。また、コンピュータの再起動が必要になる場合もあります。

   

9. Microsoft Officeのカスタマイズが正常に完了したら、「Close」をクリックしてインストールを終了します。

   

Oracle ADF Desktop IntegrationからMicrosoft Excelにアクセスできるようにするには、Excelを設定する必要があります。この手順は、インストールされているExcelに対して1回だけ実行する必要があります。次の手順は、マシンにインストールされているWindowsやMS Officeのバージョンによって少し異なる場合があります。

1. デスクトップで「スタート」ボタンをクリックします。

   

2. スタート・メニューから「すべてのプログラム」→「Microsoft Office」→「Microsoft Office Excel 2007」（または「Microsoft Office 2010」）を選択します。

   

3. Microsoft Excelが起動したら、「Office」ボタンをクリックします。

   

4. Officeウィンドウで、「Excelのオプション」をクリックします。

   

5. Excelのオプション・ウィンドウで「セキュリティセンター」タブを選択し、「セキュリティセンターの設定」ボタンをクリックします。

   

6. セキュリティセンター・ウィンドウで「マクロの設定」タブを選択し、続いて「VBAプロジェクトオブジェクトモデルへのアクセスを信頼する」チェック・ボックスを選択します。「OK」をクリックします。

   

7. Excelのオプション・ウィンドウに戻り、「OK」をクリックします。

   

8. Excelに戻ったら、ワークブックを閉じます。

起動用のFusion Webアプリケーションは、Oracle ADF Desktop Integrationをできる限り速やかに使用できるようにすることを目的に提供されています。 起動用のFusion Webアプリケーションをまだロードしていない場合は、こちらのリンクを使用してzipファイルをダウンロードできます。このファイルを一時ディレクトリに解凍します。

1. JDeveloperに戻り、「Open Application」リンクをクリックします（または、メイン・メニューから「File」→「Open」の順に選択します）。

   

2. Open Applicationダイアログで、adfdi_bc.zipファイルを解凍したフォルダを開き、「ADFdi_BC.jws」ファイルを選択します。「Open」をクリックします。

   

   以前のバージョンからアプリケーションを移行するよう指示されたら、承諾して処理を続行します。

3. アプリケーションのロードが完了すると、Applicationsウィンドウに2つのプロジェクトが表示されます。Applicationsウィンドウは、次のように表示されます。

   

4. JDeveloperメニュー・バーの「」Save Allアイコンをクリックするか、メニューから「File」→「Save All」の順に選択します。

アプリケーションは、データベースに接続できる必要があります。データベース接続は、起動用のアプリケーション内ですでに作成されています。このステップでは、起動用のアプリケーション内のデータベース接続がデータベースに接続できることを確認するためのタスクについて説明します。

1. 「Model」プロジェクトを右クリックし、「Project Properties」を選択します。

   

2. Connectionフィールドの横にある「Edit」アイコンをクリックします。
   
   

3. Edit Database Connectionダイアログで、以下の値が設定されていることを確認します（必要であれば修正します）。

   プロパティ	値
   Connection Name	HRConn
   Connection Type	Oracle (JDBC)
   Username	hr
   Password	hr
   Save Password	（チェック）
   Driver	Thin
   Host Name	（使用するホストの名前、例：localhost）
   JDBC Port	（使用するポート番号、例：1521）
   SID	XE（または使用するデータベースのSID）

   

4. 「Test Connection」ボタンをクリックして、接続パラメータの設定が成功したことを確認します。

   

   「OK」をクリックします。もう一度「OK」をクリックして、Applicationsウィンドウに戻ります。

5. 「Model」プロジェクト・ノードを展開し、既存のビジネス・コンポーネントをすべて表示します。この時点で、Applicationsウィンドウは、次のように表示されます。

   

6. 「AppModule」ノードを右クリックし、コンテキスト・メニューから「Run」を選択します。

   

7. Oracle ADF Model Testerが起動します。

   Business Component Browserは、ビジネス・コンポーネント・アプリケーションのテストとデバッグに非常に有効です。チュートリアルを進める前に、起動用のアプリケーションが機能していることを確認する必要があります。Business Component Browserでは、ビジネス・コンポーネントが正しく機能しているかどうか、およびアプリケーションがデータベースからデータを取得できるかどうかをテストできます。
   

8. 「DepartmentsView1」ノードをダブルクリックし、Departmentsデータを表示します。

   

9. 部門情報を参照するには、右矢印をクリックします。

   
   
   

   Business Component Browserウィンドウを閉じます。

10. JDeveloperメニュー・バーの「」Save Allをクリックするか、メニューから「File」→「Save All」の順に選択します。

これで、開発環境のセットアップが完了し、Oracle ADF Desktop Integration対応Excelワークブックの開発を開始する準備が整いました。