Oracle® Fusion Middleware Oracle Application Development Frameworkデスクトップ統合開発者ガイド 11gリリース1(11.1.1.6.0) B66694-01 |
|
![]() 前 |
![]() 次 |
この章では、ADFデスクトップ統合により提供される開発ツール(バインディング・パレット、コンポーネント・パレット、プロパティ・インスペクタ、式ビルダーなど)の使用方法について説明します。また、Oracle ADFがExcel内で公開する開発環境の概要と、この環境の様々な要素の表示および使用についても説明します。
この章の内容は次のとおりです。
ADFデスクトップ統合には、Oracle ADF機能にアクセスできるようにExcelワークブックを構成するためのツールがいくつかあります。これらのツールは、「Oracle ADF」タブとADFデスクトップ統合のデザイナ作業ウィンドウで使用できます。
開発ツールの使用を開始する前に、Fusion Webアプリケーションに統合するExcelワークブックを構成する際に、2つのモードがあることを知っておく必要があります。最初のモードは設計モードで、2番目がテスト・モードです。
設計モードでは、Oracle ADFで提供されるツールをExcelで使用して、統合Excelワークブックを設計および構成します。テスト・モードでは、エンド・ユーザーが公開された統合Excelワークブックで見るのと同じようにして、設計モードで行う変更を表示およびテストできます。
「Oracle ADF」タブ(図5-1)には、設計モードで様々なボタンが用意されています。
「Oracle ADF」タブのボタンを使用して、表5-1に示すアクションを起動できます。
表5-1 Oracle ADFタブのオプション
グループ | クリックするボタン | アクション | ボタンが使用可能なモード |
---|---|---|---|
ワークブック |
![]() |
「ワークブック・プロパティの編集」ダイアログを表示して、統合Excelワークブックのプロパティを閲覧および編集します。 このボタンは、ADFデスクトップ統合を統合Excel以外のワークブックで有効にするときにも使用します。 |
設計 |
ワークブック |
![]() |
「ワークシート・プロパティの編集」ダイアログを表示して、現在のワークシートのプロパティを閲覧および編集します。 |
設計 |
ワークブック |
![]() |
統合Excelワークブックのバージョンとプロパティ情報を提供する、Oracle ADF 11gデスクトップ統合の詳細ダイアログを開きます。 このボタンは、ADFデスクトップ統合のインストール後は統合Excel以外のワークブックでも使用可能です。 |
設計、テスト、ランタイム |
ADFコンポーネント |
![]() |
選択したセルに挿入可能なOracle ADFコンポーネントのドロップダウン・リストを表示します。 |
設計 |
ADFコンポーネント |
![]() |
選択したコンポーネントのコンポーネント・プロパティを閲覧および編集する「プロパティ・インスペクタ」ウィンドウを表示します。 |
設計 |
ADFコンポーネント |
![]() |
選択したコンポーネントをExcelワークシートから削除します。 |
設計 |
ADFコンポーネント |
![]() |
JDeveloperのページ定義ファイルに加えたすべての変更が、Excelワークブックで使用可能になります。詳細は、4.3.3項「Excelワークブックへのページ定義ファイルのリロード」を参照してください。 |
設計 |
テスト |
![]() |
Excelワークブックを設計モードからテスト・モードに切り替えます。このボタンは、設計モードの場合のみアクティブになります。 |
設計 |
テスト |
![]() |
Excelワークブックをテスト・モードから設計モードに切り替えます。このボタンは、テスト・モードの場合のみアクティブになります。 設計モードとテスト・モードの切替えの詳細は、13.3項「統合Excelワークブックのテスト」を参照してください。 |
テスト |
ロギング |
![]() |
クライアント・サイドのログ・エントリを確認するダイアログを表示します。詳細は、C.3.2項「クライアント・サイド・ロギングの概要」を参照してください。 |
設計、テスト |
ロギング |
![]() |
ADFデスクトップ統合の構成ファイルをリロードします。詳細は、C.3.2項「クライアント・サイド・ロギングの概要」を参照してください。 |
設計、テスト |
ロギング |
![]() |
クライアント・サイド・ログ出力レベルを選択する出力レベルの設定ダイアログを表示します。詳細は、C.3.2項「クライアント・サイド・ロギングの概要」を参照してください。 |
設計、テスト |
ロギング |
![]() |
クライアント・サイド・ログ出力ファイルとして機能する新しい一時ロギング・リスナーを作成します。詳細は、C.3.2項「クライアント・サイド・ロギングの概要」を参照してください。 |
設計、テスト |
公開 |
![]() |
ExcelワークブックとFusion Webアプリケーションの統合を完了した後に、Excelワークブックを公開します。 統合されたExcelワークブックの公開の詳細は、第14章「統合Excelワークブックのデプロイ」を参照してください。 |
設計 |
ヒント: すばやく簡単にアクセスするには、Excelのクイック アクセス ツール バーに「Oracle ADF」タブ・ボタンを追加できます。 |
図5-2に、ADFデスクトップ統合デザイナの作業ウィンドウを示します。
ADFデスクトップ統合デザイナの作業ウィンドウは、図5-3に示す「Oracle ADF」タブのワークブックおよびADFコンポーネント・グループの右下にあるランチャ・ボタンから起動できます。
表5-2は、作業ウィンドウに表示されるビュー・タブおよびリンクの一覧と各項目の簡単な説明です。
表5-2 ADFデスクトップ統合デザイナの作業ウィンドウの概要
バインディング・パレットには、Excelワークシートに挿入できるOracle ADFバインディングが表示されます。現在のExcelワークシートのページ定義ファイルによって、バインディング・パレットに表示されるOracle ADFバインディングが決まります。図5-4に、Oracle ADFバインディングが移入された、ADFデスクトップ統合デザイナの作業ウィンドウのバインディング・パレットを示します。バインディング・パレットには統合Excelワークブックが使用できないバインディングは表示されない点に注意してください。表示されるバインディングは、JDeveloperで閲覧するページ定義ファイルに表示されるものとは異なる場合があります。
バインディングを挿入するには、設計モードでバインディング・パレットを使用します。バインディングを挿入しようとする際、ADFデスクトップ統合は選択したバインディングを参照するOracle ADFコンポーネントを挿入します。また、ADFデスクトップ統合もOracle ADFコンポーネントのプロパティに適切な値を移入します。たとえば、図5-4に示すようにCommit (action)のようなバインディングを挿入する場合、Oracle ADFボタン・コンポーネントのプロパティ・インスペクタが表示されます。このOracle ADFボタン・コンポーネントには、ClickActionSet
にCommit
アクション・バインディングの起動を含む値が指定されています。
Oracle ADFバインディングを挿入するには、Excelワークシート内のバインディングを参照する、Oracle ADFコンポーネントを配置するセルを選択し、次のいずれかの方法でバインディングを挿入します。
挿入するOracle ADFコントロール・バインディングをダブルクリックします。
コントロール・バインディングを選択して、ADFデスクトップ統合デザイナの作業ウィンドウでバインディングの挿入をクリックします。
挿入しようとしているバインディングに関連するOracle ADFコンポーネントのプロパティ・インスペクタが表示されます。場合によっては、複数のOracle ADFコンポーネントをバインディングと関連付けることが可能なOracle ADFコンポーネントのリストから、Oracle ADFコンポーネントを1つ選択するよう求められることがあります。リストからOracle ADFコンポーネントを1つ選択すると、プロパティ・インスペクタが表示されます。
コンポーネント・パレットには、Excelワークシートに挿入できるADFデスクトップ統合コンポーネントが表示されます。図5-5に、ADFデスクトップ統合デザイナの作業ウィンドウで表示されるコンポーネント・パレットを示します。
Oracle ADFコンポーネントを挿入するには、設計モードでコンポーネント・パレットを使用します。まず、Excelワークシート内でOracle ADFコンポーネントを配置するセルを選択し、次のいずれかの方法でOracle ADFコンポーネントを挿入します。
挿入するOracle ADFコンポーネントをダブルクリックします。
コンポーネントを選択して、ADFデスクトップ統合デザイナの作業ウィンドウでコンポーネントの挿入をクリックします。
どちらの場合でも、Oracle ADFコンポーネントのプロパティ・インスペクタが表示されます。プロパティ・インスペクタを使用して、Excelワークシートへの挿入を完了する前にコンポーネントに値を指定します。
注意: ADFデスクトップ統合コンポーネントは、「Oracle ADF」タブのコンポーネントの挿入ドロップダウン・リストからも使用できます。 |
プロパティ・インスペクタは、Oracle ADFバインディング、Oracle ADFコンポーネント、ExcelワークシートまたはExcelワークブックのプロパティを表示および編集できるダイアログです。プロパティ・インスペクタは次のいずれかの方法で開くことができます。
コンポーネントまたはバインディングを選択し、「Oracle ADF」タブで「プロパティの編集」アイコンをクリックします。
コンポーネントまたはバインディングを選択し、右クリックしてコンテキスト・メニューからADFコンポーネント・プロパティの編集を選択します。
ADFボタンでは右クリックのアクションはサポートされていないため、ボタンをクリックしてプロパティ・インスペクタ・ダイアログを開いてください。
ExcelワークシートにOracle ADFバインディングまたはコンポーネントを挿入した後にも、プロパティ・インスペクタが自動的に表示されます。図5-6に、Oracle ADFボタン・コンポーネントのプロパティを表示および編集できるプロパティ・インスペクタを示します。
設計時には、コンポーネントが表示されるExcelのセルを編集することにより、特定のOracle ADFコンポーネントの主要なプロパティを編集できます。たとえば、ADF LabelコンポーネントおよびADF Input TextコンポーネントのValueプロパティの編集は、セルに表示された値を編集すれば実行できます。
注意: プロパティ・インスペクタは、プロパティまたはプロパティの組合せに入力した値が有効かどうかの検証は実行しません。無効な値があると、実行時にエラーが発生します。実行時のエラーを回避するには、プロパティ・インスペクタでプロパティに有効な値を指定してください。 |
プロパティは、アルファベット順、またはカテゴリ(動作、データなど)別にグループ化されたリストで表示できます。表5-3は、プロパティ・インスペクタでのプロパティの表示を変更するときに使用可能なボタンを示します。
表5-3 プロパティ・インスペクタでのプロパティ表示を構成するボタン
ボタン | 説明 |
---|---|
![]() |
このボタンを使用すると、プロパティがカテゴリに応じて表示されます。 |
![]() |
このボタンを使用すると、プロパティがアルファベット順に表示されます。 |
図5-6のプロパティ・インスペクタには、カテゴリ別にグループ化されたプロパティが表示されています。
バインディングIDピッカーは、実行時のOracle ADFコンポーネントの動作を構成するために、設計時にOracle ADFバインディングを選択できるダイアログです。バインディングIDピッカーは、「プロパティ・インスペクタ」から起動します。また、バインディングIDピッカーはOracle ADFコンポーネントのプロパティが受け入れるバインディングのタイプに基づいて、表示されるOracle ADFバインディングをフィルタ処理します。たとえば、ADFボタンのSuccessActionID
ボタン・コンポーネントは、アクション・バインディングのみをサポートします。したがって、図5-7に示すように、バインディングIDピッカーは、ページ定義ファイルのバインディングをフィルタ処理して、アクション・バインディングのみが表示されるようにします。
ADFデスクトップ統合コンポーネントのプロパティ、およびそれらがサポートするバインディングの詳細は、付録A「ADFデスクトップ統合コンポーネントのプロパティとアクション」を参照してください。
式ビルダーを使用して、Excelワークブックでの実行時のコンポーネントの動作を構成する式言語(EL)または式を記述します。式ビルダーは、EL式をサポートするコンポーネント・プロパティのプロパティ・インスペクタから起動します。たとえば、図5-8のプロパティLabel
はEL式をサポートするため、このプロパティの値を設定する式ビルダーを起動できます。
記述するEL式内のバインディングを参照できます。式ビルダーは、バインディングのフィルタ処理は実行しない点に注意してください。ページ定義ファイルが公開するすべてのバインディングが表示されます。それぞれのADFデスクトップ統合がサポートするバインディングのタイプの詳細は、表4-1 を参照してください。
「式」ボックスに式を追加するには、項目を選択して「式に挿入」をクリックします。また、項目をダブルクリックして、「式」ボックスに追加することもできます。表5-4は、式ビルダーで使用可能なフォルダを示します。
表5-4 式ビルダーのフォルダ
フォルダ名 | 説明 |
---|---|
バインディング |
現在のワークシートのページ定義からADFデスクトップ統合でサポートされるバインディングの一覧を表示します。 |
コンポーネント |
現在のワークシートで使用可能なADFコンポーネントを一覧表示します。 |
リソース |
|
スタイル |
現在のワークブックに定義されたすべてのExcelのスタイルを一覧表示します。詳細は、9.2項「スタイルの使用」を参照してください。 |
ワークブック |
|
ワークシート |
|
Excel関数 |
ADFデスクトップ統合で使用可能なサンプルのExcel関数を一覧表示します。詳細はExcelのドキュメントを参照してください。 |
式ビルダーの使用の詳細は、9.3項「EL式を使用した動的なスタイルの適用」を参照してください。ADFデスクトップ統合のEL式の構文と、これらの式を記述するガイドラインの詳細は、付録B「ADFデスクトップ統合のEL式」を参照してください。
Webページ・ピッカーを使用して、Fusion WebアプリケーションからWebページを選択します。実行時にOracle ADFコンポーネント(Oracle ADFボタン・コンポーネントなど)によって、そのOracle ADFコンポーネントに関連付けられているWebページを起動できます。
Webページ・ピッカーは、アクション・コレクタ・エディタで設定されたアクションにDialog
アクションを追加するときに起動できます。図5-9に示すように、Webページ・ピッカーを使用して、Dialog
アクションのPage
プロパティにWebページを指定します。
統合ExcelワークブックでのWebページの表示の詳細は、8.4項「Fusion WebアプリケーションからのWebページの表示」を参照してください。
ファイル・システム・フォルダ・ピッカーを使用して、Windowsファイル・システム内を移動し、フォルダを選択できます。このピッカーを使用して、次のワークブックのプロパティの値を指定します。
初めてExcelワークブックを開くときにピッカーが表示され、前述のプロパティの値を設定できます。初めてExcelワークブックを開くときに設定するプロパティの詳細は、4.4.3項「新しい統合Excelワークブックの構成方法」を参照してください。
図5-10に、ワークブックのプロパティApplicationHomeFolder
の値を選択するファイル・システム・フォルダ・ピッカーを示します。
ページ定義ピッカーを使用して、ページ定義ファイルのページ定義IDを選択し、ファイルをワークシートに関連付けます。ピッカーは、統合Excelワークブックで最初にワークシートを有効にするときに表示されます。また、図5-11に示すように、ワークシートのプロパティPageDefinition
の値を設定する際にも起動できます。
ページ定義ファイルの詳細は、4.3項「統合Excelワークブックのページ定義ファイルの使用」を参照してください。
ADFデスクトップ統合では、コレクション・エディタを使用してコレクション内の要素のプロパティを管理します。コレクション・エディタのタイトル・バーに表示されるタイトルは、コレクション・エディタにより構成可能な対象を示します。コレクション・エディタのタイトルの例としては、CacheDataContextコレクション・エディタ、TableColumnコレクション・エディタ、Actionコレクション・エディタなどがあります。これらのコレクション・エディタを使用して、キャッシュされたデータ、ADF表コンポーネントの表列、アクション・セットのアクションのコレクションを構成できます。図5-12は、Master Price ListモジュールのEditPriceList-DT.xlsx
ワークブックで実行時に表示される「検索」ボタンのアクション・セットを構成するコレクション・エディタを示します。
ヒント: アクション・コレクション・エディタに追加する各要素の「注釈」フィールドに説明を記述してください。記述する説明はMembersリスト・ビューに表示されます。記述する説明によっては、ADFデスクトップ統合が生成するデフォルトのエントリよりも意味をなす場合があります。 |