OpenEdge Development: Mobile Applications - Product ...

fill( ) method
fill( ) method
Initializes the JSDO local storage from the data records in a single temp-table, or in one
or more temp-tables of a ProDataSet, as returned by the built-in read operation of the
Mobile resource for which the JSDO is created. This built-in operation is the single
resource operation that is annotated in the Mobile interface with the "read" operation
type. The result of calling this method replaces any prior data in JSDO local storage
with the records returned by the built-in read operation.
After completing execution, the working record for each referenced temp-table is set to
its first record, depending on any active parent-child relationships. So, for each child
temp-table, the first record is determined by its relationship to the related working
record in its parent temp-table.
Return type: null
Applies to: progress.data.JSDO class
Syntax
fill ( [ filter-string ] )
filter-string
A string that can be used on the AppServer to select records to be returned, much
like the WHERE option of the ABL record phrase. The actual format of this string and
its affect on the records returned is determined by the ABL routine on the
AppServer that uses it. For example, you might pass:
• A single key value (e.g., "30")
• A relational expression (e.g., "CustNum > 10 AND CustNum < 30")
• An actual WHERE string (e.g., 'Item.CatDescription CONTAINS "ski &
(gog* ! pol*)"')
Note: The JSDO requires the URI for the "read" operation of the resource to
contain the following query string: "?filter=~{filter~}", where filter
is the name of a string input parameter defined for the ABL routine that
implements the operation (INPUT filter AS CHARACTER).
Caution: Using an actual WHERE string for a dynamic ABL query can create a
potential security issue.
If you do not specify filter-string, the records returned, again, depend on the
ABL routine.
This method always executes asynchronously, and fires the following JSDO named
events, shown in operational order:
1. beforeFill event
2. afterFill event
208 OpenEdge ® Development: Mobile Applications