| Oracle® Fusion Middleware Oracle Application Development Frameworkデスクトップ統合開発者ガイド 11gリリース1(11.1.1.6.0) B66694-01 |
|
 前 |
 次 |
| Oracle® Fusion Middleware Oracle Application Development Frameworkデスクトップ統合開発者ガイド 11gリリース1(11.1.1.6.0) B66694-01 |
|
前 |
次 |
この章では、ADFデスクトップ統合により提供される表タイプのコンポーネントやその構成と使用方法、Fusion Webアプリケーションからのデータのダウンロード方法、統合Excelワークブックでの表タイプ・コンポーネントへの行の挿入、更新、削除の方法、変更の追跡方法、表タイプ・コンポーネントでの特殊な列の構成方法、表タイプ・コンポーネントで実行可能なその他の作業について説明します。
この章の内容は次のとおりです。
ADFデスクトップ統合には、構造化データを表示するための次の表タイプ・コンポーネントがあります。
ADF表コンポーネントおよびADF読取り専用コンポーネントは、Fusion Webアプリケーションからデータ行をダウンロードする機能をエンド・ユーザーに提供します。ADF表コンポーネントは、ダウンロードしたデータの編集や削除、新しいデータ行の挿入を可能にする追加機能をエンド・ユーザーに提供します。ADF表コンポーネントのUploadアクションは、結果のデータをアップロードするときに使用します。
ADF表コンポーネントやADF読取り専用コンポーネントに含まれる行数は、Fusion Webからダウンロードする行数に基づいて増減します。Excelが表タイプ・コンポーネントがダウンロードするデータを受け入れるために行を挿入するときに、複製する場合を除いて、表タイプ・コンポーネントの左右には何も配置しないでください。実行時に表タイプ・コンポーネントに対して位置が維持されるため、表タイプ・コンポーネントの上下には他のコンポーネントを配置できます。エンド・ユーザーが実行時にADF表コンポーネントに新しいデータ行を挿入する場合は、ADF表コンポーネントをホストするExcelワークシートに行全体を挿入する必要があります。
それぞれのADF表コンポーネントには、「キー」列が1つ含まれています。「キー」列には、ADFデスクトップ統合で表が正しく機能するために使用される重要な情報が含まれるため、削除しないでください。「キー」列を削除したり、「キー」列のセルを変更すると、エラーおよびデータ破損が発生します。キー列の詳細は、7.12項「ADF表コンポーネントのキー列の構成」を参照してください。
これらの表タイプ・コンポーネントとともに使用可能な他のADFデスクトップ統合コンポーネントの詳細は、第6章「ADFデスクトップ統合フォーム・タイプ・コンポーネントの使用」を参照してください。
ADF表コンポーネントは、ADFデスクトップ統合が公開するOracle ADFコンポーネントの1つです。ADFデスクトップ統合デザイナの作業ウィンドウのコンポーネント・パレットに表示され、Excelワークシートに挿入された後は、次の操作を可能にします。
読取り専用
挿入専用
更新専用
挿入と更新
ADF表コンポーネントに固有のページ定義ファイルの要件の詳細は、次の項を参照してください。
エンド・ユーザーにデータ・エントリ機能を提供するようADF表コンポーネントを構成するには、Excelワークシートの基礎となるページ定義ファイルにADFバインディングをあらかじめ構成しておく必要があります。統合Excelワークブックのページ定義ファイルの要件の概要は、4.3項「統合Excelワークブックのページ定義ファイルの使用」を参照してください。
ADF表コンポーネント作成のためにページ定義ファイルを作成する際に、次のコントロール・バインディングを公開します。
希望する属性バインディングを公開するツリー・バインディング、および表の各行を個別に識別するツリー・バインディング属性。
ADF表コンポーネントのRowActionsおよびBatchOptionsプロパティ・グループの値を構成する場合は、メソッド・アクション・バインディングとアクション・バインディング。これらのプロパティ・グループに値を設定する手順の例には、次のものがあります。
|
注意: 前述のリストは完全なものではありません。 |
(オプション)レコード・アクション・バインディングを更新します。
|
注意: 各種イテレータの属性には、わかりやすい名前を使用します。Excelにはバインディングのフラット・リストが表示されるため、イテレータは表示されません。 |
図7-1に、ページ定義ファイルExcelPriceListPageDef.xmlに含まれるバインディングを示します。このページ定義ファイルは、関連付けられているExcelワークシートでのADF表コンポーネントの使用をサポートします。
ページ定義ファイルを正しく構成した後、ADF表コンポーネントをワークシートに挿入してプロパティを構成し、必要な機能を使用可能にできます。
ExcelワークシートへADF表コンポーネントを挿入する手順:
統合Excelワークブックを開きます。
ADF表コンポーネントを挿入するExcelワークシートのセルを選択します。ADF表コンポーネントを挿入するときは、2つの表のデータが実行時に重複しないようにしてください。
ADFデスクトップ統合デザイナの作業ウィンドウのバインディング・パレットで、使用するツリー・バインディングを選択して、バインディングの挿入をクリックします。選択内容に基づいて、「コンポーネントの選択」ダイアログまたはコンポーネントの挿入ダイアログが表示されます。
表示されたダイアログで、「ADF表」を選択して「OK」をクリックします。
|
注意:
|
図7-2に示すように、プロパティ・インスペクタを使用してADF表コンポーネントのプロパティを構成します。
ツリー・バインディングに関連付けられたイテレータの各行を一意に識別する属性のバインディング式を指定します。バインディングのイテレータが行のキーをサポートする場合、UniqueAttributeプロパティは空白のままにしても問題ありません。
表7-1の説明に従って、ADF表コンポーネントのBatchOptionsプロパティを構成します。
オプションで、RowLimitグループ・プロパティを構成し、ADF表コンポーネントがダウンロード可能な行数を決定します。
詳細は、7.17項「表タイプ・コンポーネントがダウンロードする行数の制限」を参照してください。
「OK」をクリックします。
ADF表コンポーネントに設定可能なプロパティの詳細は、A.9項「ADF表コンポーネントのプロパティとアクション」を参照してください。
統合ExcelワークブックのワークシートにADF表コンポーネントを挿入した後、ツリー・バインディングで使用できない列を追加したい場合があります。たとえば、Excel式によって計算される値を表示する列を追加する場合です。
ADF表コンポーネントに列を追加する手順:
統合Excelワークブックを開きます。
ADF表コンポーネントを参照するExcelワークシートのセルを選択し、「Oracle ADF」タブの「コンポーネントの編集」ボタンをクリックします。また、右クリックしてコンテキスト・メニューからADFコンポーネント・プロパティの編集を選択することもできます。
コンポーネントの編集: ADF表ダイアログで、Columnsプロパティの省略記号ボタン(...)をクリックして、TableColumnのコレクション・エディタ・ダイアログを開きます。このダイアログには、選択したADF表コンポーネントのすべての列が一覧表示されます。
「追加」をクリックして、新しい列を追加します。新しい列が、Membersリストの末尾に挿入されます。列を特定の位置に移動するには、列を選択して「上」と「下へ」の配列キーを使用します。
ダイアログの右側ウィンドウにある新しい列のプロパティを構成します。ADF表コンポーネント・プロパティの詳細は、A.9項「ADF表コンポーネントのプロパティとアクション」を参照してください。
「OK」をクリックします。
ADFデスクトップ統合は、ADF表コンポーネントに追加可能な列の数を制限していません。使用するバージョンExcelでサポートされる列の数だけ追加できます。ただし、非常に幅の広い表では、パフォーマンスと操作性が低下することが報告されています。同じことが起こった場合、パフォーマンス低下の他の理由を診断する前に、表の列数を少なくしてみてください。
ADF表コンポーネントを追加すると、デフォルトでエンド・ユーザーが既存のデータを編集できるようになりますが、新しいデータ行の追加や既存のデータ行の削除はできません。
エンド・ユーザーが既存のデータを編集できるようにしながら、データ行の追加や削除を制限する場合、追加の構成は必要ありません。表7-2に示すように、ADF表コンポーネントのRowActionプロパティが設定されていることを確認してください。
エンド・ユーザーが行のデータを変更すると、ADFデスクトップ統合によりその行にマークが付けられ、上向きの三角形が_ADF_ChangedColumn列の行に表示されます。既存のデータを更新した後、エンド・ユーザーはアップロード処理を開始して変更を保存します。ADF表コンポーネントのアップロード処理の詳細は、7.8項「ADF表コンポーネントから変更をアップロードするためのOracle ADFコンポーネントの構成」を参照してください。
Excelは、統合ワークブックで変更された行を、行ごとにではなくバッチ処理でアップロードします。バッチをアップロードするときのバッチのサイズとADF表コンポーネントが起動するアクションを構成できます。バッチ処理の詳細は、7.10項「ADF表コンポーネントでのバッチ処理」を参照してください。
ADF表コンポーネントに設定可能なプロパティの詳細は、A.9項「ADF表コンポーネントのプロパティとアクション」を参照してください。
ADF表コンポーネントの第一の目的は、データを入力および編集し、Fusion Webアプリケーションにサービスを提供するデータベースにアップロードできるインタフェースをエンド・ユーザーに提供することです。この目的を達成するには、データ・コントロールのメソッドを公開し、ページ定義ファイルでアクション・バインディングを作成して、ExcelワークシートがホストするADF表コンポーネントのプロパティを設定する必要があります。この機能が正常に動作するには、Excelの行全体を挿入する必要がある点に注意してください。
エンド・ユーザーがADF表コンポーネントで行う変更をADF表コンポーネントのUploadアクションを起動してコミットするには、ADF表コンポーネントのプロパティをいくつか構成する必要があります。
ビュー・オブジェクトの操作を使用してデータを挿入するためにADF表コンポーネントを構成する手順:
JDeveloperでプロジェクトを開きます。
プロジェクトがない場合は、CreateInsertとCommitアクション・バインディングを、ADF表コンポーネントをホストするExcelワークシートに関連付けられたページ定義ファイルに追加します。
詳細は、4.3項「統合Excelワークブックのページ定義ファイルの使用」と7.2項「ADF表コンポーネントのページ定義の要件」を参照してください。
統合Excelワークブックを開きます。
ADF表コンポーネントを参照するExcelワークシートのセルを選択し、「Oracle ADF」タブの「コンポーネントの編集」ボタンをクリックします。
コンポーネントの編集: ADF表ダイアログで、表7-3に示すようにADF表コンポーネントのRowActionsプロパティを構成します。
次の表に示すように、ADF表コンポーネントのBatchOptionsプロパティを構成します。
次の表に示すように、ADF表コンポーネントのColumnsプロパティを構成します。
表7-5 ADF表コンポーネントのColumnsプロパティ
| 設定するプロパティ | 設定する値 |
|---|---|
|
|
|
|
|
|
|
ADF表コンポーネントの列のリストで列を一意に識別する値をこのフィールドに設定します。このプロパティの値は必須です。ADF表コンポーネントによって、変更の必要がない初期値が生成されます。 |
|
このプロパティを、ワークブックで定義するスタイル、または実行時に列のセルにスタイルを適用するEL式に設定します。スタイルの詳細は、第9章「統合Excelワークブックの外観の構成」を参照してください。 |
|
|
このプロパティをラベル、または実行時に列ヘッダーにレンダリングされるラベルに評価されるEL式に設定します。ラベルの詳細は、9.4項「統合Excelワークブックでのラベルの使用」を参照してください。 |
|
|
このプロパティをワークブックで定義するスタイル、または実行時に列のヘッダーのセルにスタイルを適用するEL式に設定します。スタイルの詳細は、第9章「統合Excelワークブックの外観の構成」を参照してください。 |
Uploadアクションの起動時にコミットするデータを含む列ごとに、手順7を繰り返します。
ADF表コンポーネント・プロパティの詳細は、A.9項「ADF表コンポーネントのプロパティとアクション」を参照してください。
|
注意: InsertRowsAfterUploadEnabledプロパティがFalseに設定されていて、エンド・ユーザーが挿入済のデータをもう一度アップロードしようとすると、行を二度挿入することはできないというエラー・メッセージがステータス列に表示されます。 |
多相ビュー・オブジェクトを使用中に新しい行を挿入する場合は、カスタム・メソッドを作成して、識別子の値を新しく挿入した行に設定してください。デフォルトのCreateInsertアクション・バインディングは、多相ビュー・オブジェクトをサポートしていません。
例7-1は、新しい行の挿入に使用されるカスタム・メソッドのサンプル・コードを示します。
例7-1 多相ビュー・オブジェクトへの新しい行の挿入
public void createInsertWithDiscriminator()
{
AttributeList attrs = new NameValuePairs();
attrs.setAttribute("<Discriminator_Attribute>", <Discriminator_Value>);
ViewRowImpl row = (ViewRowImpl)<View_Object>.createAndInitRow(attrs);
<View_Object>.insertRow (row);
}
例7-1のサンプル・コードを実装する前に、<Discriminator_Attribute>を属性名に、<Discriminator_Value>を識別子の値に、<View_Object>をビュー・オブジェクト名にそれぞれ置換してください。
ワークシートにADF表コンポーネントを追加した後は、ADF表コンポーネントがFusion Webアプリケーションからデータをダウンロードするように、コンポーネントおよびそれをホストするワークシートを構成できます。これを実行するには、ADFボタンやワークシート・リボン・ボタン、ワークシート・イベントなどのOracle ADFコンポーネントを構成して、アクション・セットを起動します。起動されるアクション・セットには、起動されるアクションの中からADF表コンポーネントDownloadアクションを含める必要があります。
Oracle ADFコンポーネント、ワークシート・リボン・ボタン、ワークシート・イベントを構成して、ADF表コンポーネントDownloadアクションを起動するアクション・セットを起動します。
Oracle ADFコンポーネントを構成してADF表コンポーネントにデータをダウンロードする手順:
統合Excelワークブックを開きます。
アクション・コレクション・エディタを開き、実行時にアクション・セットを起動するワークシート・イベント、ワークシート・リボン・ボタン、Oracle ADFコンポーネント(ボタンなど)にアクション・セットを構成します。
アクション・セットの起動の詳細は、8.2項「アクション・セットの使用」を参照してください。
ADF表コンポーネントDownloadアクションを、実行時にアクション・セットにより起動されるアクションのリストに追加します。
ADF表コンポーネントDownloadアクションは、ADF表コンポーネントTreeIDプロパティにより参照されるバインディングの現在の状態をダウンロードします。ダウンロードの前にこのバインディングの状態が最新であることを確認するため、アクション・セットがADF表コンポーネントDownloadアクションを起動する前にバインディングをリフレッシュする問合せアクションを追加します。
図7-3は、EditPriceList-DT.xlsxワークブックのアクション・コレクション・エディタを示します。ここでは、ワークシート・イベントStartupにより起動されるアクション・セットが構成されます。
「OK」をクリックします。
エンド・ユーザーは、構成されたアクション・セットを起動します。アクション・セットは、指定されたアクションのリストを順に起動します。これには、ADF表コンポーネントのDownloadアクションを起動するアクションが含まれます。このアクションは、ADF表コンポーネントTreeIDプロパティにより参照されるバインディングの現在の状態をダウンロードします。TreeIDプロパティにより参照されるツリー・バインディングにマスター/ディテール関係のデータ(たとえば、複数の製品を持つ製品カテゴリなど)が含まれる場合、ADF表コンポーネントは詳細結果セットに最初のレコードを表示します(最初の製品など)。Fusion Webアプリケーションでどのようにツリー・バインディングを構成したかによって、最初のレコードとして定義された詳細レコードが決まります。ツリー・バインディングを使用したマスター/ディテール・データの表示の詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』の「ツリーを使用したマスター/ディテール・オブジェクトの表示」の項を参照してください。
アクションによりダウンロードされる行数は、ADF表コンポーネントでRowLimitグループ・プロパティに設定された値によって異なります。詳細は、7.17項「表タイプ・コンポーネントがダウンロードする行数の制限」を参照してください。
挿入前のデータとは、参照するFusion Webアプリケーションのイテレータを構成する1つ以上のデータ行が含まれるデータです。これらのデータ行は、Fusion Webアプリケーションのデータベースにまだコミットされていません。イテレータを構成して、属性の一部またはすべての値を移入できます。
統合Excelワークブックで設計時に、ADF表コンポーネントが挿入前のデータをFusion Webアプリケーションからダウンロードするように、ADF表コンポーネントおよびそれをホストするワークシートを構成できます。これを実行するには、ADFボタン・コンポーネントやワークシート・リボン・ボタン、ワークシート・イベントなどのOracle ADFコンポーネントを構成して、アクション・セットを起動します。起動されるアクション・セットには、起動されるアクションの中からADF表コンポーネントのDownloadForInsertアクションを含める必要があります。
DownloadForInsertアクションは、次の点でDownloadアクションとは異なります。
DownloadForInsertは、ADF表コンポーネントの各列に関連付けられた挿入コンポーネントに対して、表セルのデータにEL式の値を移入します。Downloadは、ADF表コンポーネントの各列に関連付けられた更新コンポーネントに対して、表セルのデータにEL式を移入します。
EL式#{components.componentID.currentRowMode}は、DownloadForInsertアクションにより評価されたときにInsertを返します。対照的に、Downloadアクションにより評価されるEL式はUpdateを返します。EL式のcomponentIDの部分は、ADF表コンポーネントのIDを参照します。
DownloadForInsertアクションの起動に際して、次の点に注意してください。
STATUS_INITIALIZEDの状態にあるデータ行を持つアクションを使用してください。トランザクションがコミットされるときに、これらのデータ行は無視されるためです。
DownloadForInsertアクションを含むアクション・セットは、ADF表コンポーネントのRowActions.InsertRowEnabledプロパティがFalseに設定されていると、このアクションを実行しません。
最後に実行されたアクションによってADF表コンポーネントに表示されるデータが決まるため、同じアクション・セットにDownloadForInsertとDownloadの両方のアクションを含めることは意味がありません。
Oracle ADFコンポーネント、ワークシート・リボン・ボタン、ワークシート・イベントを構成して、ADF表コンポーネントDownloadForInsertアクションを起動するアクション・セットを起動します。
ADF表コンポーネントに挿入前のデータをダウンロードするためにワークシートを構成する手順:
統合Excelワークブックを開きます。
アクション・コレクション・エディタを開き、実行時にアクション・セットを起動するワークシート・イベント、ワークシート・リボン・ボタン、Oracle ADFコンポーネントにアクション・セットを構成します。
アクション・セットの起動の詳細は、8.2項「アクション・セットの使用」を参照してください。
ADF表コンポーネントDownloadForInsertアクションを、実行時にアクション・セットにより起動されるアクションのリストに追加します。
「OK」をクリックします。
エンド・ユーザーは、構成されたアクション・セットを起動します。アクション・セットは、指定されたアクションのリストを順に起動します。これには、ADF表コンポーネントのDownloadForInsertアクションを起動するアクションが含まれます。このアクションは、Fusion Webアプリケーションから挿入前のデータをダウンロードし、ExcelワークシートのADF表コンポーネントの行にそれを挿入します。InsertComponentプロパティは、挿入前のデータをホストするために挿入される行に関連付けられたADF表コンポーネントに対して構成されます。エンド・ユーザーはADF表コンポーネントのUploadアクションを起動して、挿入前のデータをFusion Webアプリケーションのデータベースにコミットできます。
エンド・ユーザーがADF表コンポーネントでデータに加える変更をFusion Webアプリケーションにアップロードできるように、ADF表コンポーネントおよびホストされるワークシートを構成します。この機能を構成するには、どのようなユーザーによる操作やワークシート・イベントが、ADF表コンポーネントのUploadアクションを起動するアクション・セットを起動するかを決定します。
Fusion WebアプリケーションからのWebページで、エンド・ユーザーにデフォルトのアップロード用ダイアログとは異なるアップロード・オプションを提供するには、ADF表コンポーネントのUploadを起動するアクションの前に、アクション・セットでDialogアクションを指定する必要があります。詳細は、7.8.5項「カスタムのアップロード・ダイアログの作成方法」を参照してください。
|
注意: マスター/ディテール関係では、ADFデスクトップ統合はViewLink属性の編集をサポートしていません。これは、子のビュー・オブジェクトの選択が変わるためです。誤って編集されないようにするため、ViewLink属性を読取り専用にするか、マスターとディテール間のビュー・リンクを含まないモデル構成を使用してください。 |
Oracle ADFコンポーネント、ワークシート・リボン・ボタン、コンポーネント(ボタンなど)、ワークシート・イベントを構成して、ADF表コンポーネントのUploadアクションを起動するアクション・セットを起動します。
Oracle ADFコンポーネントを構成してADF表コンポーネントに変更済データをアップロードする手順:
統合Excelワークブックを開きます。
アクション・コレクション・エディタを開いて、ADF表コンポーネントのUploadアクションを起動するアクション・セットを構成します。
アクション・セットの詳細は、8.2項「アクション・セットの使用」を参照してください。
ADF表コンポーネントのUploadアクションを、実行時にアクション・セットにより起動されるアクションのリストに追加します。
図7-4は、EditPriceList-DT.xlsxワークブックのアクション・コレクション・エディタを示します。ここでは、実行時にSave ChangesというラベルのADFボタンにより起動されるアクション・セットが構成されます。
「OK」をクリックします。
|
注意: このアクション・セットには、ADF表コンポーネントのバッチ・オプションにCommitへのコールがすでに含まれるため、コミット・タイプのアクションのコールは含まれません。詳細は、7.10.1項「ADF表コンポーネントのバッチ・オプションの構成」を参照してください。 |
実行時にエンド・ユーザーは、構成したメカニズム(ADFコンポーネント、ワークシート・リボン・ボタン、ワークシート・イベント)アクション・セットを起動します。これによって、次の一連のイベントがトリガーされます。
ADF表コンポーネントに動的な列が含まれる場合、ADFデスクトップ統合は前回ADF表コンポーネントのDownloadアクションが起動されたときに展開された動的な列が、まだFusion Webアプリケーションに存在するかどうかを検証します。列が存在しない場合は、ADFデスクトップ統合はアップロード処理を続行するかどうか決めるようエンド・ユーザーにプロンプトを表示します。エンド・ユーザーが続行しないと決めた場合、ADFデスクトップ統合は実行中のアクション・セットに中止コードを返します。
ADF表コンポーネントにアップロードする保留中の変更がない場合、ADF表コンポーネントのUploadアクションは実行中のアクション・セットに成功コードを返します。
7.8.5項「カスタムのアップロード・ダイアログの作成方法」」にあるようにアクション・セットにカスタムのアップロード・ダイアログを構成しなかった場合、ADFデスクトップ統合は図7-5に示すようなデフォルトのアップロード・ダイアログを表示します。
エンド・ユーザーが「取消」をクリックした場合、ADFデスクトップ統合は実行中のアクション・セットに中止コードを返します。エンド・ユーザーが「OK」をクリックすると、アクション・セットはアップロード操作のダイアログで指定したオプションの実行を続けます。
ADF表コンポーネントは、変更した行を1行ずつではなく、バッチでアップロードします。バッチ・オプションはBatchOptionsプロパティ・グループを使用して構成できます。ADF表コンポーネントのバッチ・オプションの詳細は、7.10項「ADF表コンポーネントでのバッチ処理」を参照してください。
各バッチ行は次のように処理されて、各バッチの変更されたすべての行が終わるまで処理が続けられます。
挿入された行の場合は、InsertBeforeRowActionIDアクションが起動されます(指定されている場合)。
キャッシュされたすべての行属性の値を含む、ワークシートからの属性をモデルに設定します。
編集された行の場合、UpdateRowActionIDアクションを起動し、挿入された行については、InsertAfterRowActionIDアクションを起動します(指定されている場合)。
アップロードされた各行について、ステータス・メッセージがStatus列に表示されます。詳細は、8.2.5項「アクション・セットの実行中にステータス・メッセージを表示する方法」を参照してください。
行について失敗があった場合、AbortOnFailの値が検証されます。AbortOnFailがFalseに設定されている場合、アップロード処理は続けられ、それ以外の場合はデータのアップロードを停止してコミット・アクションを起動します。
データをアップロードする際、ADF表コンポーネントは次の条件に基づいて実行中のアクション・セットに成功または失敗のコードを返します。
ADF表コンポーネントがすべてのバッチを問題なくアップロードした場合、実行中のアクション・セットに成功のステータスが返されます。エンド・ユーザーが手順3で「正常にアップロードした後はすべての行をダウンロードします」オプションを選択した場合、ADF表コンポーネントはFusion Webアプリケーションからすべての行をダウンロードします。
ADF表コンポーネントがすべてのバッチを正常にアップロードしなかった場合、アクション・セットはRowActions.FailureActionIDプロパティで指定されたアクションを起動します(このプロパティにアクションが指定されている場合)。ADFデスクトップ統合は、アクション・セットに失敗コードを返します。
手順3の「アップロード・オプション」ダイアログで「失敗した場合は、引き続き後続の行をアップロードします」を選択した場合、一部の行で検証に失敗した場合でも、Uploadアクションはアクション・セットに成功コードを返します。
|
注意: ADF表コンポーネント列のReadOnlyプロパティがTrueに評価された場合、ADF表コンポーネントのUploadアクションは列のセルの変更を無視します。
ADF表コンポーネント列のプロパティの詳細は、表A-10を参照してください。 |
実行時にADF表コンポーネント列のReadOnlyプロパティがTrueに評価された場合、ADF表コンポーネントのUploadアクションは列のセルにあるすべての変更を無視します。
行の値をバインディングする式を式の一部として指定するReadOnly EL式は使用しないでください。行の値のバインディングを使用しなければならない場合、EL式がUpload中にどのように評価されるかを理解する必要があります。すべてのEL式の評価は現在、クライアント上で実行されています。このため、行の値を更新する前に、最初に行の値のバインディングを含むReadOnly EL式を評価するときに、サーバーへの余分な往復の通信が必要となります。サーバーへの追加コールの高いコストを回避するために、アップロード中のReadOnly EL式の評価は、表の変更の追跡と同じようにして実行されます(ユーザーがオフラインの場合と同様)。
変更の追跡の詳細は、7.19項「ADF表コンポーネントでの変更の追跡」を参照してください。
ADF表コンポーネントがデータのアップロードを開始すると、ADFデスクトップ統合はアップロード処理を開始する前にセーブポイントを作成します。なんらかの失敗があった場合、ADFデスクトップ統合は同じセーブポイントまで戻り、Fusion Webアプリケーションのサーバー・サイドの状態の整合性を維持します。
アップロードされる行ごとに、ADFデスクトップ統合は次の処理を実行します。
サーバー上でDataControlFrameセーブポイントを作成。
行の属性値の変更を適用し、データの検証を実行。
なんらかのエラーがあった場合、セーブポイントの状態に復元。
セーブポイントの詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』の「ツリーを使用したマスター/ディテール・オブジェクトの表示」の項を参照してください。
デフォルトのアップロード・ダイアログのものとは異なるオプションをエンド・ユーザーに提供する、Fusion Webアプリケーションからのページを表示します。アクション・セットでADF表コンポーネントのUploadアクションを起動するアクションの前に、Dialogアクションを追加します。
カスタムのアップロード・ダイアログを作成する手順:
Fusion Webアプリケーションを開発するJDeveloperプロジェクトにページを作成します。このページの作成方法の詳細は、8.4項「Fusion WebアプリケーションからのWebページの表示」を参照してください。
8.4項「Fusion WebアプリケーションからのWebページの表示」 に示すADFdi_CloseWindow要素(span要素など)の他に、手順1で作成するページには表7-6に示す要素を含める必要があります。
表7-6 カスタム・アップロードに必要なSpan要素
| 名前 | 説明 |
|---|---|
|
この要素を |
|
|
この要素を |
|
注意: 作成するページには、ADFデスクトップ統合がデフォルトのアップロード・ダイアログをエンド・ユーザーに表示しないように、両方の要素を含める必要があります。 |
手順1 で作成したページを起動するには、ADF表コンポーネントのUploadアクションを起動するアクション・セットのアクションより前に、Dialogアクションを追加します。
Fusion Webアプリケーションからのページを表示する詳細は、8.4項「Fusion WebアプリケーションからのWebページの表示」を参照してください。
カスタムのダイアログが表示されるときに、デフォルトのアップロード・ダイアログではなく、表示されるアクション・セットでDialogアクションを構成するFusion Webアプリケーションからのページが表示されます。
|
注意: エンド・ユーザーがデータをアップロードしようとしたときにサーバーに接続されていなかったり、エンド・ユーザーが統合Excelワークブックをオフライン・モードで使用している場合、Dialogアクションでカスタムのアップロード・ページが見つからなければ、エラーが表示されます。サーバーへの接続がない場合、ADFデスクトップ統合が標準のダイアログに戻ることはありません。 |
Fusion Webアプリケーションからのページを表示する詳細は、8.4項「Fusion WebアプリケーションからのWebページの表示」を参照してください。それ以外の、データをアップロードするために構成するアクション・セットの実行時の動作については、7.8.2項「ADF表コンポーネントでデータをアップロードする際の実行時の処理」を参照してください。
ADF表コンポーネントは、アクション(DeleteFlaggedRows)を公開します。このアクションは起動されたときに、ADF表コンポーネントでフラグの付いた行に対応するFusion Webアプリケーションの行を削除します。ADF表コンポーネントでフラグの付けられた行とは、7.10項「ADF表コンポーネントでのバッチ処理」に示すように、エンド・ユーザーがダブルクリックしたか、_ADF_FlagColumn列のセルに文字を入力した行です。_ADF_FlagColumn列を構成してFusion Webアプリケーションの行を削除するには、列がADF表コンポーネントに存在する必要があります。
また、ADF表コンポーネントをホストするワークシートに関連付けるページ定義ファイルは、Deleteアクション・バインディングを公開する必要があります。
ADF表コンポーネントから行を削除するには、Deleteアクション・バインディングをページ定義ファイルに追加し、ADF表コンポーネントのRowActionsプロパティ・グループを構成して、さらにアクション・セットを構成してDeleteFlaggedRowsアクションを起動する必要があります。
ADF表コンポーネントを構成して、Fusion Webアプリケーションで行を削除する手順:
JDeveloperでFusion Webアプリケーションを開きます。
存在しない場合は、Deleteアクション・バインディングを、ADF表コンポーネントをホストするExcelワークシートに関連付けられたページ定義ファイルに追加します。
詳細は、4.3項「統合Excelワークブックのページ定義ファイルの使用」を参照してください。
ADF表コンポーネントのプロパティ・インスペクタを開いて、表7-7に示すようにRowActionsプロパティ・グループの値を設定します。
表7-7 ADF表コンポーネントのRowActionsプロパティ
| 設定するプロパティ | アクション |
|---|---|
|
ページ定義ファイルで公開された |
|
|
デフォルト値は |
ADF表コンポーネント・プロパティの詳細は、A.9項「ADF表コンポーネントのプロパティとアクション」を参照してください。
「OK」をクリックします。
統合Excelワークブックを開きます。
アクション・コレクション・エディタを開き、実行時にアクション・セットを起動するときにエンド・ユーザーが使用するOracle ADFコンポーネント、リボン・コントロール、ワークシート・イベントにアクション・セットを構成します。
ADF表コンポーネントのDeleteFlaggedRowsアクションを、実行時にアクション・セットにより起動されるアクションのリストに追加します。
アクション・セットの起動の詳細は、8.2項「アクション・セットの使用」を参照してください。
「OK」をクリックします。
エンド・ユーザーは、7.10.2項「ADF表コンポーネントでの行のフラグ付け」にあるように、削除する行にフラグを付けます。それからエンド・ユーザーはアクション・セットを起動します。次の一連のイベントが発生します。
指定があれば、BatchOptions.StartBatchActionIDプロパティに参照されるアクション・バインディングが起動されます。
この手順での失敗はエラーとして処理されます。エラーがあるとアクション・セットの起動が停止します。また、アクション・セットにエラー条件が返されます。ActionSet.FailureActionIDプロパティにアクション・バインディングが指定されている場合、アクション・セットは指定されたアクション・バインディングを起動します。
バッチ・オプションの構成の詳細は、7.10項「ADF表コンポーネントでのバッチ処理」を参照してください。
アクション・セットは、RowActions.DeleteRowActionIDにより指定されたDeleteアクション・バインディングを起動します。
|
注意: ADF表コンポーネントのDownloadアクションを最後に起動した後に挿入され、Fusion Webアプリケーションにアップロードされていない行は、削除のフラグが付いていても無視されます。 |
Deleteアクション・バインディングの起動中にエラーがなければ、成功のメッセージ・エントリが_ADF_StatusColumn列に表示されます。失敗があった場合、ADF表コンポーネントはDeleteアクション・バインディングの起動を中止して、手順4に進みます。
BatchOptions.CommitBatchActionIDプロパティにアクション・バインディングが指定されている場合、アクション・セットがそれを起動します。この手順に失敗した場合、アクション・セットはバッチ処理を停止します。失敗がなかった場合、アクション・セットはBatchOptions.StartBatchActionIDプロパティによって指定されたアクション・バインディングを起動することにより、すべてのバッチがアクションによって処理されるまで次のバッチを処理します。
アクション・セットがすべてのバッチを正常に処理した場合、このプロパティにアクション・バインディングが指定されていれば、ActionOptions.SuccessActionIDプロパティにより指定されたアクション・バインディングが起動されます。続いて、RowActions.DeleteRowActionIDで指定されたDeleteアクション・バインディングを起動することによって、Fusion Webアプリケーションにより削除された行がワークシートから除去されアクション・セットに成功コードが返されます。
アクションがバッチを処理する間に失敗があった場合、アクション・セットはそのActionOptions.FailureActionIDプロパティで指定されたアクション・バインディングを起動します(このプロパティにアクション・バインディングが指定されている場合)。このアクション・バインディングは、アクション・セットに失敗コードを返します。
アクション・セットがアクションを起動する際に予期しない例外が発生した場合、アクション・セットにエラー・コードが返されます。行レベルのエラーはすべてStatus列に表示され、バッチ・レベルのエラーはすべてTable.errorsから追跡できます。エラー処理の詳細は、12.4項「統合Excelワークブックでレポートされるエラー」を参照してください。
ADFコンポーネントは、Excelワークブックで変更された行を、行ごとにではなくバッチ処理でアップロードします。バッチのサイズや、バッチのアップロード時にADF表コンポーネントが起動するアクションを決定するバッチ・オプションのプロパティを構成できます。
ADF表コンポーネントからデータをアップロードする際に、特定の状況ではエンド・ユーザーが予期しないエラーを体験する可能性があることに注意してください。バッチからの変更を記録した後に、ADFデスクトップ統合はCommitBatchActionIDで指定されたアクションを実行します。コミット・アクション中に発生したエラーが、それ以降のレコードのバッチにエラーがなくても、後に続くバッチ・コミット・アクションで引き続き報告される可能性があります。CommitBatchActionIDが呼び出されるときに存在する保留中のモデル更新が、コミットが失敗したときに自動的に戻らない場合、これが起こります。
こうしたエラーを回避するには、最初に保留中のモデル変更をコミットしようとするカスタムのアクションをCommitBatchActionIDに作成する必要があります。ただし、コミット中に例外が発生した場合は、カスタム・メソッドは後に続くすべてのバッチ・コミットが成功するように、最初に保留中のモデル変更をロールバックする必要があります。
|
注意: クライアントで期待されるコミット・エラーが報告されるように、ロールバック後にコミットの例外がスローされることが重要です。 |
ADF表コンポーネントには、ADF表コンポーネントによる行のバッチの管理を構成できるプロパティ・グループ(BatchOptions)があります。これらのプロパティの詳細は、A.9項「ADF表コンポーネントのプロパティとアクション」を参照してください。
ADF表コンポーネントのバッチ・オプションを構成する手順:
統合Excelワークブックを開きます。
ADF表コンポーネントを参照するExcelワークシートのセルを選択し、「Oracle ADF」タブの「コンポーネントの編集」ボタンをクリックします。
表示されたプロパティ・インスペクタでBatchOptionsプロパティ・グループの値を設定します。
表7-8 RowData.BatchOptionsプロパティ
| 設定するプロパティ | アクション |
|---|---|
|
ADF表コンポーネント・アクション( |
|
|
ADF表コンポーネントがそれぞれのバッチを処理した後で起動するアクション・バインディング。通常これは |
|
|
デフォルト値は |
|
|
各バッチの開始時に起動するアクション・バインディングを指定します。 |
「OK」をクリックします。
エンティティ・レベルでの失敗はバッチの失敗とは見なされません。コミット・レベルでの失敗(たとえば、外部キー属性の間違った値)はバッチの失敗と見なされます。
ADF表コンポーネントには、フラグの付いた処理で行を簡単に選択できる_ADF_FlagColumn列がデフォルトで含まれています。_ADF_FlagColumn列のセルをダブルクリックすると、対応する行にコンポーネント・アクションによって起動されるアクションによる処理のフラグが付きます。
エンド・ユーザーが_ADF_FlagColumn列のセルをダブルクリックすると、セルに実線の円が表示されるか非表示になり、その行にフラグが付いているかどうかが示されます。図7-6はフラグの付いた列の例を示します。
|
注意: デフォルトでは、実線の円記号はフラグ付けされた行処理としてフラグ付けされた行を示します。ただし、_ADF_FlagColumn列の空白でないセルは、フラグ付けされた行処理のために対応する行にフラグを付けます。 |
次のコンポーネント・アクションは、フラグ付けされた行に対して起動できます。
DeleteFlaggedRows
DownloadFlaggedRows
すべての行にフラグを付けるにはFlagAllRowsコンポーネント・アクションを、ADF表コンポーネントのすべての行からフラグを取るにはUnflagAllRowsコンポーネント・アクションを使用できます。
これらのコンポーネント・アクションの使用は、ADF表コンポーネントの_ADF_FlagColumn列があるかどうかによって決まります。ADF表コンポーネントから_ADF_FlagColumn列を削除すると、これらのコンポーネント・アクションはいずれも起動できません。コンポーネント・アクションの詳細は、A.9.3項「ADF表コンポーネントのアクション」を参照してください。
実行時にはエンド・ユーザーは以前にリストされたすべてのコンポーネント・アクションをアクション・セットから起動できます。起動されたコンポーネント・アクションは、フラグ付けされたすべての行を起動します。たとえば、フラグ付けされたすべての行をダウンロード、または削除します。コンポーネント・アクションを起動するアクション・セットの構成の詳細は、8.2.2項「アクション・セット内のコンポーネント・アクションの起動方法」を参照してください。
ADF表コンポーネントには、ワークシートにADF表コンポーネントを挿入する際にいくつかの列がデフォルトで含まれています。これらの列は、必要に応じてそのまま残しておくことも、削除することもできます。次に、これらの列とその目的を示します。
この列のセルは、ADF表コンポーネントの行の変更を追跡します。ダウンロードまたは最後に成功したアップロード以降にADF表コンポーネントの行のデータを変更した場合、上向き矢印のような記号が、_ADF_ChangedColumn列の対応するセルに表示されます。ユーザーのこの列のセルをダブルクリックすると、この記号は切り替わります(表示または非表示)。図7-7に例を示します。
|
注意: エンド・ユーザーがADF表コンポーネントのUploadアクションで、この列によってフラグ付けされた行の変更をアップロードしない場合、対応するセルに表示されるエントリをクリアする必要があります。 |
ADF表コンポーネントのDownloadアクションが起動されると、確認のダイアログがエンド・ユーザーに表示され、この列の1つ以上の行が変更済としてフラグ付けされます。Downloadアクションの実行を許可するには「OK」を、Downloadアクションの実行を停止するには「取消」をクリックします。
エンド・ユーザーがこの列のセルをダブルクリックすると、対応する行がフラグ付けされた行処理としてフラグ付けされます。実線の円記号が表示され、フラグ付けされた行処理のために行にフラグが付けられたことが示されます。この列の詳細は、7.10.2項「ADF表コンポーネントでの行のフラグ付け」を参照してください。
ADF表コンポーネントのDownloadFlaggedRowsアクションが起動されると、確認のダイアログがエンド・ユーザーに表示され、_ADFChangedColumnと_ADF_FlagColumnの1つ以上の行がフラグ付けされます。アクションの実行を許可するには「OK」を、アクションの実行を停止するには「取消」をクリックします。
|
注意: デフォルトでは、実線の円記号はフラグ付けされた行処理としてフラグ付けされた行を示します。ただし、_ADF_FlagColumnの空白でないセルは、フラグ付けされた行処理のために対応する行にフラグを付けます。 |
この列は、次のADF表コンポーネント・アクションの起動の結果をレポートします。
_ADF_StatusColumnのセルにメッセージが表示され、対応する行の起動結果が示されます。エンド・ユーザーがADF表列で定義されたDoubleClickActionSetを起動してエラーが発生した場合、そのエラーは対応する行のステータス列でもレポートされます。図7-8は、ステータス列のメッセージの例を示します。
「キー」列とも呼ばれるこの列には、実行時にADFデスクトップ統合によって使用されるADF表コンポーネントに関する重要な情報が含まれます。この列は実行時と設計時の両方に表示されます。設計時に表からこの列を削除できますが、実行時には自動的に表示される点に注意してください。
_ADF_RowKeyColumnの詳細は、7.12項「ADF表コンポーネントのキー列の構成」を参照してください。
ADF表コンポーネントは、_ADF_ChangedColumn列、_ADF_FlagColumn列、_ADF_StatusColumn列のプロパティを、参照する他の列のプロパティとは別の方法で処理します。InsertComponentやInsertUsesUpdate、UpdateComponentなどのプロパティの値セットは、表A-11に示すようなDisplayRowErrorsアクションを起動する場合を除いて無視されます。CellStyleNameやHeaderStyleNameなど、スタイルや外観に関連するプロパティの値を読み取ります。
統合ExcelワークブックにADF表を追加すると、設計時に「キー」列(列ID: _ADF_RowKeyColumn)が自動的に表示されます。「キー」列には、ADFデスクトップ統合で表が正しく機能するために使用される重要な情報が含まれます。実行時には「キー」列を削除しないでください。
「キー」列の位置、スタイルのプロパティ、ヘッダー・ラベルを構成できます。デフォルトでは_ADFDI_TableKeyCellStyleスタイルが適用されます。
「キー」列を構成する手順:
統合Excelワークブックを開きます。
ADF表コンポーネントを参照するExcelワークシートのセルを選択し、「Oracle ADF」タブの「プロパティの編集」ボタンをクリックします。
コンポーネントの編集: ADF表ダイアログで、Columnsの省略記号ボタン(...)をクリックして、TableColumnのコレクション・エディタを開きます。
IDが_ADF_RowKeyColumnの列を選択します。
必要に応じて列のプロパティを変更します。ただし、次のプロパティは変更しないでください。
DynamicColumn
InsertComponent
InsertUsesUpdate
UpdateComponent
ID
Visible
必要があれば、「上」と「下へ」の矢印キーを使用して、列の位置を変更します。
「OK」をクリックして、TableColumnコレクション・エディタを閉じます。
Click OK to close the Edit Component: ADF Table dialog.
旧バージョンのADFデスクトップ統合を使用して準備、構成された統合Excelワークブックを使用する場合、「キー」列は設計時には使用できません。この列は実行時にのみ表示されます。「キー」列のプロパティを構成する場合は、設計時にワークブックにプロパティを追加します。
設計時に手動で「キー」列を追加する手順:
統合Excelワークブックを開きます。
ADF表コンポーネントを参照するExcelワークシートのセルを選択し、「Oracle ADF」タブの「プロパティの編集」ボタンをクリックします。
表7-9の説明に従って、ADF表に新しい列を追加してプロパティを指定します。列の追加の詳細は、7.3.1項「ADF表コンポーネントへの列の追加方法」を参照してください。
表7-9 「キー」列のプロパティ
| 設定するプロパティ | 値 |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Valueのプロパティは空白にする必要があります。 |
|
|
|
必要があれば、「上」と「下へ」の矢印キーを使用して、「キー」列の位置を変更します。
「OK」をクリックします。
|
注意: 新しい列のIDプロパティを_ADF_RowKeyColumnに指定する必要があります。そうしなければ、この列は「キー」列と見なされず、実行時に別の「キー」列が自動的に表示されます。 |
ADF表コンポーネント列で値のドロップダウン・リストをレンダリングする場合は、TreeNodeListサブコンポーネントを使用します。値リストは、実行時に最高250の値を表示できます。ADFデスクトップ統合とは異なり、TreeNodeListサブコンポーネントは5.5項「コンポーネント・パレットの使用」の説明にあるように、コンポーネント・パレットには表示されません。かわりに、ADF表コンポーネント列のInsertComponentプロパティやUpdateComponentプロパティに値を指定するときに、サブコンポーネントとして起動します。ADF表コンポーネント列のプロパティの詳細は、A.9.2項「ADF表コンポーネント列のプロパティ」を参照してください。
TreeNodeListサブコンポーネントを起動した後、モデルドリブンのリストに関連付けられたツリー・バインディング属性を、TreeNodeListサブコンポーネントのListプロパティの値として指定する必要があります。モデルドリブン・リストに関連付けられたツリー・バインディング属性は、表コンポーネントのDownloadアクションが起動された後で、表コンポーネントの列のドロップダウン・メニューに値リストを移入します。
|
注意: ModelDrivenColumnComponentをサブコンポーネント・タイプとして選択すると、モデルドリブンの値リストをADF表コンポーネントに作成できます。モデルドリブン・リストの作成の詳細は、7.14項「ADF表コンポーネントへのModelDrivenColumnComponentサブコンポーネントの追加」を参照してください。 |
TreeNodeListサブコンポーネントのプロパティの詳細は、A.6項「TreeNodeListサブコンポーネントのプロパティ」を参照してください。
図7-9は、TreeNodeListが列のUpdateComponentプロパティのサブコンポーネントとして選択された後の、AdvEditPriceList-DT.xlsxのADF表コンポーネント列のプロパティ・インスペクタを示します。
ADF表コンポーネント列に列を追加して、TreeNodeListをサブコンポーネントとして選択します。それから、ツリー・バインディング属性をTreeNodeListサブコンポーネントのListプロパティの値に指定します。モデルドリブン・リストは、指定するツリー・バインディング属性に関連付ける必要があります。
ADF表コンポーネント列に値リストを作成する手順:
統合Excelワークブックを開きます。
ADF表コンポーネントを参照するExcelワークシートのセルを選択し、「Oracle ADF」タブの「コンポーネントの編集」ボタンをクリックします。
コンポーネントの編集: ADF表ダイアログで、Columnsの省略記号ボタン(...)をクリックして、TableColumnのコレクション・エディタを開きます。
「追加」をクリックして、新しい列を追加します。
InsertComponentの入力フィールドの横にある省略記号ボタン(...)をクリックして、挿入操作の実行時の値リストを構成します。
UpdateComponentの入力フィールドの横にある省略記号ボタン(...)をクリックして、更新操作とダウンロード操作の実行時の値リストを構成します。
両方のオプションでも、作成するサブコンポーネントの選択ダイアログが表示されます。
TreeNodeListを選択して、「OK」をクリックします。
手順5で選択したプロパティを展開して、次のように値を構成します。
Listプロパティのモデルドリブン・リストに関連付けられたツリー・バインディング属性を選択します。
8.8項「統合Excelワークブックでの依存値リストの作成」の説明にあるように、従属する値リストを作成する場合にのみ、DependsOnListの値を選択してください。DependsOnListに選択したツリー・バインディング属性またはリスト・バインディングは、従属値リスト内で親の値リストとして機能します。
必要に応じてReadOnlyプロパティを構成します。
これらのプロパティの詳細は、A.6項「TreeNodeListサブコンポーネントのプロパティ」を参照してください。
「OK」をクリックします。
実行時には、ADF表コンポーネントはDownloadアクションを起動して、それぞれの列に値を移入します。また、このアクションは値リストをレンダリングするよう構成した列に値リストを移入します。図7-10は、Master Price ListモジュールのAdvEditPriceList-DT.xlsxからの例を示し、Categoryが値リストを表示するよう構成された列です。
ModelDrivenColumnComponentサブコンポーネントをADF表コンポーネントに追加できます。ModelDrivenColumnComponentの値は、サーバー上でそれぞれの属性に指定されたコントロール・タイプのヒントにより決まります。
設計時には、列について、UpdateComponentプロパティまたはInsertComponentプロパティに対して、サブコンポーネント・タイプをModelDrivenColumnComponentと指定します。実行時には、属性に関連付けられたモデルドリブン・リストがある場合は、列はTreeNodeListサブコンポーネントを使用したドロップダウン・リストを使用します。属性に関連付けられたモデルドリブン・リストがなかったり、リストに基づいていないコントロール・タイプが指定されている場合、列でInputTextサブコンポーネントが使用されます。
モデルドリブン・リストの作成の詳細は、『Oracle Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド』の「モデルドリブン・リストの作成方法」の項を参照してください。
従属値リストのサポート
複数のModelDrivenColumnComponentリスト・サブコンポーネントがADF表コンポーネントで公開される場合、ADFデスクトップ統合は各リストが別のモデルドリブン・リストに依存するかどうかを判断します。リストに指定されたバインド変数が、別のリストにバインドされた属性を参照するかどうかが検証されます。
リストが別のモデルドリブン・リストに従属する場合、サブコンポーネントのDependsOnList値は実行時に自動的に設定されます。
サーバー・サイド・リストのバインディングの従属性は、同じツリー・ノードにあるリストについてのみ判断されます。次のツリー・ノード・リストのバインディングはサポートされていません。
異なるツリーまたはツリー・ノード内のリスト・バインディングに依存するバインディング
ページ定義ファイル内のリスト・バインディングに依存するバインディング
ビュー・オブジェクトによって返される使用可能な属性に応じて、実行時にADF表コンポーネントが拡張または収縮するように、ADF表コンポーネントに動的な列を追加できます。TableColumn配列内にあるColumnsグループのDynamicColumnプロパティによって、この動作は制御されます。列を動的にするには、DynamicColumnプロパティをTrueに設定します。TableColumn配列の動的な列とは、属性名が設計時に認識されていないツリー・バインディングまたはツリー・ノード・バインディングにバインドされている列です。動的な列は、実行時に複数のワークシートの列に拡張できます。
ADF表コンポーネントの動的な列は、次のサブコンポーネント・タイプをサポートしています。
InputText
OutputText
ModelDrivenColumnComponent
|
注意: ADFデスクトップ統合は、動的な列にあるサブコンポーネント・タイプTreeNodeListをサポートしていません。 |
モデルドリブンの値リストのサポート
また、動的な列を構成して、サブコンポーネント・タイプが実行時のモデルのメタデータから決定される値リスト・サブコンポーネントをサポートできます。設計時には、UpdateComponentプロパティまたはInsertComponentプロパティに対して、サブコンポーネント・タイプをModelDrivenColumnComponentと指定します。実行時には、動的な列の拡張の際に、値リストをキャッシュする前にモデルドリブンのランタイム・コンポーネントが決定されます。リモート・サーブレットによって、クライアントはモデル・メタデータを取得でき、クライアントは希望する列のサブコンポーネント・タイプを選択できるようになります。ModelDrivenColumnComponentの詳細は、7.14項「ADF表コンポーネントへのModelDrivenColumnComponentサブコンポーネントの追加」を参照してください。
EL式を次の形式で、ADF表コンポーネント列のInsertComponentプロパティによってサブコンポーネントとして指定されたコンポーネントのValueプロパティについて指定することにより、動的な列は、構成します。
#{bindings.TreeID.[TreeNodeID].AttributeNamePrefix*.inputValue}
または:
#{bindings.TreeID.AttributeNamePrefix*.inputValue}
詳細は、次のようになります。
TreeIDはADF表コンポーネントで使用されるツリー・バインディングのIDです。
TreeNodeIDは、ツリー・ノード・バインディングIDを指定するオプションの値です。この値を省略する場合は、属性がどのツリー・ノード・バインディングに属するかに関係なく、ツリー・バインディングからの一致するすべての属性が表示されます。
AttributeNamePrefixは、ツリー・バインディングの基底にあるイテレータ内に存在する属性のサブセットを識別します。AttributeNamePrefixの値を指定しない場合、ツリー・バインディングまたはツリー・バインディング・ノードのすべての属性が返されます。常に*文字を使用してください。
|
注意: 動的な列を追加する際、ツリー・ノード属性名がページ定義ファイルで指定されていないことを確認してください。実行時には、ツリー・ノード・オブジェクトは基底にあるイテレータからすべての属性名を返します。ページ定義ファイルに指定された属性名がある場合、ツリー・ノード・オブジェクトはそのリストに基づいて、使用可能な属性名のリストを限定します。 |
次の例は、EmpTreeバインディングのmodel.EmpViewノードにある、"period"で始まる名前を持つすべての属性を返します。
#{bindings.EmpTree.[model.EmpView].period*.inputValue}
ADF表コンポーネントのDownloadアクションまたはDownloadForInsertアクションが起動されるとき、ADF表コンポーネントは一致する属性の最新のセットが含まれるように動的な列を自動的に更新します。Downloadが起動されるたびに、ADFデスクトップ統合は動的な列に対して、すべての行に同じ属性セットがあることを要求します。Downloadの際に属性のセットが行ごとに異なる場合、エラーが発生することがあります。
動的な列がInsert操作とUpdate操作をどちらもサポートする場合、動的な列のInsertComponentサブコンポーネントとUpdateComponentサブコンポーネントについて、Valueプロパティに同じEL式を指定する必要があります。実行時には、ADF表コンポーネントはEL式により返される属性バインディングの値を表示する動的な列を含むように拡張します。
ADF表コンポーネントのUploadアクションが起動されるとき、ワークブックはエンド・ユーザーに対して、以前にダウンロードした属性がツリー・バインディングにもう存在しない場合、データのアップロードを続行するかどうかを決定するプロンプトを表示します。
宣言型SQLモードによるビュー・オブジェクトのサポート
宣言型SQLモードで構成され、実行時にカスタマイズされたビュー・オブジェクトをサポートするために、ADFデスクトップ統合はselectedプロパティがFalseに設定されている属性をすべて無視します。サーバー・サイドでは、JUCtrlHierNodeBindingオブジェクトが属性リストを決定し、リクエストがあればそれを統合Excelワークブックに渡します。
次の構文を使用して、動的な列のHeaderLabelプロパティにEL式を記述します。
#{bindings.TreeID.[TreeNodeID].hints.AttributeNamePrefix*.label}
または:
#{bindings.TreeID.hints.AttributeNamePrefix*.label}
動的な列でInsert操作およびUpdate操作がサポートされている場合、動的な列のInsertComponentおよびUpdateComponentのValueプロパティに指定するものと同じツリー・バインディングID、ツリー・ノード・バインディングID、および属性名の接頭辞の値を、動的な列のHeaderLabelプロパティで指定します。
エンド・ユーザーが値を入力しなければならない必須の列に、記号や文字列でマークを付ける場合は、HeaderLabelプロパティを構成する必要があります。次の構文を使用して、すべての必須の列に記号や文字列を追加するEL式を記述します。
=IF(#{bindings.TreeID.[TreeNodeID].hints.*.mandatory}, "<prefix_for_mandatory_cols>", "") & "#{bindings.TreeID.[TreeNodeID].hints.*.label}"
たとえば、次のEL式は必須の列のラベルにアスタリスク(*)文字を追加します。
=IF(#{bindings.MyTree.[myapp.model.MyChildNode].hints.*.mandatory}, "* ", "") & "#{bindings.MyTree.[myapp.model.MyChildNode].hints.*.label}"
列のデータ型に応じて、データ型ごとに異なるスタイルを指定できます。次の構文を使用して、動的な列のCellStyleNameプロパティにEL式を記述します。
=IF("#{bindings.TreeID.[TreeNodeID].hints.*.dataType}"="<data_type>", <custom_style_expression1>, <custom_style_expression2>)
次の例では、すべてのdate列にMyDateStyleスタイルが適用され、他のデータ型の列にはMyDefaultStyleが適用されます。
=IF("#{bindings.MyTree.[myapp.model.MyChildNode].hints.*.dataType}"="date", "MyDateStyle", "MyDefaultStyle")
次の例は、MyDateStyleスタイルがすべてのdateデータ型の列に、MyNumberStyleがすべてのnumberデータ型の列に、MyDefaultStyleがその他のデータ型の列にそれぞれ適用されるシナリオを示します。
=IF("#{bindings.MyTree.[myapp.model.MyChildNode].hints.*.dataType}"="date", "MyDateStyle", IF("#{bindings.MyTree.[myapp.model.MyChildNode].hints.*.dataType}"="number", "MyNumberStyle", "MyDefaultStyle"))
EL式の詳細は、付録B「ADFデスクトップ統合のEL式」を参照してください。
実行時、ADF読取り専用表コンポーネントは、参照するツリー・バインディングのデータを表示する、連続した範囲のセルにまたがる表をレンダリングします。エンド・ユーザーが編集できないデータを表示する場合に、このコンポーネントを使用します。
このコンポーネントは、Downloadアクションの起動時にコンポーネントがダウンロードする行数を決定するRowLimitなどのプロパティをサポートします。また、実行時にExcelワークシートに表示されるツリー・バインディングの列を決定するプロパティ・グループ(Columns)も含まれます。TreeIDプロパティは、コンポーネントが参照するツリー・バインディングを指定します。これらのプロパティや、ADF読取り専用表コンポーネントがサポートする他のプロパティの詳細は、A.10項「ADF読取り専用表コンポーネントのプロパティおよびアクション」を参照してください。
図7-11に、Master Price Listモジュールのページ定義ファイルExcelReadOnlyPageDef.xmlのツリー・バインディングProductListを参照するADF読取り専用表コンポーネントが実行時にレンダリングする列を示します。
図7-12に、同じADF読取り専用表コンポーネントの設計時の対応するビューを示します。プロパティ・インスペクタが最前面に表示されています。
ADFデスクトップ統合デザイナの作業ウィンドウを使用して、ADF読取り専用表コンポーネントをワークシートに挿入します。
ADF読取り専用表コンポーネントを挿入する手順:
統合Excelワークブックを開きます。
コンポーネントを配置するExcelワークシートのセルを選択します。
バインディング・パレットで、ADF読取り専用表コンポーネントを作成するバインディングを選択して、バインディングの挿入をクリックします。
表示されるダイアログで、「ADF読取り専用表」を選択します。
|
注意: または、コンポーネント・パレットまたは「Oracle ADF」タブを使用しても、ADF読取り専用表コンポーネントを挿入できます。「ADF読取り専用表」を選択して、コンポーネントの挿入をクリックします。コンポーネント・パレットを使用してコンポーネントを作成する場合は、実行時にコンポーネントに表示されるそれぞれの列を追加する必要があります。 |
表示されるプロパティ・インスペクタでプロパティを構成し、表示される列とコンポーネントが実行時に起動するアクションを決定します。
「OK」をクリックします。
|
注意: コンポーネントのプロパティを後から変更するには、コンポーネントを配置するワークシートのセルを選択して、プロパティ・インスペクタを表示します。 |
その他の列をADF読取り専用表コンポーネントに手動で追加したり、以前に削除した列をもう一度追加したりすることができます。
ADF読取り専用表コンポーネントに手動で列を追加する手順:
統合Excelワークブックを開きます。
ADF読取り専用表コンポーネントをホストするワークシートのセルを選択して、「Oracle ADF」タブの「コンポーネントの編集」ボタンをクリックし、コンポーネントの編集:ADF読取り専用表ダイアログを表示します。
Columnsの入力フィールドの横にある省略記号ボタン(...)をクリックして、ReadOnlyColumnコレクション・エディタを起動します。
「追加」をクリックして、ADF読取り専用表コンポーネントに手動で新しい列を追加します。
新しい列のプロパティに値を設定します。
ADF読取り専用表コンポーネントのプロパティの詳細は、表A-13を参照してください。
「OK」をクリックします。
ADF表またはADF読取り専用表コンポーネントがダウンロードする行数は、コンポーネントのRowLimitプロパティ・グループの値を設定すれば後世できます。また、必要に応じて、ダウンロード可能な行数が指定した行数を超過したときにエンド・ユーザーに警告する警告メッセージを表示できます。
Downloadアクションを起動するときにコンポーネントがダウンロードする行数を、RowLimit.MaxRowsプロパティの値として指定します。オプションで、ダウンロード可能な行数がRowLimit.MaxRowsで指定した値を超過した場合に、エンド・ユーザーがメッセージを受信するように、RowLimit.WarningMessageプロパティのEL式を記述します。
表タイプ・コンポーネントがダウンロードする行数を制限する手順:
統合Excelワークブックを開きます。
表タイプ・コンポーネントを参照するExcelワークシートのセルを選択し、「Oracle ADF」タブの「コンポーネントの編集」ボタンをクリックします。
詳細は、8.2項「アクション・セットの使用」を参照してください。
表7-10の説明に従って、RowLimitプロパティ・グループのプロパティを構成します。これらのプロパティの詳細は、A.1項「ADFデスクトップ統合で頻繁に使用するプロパティ」を参照してください。
表7-10 RowLimitプロパティ・グループ
| 設定するプロパティ | 設定する値 |
|---|---|
|
|
|
|
ダウンロードする最大行数に評価されるEL式を記述します。 |
|
|
このプロパティにEL式を記述して、ダウンロード可能な行数が デフォルトの値では次のメッセージも生成されます。
このプロパティの値がNULLの場合、 |
「OK」をクリックします。
図7-13は、ADF表コンポーネントの行の制限が構成されているEditPriceList-DT.xlsxワークブックの「コンポーネントの編集」ダイアログを示します。
表タイプ・コンポーネントのDownloadアクションが起動されると、RowLimit.MaxRowsの値として指定した行数がFusion Webアプリケーションからダウンロードされます。RowLimit.MaxRowsにEL式を指定したり、デフォルト値を変更しない場合、図7-14 に示すものに似たメッセージ・ダイアログが表示されます。
#{_ADFDIres['ROWLIMIT_WARNINGS_MESSAGE_1']}
表A-9 に示すRowDataプロパティ・グループを使用して、ADF表コンポーネントでキャッシュするデータを指定できます。この機能の詳細は、次を参照してください。
ADF表コンポーネントは、アクション(ClearCachedRowAttributes)を公開します。これは、公開されるとADF表コンポーネントの現在の行のキャッシュされた属性の値をクリアします。
エンド・ユーザーがRowData.CachedAttributes配列の要素にも指定した属性バインディングを表示または編集できるように、コンポーネント(ADF表コンポーネントの列やADF入力テキスト・コンポーネントなど)は構成しないでください。RowData.CachedAttributes配列は、ワークシートのDownSyncアクションで取得された値をキャッシュします。ワークシートのUpSyncアクションは、RowData.CachedAttributes配列の値をFusion Webアプリケーションに送信します。これによって、エンド・ユーザーがワークシート内のコンポーネントを通して公開される属性バインディングに行う編集が上書きされることがあります。
ADF表コンポーネントのClearCachedRowAttributesアクションを起動するアクションを含むDoubleClickActionSetを構成します。
ADF表コンポーネント内のキャッシュされた属性の値をクリアする手順:
統合Excelワークブックを開きます。
実行時にDoubleClickActionSetを起動するOracle ADFコンポーネントのアクション・コレクション・エディタを開きます。
アクション・セットの起動の詳細は、第8章「アクション・セットの使用」を参照してください。
ADF表コンポーネントのClearCachedRowAttributesアクションを起動するDoubleClickActionSetにアクションを追加します。
「OK」をクリックします。
エンド・ユーザーは、ADF表コンポーネントをホストする統合Excelワークブックのセルで、データを作成したり変更できます。
列が更新可能で読取り専用でなければ、変更の追跡がアクティブ化されます。エンド・ユーザーが次の変更を行うと、変更の追跡がアクティブ化されます。
セルの値の編集
セルの値の挿入または削除
どこかでコピーした値をADF表コンポーネント列のセルに貼り付ける場合
エンド・ユーザーが対応する行のデータを変更した場合、上向きの矢印に似た記号が_ADF_ChangedColumn列に表示されます。図7-15に例を示します。
この記号は、コンポーネントのReadOnlyプロパティの値がFalseに設定されているコンポーネントによってホストされているデータを、エンド・ユーザーが変更すると表示されます。ADF入力テキストおよびTreeNodeListサブコンポーネントには、どちらにもReadOnlyプロパティがあります。TrueあるいはFalseに評価されるこのReadOnlyプロパティに、EL式または静的な文字列を記述できます。Trueに評価される静的な文字列またはEL式を記述する場合、_ADF_ChangedColumn列には記号は表示されません。ReadOnly EL式および変更の追跡の詳細は、7.8.2項「ADF表コンポーネントでデータをアップロードする際の実行時の処理」を参照してください。
Trueに評価されるこのReadOnlyプロパティにEL式を記述する場合、ADFデスクトップ統合は変更の追跡の際に他のEL式とは異なる方法でこれを評価します。これは、エンド・ユーザーが切断されたモードで作業中にADF表コンポーネントのデータに変更を加える場合、Fusion Webアプリケーションへの接続を起動するのが望ましくないためです。かわりに、ADFデスクトップ統合は、Fusion Webアプリケーションへの接続が必要なEL式のあらゆる部分について、空白の文字列の値を代用します。この動作は、ADF表コンポーネントのCellStyleNameプロパティにも該当します。
|
注意: 変更を追跡する間に、エンド・ユーザーが新しいワークシートの行を挿入すると、セルのスタイルが適用されます。 |
たとえば、エンド・ユーザーが切断されたモードで、ADF表コンポーネント列のADF入力テキスト・コンポーネントにホストされるデータ値を変更するとします。変更を追跡する際に、ADFデスクトップ統合は、Fusion Webアプリケーションへの接続が必要なADF入力テキスト・コンポーネントのReadOnlyプロパティおよびADF表コンポーネント列のCellStyleNameプロパティのEL式の部分に対して、空白の文字列の値を代用します。このため、実行時の値を取得するためにFusion Webアプリケーションへの接続が必要な式の部分で、空白の文字列の値が代用された場合に、意図したとおりに評価されるこれらのプロパティにはEL式を記述します。
ADF出力テキスト・コンポーネントにはReadOnlyプロパティはありません。このコンポーネントまたはADF入力テキスト・サブコンポーネントおよびTreeNodeListサブコンポーネントによりホストされる値が変更されても、_ADF_ChangedColumn列は変更されません。
