Using Pagelet Wizard With PeopleSoft Enterprise Portal

This chapter provides an overview of using Pagelet Wizard with PeopleSoft Enterprise Portal and discusses how to:

Note. This documentation discusses PeopleSoft-Enterprise-Portal-specific features that are available through the basic Pagelet Wizard PeopleTools only when PeopleSoft Enterprise Portal is installed.

The basic Pagelet Wizard PeopleTool is covered in Enterprise PeopleTools 8.46 PeopleBook: Internet Technology, “Using Pagelet Wizard.” Please refer to this PeopleTools documentation for information about setting up and using the basic Pagelet Wizard PeopleTool.

Click to jump to top of pageClick to jump to parent topicUnderstanding Using Pagelet Wizard With PeopleSoft Enterprise Portal

When you use the basic Pagelet Wizard PeopleTool with PeopleSoft Enterprise Portal installed, Pagelet Wizard is able to transform content from additional data sources that are only available by way of PeopleSoft Enterprise Portal. As a result, Pagelet Wizard provides options and features that are unique to PeopleSoft Enterprise Portal. These are the options and features discussed in this documentation.

Specifically, we discuss how to use Pagelet Wizard to create pagelets using the following PeopleSoft Enterprise Portal specific data sources:

See Also

Describing PeopleSoft-Enterprise-Portal-Specific Pagelet Wizard Data Types

Click to jump to top of pageClick to jump to parent topicStep 1: Entering Pagelet Identifying Information

This section discusses the page used to enter pagelet identifying information.

Click to jump to top of pageClick to jump to parent topicPage Used to Enter Pagelet Identifying Information

Page Name

Object Name

Navigation

Usage

Specify Pagelet Information

PTPPB_WIZ_INFO

  • Portal Administration, Pagelets, Pagelet Wizard, Pagelet Wizard

  • PeopleTools, Portal, Pagelet Wizard, Pagelet Wizard

Define description and summary information for a pagelet.

See Enterprise PeopleTools 8.46 PeopleBook: Internet Technology, “Using Pagelet Wizard,” Step 1: Entering Pagelet Identifying Information

Click to jump to top of pageClick to jump to parent topicStep 2: Selecting a Pagelet Data Source

This section discusses how to:

Click to jump to top of pageClick to jump to parent topicPage Used to Select a Data Source

Page Name

Object Name

Navigation

Usage

Select Data Source

PTPPB_WIZ_DATASRC

  • Portal Administration, Pagelets, Pagelet Wizard, Pagelet Wizard

    Click the Next button or the icon for step 2.

  • PeopleTools, Portal, Pagelet Wizard, Pagelet Wizard

    Click the Next button or the icon for step 2.

Select the type of data source for the pagelet.

Click to jump to top of pageClick to jump to parent topicSelecting the Collaborative Workspace Links Data Source

Access the Select Data Source page. Select Collaborative Workspace Links in the Data Type field.

Data Source

Portal Name

Select the portal that contains the Collaborative Workspaces Links module collection for the pagelet.

Collection Name

Select the name of the Collaborative Workspace Links module collection that you want to use to create the pagelet.

Click to jump to top of pageClick to jump to parent topicSelecting the Content Management Data Source

Access the Select Data Source page. Select Content Management in the Data Type field.

Approved text or HTML content in the PeopleSoft Content Management system can be used as base data for a Pagelet Wizard pagelet.

See Enterprise Portal Content Management and Publication Overview.

When you use Content Management as the data source, the pagelet does not provide configurable data source parameters. Consequently, when creating a Content Management data source pagelet, you skip step 3 and proceed to step 4, in which you select the pagelet display format.

Data Source

Folder ID

Select the Content Management folder in which the content resides.

Content ID

Select the Content Management content you want to use as the data source for the pagelet.

Content Path

Displays the Content Management site and folder path to the content.

Click to jump to top of pageClick to jump to parent topicSelecting an IB Connector Data Source

Access the Select Data Source page. Select IB Connector in the Data Type field.

See Setting Up Pagelet Wizard IB Connector Data Source Security.

Data Source

Integration Gateway ID

Select the Integration Broker gateway that contains the connector you want to use to supply content to the pagelet.

Connector ID

Select the connector that you want to use to supply content to the pagelet.

Click to jump to top of pageClick to jump to parent topicSelecting an Integration Broker Data Source

Access the Select Data Source page. Select Integration Broker in the Data Type field.

You can use an outbound, synchronous message defined in the local database as a data source for a Pagelet Wizard pagelet. Outbound, synchronous messages are messages for which a request is made to a target system and a response is expected in real time.

See Setting Up the Pagelet Wizard Integration Broker Data Source.

The message can be either structured or unstructured. If the message is structured, then a record structure has been associated with the outbound message and that record structure is translated into data source parameters during step 3. If the message is unstructured, then no record structure has been associated with the outbound message so no data source parameters can be supplied and Pagelet Wizard skips step 3.

Typically, because outbound synchronous messages are designed to run in real time, they are associated with transactions with good performance records. As with all pagelet data sources, it is important to understand that pagelet performance, and thus homepage performance, are tied to the performance of the underlying Integration Broker message and target transaction. It is highly recommended that you review the performance of the target transaction before creating an Integration Broker message-based pagelet.

Data Source

Request Message

Select the requesting message that you want to be the data source for the pagelet.

Message Node

Select the message node associated with the selected requesting message.

Data Source Details

If the selected message is structured, the Data Source Details group box displays input and output records and fields defined in the message structure.

Click to jump to top of pageClick to jump to parent topicSelecting a News Publication Data Source

Access the Select Data Source page. Select News Publication in the Data Type field.

Publication ID

Select the new publication that you want to use as the data source for the pagelet. Available new publications are created in the News Publications component.

See Setting Up and Working With News Publications.

Publication name

Displays the name of the news publication.

Click to jump to top of pageClick to jump to parent topicSelecting a SOAP Data Source

Access the Select Data Source page. Select SOAP in the Data Type field.

Data Source

WSDL Name

Select the name of the WSDL definition that contains the service and operation you want to use to supply content to the pagelet. This value is the WSDL name as defined in the WSDL Repository.

See Enterprise PeopleTools 8.46 PeopleBook: PeopleSoft Integration Broker, “Creating Third-Party Integrations Using WSDL,” Using the WSDL Repository

Service

Select the service that you want to use to supply content to the pagelet.

Operation

Select the operation that you want to use to supply content to the pagelet.

See Also

Setting Up the Pagelet Wizard SOAP Data Source

Click to jump to top of pageClick to jump to parent topicSelecting a URL Data Source

Access the Select Data Source page. Select URL in the Data Type field.

URL

Enter any HTTP-accessible URL as the data source for the pagelet. The URL may or may not require query string parameters that can be specified and personalized as end-user prompts within Pagelet Wizard.

For example, the Yahoo! search page URL takes the form: http://search.yahoo.com/search?p=searchterm. If you want to make searchterm a user-specified data parameter, enter a URL field value of http://search.yahoo.com/search. In step 3 on the Specify Data Source Parameters page, add a data source parameter Field Name value of p and set its Usage Type field value to User Specified with a default value. Pagelet Wizard then adds the ?p=searchterm value, with the searchterm value being user personalizable, to the URL before it retrieves the content to the pagelet.

Click to jump to top of pageClick to jump to parent topicStep 3: Specifying Data Source Parameters

This section discusses how to:

Click to jump to top of pageClick to jump to parent topicPage Used to Specify Data Source Parameters

Page Name

Object Name

Navigation

Usage

Specify Data Source Parameters

PTPPB_WIZ_DATAPRMS

  • Portal Administration, Pagelets, Pagelet Wizard, Pagelet Wizard

    Click the Next button on the Select Data Source page, or click the icon for step 3.

  • PeopleTools, Portal, Pagelet Wizard, Pagelet Wizard

    Click the Next button on the Select Data Source page, or click the icon for step 3.

Configure the data source parameters required for the data to be displayed on the pagelet. For instance, when entering data source parameters for a News Publication pagelet, you specify input data that determines that the content and format of the news displayed on the pagelet. The parameters vary depending on the data source selected on the Select Data Source page.

This page is accessible only when building a pagelet with a data source that allows modification of associated parameters. For Pagelet Wizard being used by PeopleSoft Enterprise Portal, these data sources include IB Connector, Integration Broker (structured messages), News Publications, and URL.

Note. This step is not applicable when creating pagelets with Content Management and Integration Broker (unstructured messages) data sources.

Click to jump to top of pageClick to jump to parent topicSpecifying IB Connector Data Source Parameters

Access the Specify Data Source Parameters page after selecting IB Connector as the data type on the Select Data Source page.

Define the data source parameters for the IB Connector data source.

See Enterprise PeopleTools 8.46 PeopleBook: PeopleSoft Integration Broker, “Understanding PeopleSoft Integration Broker”

Click to jump to top of pageClick to jump to parent topicSpecifying Integration Broker Data Source Parameters

Access the Specify Data Source Parameters page after selecting Integration Broker as the data type on the Select Data Source page.

This step is applicable for the Integration Broker data source if the message is structured. The record structure associated with the message is translated into data source parameters on this page.

If the message is unstructured, then no record structure has been associated with the message. Therefore, no data source parameters can be supplied and Pagelet Wizard skips this step.

You must supply values for all rows with the Required option selected.

Click to jump to top of pageClick to jump to parent topicSpecifying News Publication Data Source Parameters

Access the Specify Data Source Parameters page after selecting News Publications as the data type on the Select Data Source page.

Field Name

.SHOW_TS_IMAGES. Set the Default Value field to Y if you want the pagelet to display images for top stories for the news publication.

.SHOW_SECTION_LINKS. Set the Default Value field to Y if you want the pagelet to display links to sections in the news publication.

.NUM_ARTICLES. Set the Default Value field to the number of articles you want the pagelet to display.

Set the viewing options for the content IDs lists for the news publication.

Click to jump to top of pageClick to jump to parent topicSpecifying URL Data Source Parameters

Access the Specify Data Source Parameters page after selecting URL as the data type on the Select Data Source page.

The data source parameters you can define on this page correspond to URL query parameters, such as an HTTP GET request.

An HTTP GET request is a URL type for which parameters are placed on the query string separated by ? and &, such as http://search.yahoo.com/search?p=searchterm.

For example, the Yahoo! search page URL takes the form: http://search.yahoo.com/search?p=searchterm. If you want to make searchterm a user-specified data parameter, enter a URL field value of http://search.yahoo.com/search in step 2 on the Select Data Source page. In step 3 on this page, add a data source parameter Field Name value of p and set its Usage Type field value to User Specified with a default value. Pagelet Wizard then adds the ?p=searchterm value, with the searchterm value being user personalizable, to the URL before it retrieves the content to the pagelet.

Click to jump to top of pageClick to jump to parent topicStep 4: Selecting a Pagelet Display Format

This section discusses how to select a display format.

Click to jump to top of pageClick to jump to parent topicPage Used to Select a Pagelet Display Format

Page Name

Object Name

Navigation

Usage

Select Display Format

PTPPB_WIZ_DISPFRMT

  • Portal Administration, Pagelets, Pagelet Wizard, Pagelet Wizard

    Click the Next button on the Specify Data Source Parameters page, or click the icon for step 4.

  • PeopleTools, Portal, Pagelet Wizard, Pagelet Wizard

    Click the Next button on the Specify Data Source Parameters page, or click the icon for step 4.

Specify the data transformation method and display format for the pagelet.

Click to jump to top of pageClick to jump to parent topicSelecting a Display Format

Access the Select Display Format page.

Select the format to use for the pagelet. The display formats available for selection on this page depend on the data source you have selected on the Select Data Source page. Options available for pagelets created using PeopleSoft Enterprise Portal-specific data sources are:

Passthru

Available for Content Management, IB Connector, and URL pagelets.

Custom

Available for Content Management, IB Connector, Integration Broker, news publication, SOAP, and URL pagelets.

See Also

Enterprise PeopleTools 8.46 PeopleBook: Internet Technology, “Using Pagelet Wizard,” Step 4: Selecting a Pagelet Display Format

Click to jump to top of pageClick to jump to parent topicStep 5: Specifying Pagelet Display Options

This section provides information about the pages used to specify pagelet display options.

Click to jump to top of pageClick to jump to parent topicPages Used to Specify Pagelet Display Options

Page Name

Object Name

Navigation

Usage

Specify Display Options (passthru format)

PTPPB_WIZ_DISP_PST

  • Portal Administration, Pagelets, Pagelet Wizard, Pagelet Wizard

    Select Passthru as the display format and click the Next button on the Select Display Format page, or click the icon for step 5.

  • PeopleTools, Portal, Pagelet Wizard, Pagelet Wizard

    Select Passthru as the display format and click the Next button on the Select Display Format page, or click the icon for step 5.

Enter pagelet passthru formatting details and header and footer options. Preview the pagelet.

Specify Display Options (custom format)

PTPPB_WIZ_DISP_CUS

  • Portal Administration, Pagelets, Pagelet Wizard, Pagelet Wizard

    Select Custom as the display format and click the Next button on the Select Display Format page, or click the icon for step 5.

  • PeopleTools, Portal, Pagelet Wizard, Pagelet Wizard

    Select Custom as the display format and click the Next button on the Select Display Format page, or click the icon for step 5.

Enter pagelet custom formatting details and header and footer options. Preview the pagelet.

Link Details

PTPPB_WIZ_LINK_DTL

Click the Link Options button on the Specify Display Options page.

Enter linking details that convert pagelet column data into drill-down links to pages that provide details about the pagelet data.

See Also

Enterprise PeopleTools 8.46 PeopleBook: Internet Technology, “Using Pagelet Wizard,” Step 5: Specifying Pagelet Display Options

Click to jump to top of pageClick to jump to parent topicStep 6: Specifying Pagelet Publication Options

This section provides information about the pages used to specify pagelet publication options.

Click to jump to top of pageClick to jump to parent topicPages Used to Specify Pagelet Publication Options

Page Name

Object Name

Navigation

Usage

Specify Publishing Options

PTPPB_WIZ_PUBOPT

  • Portal Administration, Pagelets, Pagelet Wizard, Pagelet Wizard

    Click the Next button on the Specify Display Options page, or click the icon for step 6.

  • PeopleTools, Portal, Pagelet Wizard, Pagelet Wizard

    Click the Next button on the Specify Display Options page, or click the icon for step 6.

Specify the type of pagelet that you want to publish. Provide registration, caching, and security details, and register the pagelet.

Pagelet Creation Confirmed

PTPPB_WIZ_FINISH

Click the Finish button on the Specify Publishing Options page.

Confirm that the creation of the pagelet is complete.

See Also

Enterprise PeopleTools 8.46 PeopleBook: Internet Technology, “Using Pagelet Wizard,” Step 6: Specifying Pagelet Publication Options