アクション・チェーン・コードについて
新しいアクション・チェーンを作成すると、Visual Builderによって、新しいアクション・チェーンの基本クラス宣言を含むコード・ファイルが作成されます。 入力パラメータと戻りペイロード・タイプ(ある場合)を指定し、run()関数をオーバーライドするだけで済みます。 これらはすべて、コード・エディタ、アクション・チェーン・エディタ、またはその両方を使用して視覚的に実行できます。 必要に応じてローカル関数を作成することもできます。
次に、2つの入力パラメータの合計を返す単純なアクション・チェーンの例を示します:
図jsac-action-chain-code-overview.jpgの説明
アクション・チェーン内の変数の可用性は、変数のスコープによって異なります。 サブスコープで定義された変数は、上位スコープでは使用できません。 たとえば、アクション・チェーンがフロー・レベルにある場合、ページ・スコープの変数( $page)は使用できません。
変数、定数または関数を参照する場合は、現在のスコープで定義されていないかぎり、スコープを指定する必要があります。 スコープが指定されていない場合は、現在のスコープであることを意味します。 たとえば、ページの変数および関数は、$page.variables.myvarおよび$page.functions.myfuncではなく、$variables.myVarおよび$functions.myFuncとして参照されます。
ノート:
コンテキスト変数の再割当てを使用しないことを強くお薦めします(例: 監査およびアクション・チェーン・テストは文字列検索を使用した変数の使用状況の検出に依存するため、const page = $pageまたはconst pageVariables = $page.variables)。 たとえば、常にオブジェクトを完全に参照する必要があります: $page.variables.var1。
Actions.<actionName>(context, {
param1: val1,
param2: val2,
});moduleパラメータでは、カスタム・アクションのIDを指定します:Actions.runAction(context, {
module: â<custom-action-ID>â,
parameters: {
param1: val1,
param2: val2,
},
});| API部 | 詳細 |
|---|---|
| <actionName> | アクションの名前。 |
| コンテキスト | ランタイム・コンテキスト。 |
| パラメータ | アクション固有のパラメータ・オブジェクト。 |
| <custom-action-ID> | カスタム・アクションのJSONファイルで設定されたカスタム・アクションID。 |
| options | オプション。テストまたはトレースの目的でアクションのプロパティを保持するオブジェクト。 現在、アクションのIDを含めることができます。 |
各組込みアクションのAPIパラメータの詳細は、「Oracle Visual Builderページ・モデル参照」の「JavaScriptアクション」を参照してください。
ローカル関数
run()エントリ・ポイント関数をモジュラ・パーツに分割する必要が生じた場合は、ローカル関数を作成できます:
図jsac-local-function-code-example.pngの説明