About Supported Data Collection Operations in Oracle ADF
When you create and register business services for an application, the
Data Control Palette displays two types of actions:
-
Actions that typically operate on all data collections in the current
web page's binding context (such as commit and rollback) in the
Operations folder at the root level of the hierarchy.
-
Operations on a specific data collection (for example, EmployeesView).
Data collection&ndashspecific operations (such as create and delete)
appear in the Operations folder as child
nodes of the collection in the Data Control Palette.
Typical data control&ndashlevel, global actions defined by business
services include:
-
Commit will commit a transaction that updates the values of
data objects from the bound data collection to the database.
-
Rollback will rollback a transaction meant to update the values
of data objects in the bound data collection. No data is sent to the
database.
Typical data collection-specific operations defined by business services
include:
-
Create will create a new data object in the bound data
collection after the user submits the form with the response
object. In the case of web applications, create is the default
operation that appears on the Data Control Palette. Note:
In the case of Java clients (JClient), dragging Create from
the palette will set the button's action binding to
CreateInsert (see below), as this is the preferred behavior
for Java clients.
-
CreateInsert will create and insert a new data object into the
bound data collection. This operation does not wait for the user to
complete the submit. Note: This operation is
available only with Oracle ADF Business Components and it does not
appear on the Data Control Palette. In the case of web applications,
to change an existing create-only operation, to a create-and-insert
operation, display the action binding editor for the button in your UI
Model and select CreateInsert. In the case of JClient
applications, create and insert is the default behavior, although the
Data Control Palette displays the operation as Create.
-
Delete will delete the current data object from the bound data
collection.
-
Execute will execute the bound action defined by the data
collection. In the case of a JavaBean, the execute operation will
refresh the data control.
-
Find will retrieve a data object from the data collection.
-
First will navigate to the first data object in the data
collection range.
-
Last will navigate to the last data object in the data
collection range.
-
Next will navigate to the next data object in the data
collection range. If the current range position is already on the last
data object, then no action is performed.
-
Next Set will move the viewable range to the first data object
after the current range position defined by the bound data collection.
For example, when the data collection is a rowset, next set navigates
to the first row after the current range position. If the current
range position is already on the last set, then no action is
performed. Note: This operation is available only
with Oracle ADF Business Components.
-
Previous will navigate to the previous data object in the data
collection range. If the current position is already on the first data
object, then no action is performed.
-
Previous Set will move the viewable range to the data objects
located just before the current range defined by the bound data
collection. For example, when the data collection is a rowset,
previous set navigates to the first row after the current range
position. If the current range position is already on the last set,
then no action is performed. Note: This operation is
available only with Oracle ADF Business Components.
-
setCurrentRowWithKey(String) will pass the row key as a String
converted from the value specified by the input field. The row key is
used to set the currency of the data object in the bound data
collection. When passing the key, the URL for the form will not
display the row key value. You may use this operation when the data
collection defines a multipart attribute key.
-
setCurrentRowWIthKeyValue(String) will pass the row key as a
String specified by the input field. The row key is used to set the
currency of the data object in the bound data collection. Use this
operation only when the data collection uses a single key attribute
and does not define a multipart attribute key. When passing the key as
a value, the URL for the form will display the row key value.
Related topics
Inserting Business
Service Actions Using the Data Control Palette
Executing Business Service Methods with a Data Action
Inserting a URL to Pass Current Row Information to the ADF Binding Context
Copyright © 1997, 2004, Oracle.
All rights reserved.