ヘッダーをスキップ
Oracle® Fusion Middleware Oracle Application Development Frameworkデスクトップ統合開発者ガイド
11
g
リリース1 (11.1.1.7.0)
B66694-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
ADFデスクトップ統合のSummitサンプル・アプリケーションの概要
2.2
ADFデスクトップ統合のSummitサンプル・アプリケーションの設定と実行
2.3
ADFデスクトップ統合のSummitサンプル・アプリケーションのFusion Webアプリケーションの概要
2.3.1
ADFデスクトップ統合のSummitサンプル・アプリケーションのFusion Webアプリケーションへのログオン
2.3.2
統合Excelワークブックのダウンロード
2.4
ADFデスクトップ統合のSummitサンプル・アプリケーションの統合Excelワークブックの概要
2.4.1
統合ExcelワークブックからのFusion Webアプリケーションへのログオン
2.4.2
データ行のダウンロード
2.4.3
ワークブックの顧客および倉庫情報の変更
2.4.4
Fusion Webアプリケーションへの変更済の情報のアップロード
3
開発環境の設定
3.1
開発環境の設定の概要
3.2
必要なOracle ADFモジュールおよびサード・パーティ製ソフトウェア
3.3
ADFデスクトップ統合と協働するExcelの構成
3.4
ADFデスクトップ統合のインストール
3.4.1
ADFデスクトップ統合の設定方法
3.5
ADFデスクトップ統合の削除
3.6
ADFデスクトップ統合のアップグレード
3.6.1
統合Excelワークブックを最新バージョンのADFデスクトップ統合に移行する方法
3.7
旧バージョンのADFデスクトップ統合との統合Excelワークブックの使用
3.8
複数のインスタンスのJDeveloperを持つシステムでのADFデスクトップ統合の使用
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
Fusion WebアプリケーションのOracle WebLogic Serverへのデプロイ
4.2.4.2
WebアプリケーションのIBM WebSphere Application Serverへのデプロイ
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.2
デザイナ・リボン・タブ
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
セルのコンテキスト・メニューの使用
5.14
ADFデスクトップ統合コンポーネントの削除
6
ADFデスクトップ統合フォーム・タイプ・コンポーネントの使用
6.1
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.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表コンポーネントでの変更の追跡
7.20
読取り専用プロパティのEL式の評価
7.20.1
実行時の処理: データのダウンロード時のEL式の評価
7.20.2
実行時の処理: データのアップロードまたは変更のトラッキング時のEL式の評価
7.20.3
データのアップロードまたは変更のトラッキング時のEL式の評価に関する留意事項
8
統合Excelワークブックへの対話性の追加
8.1
統合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.2.12
実行時の処理: アクション・セットによる確認の提供
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
ADF表の列へのカスタム・ポップアップ・ピッカー・ダイアログの追加
8.6
統合Excelワークブックでのデータ・バインドされたADF検索フォームの作成
8.6.1
統合Excelワークブックの検索フォームの作成方法
8.6.2
統合ExcelワークブックのWebページを使用した検索フォームの作成方法
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
表タイプ・コンポーネント列の合計の計算方法
8.10.2
実行時の処理: Excelによる表タイプ・コンポーネント列の合計計算
8.11
統合Excelワークブックでのマクロの使用
9
統合Excelワークブックの外観の構成
9.1
統合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.2
統合Excelワークブックでのリソース・バンドルの使用
10.2.1
統合Excelワークブックでのリソース・バンドルの登録方法
10.2.2
構成不可能なリソースの上書き方法
10.2.3
実行時の処理: 構成不可能なリソースの上書き
10.2.4
リソース・バンドルに関する留意事項
10.2.4.1
リソース・バンドルのタイプ
10.2.4.2
統合Excelワークブックのリソース・バンドルのキャッシング
10.2.4.3
リソース・バンドルのEL式の構文
10.3
ADFデスクトップ統合でのローカライズ
11
統合Excelワークブックの保護
11.1
統合Excelワークブックのセキュリティの概要
11.2
Excelワークブック・ユーザーの認証
11.2.1
実行時の処理: Loginメソッドの起動
11.2.2
実行時の処理: Logoutメソッドの起動
11.3
統合Excelワークブックのメタデータの整合性チェック
11.3.1
ワークブックIDのリセット方法
11.3.2
メタデータ改ざんチェックを実行する際の実行時の処理
11.4
統合Excelワークブックの保護に関する留意事項
12
統合Excelワークブックへの検証の追加
12.1
統合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.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
I統合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.4.1
実行時の処理: 公開されたワークブックのデプロイ
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.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
Webアプリケーション・デプロイメント・ディスクリプタでのADFデスクトップ統合の設定
D.1
ADFデスクトップ統合サーブレットの構成
D.2
ADFデスクトップ統合Excelダウンロード・フィルタの構成
D.3
デプロイメント・ディスクリプタ・ファイルの例
E
オーバーライド可能なリソースの文字列キー
F
ADFデスクトップ統合でサポートされるJavaのデータ型
G
ADFデスクトップ統合モデルAPIの使用
G.1
一時行オブジェクトの概要
G.2
ADFデスクトップ統合モデルAPIの概要
G.2.1
JDeveloperプロジェクトへのADFデスクトップ統合モデルAPIライブラリの追加方法
G.3
ADFデスクトップ統合モデルAPIのクラスおよびメソッド
G.3.1
oracle.adf.desktopintegration.model.ModelHelperクラス
G.3.1.1
getAdfdiTempChildRowメソッド
G.3.1.2
getAdfdiTempRowForViewメソッド
G.3.1.3
getChildViewDefメソッド
H
エンド・ユーザーのアクション
H.1
ADFデスクトップ統合のランタイム・エディションのインストール、アップグレードおよび削除
H.1.1
ADFデスクトップ統合のランタイム・エディションのインストール方法
H.1.2
ADFデスクトップ統合のランタイム・エディションの削除方法
H.1.3
ローカル・システムのADFデスクトップ統合のランタイム・エディションのアップグレード方法
H.2
統合されていないExcelワークシートからのデータのインポート
H.3
個人情報の削除
H.4
実行時の統合Excelワークブックの変更
H.5
実行時の統合Excelワークブックの制限
H.6
統合Excelワークブックの使用
H.6.1
統合ExcelワークブックのADF表コンポーネントに行を挿入する方法
H.6.2
統合ExcelワークブックのADF表のデータをソートする方法
H.6.3
統合ExcelワークブックのADF表の行を削除する方法
H.7
タイムゾーン変換の処理