SAP Knowledge Base Article - Public

2541909 - Job Info: How to configure the Event Reason (event-reason)

Symptom

  • The Event Reason field is by default, hard-coded to be part of the Job Information configuration, although by default it is not defined in the Succession Data Model.
  • If you require to manage the label translations of the "event-reason" field or to add onChange rules to the Event Reason field, then it must be defined in the configuration.

Environment

SAP SuccessFactors Employee Central

Cause

The system prevents the Event Reason field from displaying twice if configured in Job Information.

Resolution

The "event-reason" field can be configured in the Succession Data Model so translations can be managed and onChange Business Rules can be triggered. Please see the information and FAQ below for more information.

 

How to configure the Event Reason field

Manage Business Configuration

  1. Navigate to Admin Center > Manage Business Configuration > Employee Central > HRIS Elements > jobInfo
  2. Scroll to the bottom of the field list, and in the blank row under the column "HRIS Fields", select the field "event-reason"
  3. Click on "Details" and set the following configuration settings:
    • Label = Event Reason (or what you wish it to be - make sure to add translations by clicking the globe icon next to it- in example the label used is Event Reason from SDM)
    • Section = Job Information (jobInfo_jobFieldsList)
    • Enabled = Yes
    • Mandatory = Yes
    • Visibility = Edit
    • Maximum Length = 256
    • All other fields should be left as they are.

ER added in SDM.png

 

 

Succession Data Model

Add the following XML under the jobInfo hris-element, and if you are using hris-section configuration, put the field under the hris-section "jobFieldsList"

    <hris-section id="jobFieldsList">
      <label>Job Information</label>
      <label xml:lang="en-GB">Job Information</label>
      <label xml:lang="en-US">Job Information</label>
       .........


   <hris-field max-length="256" id="event-reason" visibility="both" required="true">
        <label>Event Reason from SDM</label>
        <label xml:lang="en-GB">Event Reason from SDM</label>
        <label xml:lang="en-US">Event Reason from SDM</label>
      </hris-field>

 

Behavior of the Event Reason field when not defined in the Data Model

If you do not define the field "event-reason" in the jobInfo hris-element configuration in the Succession Data Model:

  • You will still be able to see the hard-coded permission switch in Admin Center > Manage Permission Roles > Employee Central Effective Dated Entities > Job Information > jobInfo_event-reason
  • There is no change in the UI behavior
  • There is no change in previous behavior for this permission configuration or the field behavior

ER not in SDM RBP.png

 

Behavior of the Event Reason field when defined in the Data Model

If you do define the field "event-reason" in the jobInfo hris-element configuration in the Succession Data Model:

  • You will find that the hard-coded permission switch is no longer available in Admin Center > Manage Permission Roles > Employee Central Effective Dated Entities > Job Information > jobInfo_event-reason
    • Instead the "event-reason" field you have configured in the Data Model will be listed (with the label that you defined)
  • There is no change in the UI behavior (the Event Reason field will still be displayed in the same location in all UI's).

 

ER in SDM RBP.png

ER in Job Info UI.png

FAQ

Q) Can the field be set to Required = False?
A) No. The field is mandatory and must be defined as such for it to display in the UI (regardless of Permission).

Q) Can onChange rules be added to the "event-reason" field to trigger rules when Event Reasons are selected?
A) Yes.

Q) Can I configure the Event Reason field to display in other HRIS Sections such as Organisational Information?
A) No. If you are using HRIS Section configuration, the field must be configured in the HRIS Section "jobInfo_jobFieldsList".

Q) Can I change the location of the Event Reason field in the UI?
A) No, it will always display after selecting the "Event" field, at the top of the page under the Effective Date field.

Q) Can I expose the "event-reason" field and use onChange rules when Event Derivation is enabled?
A) It is not recommended. Event Derivation is triggered during the SAVE action, therefore the onChange rule would not trigger until the data changes are being saved.

Q) Can I add “event-reason” field to the Data Model when Event Derivation is enabled, to manage the label of the event-reason field?
A) Yes.

Keywords

ECT-41008, Event Reason, Job Information, twice, duplicated, onChange, event-reason, jobInfo, success factors, SF, EC, behavior , KBA , LOD-SF-EC-JOB , Job Information , How To

Product

SAP SuccessFactors Employee Central all versions