Oracle® Fusion Middleware Oracle Application Development Framework Fusion開発者ガイド 11gリリース1(11.1.1.9.0) B52028-07 |
|
![]() 前 |
![]() 次 |
この章では、ビュー・アクティビティおよびADFバインド・タスク・フローでパラメータを指定する方法について説明します。
この章には次の項が含まれます:
ビュー・アクティビティ入力ページ・パラメータは別名として使用できます。別名を使用すると、バインド・タスク・フロー入力パラメータをページ・パラメータにマップできるようになります。ビュー・アクティビティ入力ページ・パラメータは、コール元のタスク・フローで使用可能なマネージドBeanおよび情報をページ自体のマネージドBeanにマップします。ビュー・アクティビティから値を渡すには、値をページ・フロー・スコープまたはマネージドBeanに格納します。タスク・フローでのビュー・アクティビティの使用に関する詳細は、15.2項「ビュー・アクティビティの使用」を参照してください。
たとえば、ページはページ・パラメータとして#{pageFlowScope.empno}
を指定し、バインド・タスク・フローは入力パラメータ定義の値として#{pageFlowScope.employeeID}
を指定するとします。
ビュー・アクティビティ入力ページ・パラメータのfrom-value
は#{pageFlowScope.employeeID}
であり、to-value
は#{pageFlowScope.empno}
です。これにより、ページ定義とバインド・タスク・フローのそれぞれが使用されているコンテキストごとにパラメータを再定義する必要がなくなるため、両方とも再利用が可能になります。
タスク・フロー内に含まれている他の値は、バインド・タスク・フローの入力パラメータ定義値のみでなく、入力ページ・パラメータにもマップできます。
図16-1は、入力ページ・パラメータ・マッピングの指定方法を示しています。pageFlowScope
値またはマネージドBeanの値として、Employeeアクティビティにパラメータを渡すことができます。Employeeアクティビティでは、to-value
に指定したEL式に基づいて、pageFlowScope
内に配置することによって値を、またはマネージドBeanをTargetアクティビティに渡すことができます。
入力ページ・パラメータ値を設定して取得するには:
エディタで、タスク・フロー・ダイアグラムを開きます。
タスク・フロー・ダイアグラムで、ビュー・アクティビティを選択します。
プロパティ・インスペクタで、「ページ・パラメータ」をクリックします。
「入力ページ・パラメータ」セクションで、「追加」アイコンをクリックします。
評価時に、渡す入力ページ・パラメータがある場所、たとえば、#{pageFlowScope.EmployeeID}
を指定するEL式を使用して、from-value
を入力します。
図16-1のタスク・フローは、ビュー・アクティビティが取得できる入力パラメータ定義値を設定できます。パラメータ値を取得するために、ADFバインド・タスク・フロー入力パラメータ定義に対して指定された「値」
に一致するビュー・アクティビティについてfrom-valueを指定できます。
評価時に、ビュー・アクティビティに関連付けられたページが入力ページ・パラメータの値を取得できる場所、たとえば、#{pageFlowScope.EmployeeNo}
を指定するEL式を使用して、to-value
を入力します。
to-value
は、ビュー・アクティビティ入力ページ・パラメータの2番目の部分です。ビューに関連付けられたページが、ビュー・パラメータの値を取得できる場所を指定します。
コール先のADFバインド・タスク・フローは、入力パラメータを受け入れて、終了時にコール元に戻り値を渡すことができます。詳細は、16.4項「戻り値の指定」を参照してください。
注意: データ・コントロールは、タスク・フロー間でパラメータとして明示的に渡すのではなく、単にコール先のバインド・タスク・フローに対してdata-control-scope オプションを指定して共有できます。詳細は、18.3項「タスク・フロー間のデータ・コントロールの共有」を参照してください。 |
バインド・タスク・フローに入力パラメータを渡すには、次のものを1つ以上指定する必要があります。
タスク・フロー・コール・アクティビティの入力パラメータ。コール元のタスク・フローがパラメータ値を格納する場所を指定します。
コール先のバインド・タスク・フローの入力パラメータ定義。コール先のバインド・タスク・フローがパラメータ値を取得できる場所を指定します。
タスク・フロー・コール・アクティビティではなくURLを使用してバインド・タスク・フローをコールする場合は、URL自体にパラメータと値を渡します。詳細は、15.6.4項「URLを使用したバインド・タスク・フローのコール方法」を参照してください。
各オプションに指定された入力パラメータname
は、入力パラメータ値をコール先のバインド・タスク・フローに再度マップして戻すため同一になります。それぞれの「value」
は、コール元で値が取得される場所とコール先のタスク・フロー間のマッピングに対応します。
入力パラメータの値を指定しない場合、値はデフォルトで#{pageFlowScope.parmname}
に設定されます。parmname
はパラメータ名です。
コール先のバインド・タスク・フローの入力パラメータ定義に対して、入力パラメータが必要かどうかを指定できます。必要な入力パラメータを受け取らない場合は、エラーが発生します(これらのエラーには設計時および実行時にフラグが立てられます)。必要ではないと識別された入力パラメータ定義は、タスク・フロー・コール・アクティビティ作成時は無視できます。
デフォルトでは、すべてのオブジェクトは参照渡しされます。タスク・フロー・コール・アクティビティ入力パラメータは、個々の値ではなく、マネージドBeanオブジェクトが渡される場合にのみ、参照渡しできます。デフォルトでは、プリミティブ・タイプ(int
、long
、boolean
など)は値渡しされます。
「値渡し」チェック・ボックスは、プリミティブではなくオブジェクトにのみ適用され、参照渡しのデフォルト設定をオーバーライドするために使用されます。ただし、これらの2つを併用すると、パラメータが相互に参照する場合に予期しない動作につながる可能性があります。タスク・フロー・コール・アクティビティの入力パラメータAが値渡しで、タスク・フロー・コール・アクティビティの入力パラメータBが参照渡しの場合、BにAへの参照が含まれていると、AとBで2つの異なるインスタンスが生じる可能性があります。
例16-1は、バインド・タスク・フローで指定された入力パラメータ定義を示しています。
例16-1 入力パラメータ定義
<task-flow-definition id="sourceTaskflow"> . . . <input-parameter-definition> <name>inputParameter1</name> <value>#{pageFlowScope.parmValue1}</value> <class>java.lang.String</class> </input-parameter-definition> . . . </task-flow-definition>
例16-2は、タスク・フロー・コール・アクティビティに対して指定された入力パラメータ・メタデータを示しており、例16-1のバインド・タスク・フローがコールされています。
例16-2 タスク・フロー・コール・アクティビティの入力パラメータ
<task-flow-call id="taskFlowCall1"> . . . <input-parameter> <name>inputParameter1</name> <value>#{pageFlowScope.newCustomer}</value> <pass-by-value/> </input-parameter> . . . </task-flow-call>
ヒント: ページのパラメータを設定するために、ADFタスク・フローを使用できますが、この他にもパラメータ化されたフォームを「データ・コントロール」パネルからドロップしたり、起動アクションによって起動されたパラメータを取るメソッド付きのフォームを使用する方法があります。最初の方法では、パラメータがページに渡されます。その他の方法では、ページのパラメータが使用されます。ページにパラメータが必要な場合は、タスク・フロー・パラメータを使用するかスコープ変数を設定して渡す必要があります。 |
次の手順は、タスク・フロー・コール・アクティビティを使用してソース・タスク・フローからターゲット・バインド・タスク・フローに入力パラメータを渡す方法を説明しています。ソース・タスク・フローにある任意のアクティビティからパラメータ値を渡すことができますが、この手順で渡されるパラメータには、ソース・タスク・フロー内のページにある入力テキスト・フィールドの値が含まれます。
始める前に:
コール元およびコール先のタスク・フローを作成します(詳細は、14.2項「タスク・フローの作成」を参照してください)。コール元は、バインド・タスク・フローでも無制限タスク・フローでもかまいません。コール先のタスク・フローは、バインド・タスク・フローである必要があります。
コール元のタスク・フローで、図16-2のようなアクティビティを追加します。コール元のタスク・フロー上のビューに関連付けられたページには、入力テキスト・フィールドとボタンが含まれています。エンド・ユーザーがJSFページのボタンをクリックすると、タスク・フロー・コール・アクティビティに制御が渡されます。
ADFバインド・タスク・フローに入力パラメータを渡すには:
JSFページの入力テキスト・コンポーネントを選択します。
「プロパティ・インスペクタ」で、入力テキスト・コンポーネントの「value」を入力します。
EL式として、たとえば#{pageFlowScope.inputValue}
などの値を指定できます。
アプリケーション・ナビゲータで、コール先のタスク・フローの名前をダブルクリックしてそのダイアグラムを開きます。
コール先のタスク・フローの「概要」タブをクリックします。
「パラメータ」をクリックして、「入力パラメータの定義」ノードを展開します。
「入力パラメータの定義」の隣の「追加」アイコンをクリックします。
「名前」フィールドで、inputParm1
などのパラメータ名を入力します。
「値」フィールドで、パラメータ値を格納および参照するEL式、たとえば#{pageFlowScope.inputValue}
を入力します。
エディタで、コール元のタスク・フローのダイアグラムを開きます。
アプリケーション・ナビゲータで、コール元のタスク・フローにあるタスク・フロー・コール・アクティビティの最上部に、コール先のADFバインド・タスク・フローをドラッグ・アンド・ドロップします。
ダイアグラムでタスク・フロー・コール・アクティビティの最上部にバインド・タスク・フローをドロップすると、バインド・タスク・フローを参照するタスク・フローが自動的に作成されます。図16-3に示すように、タスク・フロー参照にはバインド・タスク・フローのIDとドキュメント名が含まれます。ドキュメント名は、IDを含むXMLソース・ファイルを示します。
タスク・フロー・コール・アクティビティの「プロパティ・インスペクタ」で、「パラメータ」をクリックして、「入力パラメータ」セクションを展開します。
入力パラメータを識別するnameを入力します。
入力パラメータを定義済のタスク・フロー・コール・アクティビティの上にバインド・タスク・フローをドロップしたため、nameはすでに指定されています。同じ入力パラメータ名を維持する必要があります。
パラメータ値(#{pageFlowScope.parm1}
など)を入力します。
タスク・フロー・コール・アクティビティの入力・パラメータの値は、コール元のタスク・フローがパラメータ値を格納する場所を指定します。
コール先のタスク・フローの入力パラメータ定義の値は、値が渡された後にコール先のバインド・タスク・フローの内で使用するために値が取得される場所を指定します。
実行時、コール先のタスク・フローは入力パラメータを使用できます。コール先のタスク・フローの入力パラメータ定義でvalue
としてpageFlowScope
を指定したため、コール先のADFバインド・タスク・フローのどこでもパラメータ値を使用できます。たとえば、コール先のバインド・タスク・フローのビュー・アクティビティにパラメータ値を渡すことができます。詳細は、15.2.2.2項「アクティビティ間の遷移時の処理」を参照してください。
図16-4に示すように、タスク・フロー・リターン・アクティビティにより、ADFバインド・タスク・フローはコール元のタスク・フローに戻ります。コール先のバインド・タスク・フローは、コール元のタスク・フローに戻り値を渡すことができます。
図16-5に示すように、コール元のタスク・フローに値が戻されます。
値を戻すには、次のものを指定する必要があります。
コール先のバインド・タスク・フローの戻り値定義。戻り値を読み取る場所を指定します。
コール元のタスク・フローのタスク・フロー・コール・アクティビティの戻り値。コール元のタスク・フローが戻り値を検出できる場所を指定します。
バインド・タスク・フローのコール元は、コール元に戻されるタスク・フロー・コール・アクティビティの戻り値を識別しないことにより、戻り値定義の値を無視することもできます。
タスク・フロー・コール・アクティビティの戻り値は、参照渡しで戻されます。ADFバインド・タスク・フロー内部で参照しているものがないため、値渡しおよびコピー作成の必要がありません。
次の手順を開始する前に、次のようにします。
コール元のタスク・フロー(バインドも無制限も可)およびターゲットのバインド・タスク・フローを作成します。
コール先のADFバインド・タスク・フローの戻り値を指定するには:
概要エディタで、コール先となるADFバインド・タスク・フローを開きます。
「パラメータ」をクリックして、「戻り値の定義」セクションを展開します。
「戻り値の定義」の隣の「追加」アイコンをクリックします。
「名前」フィールドで、Return1
などの戻り値を識別する名前を入力します。
「値」フィールドに、戻り値を読み取る場所を示すEL式を入力します。たとえば、#{pageFlowScope.ReturnValueDefinition}
。
タスク・フロー概要エディタで、コール元のADFタスク・フローを開きます。
コンポーネント・パレットで、ADFタスク・フロー・リストからコール元のADFタスク・フローのダイアグラムにタスク・フロー・コール・アクティビティをドラッグ・アンド・ドロップします。
タスク・フロー・ダイアグラムで、タスク・フロー・コール・アクティビティを選択します。
「プロパティ・インスペクタ」で、「パラメータ」をクリックし、「戻り値」セクションを展開します。
「名前」フィールドで、Return1
などの戻り値を識別する名前を入力します。
戻り値の名前は、コール先のバインド・タスク・フローの戻り値定義の名前と一致する必要があります。
ヒント: タスク・フロー・コール・アクティビティの上にコールする予定のバインド・タスク・フローをドロップする場合、「name」フィールドはすでに指定されています。したがって、戻り値の「名前」フィールドは、コール先のバインド・タスク・フローの戻り値定義のname と自動的に一致します。 |
「value」フィールドで、コール元のタスク・フローが戻り値を検出できる場所を指定するEL式、たとえば#{pageFlowScope.ReturnValue}
を入力します。
タスク・フロー・コール・アクティビティを使用して、ADFリージョンまたはADF動的リージョンとしてバインド・タスク・フローが実装された場合、標準のEL式構文を使用してパラメータ値を指定できます。たとえば、#{bindings.bindingId.inputValue}
または#{bindings.bindingId}
、単純に#{inputValue}
構文を使用してパラメータを指定できます。
例16-3に、ADFリージョンのタスク・フロー・バインディングの例を示します。
例16-3 ADFリージョンのtaskFlowバインディング
<taskFlow id="Department1" taskFlowId="/WEB-INF/Department.xml#Department" xmlns="http://xmlns.oracle.com/adf/Controller/binding" Refresh="ifNeeded"> <parameters> <parameter id="DepartmentId" value="#{bindings.DepartmentId.inputValue}" xmlns="http://xmlns.oracle.com/adfm/uimodel"/> </parameters> </taskFlow>
パラメータ値バインディングEL式にinputValue
を付加すると、パラメータには、実際のバインディング・オブジェクトではなくバインディングの値が割り当てられるようになります。
inputValue #{bindings.bindingId}を付加せずに例16-3
の構文を使用すると、(バインディングの値ではなく)バインディング・オブジェクトが渡されます。したがって、バインディングは誤ったコンテキスト(そのページのコンテキストではなく、タスク・フロー・コール、ADFリージョンまたはADF動的リージョンのコンテキスト)内で評価されることになり、最終的には、フレーム内に誤ったデータ・コントロール・コンテキストを設定して複数のデータ・コントロール・インスタンスが作成されます。