ScrollSelect
Mon 01 January 2018Syntax
ScrollSelect(levelnum, [Record.level1_recname, [Record.level2_recname,]] Record.target_recname, Record.sel_recname [, sqlstr [, bindvars]] [, turbo])
where bindvars is an arbitrary-length list of bind variables in the form:
bindvar1 [, bindvar2]. . .
Description
The ScrollSelect function, like the related ScrollSelect functions (ScrollSelectNew, RowScrollSelect, and RowScrollSelectNew) reads data from database tables or views into a scroll area on the active page.
Note: This function remains for backward compatibility only. Use the Select rowset class method instead.
See .
Parameters
Field or Control |
Definition |
---|---|
levelnum |
Specifies the level of the scroll level to be filled (the target scroll area. The value can be 1, 2, or 3. |
target_recname |
Specifies a record identifying the target scroll, into which the selected rows are read. If target_recname is on scroll level 2, it must be proceeded by a Record. level1_recname . If it is on level 3, you must specify both Record. level1_recname and Record. level2_recname . |
Record. sel_recname |
Specifies the select record. The selname record must be defined in Application Designer and SQL created (using Build, Project) as a table or a view, unless sel_recname and target_recname are the same. The sel_recname record can contain fewer fields target_recname , although it must contain any key fields to maintain dependencies with other page records. This enables you to limit the amount of data read into the component buffers. |
sqlstr |
Contains a WHERE clause to restrict the rows selected from sel_recname and/or an ORDER BY clause to sort the rows. The WHERE clause can contain the PeopleSoft meta-SQL functions such as %Datein or %CurrentDateIn. It can also contain inline bind variables. |
bindvars |
A list of bind variables to be substituted in the WHERE clause. The same restrictions that exist for SQLExec exist for these variables. |
turbo |
Setting this parameter to True turns on turbo mode for ScrollSelect. This will improve the performance of ScrollSelect verbs by as much as 300%, but should be implemented with caution on existing applications. See . |
Returns
The number of rows read (optional.) This counts only lines read into the specified scroll. It does not include any additional rows read into autoselect child scrolls of the scroll.