Setting Internet Properties

Access the Component Properties dialog box and select the Internet tab.

This example illustrates the fields and controls on the Component Properties dialog box: Use tab. You can find definitions for the fields and controls later on this page.

Component Properties dialog box: Internet tab

Search Page

Field or Control Description

Primary Action

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 Search Technology: 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.

Default Search Action

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.

Default Search/Lookup Type

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 Search Technology: Working with Search Pages.

Allow Action Mode Selection

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.

Link to Add Page

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

Link to Find Existing Value Page

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

Link to Realtime 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.

Link to Keyword Search Page

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.

Instructional Text

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.

Toolbar

Select the toolbar actions that you want to appear on the component pages. When you select a check box, that item appears as a toolbar button at the base of the component at runtime. All toolbar actions are set to display by default with the exception of Next Page in Component , Previous Page in Component, and Notify. Note that the default settings for the Action and Save buttons are affected by settings on the Use tab of the Component Properties dialog box.

Disabling any of the toolbar options also disables the hot key for that option in the PeopleSoft Pure Internet Architecture.

Field or Control Description

Save

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

Cancel

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

Spell Check

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

Note: Spell check at the component level is not currently supported in fluid applications.

Return to List

Returns users to the search page.

Next in List and Previous in List

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

Next Page in Component and Previous Page in Component

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

Hide Back Button

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.

Note: Hiding the back button is performed only with Application Designer. In the current release, there is no programmatic control over hiding or displaying the Back button. This property is a global setting at the component level.

Refresh

Displays the page again without saving any entered data.

Notify

Enables the user to send a notification to other users.

View Worklist

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

Next in Worklist and Previous in Worklist

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

Add, Update/Display, Update/Display All, and Correction

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

See Setting Use Properties.

Disable Toolbar

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

Multi-Page Navigation

Field or Control Description

Display Folder Tabs

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

Display Hyperlinks

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

Page Navigation in History

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 PeopleCode Language Reference: SetTransferAttributes function.

Return to Last Page in History

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 PeopleCode Language Reference: SetTransferAttributes function.

Processing Mode

Field or Control Description

Interactive

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.

Deferred

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

See Understanding Processing Modes.

Allow Expert Entry

This option is available for both processing modes.

See Enabling the Expert Entry Feature in the Security Component.

WSRP Compliant Option

Important:

WSRP is desupported in PeopleTools 8.61 and currently exists for backward compatibility only.

Pagebar

The pagebar is a small menu bar that appears at the top of each component page just below the universal navigation header. You can select which options appear to the user for each component. All options are selected by default. Select the Disable Pagebar check box to disable the pagebar.

Field or Control Description

Help Link

Opens the online help PeopleBook entry for the current page.

Copy URL Link

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.

New Window Link

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

Personalize Page Link

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.

Note: If you set this option for a particular component, all users accessing the component are able to personalize the pages in the component unless their personalization options prevent them from customizing pages. Security permission list settings or personalization options do not allow the option to be enabled or disabled per end user per component.

See Applications User’s Guide: Personalizing Pages.

You can also enable or disable any of these options using PeopleCode.

Note:

To enable the Print link in the pagebar, select the Enable Print option on the General page of the web profile and ensure Disable Pagebar is not selected. The appearance of the Print link is controlled by the web profile, not the component-level settings.

See PeopleCode API Reference: Understanding Page Class.

Personalize Page Option

For the page personalization option to appear to users, the following criteria, in addition to the selection of the Page Customization Link in the pagebar, must be met:

  • A PeopleSoft Pure Internet Architecture page, including search and secondary pages, must be visible to the user.

  • The page cannot be a PeopleTools-generated page, such as the Page Personalization page or the Personalize Column and Sort Order page for grids.

  • The current page cannot be an iScript.

  • The Personalize Pagelink cannot be hidden using PeopleCode for the current component.

  • The Personalize Page Settings, CUSTOMPGSET, personalization option on the Define Personalizations page must be enabled.

    This option is enabled by default. If this option is disabled, the end user cannot define, share, or copy page personalizations and all existing page personalizations for the user are deleted.

  • The current page must allow some form of personalization based on the end user's security profile and meet at least one of these conditions:

    • Display more than one page element with a TABINDEX >=1 supporting personalization (assume that all collapsible sections are expanded when determining visibility).

    • Contain at least one visible scroll area or grid with a visible View All link, enabled or disabled.

    • Contain at least one visible collapsible section.

Related Topics