Setting Component Properties

Specify the search record for this component.

Specify if you want a different search record specifically for add actions. For example, if you selected the auto-numbering option for employee IDs (EMPLID), do not include EMPLID in the search record. Likewise, you might want to create special security views for add actions that limit the rows that users can add based on specific search criteria. The system default is the standard search record if you do not specify an add search record.

Select to always run search logic (SearchInit PeopleCode) for this component. The default is deselected.

See Configuring Web Profiles.

No longer used in PeopleSoft applications. This option appears for upgrade purposes only.

Specify the record that defines the service parameters that you must map for PeopleSoft component URL-related content services or content reference service types. The system uses the context search record only when no key fields are defined for the primary search record and only in a related content configuration.

Understanding the PeopleSoft Related Content Framework

Select to add a new high-level key, such as a new employee ID or customer. Except in the case of effective dating, use Add to insert a new current row or to update future rows.

Select to update existing rows only.

Select to update current and future rows in an effective-dated record. Use only with effective-dated records. Do not use these actions unless the main record that is associated with the page definitions is effective dated. This information is translated to include history at runtime.

Select to update any rows (history, current, and future) in an effective-dated record. Use only with effective-dated records. This information is translated to correct history at runtime.

Select when you want to hide the Save button in the toolbar and disable the Alt+1 (Save) hot key. Selecting this option prevents users from being prompted to save when exiting a page. However, it does not prevent using PeopleCode to save a page with the DoSave() or DoSaveNow() functions. This functionality can be helpful for applications in which the user is not making database changes and does not need to be prompted to save.

Select to include the component in the menu navigation at runtime. The default is selected. If you do not want the component included, deselect the check box.

Select to ensure that spell check is run on all eligible spell check enabled fields in the component when a user saves the page. A field is eligible if it has been changed (or its ReEdit flag has been set) and it has not already been manually spell checked since it was last changed.

Select to have the component run against the standby database, which is used in systems where Oracle Golden Gate or Oracle Active Data Guard have been configured. For more information, see Configuring Read-Only Components.

Specify where you want all processing to occur after the key list of a page is selected and before the user can interact with the page. Processing includes building component buffers and running many types of PeopleCode.

Specify where you want all processing to occur after the user saves the component and SaveEdit PeopleCode validations have succeeded. Processing includes SavePreChange, WorkFlow, SavePostChange PeopleCode, and updates to the database.

Select the default mode by which the user accesses the component.

Select New to access the component in Add mode.

Select Search to access the component in the mode that is specified in the Default Search Action field.

Select Keyword Search to access the component using the Keyword Search page. The Keyword Search page is available only if you have configured the PeopleSoft Search Framework and mapped the component to a search definition.

See Working with Search Pages.

Specify where you want all processing to occur after the key of a page is selected and before the user can interact with the page. Processing includes building component buffers and running many types of PeopleCode.

Select from a list of the actions that you set in the Actions group box on the Use tab of the Components Properties dialog box. If you set only one action, this drop-down list box provides that choice as the default. The default search action determines the default that users see, but they can select another option from the toolbar at runtime.

Specify the type of search or lookup which appears by default when users access the search page and lookup pages associated with the component.

Select Basic display the Basic search page by default. The Basic search page provides access to a list of search key and alternate search key fields from which the user can choose one field to search. You should select Basic as the default search type for new users because a basic search page is easier to use than other types of search pages.

Select Advanced to display the Advanced search page by default. The Advanced search page provide access to all search key and alternate search key fields simultaneously. You should select Advanced as the default search type for power users because an advanced search page enables complex searches.

Select Keyword Only to display just the Keyword Search page by default. The Keyword Search page is availably only if you have configured the PeopleSoft Search Framework and mapped the component to a search definition.

See Working with Search Pages.

Select to display the Include History and Correct History check boxes on a search page. If a user selects Include History on a search page, the page appears in Update/Display All mode. If a user selects Correct History, the page appears in Correction mode. However, both of these check boxes appear only on the search page if Update/Display All and Correction were selected as actions in the Use properties for the component and the user has security access to the modes. This check box is selected by default.

Enter the message set and number that stores the text that comprises the link which users click to access the standard add page.

Enter the message set and number that stores the text that comprises the link which users click to access the standard search page.

Enter the message set and number that stores the text that comprises the link which users click to access the Realtime Search page. Because Realtime search functionality is disabled by default, these values are the same as the values associated with the Link to Find Existing Value Page. However, if you enable Keyword Search, you can enter different values so that the link text accurately indicates the type of search page that users access via the link.

Enter the message set and number that stores the text that comprises the link which users click to access the Keyword Search page, which appears only when Keyword Search is enabled for the component.

You set this option to display the Find an Existing Value heading on the search page. You can change the default message or redirect the component to use another message that is more appropriate for your use.

Adds a Save, OK, or Apply button to the toolbar, depending on the page type.

For modal components only. Deselecting this check box removes the Cancel button from the toolbar.

Runs spell check for all spell check-enabled fields in the component, regardless of whether any changes were made to the field.

Returns users to the search page.

Populates the page with the next or previous row of data from the database as shown on the Search page.

Opens the next or previous page in the component if it has more than one page.

Select to hide the Back button in the fluid-like portal header for classic components. This setting does not affect fluid components.

In some situations, you may want to force end users to utilize only the navigation provided by the application, such as the Next or Previous buttons for example. 

Hiding the Back button enables you to keep the user within an expected procedural sequence and can avoid confusion between a Back and a Previous button if both are displayed. The Previous button would take the user to the previous page in the current application procedure, while the Back button takes the user entirely out of the current procedure to a previous location, such as a homepage or a search results page, without saving any entered data.

Displays the page again without saving any entered data.

Enables the user to send a notification to other users.

Enables the user to view the worklist from the current component page.

Enables the user to access the next or previous item in the worklist.

Select each option to enable these toolbar buttons for this component.

See Setting Use Properties.

Select if you do not want the toolbar to appear on the component pages.

Select to display folder tabs at the top of the component page.

Select to display links at the bottom of the component page.

Enables the system to store the visited pages in the Back button history. This setting applies to the pages within the current component.

This can be enabled also using the SetTransferAttributes PeopleCode built-in function.

For more information, see SetTransferAttributes.

Select to return the user to the last viewed page within a component after being transferred to a different component. This setting applies in the event of a transfer between components.

The default behavior when using the Back button to return from a transfer between components is to display the initial page of the component, regardless if it was the last viewed page.

For example, with Return to Last Page in History selected, if the user was on the third page within the component prior to the transfer to another component, the system displays the third page in the original component after using the Back button to return from the transfer.

This can be enabled also using the SetTransferAttributes PeopleCode built-in function.

For more information, see SetTransferAttributes.

Select to send messages to the server whenever logic must be run. When the user presses Tab to exit a field-level event, a transmission to the application server occurs to run that field-level event and the page is refreshed.

Selected as the default. This mode reduces transmissions to the application server.

See Understanding Processing Modes.

This option is available for both processing modes.

See Enabling the Expert Entry Feature in the Security Component.

Opens the online help PeopleBook entry for the current page.

Copies the current page URL to the clipboard. The copied URL includes page, action, and search key information that appears in the context of the portal if the user passed through the portal. If the user did not pass through the portal, then only the page appears, without the portal frames.

This option adds a small http button to the pagebar.

Opens a new browser window with the search page for the current component. Users can view or enter data in the new window.

Opens the Page Personalizations page, which allows users to control the initial appearance of the component. This option enables users to:

• Select the initial page in the component that appears.

• Save the state of the expanded and collapsed sections.

• Save the state of the View All settings on the page for grids and scroll areas.

• Personalize the page field tab order.

Users can also elect to copy and share their settings for the component with other users.

See Personalizing Pages.