ヘッダーをスキップ
Oracle® Fusion Middleware Oracle Application Development Frameworkデスクトップ統合開発者ガイド
11
g
リリース2 (11.1.2.2.0)
B66718-02
次
目次
タイトルおよび著作権情報
はじめに
対象読者
ドキュメントのアクセシビリティについて
関連ドキュメント
表記規則
1
ADFデスクトップ統合の概要
1.1
ADFデスクトップ統合について
1.2
ADFデスクトップとMicrosoft Excelの統合の概要
1.2.1
統合Excelワークブックの作成の概要
1.2.2
ExcelとFusion Webアプリケーションを統合する利点
2
ADFデスクトップ統合のサンプル・アプリケーションの概要
2.1
Master Price Listモジュールについて
2.2
Master Price Listモジュールの設定および実行
2.3
Master Price ListモジュールでのFusion Webアプリケーションの概要
2.3.1
Master Price ListモジュールでのFusion Webアプリケーションへのログオン
2.3.2
Master Price ListモジュールでのFusion Webアプリケーションの概要
2.3.3
統合Excelワークブックのダウンロード
2.4
Master Price Listモジュールでの統合Excelワークブックの概要
2.4.1
統合ExcelワークブックからのFusion Webアプリケーションへのログオン
2.4.2
製品価格についてのデータ行のダウンロード
2.4.3
ワークブック内の製品の単純検索
2.4.4
Edit Price Listワークブック内の製品の拡張検索
2.4.5
Edit Price Listワークブック内の製品価格情報の変更
2.4.6
Fusion Webアプリケーションへの変更済の製品情報のアップロード
3
開発環境の設定
3.1
開発環境の設定について
3.2
必要なOracle ADFモジュールおよびサード・パーティ製ソフトウェア
3.3
Microsoft .NETプログラミング・サポートの有効化
3.4
ADFデスクトップ統合からMicrosoft Excelへのアクセスを許可する
3.5
ADFデスクトップ統合のインストール
3.5.1
ADFデスクトップ統合の設定方法
3.6
ADFデスクトップ統合の削除
3.7
ADFデスクトップ統合のアップグレード
3.7.1
統合Excelワークブックを最新バージョンのADFデスクトップ統合に移行する方法
3.8
複数のインスタンスのJDeveloperを持つシステムでのADFデスクトップ統合の使用
3.9
Visual Studio Tools for Officeの設定のローカライズ
4
統合Excelワークブックの準備
4.1
統合Excelワークブックの準備について
4.2
Fusion Webアプリケーションへの統合Excelワークブックの追加
4.2.1
Fusion Webアプリケーションへの統合Excelワークブックの追加方法
4.2.2
新しい統合Excelワークブックの構成方法
4.2.3
統合Excelワークブックにワークシートを追加する方法
4.2.4
ADFデスクトップ統合に対応するFusion WebアプリケーションをJDeveloperからデプロイする際の処理
4.2.4.1
Oracle WebLogicサーバーへのFusion Webアプリケーションのデプロイ
4.2.4.2
IBM WebSphere Application ServerへのWebアプリケーションのデプロイ
4.3
統合Excelワークブックのページ定義ファイルの使用
4.3.1
統合Excelワークブックのページ定義ファイルの作成方法
4.3.2
ページ定義ファイル作成時の処理
4.3.3
Excelワークブックへのページ定義ファイルのリロード方法
4.3.4
統合Excelワークブック内のページ定義ファイルに関する留意事項
4.4
ADFデスクトップ統合の手動による有効化
4.4.1
ADFデスクトップ統合を手動でFusion Webアプリケーションに追加する方法
4.4.2
既存のワークブック内でADFデスクトップ統合を有効化する方法
4.4.3
新しい統合Excelワークブックの手動による構成方法
4.4.4
ADFデスクトップ統合をJDeveloperプロジェクトに追加する際の処理
4.4.5
ADFライブラリWebアプリケーション・サポートの追加
5
開発ツールの使用
5.1
開発ツールについて
5.1.1
ADFデスクトップ統合開発ツールのユース・ケースと例
5.1.2
ADFデスクトップ統合開発ツールの追加機能
5.2
「Oracle ADF」タブ
5.3
ADFデスクトップ統合デザイナの作業ウィンドウ
5.4
バインディング・パレットの使用
5.5
コンポーネント・パレットの使用
5.6
プロパティ・インスペクタの使用
5.7
バインディングIDピッカーの使用
5.8
式ビルダーの使用
5.9
Webページ・ピッカーの使用
5.10
ファイル・システム・フォルダ・ピッカーの使用
5.11
ページ定義ピッカーの使用
5.12
コレクション・エディタの使用
5.13
セルのコンテキスト・メニューの使用
6
ADFデスクトップ統合フォーム・タイプ・コンポーネントの使用
6.1
ADFデスクトップ統合フォーム・タイプ・コンポーネントについて
6.1.1
ADFデスクトップ統合フォーム・タイプ・コンポーネントのユース・ケースと例
6.1.2
ADFデスクトップ統合フォーム・タイプ・コンポーネントの追加機能
6.2
ADFボタン・コンポーネントの挿入
6.3
ADFラベル・コンポーネントの挿入
6.4
ADF入力テキスト・コンポーネントの挿入
6.5
ADF出力テキスト・コンポーネントの挿入
6.6
ADF値リスト・コンポーネントの挿入
6.7
ADFコンポーネントのマネージドBeanからの出力の表示
6.7.1
マネージドBeanからの出力の表示方法
6.7.2
実行時の処理: ADFコンポーネントによるマネージドBeanからの出力の表示
6.8
コンポーネント内での連結または計算されたデータの表示
6.8.1
計算されたデータを表示するようにコンポーネントを構成する方法
6.9
ナビゲーション・ボタンの使用
7
ADFデスクトップ統合表タイプ・コンポーネントの使用
7.1
ADFデスクトップ統合表タイプ・コンポーネントについて
7.1.1
ADFデスクトップ統合表タイプ・コンポーネントのユース・ケースと例
7.1.2
表タイプ・コンポーネントの追加機能
7.2
ADF表コンポーネントのページ定義の要件
7.3
ExcelワークシートへのADF表コンポーネントの挿入
7.3.1
ADF表コンポーネントの挿入方法
7.3.2
ADF表コンポーネントへの列の追加方法
7.4
既存データを更新するためのADF表コンポーネントの構成
7.4.1
データを更新するためのADF表コンポーネントの構成方法
7.4.2
実行時の処理: ADF表コンポーネントでのデータ更新
7.5
データを挿入するためのADF表コンポーネントの構成
7.5.1
ビュー・オブジェクトの操作を使用してデータを挿入するためのADF表コンポーネントの構成方法
7.6
ADF表コンポーネントにデータをダウンロードするためのOracle ADFコンポーネントの構成
7.6.1
ADF表コンポーネントにデータをダウンロードするためのADFコンポーネントの構成方法
7.6.2
実行時の処理: ADF表コンポーネントによるデータのダウンロード
7.7
ADF表コンポーネントに挿入前のデータをダウンロードするためのワークシートの構成
7.7.1
ADF表コンポーネントに挿入前のデータをダウンロードするためのワークシートの構成方法
7.7.2
実行時の処理: ADF表コンポーネントによる挿入前のデータのダウンロード
7.8
ADF表コンポーネントから変更をアップロードするためのADFコンポーネントの構成
7.8.1
ADF表コンポーネントからデータをアップロードするためのADFコンポーネントの構成方法
7.8.2
実行時の処理: ADF表コンポーネントによるデータのアップロード
7.8.3
実行時の処理: アップロード中のReadOnly EL式の評価
7.8.4
実行時の処理: アップロードの失敗
7.8.5
カスタムのアップロード・ダイアログの作成方法
7.8.6
実行時の処理: カスタム・アップロード・ダイアログ
7.9
Fusion Webアプリケーションで行を削除するためのADF表コンポーネントの構成
7.9.1
Fusion Webアプリケーションで行を削除するためのADF表コンポーネントの構成方法
7.9.2
実行時の処理: Fusion Webアプリケーション内でのADF表コンポーネントによる行の削除
7.10
ADF表コンポーネントでのバッチ処理
7.10.1
ADF表コンポーネントのバッチ・オプションの構成方法
7.10.2
ADF表コンポーネントでの行のフラグ付け
7.10.3
データのアップロード中のエラーのトラブルシューティング
7.11
ADF表コンポーネント内の特殊な列
7.12
ADF表コンポーネントのキー列の構成
7.12.1
キー列の構成方法
7.12.2
設計時のキー列の手動による追加方法
7.13
ADF表コンポーネント列での値リストの作成
7.13.1
ADF表コンポーネント列での値リストの作成方法
7.13.2
実行時の処理: ADF表列による値リストのレンダリング
7.14
ADF表コンポーネントへのModelDrivenColumnComponentサブコンポーネントの追加
7.15
ADF表コンポーネントへの動的な列の追加
7.15.1
動的な列の構成方法
7.15.2
実行時の処理: 動的な列でのデータのダウンロードまたはアップロード
7.15.3
動的な列のヘッダー・ラベルの指定方法
7.15.4
属性データ・タイプに基づいた動的な列のスタイルの指定方法
7.16
ADF読取り専用表コンポーネントの作成
7.16.1
ADF読取り専用表コンポーネントの作成方法
7.16.2
ADF読取り専用表コンポーネントへの手動による列の追加方法
7.17
表タイプ・コンポーネントがダウンロードする行数の制限
7.17.1
コンポーネントがダウンロードする行数の制限方法
7.17.2
実行時の処理: RowLimitプロパティのしくみ
7.18
ADF表コンポーネントでのキャッシュされた属性値のクリア
7.18.1
ADF表コンポーネントでのキャッシュされた属性値のクリア方法
7.18.2
実行時の処理: ADF表コンポーネントによる値のキャッシュ
7.19
ADF表コンポーネントでの変更の追跡
8
統合Excelワークブックへの対話性の追加
8.1
統合Excelワークブックへの対話性の追加について
8.1.1
統合Excelワークブックへの対話性の追加のユース・ケースと例
8.1.2
統合Excelワークブックへの対話性の追加の追加機能
8.2
アクション・セットの使用
8.2.1
アクション・セット内のメソッド・アクション・バインディングの起動方法
8.2.2
アクション・セット内のコンポーネント・アクションの起動方法
8.2.3
コンポーネント・アクションを起動するアクション・セットに関する留意事項
8.2.3.1
アクション・セットの検証による正しいコンポーネント・アクションの起動
8.2.3.2
切断されたワークブックでのアクション・セットの起動
8.2.4
ワークシート・イベントからアクション・セットを起動する方法
8.2.5
アクション・セットの実行中にステータス・メッセージを表示する方法
8.2.6
実行時の処理: アクション・セットによるステータス・メッセージの表示
8.2.7
アクション・セットの起動後にアラートを発信する方法
8.2.8
実行時の処理: アクション・セットによるアラート発信
8.2.9
アクション・セットのエラー処理の構成方法
8.2.10
アクション・セット内の確認アクションの起動方法
8.2.11
実行時の処理: アクション・セットによる確認の提供
8.3
実行時リボン・タブの構成
8.3.1
実行時リボン・タブのワークブック・コマンド・ボタンの構成方法
8.3.2
実行時リボン・タブのワークシート・コマンド・ボタンの構成方法
8.4
Fusion WebアプリケーションからのWebページの表示
8.4.1
ポップアップ・ダイアログでのWebページの表示方法
8.4.2
ADFデスクトップ統合の実行時作業ウィンドウでのWebページの表示方法
8.4.3
Fusion Webアプリケーションからのページ表示に関する留意事項
8.4.3.1
統合ExcelワークブックとFusion Webアプリケーションの同期
8.4.3.2
統合ExcelワークシートとFusion Webアプリケーション・ページ間のデータ・コントロール・フレームの共有
8.4.3.3
ADFデスクトップ統合フレーム共有に対するFusion Webアプリケーションの構成
8.5
Webページ・ピッカー・ダイアログからのADF表列への値の挿入
8.6
統合Excelワークブックでのデータ・バインドされたADF検索フォームの作成
8.6.1
統合Excelワークブックの単純検索フォームの作成方法
8.6.2
統合Excelワークブックの拡張検索フォームの作成方法
8.7
統合Excelワークブックへのフォームの追加
8.8
統合Excelワークブックでの依存値リストの作成
8.8.1
Excelワークシートでの依存値リストの作成方法
8.8.2
実行時の処理: Excelワークシートによる依存値リストのレンダリング
8.8.3
ADF表コンポーネント列での依存値リストの作成方法
8.8.4
実行時の処理: ADF表コンポーネント列による依存値リストのレンダリング
8.8.5
ExcelワークシートおよびADF表コンポーネント列での依存値リストの作成
8.8.6
実行時の処理: ExcelワークシートとADF表コンポーネント列による依存値リストのレンダリング
8.9
Excel式を生成するためのEL式の使用
8.9.1
EL式を使用してハイパーリンクを表示する際のセルの構成方法
8.9.2
実行時の処理: EL式を使用したセルによるハイパーリンクの表示
8.10
統合Excelワークブックでの計算済セルの使用
8.10.1
Excel式により生成された値を表示する列の作成方法
8.10.2
実行時の処理: 列でのExcel式の値の表示
8.10.3
表タイプ・コンポーネント列の合計の計算方法
8.10.4
実行時の処理: Excelによる表タイプ・コンポーネント列の合計計算
8.11
統合Excelワークブックでのマクロの使用
9
統合Excelワークブックの外観の構成
9.1
統合Excelワークブックの外観の構成について
9.1.1
統合Excelワークブック構成のユース・ケースと例
9.1.2
統合Excelワークブックの外観の構成の追加機能
9.2
スタイルの使用
9.2.1
ADFデスクトップ統合により事前定義されたスタイル
9.2.2
Excelの日付形式とMicrosoft Windowsの地域と言語のオプション
9.2.3
Oracle ADFコンポーネントへのスタイルの適用方法
9.2.4
実行時の処理: ADFコンポーネントへのスタイルの適用
9.3
EL式を使用した動的なスタイルの適用
9.3.1
実行時の処理: EL式の評価
9.3.2
実行時にスタイルを適用するEL式の記述方法
9.3.3
スタイルを適用するEL式に関する留意事項
9.4
統合Excelワークブックでのラベルの使用
9.4.1
リソース・バンドルからの文字列キーの値の取得
9.4.2
属性コントロール・ヒントの値の取得
9.4.3
統合ExcelワークブックがLabelプロパティをどのように評価するか
9.5
操作性を向上するスタイルの使用
9.5.1
使い勝手を向上するADFラベル・コンポーネントの使用
9.5.2
統合Excelワークブック内の読取り専用プロパティに関する留意事項
9.6
統合Excelワークブックのブランディング
9.6.1
統合Excelワークブックのブランディング方法
9.6.2
実行時の処理: BrandingItemsプロパティ・グループ
9.7
ワークシート保護の使用
9.7.1
ワークシート保護を有効化する方法
9.7.2
実行時の処理: Lockedプロパティのしくみ
9.7.3
ワークシートの保護に関する留意事項
10
統合Excelワークブックの国際化
10.1
統合Excelワークブックの国際化について
10.1.1
統合Excelワークブックの国際化のユース・ケースと例
10.1.2
統合Excelワークブックの国際化の追加機能
10.2
統合Excelワークブックでのリソース・バンドルの使用
10.2.1
統合Excelワークブックでのリソース・バンドルの登録方法
10.2.2
予約済リソース・バンドルからの文字列キー値の置換方法
10.2.3
構成不可能なリソースの上書き方法
10.2.4
実行時の処理: 構成不可能なリソースの上書き
10.2.5
リソース・バンドルに関する留意事項
10.2.5.1
リソース・バンドルのタイプ
10.2.5.2
統合Excelワークブックのリソース・バンドルのキャッシング
10.2.5.3
リソース・バンドルのEL式の構文
10.3
ADFデスクトップ統合でのローカライズ
11
統合Excelワークブックの保護
11.1
統合Excelワークブックの保護について
11.1.1
統合Excelワークブックの保護のユース・ケースと例
11.1.2
安全なFusion Webアプリケーションにおける統合Excelワークブックの追加機能
11.2
Excelワークブック・ユーザーの認証
11.2.1
実行時の処理: Loginメソッドの起動
11.2.2
実行時の処理: Logoutメソッドの起動
11.3
統合Excelワークブックのメタデータの整合性チェック
11.3.1
ワークブックIDのリセット方法
11.3.2
Fusion Webアプリケーションでのメタデータ改ざんチェックを無効にする方法
11.3.3
ADFデスクトップ統合クライアント・レジストリで不足したエントリを許可する方法
11.3.4
メタデータ改ざんチェックを実行する際の実行時の処理
11.4
統合Excelワークブックの保護に関する留意事項
12
統合Excelワークブックへの検証の追加
12.1
統合Excelワークブックへの検証の追加について
12.1.1
統合Excelワークブックの検証のユース・ケースと例
12.1.2
統合Excelワークブックへの検証の追加の追加機能
12.2
統合Excelワークブックのサーバー・サイド検証の追加
12.3
統合Excelワークブックのクライアント・サイド検証の追加
12.4
統合Excelワークブックでレポートされるエラー
12.4.1
EL式を使用してレポートされるエラー
12.4.2
コンポーネント・アクションを使用してレポートされるエラー
12.5
ADF表コンポーネントでの行ごとのステータスの追加
12.6
統合Excelワークブックでのエラー・メッセージへの詳細の追加
12.7
ワークブックからデータをアップロードする際のデータ競合の処理
12.7.1
データをアップロードする際のデータ競合を処理するためのワークブックの構成
12.7.2
実行時の処理: データ競合の処理
13
統合Excelワークブックのテスト
13.1
統合Excelワークブックのテストについて
13.1.1
統合Excelワークブックのテストのユース・ケースと例
13.1.2
統合Excelワークブックのテストの追加機能
13.2
Fusion Webアプリケーションのテスト
13.3
統合Excelワークブックの構成の検証
13.3.1
統合Excelワークブックの構成の検証方法
13.3.2
統合Excelワークブックの構成を検証する際の実行時の処理
13.3.3
検証の失敗の修正方法
13.3.4
統合Excelワークブックの構成の失敗を実行時にログに記録する方法
13.4
統合Excelワークブックのテスト
13.5
サーバーのpingテストの実行
14
統合Excelワークブックのデプロイ
14.1
統合Excelワークブックのデプロイについて
14.1.1
統合Excelワークブックのデプロイのユース・ケースと例
14.1.2
統合Excelワークブックのデプロイの追加機能
14.2
エンド・ユーザーによるADFデスクトップ統合の使用を可能にする
14.3
統合Excelワークブックの公開
14.3.1
統合ExcelワークブックをExcelから公開する方法
14.3.2
コマンドライン公開ツールを使用して統合Excelワークブックを公開する方法
14.3.3
統合Excelワークブックを公開する際の実行時の処理
14.4
Fusion Webアプリケーションによる公開済ワークブックのデプロイ
14.5
Fusion Webアプリケーション・ページからワークブックにパラメータ値を渡す
14.5.1
パラメータを渡すためにFusion Webアプリケーションのページを構成する方法
14.5.2
ワークシートでパラメータを受け取るようにページ定義ファイルを構成する方法
14.5.3
統合Excelワークブックでパラメータのプロパティを構成する方法
14.5.4
実行時の処理: Fusion Webアプリケーションから統合Excelワークブックへのパラメータの引渡し
15
切断されたモードでの複数のWebセッションにおける統合Excelワークブックの使用
15.1
切断されたワークブックについて
15.1.1
切断されたワークブックのユース・ケースと例
15.1.2
切断されたワークブックの追加機能
15.2
セッション間のサーバー・データ・コンテキストのリストア
15.2.1
サーバー・データ・コンテキストをリストアするための統合Excelワークブックの構成方法
15.2.2
実行時の処理: 統合Excelワークブックによるサーバー・データ・コンテキストのリストア
15.3
統合Excelワークブックでの静的情報のキャッシュ
15.4
切断されたモードで使用するための値リストのキャッシング
A
ADFデスクトップ統合コンポーネントのプロパティとアクション
A.1
ADFデスクトップ統合で頻繁に使用するプロパティ
A.2
ADF入力テキスト・コンポーネントのプロパティ
A.3
ADF出力テキスト・コンポーネントのプロパティ
A.4
ADFラベル・コンポーネントのプロパティ
A.5
ADF値リスト・コンポーネントのプロパティ
A.6
TreeNodeListサブコンポーネントのプロパティ
A.7
ModelDrivenColumnComponentサブコンポーネントのプロパティ
A.8
ADFボタン・コンポーネントのプロパティ
A.9
ADF表コンポーネントのプロパティとアクション
A.9.1
ADF表コンポーネントのプロパティ
A.9.2
ADF表コンポーネント列のプロパティ
A.9.3
ADF表コンポーネントのアクション
A.10
ADF読取り専用表コンポーネントのプロパティおよびアクション
A.11
アクション・セットのプロパティ
A.11.1
確認アクションのプロパティ
A.11.2
ダイアログ・アクションのプロパティ
A.12
ワークブックのアクションとプロパティ
A.13
ワークシートのアクションとプロパティ
B
ADFデスクトップ統合のEL式
B.1
EL式を作成するガイドライン
B.2
ADFデスクトップ統合コンポーネントのEL構文
B.3
ADFデスクトップ統合の属性コントロールのヒント
C
統合Excelワークブックのトラブルシューティング
C.1
Fusion WebアプリケーションがADFデスクトップ統合をサポートするかどうかの検証
C.2
統合Excelワークブックのエンドユーザー認証の検証
C.3
統合Excelワークブックのログ・ファイルの生成
C.3.1
サーバー・サイド・ロギングの概要
C.3.2
クライアント・サイド・ロギングの概要
C.3.2.1
ADFデスクトップ統合でログを保存するための構成方法
C.3.2.2
ADFデスクトップ統合の構成ファイルの概要
C.3.2.3
ユーザー環境変数を使用したロギングの構成方法
C.3.2.4
adfdi-commonオブジェクトに関する留意事項
C.4
Excelワークブックの構成のエクスポート
C.5
ADFデスクトップ統合の一般的な問題
D
ワークブック管理ツールの使用
D.1
ワークブック管理ツールの使用
E
Webアプリケーション・デプロイメント・ディスクリプタのADFデスクトップ統合設定
E.1
ADFデスクトップ統合サーブレットの構成
E.2
ADFデスクトップ統合Excelダウンロード・フィルタの構成
E.3
デプロイメント・ディスクリプタ・ファイルの例
F
上書き可能なリソースの文字列キー
G
ADFデスクトップ統合でサポートされているJavaデータ型
H
ADFデスクトップ統合モデルAPIの使用
H.1
一時行オブジェクトの概要
H.2
ADFデスクトップ統合モデルAPIの概要
H.2.1
ADFデスクトップ統合モデルAPIライブラリをJDeveloperプロジェクトに追加する方法
H.3
ADFデスクトップ統合モデルAPIクラスとメソッド
H.3.1
oracle.adf.desktopintegration.model.ModelHelperクラス
H.3.1.1
getAdfdiTempChildRowメソッド
H.3.1.2
getAdfdiTempRowForViewメソッド
H.3.1.3
getChildViewDefメソッド
I
エンド・ユーザー・アクション
I.1
ランタイム・エディションのADFデスクトップ統合のインストール
I.2
統合Excelでないワークシートからのデータのインポート
I.3
個人情報の削除
I.4
実行時の統合Excelワークブックの変更
I.5
実行時の統合Excelワークブックの制限
I.6
統合Excelワークブックの使用
I.6.1
統合ExcelワークブックのADF表コンポーネントへの行の挿入方法
I.6.2
統合ExcelワークブックでのADF表データのソート方法
I.6.3
統合ExcelワークブックのADF表での行の削除方法
I.7
タイム・ゾーンの変換処理