2530838 - Initiate PM Form On Job Change Event: How to Launch a New Performance Form Based on a Job Info Change

How to Launch a Performance Form based on a Job Info change?

"Image/data in this KBA is from SAP internal systems, sample data, or demo systems. Any resemblance to real data is purely coincidental."

• SAP SuccessFactors Performance Management
• SAP SuccessFactors Employee Central

This Rule "Execute" Function can be used to launch Performance forms for Hire, Rehire and Job Change scenarios.

Please Note: Business rules cannot be configured to launch forms for terminated employees.

I. Performance Management

Ensure the Performance Management module is correctly implemented in the instance, and your intended Performance Management form templates are all correctly configured, tested thoroughly, and ready to be launched to end users (please ensure this is completed prior to following any next steps).

Information related to implementing Performance Management can be found in Implementing and Managing Performance Management - Overview of Performance Management.

II. Intelligent Services

Please ensure that you have implemented Intelligent Services in your instance before proceeding with the below configuration.

For more information, please refer to the following reference materials:

• Setting Up Intelligent Services
• Introduction to Publishing For Intelligent Services
• Intelligent Services Overview
• Event Center

III. Enabling the "pm-form" field in Employee Central > Job Information

1. Go to Admin Center > Manage Business Configuration
2. Under "HRIS Element", select "jobInfo"
3. Then in the field list, add the field "pm-form" and if you are using HRIS Sections, please add the field to the "jobFieldList" section
4. Add the field label "Performance Form"
5. Click "Details" and then ensure the following settings are defined:
• Enabled = Yes
• Mandatory = No
• Visibility = View
• Maximum Length = Leave this blank
6. Then save the changes to jobInfo

IV. Grant the permission for the new field in Role-Based Permissions

It is important that you permission the field (even if only for Admin users initially) so that the field is available in the UI for testing. To do so, you will need to:

1. Go to Admin Center > Manage Permission Roles
2. Select the Role to grant the field to
3. Click "Permissions..."
4. Scroll down the left panel to "Employee Central Effective Dated Entities"
5. Then in the right panel, scroll down to Job Information, and grant View permissions to the field
6. Then click "Done" > "Save Changes"
   
   

V. Configuring the "Initiate PM Form On Job Change Event" Business Rule

1. Go to Admin Center > Configure Business Rules and create a new Basic rule
2. Give the rule a sensible Rule Name and Rule ID, and select the Base Object "Job Information"
3. The "IF" criteria should be based upon values in Job Information.
4. The "THEN" condition must be "Execute" "Initiate PM Form On Job Change Event" (do not add other THEN conditions).
• Job Information = Job Information
• PM Form Template Name = Must be the "Template Name" of the form (English US)
5. Save the rule
   
   

VI. Add the Rule Trigger

1. Go to Admin Center > Manage Business Configuration
2. Under "HRIS Element", select "jobInfo"
3. Scroll to the very bottom and add the Rule as "onPostSave" (do not assign as onSave or any other trigger)
4. Save the changes

FAQ - Additional Information

Q) The Performance Form was not launched successfully although the Event was successfully published in the Event Center. The log below was found:

XX INFO  [LaunchPMFormSubscriber] [companyId=XXX, userId=XX] Form validation fails for the user = XX template name = XX

A) When a new template is imported or created, the key “DefaultFormDates” is not automatically generated/inserted. The form will never be launched from the template if the customer uses the template. The workaround is to go to Form Template Settings, then open and Save the form template without any changes. This will generate the key.

Q) Why does the Performance Form (pm-form) field text not display as a blue hyperlink?

A) Only logged in users who are part of that employee's Form Route Map will be able to see a blue (clickable) link. For example, if the roles defined in the steps of the Forms Route Map are Employee, Manager and HR Manager, only those respective users will see the blue hyperlink in Job Info. All other users of the system (including system admins) will only see the Form Template Label as a string and not a blue hyperlink.

• KB Article 2533061 - Initiate PM Form in EC: How to Configure the Off Cycle batch for future dated Scenarios
• KB Article 2500964 - Unable to activate v4admin User - System System (v4admin user is inactive)
• Implementing and Managing Performance Management - Overview of Performance Management

PM forms, Employee Central, EC, Initiate PM Form On Job Change Event, launch, job change, Form Templates, Disable Due Date Validation, job code, Business Rule, launch form, Business Rule , KBA , LOD-SF-EC-JOB-RUL , Job Info Business Rules , LOD-SF-PM-SCH , Form Schedulers and Launches , How To

SAP SuccessFactors Employee Central all versions ; SAP SuccessFactors Performance & Goals all versions