データ・コントロール・パレットを使用したビジネス・サービス・アクションの挿入

データ・コントロール・パレットを使用すると、Oracle ADFデータ・コントロールを介してビジネス・サービスによって定義されたメソッドを実行するアクション・バインディングを作成できます。ADF対応ドキュメントは、ADFアクション・バインディングをボタンまたはハイパーテキスト・リンクとして表示します。JSPファイルでは、このボタンはHTMLフォーム内の入力送信フィールドとして表示されます。

ヒント: ボタンまたはリンクを使用してメソッドを実行する以外の選択肢は、Strutsデータ・アクションを使用してメソッドを実行することです。この場合、コントローラによって作成されるADFアクション・バインディングを介して、ページにメソッドの結果を表示できます。データ・アクションに対してメソッドを実行するのは、そのメソッドがパラメータの値を受け付けるためのユーザー入力を必要としない場合に適しています。それ以外の場合、Webページでボタン(またはリンク)を使用してアクション・バインディングを作成し、そのバインディングがHTMLフォームを使用してパラメータの値を送信することができます。

Struts、JSP、ADF Business Components、およびOracle ADFアクション・バインディングと、カスタム・メソッドとの組合せを使用する詳細な例は、エンドツーエンドのトピックである「カスタム・メソッドを使用したビュー・オブジェクトでのバインド・パラメータの設定」を参照してください。

注意: データ・コントロール・パレットは、初めて開いたときには何も表示されないことがあります。モデル・プロジェクトからビジネス・サービスをパレットに移入するために必要なステップを完了してください。

ビジュアル・エディタで、WebページまたはADF JClientフォームに、グローバル・アクションをボタンとして挿入するには、次のようにします。

  1. ADF対応WebページまたはADF対応Swingパネルを作成し、ビジュアル・エディタでそれを開きます。

  2. 「表示」->「データ・コントロール・パレット」を選択して、パレットを開きます。

  3. データ・コントロール・パレットの階層を開きます。

    データ・コントロール・パレットは、次のような2種類のアクションを表示します。

  4. ルート・レベルまたはデータ・コレクションにある「Operations」フォルダから希望のアクションを選択し、ドロップダウン・リストから「Button with Form」または「Button」(すでにWebページでHTMLフォームが表示されている場合)を選択します。たとえば、HTMLフォームとコミット・ボタンを追加するためのパレットの選択肢は、次のようになります。

    Data Control Palette displays button with form operation

  5. ボタン(および、オプションでHTMLフォーム)をWebページに追加するには、データ・コントロール・パレットの上端から、ビジュアル・エディタで開いているWebページに選択項目をドラッグします。ビジュアル・エディタのデザイン・ビューでは、HTMLフォームの中でボタンを表示します。HTMLフォームは、ボタンを囲む破線のボックスとして表現されます。

    Form with Commit button

    ボタンのテキストは、実行時に生成された式から派生することに注意してください。ボタンのテキストを指定する場合は、プロパティ・インスペクタで値を編集できます。

  6. アクションが実行するメソッドがパラメータを使用する場合、パラメータの値を指定します

これで、このメソッドを実行する方法を確立できました。メソッドの結果を表示して、Webページでその値を動的に示す準備ができました。


データ・コントロール・パレットで表示される階層の詳細は、次のトピックを参照してください。

設計時にアクション・バインディングのプロパティをカスタマイズできます。詳細は、次のトピックを参照してください。

 

Copyright © 1997, 2004, Oracle. All rights reserved.