Common Elements Used in This Section

This section discusses common elements used in this section.

Common Links

This table describes the common links used in this section.

Field or Control Description

Link Options icon

Click the Link Options icon to display the Link Details page, where you can associate URLs with field values, which at runtime appear on the pagelet as active links that you click to access additional relevant information.

See Specifying Data Link Details.

Additional Text

The Additional Text group box contains options to add headers, footers, opening text, and closing text to a pagelet.

Field or Control Description

Header

Select a pagelet header. You can select from headers that are defined on the Define Header page.

See Defining Headers.

Opening Text

Select the type of opening text that you want to appear on the pagelet. Options are:

Freeform Text/HTML: The Text field appears. Enter the opening text that appears on the pagelet.

Message Catalog Entry: The Message Set and Number fields appear. Select the message set and message number that appear as opening text on the pagelet. You can select from the messages defined in the database.

See System and Server Administration: Message Catalog.

Show “View Source Data” Link

Displays when PS Query is selected as the data source for a pagelet. Select to display the Full Query Results link on the pagelet. Click the Full Query Results link to access the full results of the query used for the pagelet.

Closing Text

Select the type of closing text to appear on the pagelet. Options are:

Freeform Text/HTML: The Text field appears. Enter the closing text that appears on the pagelet.

Message Catalog Entry: The Message Set and Number fields appear. Select the message set and message number that appear as closing text on the pagelet. You can select from the messages defined in the database.

See System and Server Administration: Using Administration Utilities.

Footer

Select a pagelet footer. You can select from footers that are defined on the Define Footer page.

See Defining Footers.

Search Options

The Search Options group box contains the options to override the default search functionality for the current pagelet only.

See Defining Pagelet Wizard Transformation Types, Display Formats, and Data Types.

Field or Control Description

Search Box

Select a value from these options to determine the location of the search box field:

  • None: Do not show the search box. This is the default option.

  • Top Left: The search box appears at the top left corner of the pagelet, above the pagelet content but below any header and opening text.

  • Top Right: The search box appears at the top right corner of the pagelet, above the pagelet content but below the header and opening text.

  • Bottom Left: The search box appears at the bottom left corner of the pagelet, below the pagelet content but above any footer and closing text.

  • Bottom Right: The search box appears at the bottom right corner of the pagelet, below the pagelet content but above any footer and closing text.

  • Inline XSL: A PSSEARCHBOX node must be written into the transformation XSL to indicate where the search box appears. If multiple PSSEARCHBOX nodes are in the pagelet content after the transformation, only the first node is replaced by the search box. The PASSTHRU display format does not support this type of search box. If the display format is PASSTHRU, no search box appears in the pagelet.

Package

Enter the application class package name that you want to use to define and build the search for the pagelet.

Path

Enter the names—delimited by colons—of each subpackage in the hierarchy that drills down to the class that contains the method used to define and build the search for the pagelet.

Class ID

Enter the application class name that you want to use to define and build the search for the pagelet. The class must exist in the application package and subpackage that you specify.

Note:

If you have not defined default Search Option values for the data type on the Define Data Types page (PeopleTools, Portal, Pagelet Wizard, Define Pagelet Data Types), the Package, Path, and Class ID fields have no default values. You must enter values if you want to activate the pagelet search feature.

Customization

The Customization group box contains the option to customize your pagelet.

Field or Control Description

Customize

standardClick to customize the pagelet by applying a custom XSL template, or by directly editing the XSL resulting from the pagelet display options that you have defined so far. When you click Customize, you switch from a standard display format selected on the Select Display Format page to a custom format of your definition.

The XSL field is populated based on preexisting display options that are set for the original standard display format. You can edit the XSL directly in the XSL field and retain as much of the original standard display options as you want. Remember that if you apply an XSL template using the XSL Template field, the XSL is regenerated based on the selected template, and the original standard display options that you have set may be overridden. Making any edits to the XSL, either directly or by assigning a template, disconnects the pagelet definition from the original standard display format.

When you click the Customize button, the current pagelet definition is saved for restoration purposes. You can revert to this standard pagelet definition by clicking the Undo Customizations button.

Clicking this button assigns your pagelet to the Custom design format on the Select Display Format page - Step 4. When you return to the Specify Publishing Options page - Step 5, you access the version of the page for the Custom display format.

See Specifying Custom Display Options.