ページ・フロー・ダイアグラムでのページ・フォワードの定義

データ・アクションをページ・フロー・ダイアグラムに追加すると、ページ・フォワード要素を介してアクションをWebページにマップできます。ページ・フォワード要素とは、アクションによって起動されるWebページを表すものです。Strutsページ・フロー・ダイアグラムでは、ページ・フォワードを特定のWebページに関連付けてアクション・マッピングを完成させます。

多くの場合、データ・アクションとページ・フォワードのかわりにデータ・ページを使用すると、アプリケーションの同じ動作を迅速かつ簡単に実現できます。詳細は、コンポーネント・パレットで要素名を右クリックして「ヘルプ」を選択するか、または「データ・ページおよびデータ・アクションについて」を参照してください。

指定したページにアクションをマップするには、次のようにします。

  1. プロジェクトのStrutsページ・フロー・ダイアグラムを表示します。

  2. データ・アクション要素をページ・フロー・ダイアグラムに追加します

  3. コンポーネント・パレットからページ・フォワードを選択し、ページ・フロー・ダイアグラムのデータ・アクションの近くをクリックします。新規のページ・フォワード要素が作成されます。

    ページ・フローのデータ・アクションおよびページ・フォワード

    ページ・フローに挿入したアイコンは、最初は警告アイコンが重なって表示され、ページ・フォワードと関連付けるWebページがまだ定義されていないことが示されます。Webページをダブルクリックすると定義ダイアログが表示され、Webページを定義できます。定義後、警告マークは削除されます。

  4. ダイアグラムでページ・フォワード・アイコンのラベルをクリックし、名前を編集します。たとえば、browseDataTable.jspを起動するページ・フォワードには、/browseDataTableという名前を付けます。ページ・フォワード要素には、宛先のWebページと同じ名前を付けることをお薦めします。

    警告: 次の手順でフォワード遷移を作成する前に、必ず、フォワード先のWebページの名前を反映するようにページ・フォワード要素の名前を変更してください。フォワード遷移を挿入した後でページ・フォワードの名前を変更すると、pageNamePageDef.xmlファイル(実行時にデータ・アクションが参照)と、対応するWebページ(この.xmlファイルでADFバインディング定義を指定)との間で不一致が発生します。

  5. オプションで、すでに作成したページ要素をダイアグラムでダブルクリックし、ダイアログでページ・フォワードの宛先Webページの名前を指定します。デフォルトでは、名前はページ・フォワード要素から作成されます。ページ・フォワード要素とWebページの名前は同じにしておくことをお薦めします。

    ビジュアル・エディタでWebページをすぐに編集しない場合は、「このページをすぐに編集」チェック・ボックスの選択を解除します。この機能の詳細は、「Strutsページ・フロー・モデラーでのページ設計方法の選択」を参照してください。

  6. コンポーネント・パレットで「Forward」を選択し、ダイアグラムでデータ・アクション要素をクリックしてフォワード遷移を描画します。新規のページ・フォワード要素をもう1回クリックすると、フォワード遷移が完成します。myPageファイルの編集が完了している場合、ページ・フローは次のように表示されます。

    ページ・フォワードへのフォワードが定義されたデータ・アクション

    これで、ページ・フォワードに関連付けられたページの作成およびデータ・アクションのフォワードの作成が完了し、どちらのアイコンにも警告マークが表示されなくなります。

  7. ページ・フォワードの宛先を定義します

struts-config.xmlファイルがアクション・マッピングの定義で更新されます。

<action path="/myDataAction"
    className="oracle.adf.controller.v2.struts.actions.DataActionMapping"
    unknown="false"
    type="oracle.adf.controller.v2.struts.actions.DataAction"
    name="DataForm">
  <forward name="success" path="/myPage.do"/>
</action>    

ページ・フォワードをOracle ADFデータ・アクションにマップするたびに、ページに対するページ定義ファイルが作成され、クライアント・プロジェクト定義ファイルDataBindings.cpxにエントリが追加されます。詳細は、「データ・バインドされたStrutsアプリケーションでのページ・フローについて」を参照してください。

Webページを作成してページ・フォワード要素に関連付けると、そのページはページ・フロー・ダイアグラムのデータ・アクションから実行できます。


ページ・フロー・ダイアグラムからのOracle ADFアプリケーションの実行
ページ・フロー・ダイアグラムからのWebページの作成
ページ・フロー・ダイアグラムへの既存のWebページの関連付け