PEOPLESOFT CAMPUS SOLUTIONS 8.

Using Grid and Scroll Area Controls

Navigating Through Data

Grids and scroll areas contain the same type of navigation structure. Instead of using a scroll bar to scroll
through the rows of data, PeopleSoft uses navigation buttons and links. These buttons or links appear in
the navigation header, within the row itself, or to the right of the tabs in a tabbed grid, as appropriate.
Certain options, such as Customize and the download to spreadsheet icon, appear only on grids.
Note. Don't confuse the navigation header for a grid or scroll area with the universal navigation header
that appears in the upper-right corner of the page.
This section discusses how to:
Navigate with buttons and links.
Add rows.
Delete rows.
Select rows.
Find data.

Navigating With Buttons and Links

The following table describes the buttons and links that might appear on your grid or scroll area.

Click to insert a new row after the current row.

Click to insert multiple rows. Specify the number of rows (1 to 99).
Click to delete the current row of data.
(Show Next Row) Click to display the next row or set of rows of data.
Note. The Show Next Row and Show Previous Row buttons are disabled if you are
viewing all rows of data.
(Show Previous Row) Click to display the previous row or set of rows of data.
(Show All Columns) In a tabbed grid only, click to expand grid columns to the right so
that tabs are no longer needed.
(Show Tabs) In a tabbed grid only, click to return the expanded grid to its tabbed state.

Customize Click to access the customization page for that grid, which enables you to sort by
column and reorder, hide, and freeze columns.
(Download) Click to display a new browser window, showing the contents of the grid in
a spreadsheet-like format.
View All Click to display the maximum number of rows available to be viewed at once on a
page. When this feature is enabled, the link morphs to read View x so that you can
return to the original setting. The value of x can change, and is set by the application
developer.
Find Click to find a row of data containing a specified search string.
First Click to access the first row or set of rows of data.
Note. The First and Last links are not available if you are viewing all rows at once, in
which case you scroll to see your data.
Last Click to access the last row or set of rows of data.
There are also keyboard shortcuts for all of the above buttons and links. See Hotkeys.

In addition to these links and buttons, there is a numbering system for the rows. For example, if a grid or
scroll area were set to view only one row at a time, the navigation header might read 1 of 2 or 1 of 20,
depending on how many entries there were. If the grid or scroll area were set to view three rows of data
at a time, it might read 1-3 of 20. Click the arrows to view the next or previous series of rows. In the
Message Log scroll area, for example, you can see that it contains 560 total rows of data, displaying just
one row at a time. Select View 100 to see the rows in groups of 100 at a time.

Sample scroll area

Adding Rows
You can click the Add or + button to add an empty row after the current row

Note. If you do not insert a new row, any data that you enter overwrites the existing data in the current
row. However, the changes that you make do not take effect until you save the page. If you exit the page
without saving, the original data remains intact. You can only type over existing data in the effective-dated
table in Correction mode.
In some cases, you can add several rows at once to your grid or scroll area by clicking the +... (multi-row
insert) button. When you click this button, the system prompts you to specify the number of rows needed.
You can add up to 99 rows at once. This option is not always available.

Deleting Rows
You can also delete rows of data from a grid or scroll area. To delete a row of data, select the row by
using the navigation header or by clicking a field in the row. Then click the Delete or – button. The system
confirms the deletion by asking if you want to proceed. It also reminds you that the row will not be deleted
from the database until you save the transaction; however, the row is automatically removed from the grid
or scroll area. To retrieve the row, click the Back button in your browser or close the transaction without
saving your changes; the system does not save any other changes that you made to the page.

Selecting Rows
For certain grids and scroll areas, you can select a single row or multiple rows in case you need to batch
a number of processes. Single-row selection is available when the system displays a radio button to the
left of each grid row or in the upper-left corner of a scroll area. Select a row by selecting one of the radio
buttons in front of the row. Multiple-row selection is available when the system displays a check box to the
left of each grid row and in the upper-left corner of a scroll area. Select as many rows as you need by
selecting each check box.

Finding Data
The find feature on a grid or scroll area enables you to locate specific data, which is particularly useful if
your table contains hundreds of rows. Note that this feature allows you to search the data within the grid
or scroll area only. It does not search for any data outside the control. The find feature looks for matches
in edit boxes, display-only fields, disabled or shaded fields, dynamic links, and text in long edit boxes. It
does not find column headings, field labels, text values on icons, static links, and hidden fields. Find
searches from the left-most visible object of the current row down, based on the text that you enter in the
search prompt.
The Find link represents the find feature in the navigation bar of your grid or scroll area. Clicking this link
displays a dialog box prompting you to enter your search string. The find feature searches through all
rows of data in the buffer and brings the first occurrence in your search string to the top of the row list in
the grid. If you are in a scroll area that displays only one row of data at a time, the find feature opens that
row of data. To find the next occurrence, click the Find link and enter your search string again.
If your search string does not appear in the currently visible rows, the find feature opens a new display of
rows so that the row containing the search string appears in the grid. Note that on tabbed grids, the find
feature searches only the active tab.
When there are grid areas within a scroll area, the find feature searches only the current scroll level; it
does not search the grid data. Each control, if it is set up to perform a find, has a separate Find link in the
navigation header of that control.

Note. Your browser may also contain a find feature. This tool, however, does not search through data in
your PeopleSoft database. It searches the HTML code for what appears on the current open page only.
Thus, it searches field headings, read-only text, and headings in grids, group boxes, and scroll areas
only.

Working With Grids

Grids offer several functional benefits that scroll areas do not. This section discusses how to:
Select tabs for multiple views of a grid.
Collapse grids.
Customize grids.
Manipulate grid column sort order.
Download grid data.

Selecting Tabs for Multiple Views of a Grid

Tabbed grids enable you to view multiple columns of information without scrolling to the right. By clicking
the Show All Columns button just below the grid's navigation header, you can view the remaining columns
of grid data. To restore the grid to its original state, you can then click the Show Tabs button.
Alternatively, some grids may have an Expand All button to the right of the tabs, which enables you to
expand the grid columns to the right so that no tabs appear.

Collapsing Grids
You may also encounter grids that can be collapsed or expanded. Click the right-pointing triangle in front
of the grid heading to expand a grid that is hidden from view (collapsed).
These examples show both the collapsed and expanded states of the Component Interfaces grid.

Collapsed grid example

Expanded grid example

Downloading Grid Data

Some grids enable you to download grid data to a Microsoft Excel spreadsheet. The download feature
extracts all active, unhidden rows, regardless of whether the rows are visible on your screen.
To download grid data:
1. Click the Download button in the grid's navigation bar.
A new browser window opens, showing the data in a spreadsheet-like format.
2. Select File, Save As and save the data as a Microsoft Excel (.xls) file.

Note. The system downloads all field types (columns) with the exception of images.

Using Scroll Areas

A scroll area behaves like a grid, in that each occurrence represents one row of data in the database.
However, within a scroll area the fields are randomly arranged rather than set up like a spreadsheet.
These field groupings, although not physically displayed in a row, should still be considered as rows of
data in the database.
A scroll area looks like a group box with navigation tools in the navigation header. It does not actually
contain a scroll bar that you would use to scroll up and down between the various rows. Instead, use the
buttons and links in the navigation header to scroll through the data rows. Insert a new row into the scroll
area to insert a new row into the database table.

Example scroll area

Using Effective-Dated Scroll Areas and Grids

Many scroll areas and grids are controlled by an effective date and an effective-dated status. These
scrolls can have two values: active and inactive. The active and inactive values enable you to keep a
complete history of data for every value that you add. In most cases, you never want to delete a value;
you only make it inactive. Thus, you can retain a complete history of all your data and table values—
whether you changed them two years ago or want them to go into effect in two months—for trend
analysis and other historical reports.

With all this information at your fingertips, you can "roll back" your system to a particular point from which
you can perform analyses or projections for your company. You can also maintain all data on your
employees as it changes over time.

For example, when going through the employee review process, it is important to maintain records of past
reviews so that you can refer back to see how an employee has improved over time. Then, as employee
review time arrives again, you simply add a new row of data to the table by clicking the Add button rather
than by typing over the existing row. When you add a new row, the Eff Date (effective date) field
automatically populates with the system date, which is usually today’s date. You can keep this date or
change it to a future date if the information that you are entering does not take effect until later.

Because the system date is at or after the new effective-dated row that you created, the new information
becomes the current row and the previous row is now historical information. If you returned to this page
and clicked the Update/Display button, which displays only current and future rows, you would see only
the last data row that you entered. If you also wanted to see older data rows, you would have to click the
Include History button.

To correct incorrect data already in the system, click the Correct History button. (You should take this
approach rather than inserting a row with corrected data.)

Using Multiple Scroll Areas and Grids on a Page

Some PeopleSoft applications include pages that contain multiple scroll areas and grids. These scroll
areas and grids may be one on top of the other, side by side, or contained within each other (nested). The
fields controlled by one scroll area or grid are associated with only one database table. Pages with
multiple scroll areas or grids contain fields that write to multiple tables.

The Competency Assignment page in the following example contains two grids side by side. With this
format, you can transfer data from one grid to the other. In the example, you select a value from the
Category and Type drop-down list boxes to populate the Source Competencies grid. To select the
descriptions that you want to appear on Tom Green’s evaluation, select the appropriate check boxes
under the Description field in the Source Competencies grid. Then click the double left arrow button to
move those descriptions to the Assigned Competencies grid.

Side by side grids

Once you have assigned the competencies to the evaluation, you can evaluate Tom using the
Competency Rating page. The Competency Rating page in the following example contains the Assigned
Competencies grid nested within the Competency Evaluation scroll area.

Nested grid in a scroll area

The Evaluation ID/Type fields associated with the outer scroll area refer to the type of evaluation. The
fields associated with the Assigned Competencies inner scroll area refer to the specific competencies
included in the evaluation.

Another way of looking at nesting is to think of the scroll area and grid as having a parent and child
relationship. The table that stores information about individual competencies is a child of the table that
stores information about particular evaluations. Child tables share the same key structure as the parent
tables, plus one or more additional keys to uniquely identify individual rows.