Mapping Application Class PeopleCode to Component Events

The PeopleSoft Related Content Framework can also be used to map application class PeopleCode programs to component level, page level, and component record level events. This allows custom PeopleCode programs to be defined for a component without customizing the component definition in Application Designer. These custom PeopleCode programs can be configured to run before or after any PeopleCode program defined for the same event from the component definition.

Note: While the PeopleSoft Related Content Framework is used to complete this configuration, these PeopleCode programs do not constitute or render as related content.

Use the Event Mapping page to manage which content references have associated PeopleCode application package programs.

Navigation

  1. PeopleTools > Portal > Related Content Service > Manage Related Content Service.

  2. Select the Event Mapping page tab.

Image: Event Mapping page

This example illustrates the fields and controls on the Event Mapping page. You can find definitions for the fields and controls later on this page.

Event Mapping page

Field or Control

Definition
Find

Click the Find button to open the Event Mapping References page in a secondary window to search by application package and class.
Search

Enter a search term or phrase and click the Search button to filter the list of content references using the search terms.

Search terms are case insensitive and results are returned for partial word matches. For example, both dep and dept will match the Department (DEPT_TBL.GBL) content reference. When you click the Search button, a database search is performed on the following values:

  • Content reference name

  • Content reference label

  • Values stored in the KEYWORD content reference attribute.

See “Content Reference Attributes” in Defining Content References.
Content Reference

Click a content reference link to access the actual transaction page, which allows you to test any configured PeopleCode programs.
Edit

Click an Edit button to edit an existing PeopleCode configuration.

See Assigning Application Class PeopleCode to Component Events.
Remove

Click a Remove button to remove an existing PeopleCode configuration.
Map the event of the Application pages

Click this link to access the Select a Content Reference page to select an application page and create a new PeopleCode configuration.
Create a New Related Content Service

Click the link to access the Define Related Content Service page.

See Creating and Managing Related Content Service Definitions.

Searching by Application Package and Class

The Event Mapping References page, which allows you to search by application package and class, allows you to assess the impact to components, pages, records, and fields that have been configured with the specified application class.

Image: Event Mapping References page

This example illustrates the fields and controls on the Event Mapping References page. You can find definitions for the fields and controls later on this page.

Event Mapping References page

Field or Control

Definition
Package

Select the application package.
Path

Select the qualified subpackage or class path.
Class Name

Select the application class.
Search

Click the Search button to find components that have been configured to execute this PeopleCode.

Selecting an Application Page (Content Reference)

Use the Select a Content Reference page to select an application page and create a new PeopleCode configuration.

Image: Select a Content Reference page

This example illustrates the fields and controls on the Select a Content Reference page. You can find definitions for the fields and controls later on this page.

Select a Content Reference page

Field or Control

Definition
Include hidden Crefs

Select to make hidden content references available for assignment.

Note: The tree shows both PeopleSoft component URLs and PeopleSoft component-based generic URLs.

Folder expand button

Click to expand the folder and display child folders and links.
Folder collapse button

Click to collapse the folder and hide all children.
[link]

Click a content reference link to select that content reference to which related content will be assigned.

After selecting a content reference, continue by configuring PeopleCode programs and events. See Assigning Application Class PeopleCode to Component Events.

Use the Configure Event Mapping page to map application class PeopleCode to component level, page level, and component record level events.

Navigation

Image: Configure Event Mapping page

This example illustrates the fields and controls on the Configure Event Mapping page. You can find definitions for the fields and controls later on this page.

Configure Event Mapping page

Field or Control

Definition
Event Name

  • At the component level, an application class-based service can be associated with one of the following PeopleCode events:

    • PostBuild

    • PreBuild

    • SavePostChange

    • SavePreChange

    • Workflow

  • At the page level, an application class-based service can be associated with the Activate event only.

  • At the component record level, an application class-based service can be associated with one of the following PeopleCode events:

    • RowDelete

    • RowInit

    • RowInsert

    • RowSelect

    • SaveEdit

    • SavePostChange

    • SavePreChange

  • At the component record field level, an application class-based service can be associated with the FieldChange event only.
Select

Click the Select button to select an application class-based related content service definition.

Note: The list of application class-based services is filtered to include only those that have implemented the PT_RCF:ServiceInterface base class.
Sequence number

Specify a processing sequence when more than one custom application class program is mapped to the same event.
Processing Sequence

Select whether this application class PeopleCode is executed before or after any PeopleCode program defined for the same event from the component definition.
Page

For page level mappings, select a page from the component definition.
Record (Table) Name

For component record level mappings, select a record from the component definition.
Record

For component record field level mappings, select a record from the component definition.
Field Name

For component record field level mappings, select a field from the record definition.