ビジネス・オブジェクトのオブジェクト機能
オブジェクト関数は、特定のビジネス・オブジェクトのビジネス・ロジックをカプセル化するのに役立ちます。 オブジェクト関数を定義した後、ビジネス・オブジェクトに関連する他のスクリプトから関数を名前で呼び出すことができます。
ビジネス・オブジェクトのオブジェクト関数ルールを作成するには:
-
ルールを作成するビジネス・オブジェクトを選択します。
-
オブジェクトの「ビジネス・ルール」タブを選択します。
-
「オブジェクト関数」タブをクリックします。
ビジネス・オブジェクトに対して定義されているすべてのオブジェクト関数のリストが表示されます。
-
「+新規オブジェクト関数」をクリックし、オブジェクト関数を識別する名前を入力します。 必要であれば後でこれを変更できます。
-
ダイアログ・ボックスで「オブジェクト関数の作成」をクリックしてエディタを開きます。
-
プロパティ・ペインで、「パラメータ」をクリックし、ファンクションのパラメータを追加します。
「図bo-object-function.pngの説明」
完了したら、「すべてのプロパティ」をクリックします。
-
エディタで入力し、ビジネス・オブジェクトと関数パレットを使用して関数を作成します。 パレットを使用すると、関数の作成に使用できるフィールドおよび関数を追加できます。
パレットで関数または値の横にある矢印をクリックして、エディタの挿入カーソルの位置に挿入します。 パレットで関数を選択すると、関数の説明とその使用方法の例がパレットに表示されます。
Departmentという名前のオブジェクトにオブジェクト関数を作成すると、デフォルトで次のようになります:- 同じオブジェクト上の他のスクリプトが呼び出すことができます。
- Departmentタイプの行を取得するanotherオブジェクトに記述されたスクリプトは、それを呼び出すことができます。
プロパティ・ペインのプロパティの一部を変更すると、このデフォルトの動作の一部を変更できます。-
「外部システムから呼び出し可能」プロパティを有効にすると、Departmentオブジェクトを処理する外部システムがオブジェクト関数を起動することができます。 これを有効にするのは、そのオブジェクトに含まれるビジネス・ロジックに外部システムがアクセスできるようにする場合です。 このプロパティを有効にしない場合、オブジェクト関数はDepartmentオブジェクトの他のスクリプトによってのみコールできます。
外部システムからREST APIを介してオブジェクト関数をコールする場合は、Content-Typeヘッダーの値を
application/vnd.oracle.adf.action+jsonに設定する必要があります。 このContent-type値は、POSTアクション(application/vnd.oracle.adf.resourceitem+json)など、ビジネス・オブジェクトに対するアクションに使用される値とは異なることに注意してください。「外部システムから呼び出し可能」プロパティを有効にすると、オプションで「タイムアウト上書き」フィールドで指定された「デフォルトのGroovyタイムアウトを上書き」を指定できます。
-
「Privileged」プロパティを有効にすると、アクセス権のあるユーザーにあわせてオブジェクト関数が実行されます。 現行ユーザーがデータにアクセスする権利を持たない場合、ビジネス・ロジックがビジネス・オブジェクト・データの行を表示できるようにする必要があります。 「権限」プロパティが有効になっていない場合、スクリプトは、現在のユーザーがアクセス権を持つ行のみを問い合せることができます。
-
もう一度「オブジェクト関数」タブをクリックして関数を追加し、エディタを終了します。