Setting Component Properties for Fluid Components

This section describes component properties from a fluid perspective.

Use the Component Properties, Fluid tab to set fluid component properties.

Image: Component Properties dialog box: Fluid tab

This example illustrates the options on the Fluid tab. You can find descriptions for the options after the example.

Component Properties dialog box: Fluid tab

Component Attributes

Field or Control

Definition

Fluid Mode

Indicates that the pages in this component are to be accessed in fluid mode. This is required for fluid rendering.

Layout Only

Select when testing the layout of the pages within the component. When selected the borders of all the group boxes on the page appear in different colors to illustrate the scope of each group box container.

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 SetTransferAttributes.

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 SetTransferAttributes.

Display on Small Form Factor Homepage

Select to enable the tile for this component to be displayed on fluid homepages and fluid dashboards on small form factor devices such as smart phones.

If Display on Small Form Factor Homepage is not selected, the tile for that component will not appear on fluid homepages and fluid dashboards when accessed by a small form factor device.

If a fluid homepage does not contain any tiles for components with Display on Small Form Factor selected, that fluid homepage displays an error message on the small form factor device, reading This Homepage is Empty: None of the tiles configured for this homepage are supported on smart phones.

Note: If a tile for a fluid component is not displayed on the fluid homepage, users can still access the component using other navigation features, such as the NavBar and the Navigator menu.

When a user personalizes a fluid homepage, a visual cue in the form of a smartphone icon appears next to a tile on the Add Tile dialog box indicating which tiles can be displayed on the homepage for a small form factor device. The smartphone icon appears for tiles associated with components with Display on Small Form factor selected.

When personalizing a homepage using a smartphone, tiles associated with components that do not have Display on Small Form Factor Homepage selected display a note reading Tile is not supported on this device.

See Working with Tiles on Small Form Factor Devices.

No System Header Page

Select if you have a custom header page that you want to display instead of the default, system header.

No System Side Page

Select if you have a custom side page that you want to display instead of the default, system side page.

Component Type

Select the type of component you are building:

  • Standard. Similar to standard, classic components, this type is used for most fluid components that will include fluid application pages.

  • Activity Guide. This component type applies to custom fluid activity guides—that is, those not created using the Manage Templates menu item under the Activity Guide menu folder. Activity guides aggregate a step-wise procedure or activity that spans multiple components.

    See Understanding Activity Guides for more information on how to create activity guide templates instead of creating activity guide components.

  • Master/Detail. Used for a special type of fluid component, similar to an activity guide, master/detail components provide access to multiple components, aggregating the navigation to these components in a master list, which remains displayed in the left panel. A master/detail component enables you to create a means of navigating easily amongst a collection of components sharing a common theme, such as those most likely to be accessed regularly by a particular role. See Working with Master/Detail Components for more information.

Search Type

Select the type of search the user will interact with when accessing the component:

  • None. Disables search pages for the component.

  • Standard. Displays a “standard” search page, which provides users with search results that they click, and drill into component pages and data replacing the entire browser window.

  • Master/Detail. Displays a two-panel search results page similar to fluid master/detail components, which also provides users with search results that they click, and drill into component pages and data. However, the search results remain active and visible in the left side panel, while the application page displays in the detail area.

For Standard and Master/Detail search types, either a Search Framework search definition or a pivot grid model needs to be associated with the component. For more detailed information on these options and how they are configured, see Working with Search Pages.

Note: When you enable either a Standard or Master/Detail search type, the system displays Next and Previous buttons in the fluid banner by default.

Header Toolbar Actions

Select the options to be displayed in the fluid banner:

Field or Control

Definition

Disable All Actions

Select to deselect all header toolbar actions. At runtime, the system displays a fluid banner containing no buttons.

Logout

Select for the Sign Out item to appear in the Actions List.

Used to logout, or sign off, of the application, returning the user to the system signon page.

Home

Select for the Home button to appear on the fluid banner.

Returns the user to the default fluid homepage, as if they’ve just signed on.

Back

Select for the Back button to appear on the fluid banner.

Returns the user to the previously visited item.

Note: If you switch languages during the middle of a PeopleSoft session (such as during development or testing), the Back button will continue to display the original language. The current language for a session can be switched using PeopleTools, Utilities, International, Preferences.

Add To

Select for Add To items to appear in the Actions List.

Enables a user to add a tile for the component to a fluid homepage, the NavBar, or Favorites.

Help

Select for the Help item to appear in the Actions List for the fluid pages in this component.

Important! This option is reserved for PeopleSoft-delivered components only.

When a user clicks Help, the system displays the PeopleSoft Online Help in a new browser page regardless of the form factor. The Help URL value must be specified the General tab of the web profile to enable any online help (same as for classic components and pages). For more information on configuring online help URL for your PeopleSoft system, see Configuring General Portal Properties.

Note: For fluid applications, you cannot launch online help from modal pages.

Note: For the Safari browser, running on iOS in full screen mode, PeopleSoft Online Help is displayed in a full modal page.

Notifications

Select for the Notifications button to appear on the fluid banner. When a user clicks the Notification button, the Notification window shows the list of push notifications for that user, such as actions and alerts. See Using the Notification Window for more information.

Deselect this option to disable notifications while within a specific component.

NavBar

Select for the NavBar button to appear on the fluid header, providing users with additional navigation features, such as the Navigator menu, Favorites, and other NavBar tiles.

Use the Component Properties, Fluid tab to set some fluid component properties.

If a component is a fluid component, then most of the properties on the Internet tab of the Component Properties dialog box do not apply. For example, none of the Toolbar actions apply.

However, these properties on the Internet tab do apply to Fluid components:

  • Primary Action (Search Pages).

  • Display Folder Tabs.

  • Process Mode options (except for Allow Expert Entry).

For more information on the Internet tab off the Component Properties dialog box, see Setting Internet Properties.

Note: In the current release, spell check is not supported for fluid mode. Do not enable spell check at the component level or at the field level for fluid applications.