Step 5: Specifying Pagelet Display Options

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.

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

See Defining Headers.

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 Message Catalog.

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.

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 Using Administration Utilities.

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

See Defining Footers.

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.

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

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.

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.

Click 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 noncustom 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 noncustom display format. You can edit the XSL directly in the XSL field and retain as much of the original noncustom 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 noncustom 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 noncustom display format.

When you click the Customize button, the current pagelet definition is saved for restoration purposes. You can revert to this precustomization 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.

Displays possible column headings provided by the selected data source parameters. Use the drop-down list boxes to set the order in which the columns appear on the table-formatted pagelet. Use the Add button or the Delete button to add or remove columns.

Specify the alignment of the text in the column. Options are Center, Left, and Right.

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.

The system displays the column names and enables you to set the comparators for that column based on numbers, text, or both.

Select to enable users to set their own threshold values for the table from the Personalization page.

Select the column name from the drop-down list box.

Select a comparator value for each column.

Enter the threshold value for the column. When this value is reached, the highlight and color attributes become active.

If you choose to have highlighting for the threshold, select either the entire row or just a single cell.

Select the color for the column.

Use the arrows to move each individual column up or down in the table.

Select a value from this field to display a header below the pagelet header, but above any opening text.

Select a value to include text above the pagelet details.

Select from these values:

• Freeform Text/HTML

  Select to enable the Text field and manually enter static text or HTML.

• Message Catalog

  Select to enter the message set and message number from which to derive the opening text from the message catalog.

Enter text or HTML. This field appears when you select Freeform Text/HTML as the opening or closing text.

Select a value to include text below the pagelet details.

Select from these values:

• Freeform Text/HTML

  Select to enable the Text field and manually enter static text or HTML.

• Message Catalog

  Select to enter the message set and message number from which to derive the opening text from the message catalog.

Select a value from this field to display a footer above the Footer bar, but below any closing text.

Select to have the menu pagelet display the top-level title defined in the underlying navigation collection.

Select to have the menu pagelet display the top-level description defined in the underlying navigation collection.

Select the number of columns to display (options are 1 through 4) on the navigation collection menu pagelet. Narrow pagelets display contents in one column. Wide pagelets can display contents in up to four columns.

See Understanding Pagelet Wizard Display Sizes.

Select the order in which you want navigation collection elements to appear on the menu pagelet. When you create a navigation collection, you define the order of folders and links in the collection using options in the Placement Properties group box on the Edit Folder page and the Edit Link page. Options are:

Left to Right: Select to display the elements from left to right on the menu pagelet.

Top to Bottom. Select to display the elements from top to bottom on the menu pagelet.

Select to display alternate row shading on the menu-formatted pagelet.

Select the type of images that you want to display for parent-level navigation collection elements (folders) on the menu pagelet. When you create a navigation collection, the collection definition includes specified large and small images that appear for parent-level elements in the navigation collection. Options are:

Large Images: Select to have the menu pagelet display the large folder image defined for the underlying navigation collection.

No Images: Select to prevent parent-level images from appearing on the menu pagelet.

Small Images: Select to have the menu pagelet display the small folder image defined for the underlying navigation collection.

Select to have the menu pagelet display parent-level folder descriptions defined in the underlying navigation collection.

Select the display type for child links on the menu pagelet. Options are:

Comma Delimited: Displays the maximum number of child links separated by commas.

List with Images: Displays the maximum number of child links accompanied by icons. This icon is the small content image selected in the navigation collection system or registry options for the underlying navigation collection.

Simple List: Displays the maximum number of child links, one child link per row. No bullets, numbers, or icons appear in the list.

Select the list format for displaying query results on the list pagelet. Options are:

Bulleted List: Displays query results in a bullet list.

Numbered List: Displays query results in a numbered list.

Simple List: Displays query results in a list with no bullets or numbers.

Select the field for which values are displayed in the list on the pagelet.

Select to use alternate-row shading on the list pagelet.

Select the type of chart to use to display the query results on the pagelet. Available chart formats are those supported by the PeopleCode Chart class.

See Understanding the Charting Classes.

Select the field to use to derive x-axis values for the chart. Available values are determined by the output fields of the data source.

Select the field that you want to use to derive the labels for the x-axis values for the chart. Available values are determined by the output fields of the data source.

Enter the angle at which you want the text of the x-axis labels to appear along the x axis on the pagelet.

Select to indicate whether the y-axis data is stored in rows or columns in the selected query. This enables Pagelet Wizard to read query data and generate the chart.

in Columns: Select if the y-axis data is stored in columns.

in Rows: Select if the y-axis data to be used to generate the chart is stored in rows.

Select the field that you want to use to derive y-axis values for the chart. Available values are determined by the output fields of the data source.

If you set the Y Axis Data field to in Columns, you can select up to four y-axis fields to create a chart pagelet that displays data for multiple fields. For example, if you track sales figures for several departments over multiple years, you can assign each department its own y-axis value.

Select the color for the y-axis data. If you select multiple y-axis fields, selecting a different color for each field improves pagelet usability. This option is available only if the y-axis data is in stored columns.

This field is available if the Y Axis Data field is set to Rows. Select the field to use to generate a color-coded series of y-axis data. Colors are automatically assigned, but you can override them by supplying custom XSL.

If you select a 3D chart type, enter the angle at which you want the 3D data to be displayed.

Select the area of the pagelet for the chart legend to appear. Options are:

• Bottom

• Left

• None

• Right

• Top

Enter the height of the chart in pixels.

Enter the width of the chart in pixels.

If you do not enter height or width values, the chart is automatically sized based on the pagelet position and size (narrow or wide).

See Understanding Pagelet Wizard Display Sizes.

Select up to three fields for which you want to display data using a line drawn over the background chart. Overlays apply to all chart types except 2D and 3D pie charts.

Select the XSL template to use to generate the custom format pagelet. Available XSL templates are defined on the Define XSL page. Only XSL templates defined for the selected data source are displayed.

See Defining Pagelet Wizard XSL Prototypes.

Click to generate custom XSL for the pagelet based on the selected XSL template. This XSL is displayed in the XSL text box and is applied to the XML in the XML text box to generate the pagelet preview.

Select the method to use to determine the link destination. Options are:

Specified by Data: Select to have the system dynamically generate the link information based on the selected data field.

Fixed Text Entry: Select to hard-code the link information by entering a value.

This field appears if you select Specified by Data as the path source. Select the data field to use to generate the link.

This field appears if you select Fixed Text Entry as the path source. Enter a parameter value.

Select the method to use to determine the link destination. Options are:

Specified by Data: Select to have the system dynamically generate the link information based on the selected data field.

Fixed Text Entry: Select to hard-code the link information by entering a value.

Enter a value that corresponds to the value in the Parameter Value field.

If you have selected Specified by Data as the name source, select a data field.

If you selected Fixed Text Entry as the name source, enter a parameter value.

Select the method to use to determine the link destination. Options are:

Specified by Data: Select to have the system dynamically generate the link information based on the selected data field.

Fixed Text Entry: Select to hard-code the link information by entering a value.

If you selected Specified by Data as the link suffix, select a data field.

If you selected Fixed Text Entry as the link suffix, enter a parameter value.

Options are:

Display in portal: Select if you want the content accessed by the data link to be displayed within the portal.

Open in a new window: Select if you want the content accessed by the data link to be displayed in a new window.

Click to clear the values on this page and remove the link.