Mapping Application Class PeopleCode to Component Events

Event Mapping Configurations from PeopleTools 8.54 or 8.55

If you have directly migrated PeopleTools 8.54 or 8.55 event mapping configurations via an ADS project, these configurations have an instance ID of 0, which is invalid in the current release. You will receive an error message if you attempt to open and resave such configurations. To fix this issue, manually run the UPGPT859EVM Application Engine program, which is automatically run in a standard upgrade. After running the UPGPT859EVM program, review the log file to identify the new service IDs. With this information, you can run queries to determine which configurations have been updated.

For example, this log file indicates that one instance ID was updated to 998188404:

'UPGPT859EVM' Program Started (226,2) 
. 
Current Max Instance ID:998188403 (240,4272) 
Message Set Number: 240 
Message Number: 4272 
Message Reason: Current Max Instance ID:998188403 (240,4272) 
. 
Updated Row with Instance ID 0 to 998188404 (240,4291) 
Message Set Number: 240 
Message Number: 4291 
Message Reason: Updated Row with Instance ID 0 to 998188404 (240,4291) 
. 
Updated respective map fields rows if Any, of Table:PSPTCS_MAPFLDS. 
(240,4275) 
Message Set Number: 240 
Message Number: 4275 
Message Reason: Updated respective map fields rows if Any, of 
Table:PSPTCS_MAPFLDS. (240,4275) 
. 
Section: MAIN; Step: PTUPDINS; Updated 1 Rows of Tables:PSPTCSSRVCONF , 
PSPTCSSRVCONFLG. (240,4276) 
Message Set Number: 240 
Message Number: 4276 
Message Reason: Section: MAIN; Step: PTUPDINS; Updated 1 Rows of 
Tables:PSPTCSSRVCONF , PSPTCSSRVCONFLG. (240,4276) 
. 
'UPGPT859EVM' Program Completed (226,5) 
Application Engine program UPGPT859EVM ended normally 

Using this information, you could query PSPTCSSRVCONF, PSPTCSSRVCONFLG, and PSPTCS_MAPFLDS to determine which content reference (portal object ID) was affected. For example:

SELECT * FROM PSPTCSSRVCONF WHERE PORTAL_NAME='_PTCS_PTEVMAP' AND PTCS_INSTANCEID IN (998188404);

Searching for a Content Reference

After clicking the Add Configuration button, enter a search term or phrase. The search results are updated as you type. Select a content reference from the search results to add a new event mapping configuration.

Completing the Configuration

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

PeopleCode Example for Multiple Events in a Single Application Class

The following application class presents an example of how eve_execute could be implemented:

import PT_RCF:ServiceInterface;

class App_Class1 implements PT_RCF:ServiceInterface
   method execute();
   method eve_execute(&str As string);
end-class;

method execute
   /+ Extends/implements PT_RCF:ServiceInterface.execute +/
end-method;

method eve_execute
   /+ &str as String +/
   /+ Extends/implements PT_RCF:ServiceInterface.eve_execute +/
   /* &str variable will have the Event Map Parameter that was */
   /* set in the configuration page for that particular event  */
   /* that is being triggered.                                 */
   Evaluate &str
   When = "1"
      /* Code block for PreBuild event */
   When = "2"
      /* Code block for PostBuild event */
   When-Other
      /* Code block to handle an invalid event map parameter  */
   End-Evaluate;
end-method;

Considerations for Using Global Event Mapping

When you plan to perform event mapping on a global level, you should consider the following:

• You must ensure that global event mapping does not impact the loading of components from performance and error handling perspectives.

• You should ensure that errors are handled gracefully.

• You should be aware that if a page has multiple components, component-based grouplets, component-based pagelets, or component-based modals and so on, the configured global events run on each of the loaded components. Therefore, your PeopleCode logic should conditionally identify or filter the components, component-based grouplets, component-based pagelets, or component-based modals to ensure that the required logic is run only for the required components.

  For example, if a page contains a target component and a component-based grouplet, and you want to run it only for the target component, then your PeopleCode logic should perform a conditional check to exclude the component-based grouplet.

Prerequisites

Before you create a global event mapping configuration using the CreateGlobalEventMappingConfig method, you must create a related content service definition.

See Creating Service Definitions for Event Mapping for more information.

Verifying the Global Event Mapping Configuration

The following database tables – PSPTCS_SRVCFG and PSPTCSSRVCONF – store the event mapping configuration data. After you create a global event mapping configuration using the CreateGlobalEventMappingConfig method, you can verify the configuration using the following SQL statements:

• SELECT * FROM PSPTCS_SRVCFG WHERE PORTAL_OBJNAME LIKE 'PTCS_EVMAP_GBL_%'

• SELECT * FROM PSPTCSSRVCONF WHERE PORTAL_OBJNAME LIKE 'PTCS_EVMAP_GBL_%'

You can identify the global event mapping configuration by the data contained in the PORTAL_OBJNAME and the PTCS_PROCSEQ columns of these tables.

• In the PORTAL_OBJNAME column, identify the configuration name specified in the CreateGlobalEventMappingConfig method. The global event mapping configuration name is prefixed with PTCS_EVMAP_GBL.

  See CreateGlobalEventMappingConfig.

• In the PTCS_PROCSEQ column, the global event mapping configuration is identified by the term GBL.