Defining External News Pagelets

This topic discusses defining and maintaining External News pagelets.

Page Name

Definition Name

Usage

External News Pagelet Publications Page

EO_PE_NEWSCOM_SET

Define an External News pagelet with a unique component ID.

News Group Maintenance Page

EO_PE_NEWSGROUP_PG

Define news groups that you want to use to organize news categories that you want to make available on the External News pagelet you are defining.

News Category Maintenance Page

EO_PE_CATEG_PG

Define a news category within a news group.

News Article Maintenance Page

EO_PE_ARTICLE_PG

View and maintain news feed article data. You can define an article removal date that overrides the default article lifespan set for the article's new provider on the News Provider Maintenance page.

While you can access news feed article data on this page, you do not define article data in your system. News feed article data is loaded into your system when you run the Schedule External News Feed process.

You can also display news feeds on External News pagelets.

To display these news feeds, you must first create a specific instance of an External News pagelet, which is assigned a unique component ID. Once you have created this pagelet definition, you can create and associate news groups and categories from news providers with the pagelet. These news groups and categories are then available on the new pagelet.

You may choose to create a new pagelet for an existing provider, such as Multex, to display specific news categories to specific users. In essence, you can split off news to specialized communities.

Note: While you can access news feed article data on the News Article Maintenance page, you do not define article data in your system. News feed article data is loaded into your system when you run the Schedule External News Feed process.

Use the External News Pagelet Publications page (EO_PE_NEWSCOM_SET) to define an external news pagelet with a unique component ID.

Navigation:

Portal Administration > Pagelets > External News > Publications

This example illustrates the fields and controls on the External News Pagelet Publications page. You can find definitions for the fields and controls later on this page.

External News Pagelet Publications page

Field or Control

Description

Component ID

System-generated value that is used to identify the External News pagelet you are defining. This component ID is used to identify the pagelet when associating it with news groups and categories.

Pagelet Title

Enter a title for the pagelet that is used to populate the title/label field for the component reference. This text becomes the title displayed on the pagelet title bar.

Default News Category

You cannot enter a code until you have defined news categories for this pagelet component ID on the News Category Maintenance page. Once you have completed this definition, return to this page to select the code for the default news category that you want users to see on the External New pagelet when no personalizations have been defined.

For New Categories in NewsFeed

The field in the For New Categories in NewsFeed group box applies to news loaded through the Schedule External News Feed process.

Field or Control

Description

Role Name

Select the default role name to associate with new categories that are loaded by the Schedule External News Feed process.

This enables you to associate a role with news categories that are automatically created by the process. Selecting a value here ensures that you have at least one viewer role assigned to automatically created categories.

Create Homepage Pagelet

The Create Homepage Pagelet group box displays registry information generated upon saving the page. You use this information to register the pagelet in the portal registry.

Field or Control

Description

Pagelet Folders

Displays PAPP_NEWS. The system stores all External News pagelets in this portal registry folder.

Public Access

Select if you want to make access to this External News pagelet available to all users. You can restrict use of the pagelet to specific groups of users using the portal registry.

See the product documentation for PeopleTools: Portal Technology, “Administering Portals.”

Registered

Displays as selected once the pagelet has been entered into the portal registry.

Portal Object Name

Displays once the pagelet has been registered and saved.

Create HomePage Pagelet

Click to register the External News pagelet.

Use the News Group Maintenance page (EO_PE_NEWSGROUP_PG) to define news groups that you want to use to organize news categories that you want to make available on the External News pagelet you are defining.

Navigation:

Portal Administration > Pagelets > External News > Groups

This example illustrates the fields and controls on the News Group Maintenance page. You can find definitions for the fields and controls later on this page.

News Group Maintenance page

Field or Control

Description

Description

Enter a news group description.

Active for all categories

Clear this option to disable user access to all categories in the selected news group without having to disable each individual category.

Provider ID

Select the providers that you want to associate with the news group. This establishes an association between the content provider query URL and the selected news group.

Use the News Category Maintenance page (EO_PE_CATEG_PG) to define a news category within a news group.

Navigation:

Portal Administration > Pagelets > External News > Categories

This example illustrates the fields and controls on the News Category Maintenance page. You can find definitions for the fields and controls later on this page.

News Category Maintenance page

Field or Control

Description

News Category Title

Enter a news category title. For some news providers, the news category title text must match the news category title the provider uses. The Schedule External News Feed process attempts to match this title with the title string from the provider.

Provider ID

Select the associated news provider. The news provider you select identifies which query URL should be used for the category.

Providers are defined on the News Provider Maintenance page.

News Group ID

Select the news group in which the end user should be able to access this category when personalizing the External News pagelet.

News groups are defined on the News Group Maintenance page.

Newsfeed Type

Select the method to use to load the news category.

SQL Server to XML Load. Reserved for future use.

System Maintained.

URL

Enter a URL that you want to use to override the query URL value you provided on the News Provider page.

URL Parameter

Enter text you want to be appended to the query URL provided by the news provider.

Language Code

Select the language for the news category.

Viewer Roles

Field or Control

Description

Select

Select for the roles that you want to be able to view and select the news category. Users who do not belong to a selected role cannot access the category when personalizing an External News pagelet or view articles in the category.

For example, you can use this option to restrict access to subscription-based content.

Role Name

This is a subset of all PeopleSoft roles defined by an administrator on the Maintain Viewer Roles page. This is a list of valid viewers for news, rather than a list of all roles in the PeopleTools Roles table.