ビジネス・オブジェクトへのプログラム・アクセスのためのビュー・オブジェクトへのアクセス

ビュー・オブジェクトは、ビジネス・オブジェクト行の問合せおよび操作を簡略化するOracle ADFコンポーネントです。 newView()関数を使用すると、特定のビジネス・オブジェクトのプログラムによるアクセス専用のビュー・オブジェクトにアクセスできます。

デフォルトでは、作成するカスタム・オブジェクトは、そのようなビュー・オブジェクトを持つように有効化され、選択した標準オブジェクトは、カスタマイズする元のアプリケーションの開発者によって有効化されます。オブジェクトAPI名の特定の値に対して newView(objectAPIName)ファンクションが呼び出されるたびに、そのプログラム・アクセス用に新しいビュー・オブジェクト・インスタンスが作成されます。この新しいビュー・オブジェクト・インスタンスは予測可能な初期状態です。通常、この新しいビュー・オブジェクト・インスタンスに対して最初に行うことは、次のとおりです:

ビュー・オブジェクトのfindByKey()関数をコールして、キーによる行を検索
ビュー基準を追加して、ニーズを満たすビジネス・オブジェクト行の必要な「サブセット」のみが返されるようにビュー・オブジェクトを制限します(「ビュー基準を使用したオブジェクトの検索」を参照)。

通常、ビュー・オブジェクトは、結果をソート順に返すように構成されます。デフォルトのソート順序がニーズを満たさない場合は、ビュー・オブジェクトのsetSortBy()メソッドを使用して、結果をソートするフィールド名のカンマ区切りリストを指定できます。新しいソート順序は、次にビュー・オブジェクトでexecuteQuery()メソッドをコールしたときに有効になります。使用可能なソート・オプションの詳細は、「問合せ結果のソート順の定義」を参照してください。

ビジネス・オブジェクトへのプログラムによるアクセスのためのビュー・オブジェクト・インスタンスは、どのアプリケーション・ユーザー・インタフェース・ページでも使用されないことが保証されます。つまり、スクリプト内のビュー・オブジェクトに対して実行する反復は、ユーザー・インタフェースに表示される現在の行に悪影響を及ぼしません。つまり、エンド・ユーザーには、変更したフィールド値、追加した新しい行、および変更した既存の行の結果が表示されます。これらは、そのオブジェクトとフィールドが表示されるページに存在すると想定されます。

たとえば、ユーザー・インタフェースに従業員が勤務する部門の番号および関連名と共に表示されているとします。スクリプトを記述した場合...

newView()を使用して、Departmentオブジェクトのプログラム・アクセス用のビュー・オブジェクトを取得し、
findByKey()を使用して、IDが現在の従業員の部門と一致する部門を検索し、最後に
現在の従業員の部門の名前を変更

この変更は、次回更新時に画面に反映されます。ビュー・オブジェクトにアクセスした後、ビュー・オブジェクトで使用する最も一般的なメソッドを次の表に示します。

最も一般的に使用されるビュー・オブジェクト・メソッド

メソッド名	説明
`findByKey()`	一意のIDで行を検索できます。戻り値: 指定されたキーを持つ行の配列(通常は0または1行を含む)。パラメータ: `key` - 目的の行の一意の識別子を表すキー・オブジェクト `maxRows` - 検索する最大行数を表す整数(通常は`1`が使用されます) 例: IDによるオブジェクトの検索を参照してください
`findRowsMatchingCriteria()`	フィルタ基準に基づいて一致する行のセットを検索できます。戻り値: 1行の`iter.hasNext()`および`iter.next()`メソッドを使用して一致する行を処理するために使用できるイテレータ。パラメータ: `viewCriteria` - フィルタを表すビュー基準。新しいビュー基準を作成する最も簡単な方法は、`newViewCriteria()`関数を使用することです。 `maxRows` - 検索する最大行数を表す整数(`-1`は、一致するすべての行を`500`の制限まで戻すことを意味します) 例: findRowsMatchingCriteriaを使用した子Rowset内の行の検索を参照してください
`appendViewCriteria()`	追加のビュー基準問合せフィルタを追加します。パラメータ: `filterExpr` - フィルタ式を表す文字列。 `ignoreNullBindVarValues` - NULLバインド変数値を含む式の述語を無視する必要があるかどうかを示すオプションのブール・パラメータ(指定されていない場合、デフォルトはfalse)。戻り値: - `void`. または、`newViewCriteria()`を使用してビュー基準をすでに作成している場合は、そのビュー基準を単一の引数としてこの関数に渡すことができます。
`executeQuery()`	現在追加されているビュー基準フィルタを使用して、ビュー・オブジェクトの問合せを実行します。戻り値: - `void`.
`hasNext()`	戻り値: - 行イテレータに反復処理する行が追加されている場合は`true`、イテレータにそれ以上の行がない場合、または最後の行の上または上にある場合は`false`。
`next()`	戻り値: - イテレータの次の行
`reset()`	ビュー・オブジェクトのイテレータを最初の行の前のスロットにリセットします。戻り値: - `void`.
`first()`	戻り値: - 行イテレータの最初の行、またはイテレータの行セットが空の場合は`null`
`createRow()`	新しい行を作成し、システム生成の`Id`主キー・フィールドに自動的に移入します。戻り値: - 新しい行
`insertRow()`	ビュー・オブジェクトの行のセットに新しい行を挿入します。戻り値: - `void`
`setSortBy()`	問合せ結果のソート順を設定します。戻り値: - `void`