Configuring Element Overrides

This chapter provides an overview of element assignment overrides, and discusses how to:

Click to jump to parent topicUnderstanding Element Override Configurations

Global Payroll enables you to configure the following delivered pages:

You can use the pages as delivered, or:

Click to jump to top of pageClick to jump to parent topicModifying the Element Override Components

Two setup components enable you to modify the element override pages. More specifically, through the Configuration by Element and Configuration by Category components, you can:

The following table lists the element override pages that you can modify or replace, and describes the changes that you can make to each:

Element Override Page Name

Access Method

Modify/Replace

Hide/Display Additional Overrides Group Box

Summary

Positive Input - Details

  • Click the Details link on the Positive Input page.

  • Click the Details link on the Positive Input by Calendar page.

Yes/No

Not applicable

  • Define a descriptive label for the Supporting Element Overrides group box. For example, you can label the group box Car Allowance Overrides which will display as a new group box within the standard Supporting Element Overrides group box.

  • Replace the generic field labels in the Supporting Element Overrides group box with descriptive labels. For example, in place of the field labeled Variable Name, which lists variables by their object name, you can insert a field with a descriptive label, such as State or Company for variables identifying a state or business unit.

  • Link the fields in the Supporting Element Overrides group box to prompts such as Yes/No edit prompts, translate table prompts, and standard prompts. For example, you can define a field for State or Location and link it to a prompt table for states or locations.

  • Define a field as Required to oblige the user to enter data.

 

Element Detail

  • Click the Element Name link on the Element Assignment page.

  • Click the EmplID link on the Payee Assignments page.

  • Click on Add New Assignment button on Element Assignment page or Payee Assignment page.

Yes/Yes

Yes

  • Define a descriptive label for the Supporting Element Overrides group box. For example, you can label the group box Car Allowance Overrides instead of Supporting Element Overrides for a specific car allowance.

  • Replace the generic field labels in the Supporting Element Overrides group box with descriptive labels. For example, in place of the field labeled Variable Name, which lists variables by their object name, you can insert a field with a descriptive label, such as State or Company for variables identifying a state or business unit.

  • Link the fields in the Supporting Element Overrides group box to prompts such as Yes/No edit prompts, translate table prompts, and standard prompts. For example, you can define a field for State or Location and link it to a prompt table for states or locations.

  • Define a field as Required to oblige the user to enter data.

  • Configure the Element Detail page to hide or display the fields in the Additional Overrides group box.

Click to jump to parent topicConfiguring Element Override Assignments

This section provides an overview of the setup components and modification steps, and discusses the pages used to create standard and alternate element override components.

Click to jump to top of pageClick to jump to parent topicUnderstanding the Setup Components

PeopleSoft delivers two similar components through which you can modify or replace the supporting element override components:

You can do the following for both components:

Note. When setting up Configuration by Element you may work with Earning or Deduction elements that only allow data to be entered at the Element Assignment level or only via Positive Input. In these cases the page will restrict your options and only allow you to configure overrides that are applicable to one of these pages.

Note. If you configuration a display template for a category such as lets say "TAX" and you also configure a display template for specific to an element of that category, the configuration made at the element level takes priority. So, in other words, if you have 15 elements within a given category and 14 of these need one display template while a single one needs another, you only need to 2 separate configuration to cover your needs.

Click to jump to top of pageClick to jump to parent topicUnderstanding Standard Modification Steps

To modify an element override component:

  1. Access the Configuration by Element component or the Configuration by Category component for the element.

  2. On the Override Frame Label group box, define your own element override group box label using the Label Type.

    If option Message Catalog is selected as Label Type, other fields like Message Set and Message Number are available. If option Static Text is selected as Label Type, only field Label is available.

  3. If you plan to create a standard override for both earning/deduction assignments and positive input, and the override information is the same for each, select option Both on Override applies to field.

  4. If you have different specifications for earning/deduction assignment overrides and positive input overrides, the drop-down field Override applies to has an option to select Element Assignment or Positive Input.

  5. Save the component.

Click to jump to top of pageClick to jump to parent topicUnderstanding Alternate Component Modification Steps

To create an alternate component and use it to replace the existing Element Detail page for an element:

  1. Create a replacement component using PeopleSoft Application Designer.

    See PeopleTools: PeopleSoft Application Designer Developer's Guide PeopleBook

  2. Access the Configuration by Element component, or the Configuration by Category component for the element.

  3. On the Common Settings page, define your own element override group box label using the Label Type, Message Set, Message Number, and Label fields on the Override Frame Label group box. This will apply to the Positive Input - Details page only, since you are replacing the Element Detail page with an alternate component.

  4. On the Element Assignment Page group box, select the Use Alternate Page option.

    When switching from Use Standard Page to Use Alternate Page option, the system will evaluate the content of the Standard Page and Positive Input Overrides list, as this list will now only apply to the display of the Positive Input page. If entries are found that are set to control the display of the Standard Element Assignment page, these will be removed and the following warning is displayed.

    "Changing the Element Assignment Page will clear the element override list. (17000,136)

    By changing the setup to use a Custom data entry page, the list of overrides now only applies to the entering of Positive Input. Any rows listed as applying to Element Assignment or to Both (Element Assignment and Positive Input) will be removed.

    In order to complete the change click OK, to cancel the change and retain the current data, click Cancel.

    Click OK to Use Alternate Page option.

  5. In the Content Reference Name field, enter the Content Reference as defined under PeopleTools, Portal, Structure, and Content that you defined in step 1.

  6. Make any modifications on the Standard Page and Positive Input Overrides grid when using the Configuration by Category. On Configuration by Element, make any modifications on the Positive Input Overrides grid. Only Positive Input option is available on the Override applies to field.

    Note. You cannot replace the Positive Input - Details page with an alternate component. Modification to the Positive Input - Details page is limited to modifying the fields, labels, and prompts, in the Element Overrides group box only.

  7. Save the component.

Click to jump to top of pageClick to jump to parent topicPages Used to Configure Element Overrides

Page Name

Definition Name

Navigation

Usage

Configuration by Category

GP_ED_SETUP_CAT

Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Elements, Payroll Elements, Configuration by Category, Configuration by Category

Define your own label for the Supporting Element Overrides group box. It will appear in the system for elements in the specified element category. It applies to both the Element Detail and the Calendar ID Override page.

Specify Element Assignment page (applies to Element Detail only). Using the Standard Page you can control whether the group of Additional Overrides field are to be displayed or not. Using a Custom Page you specify what page you want displayed and any additional search criteria required to transfer to this page.

Enter standard element override specifications while indicating if you want the Supporting Element Override fields to appear the same on the Element Detail or the Positive Input - Details pages, or both.

Configuration by Element

GP_ED_SETUP

Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Elements, Payroll Elements, Configuration by Element, Configuration by Element

Define your own label for the Supporting Element Overrides group box. It will appear in the system for elements in the specified element category. It applies to both the Element Detail and the Calendar ID Override page.

Specify Element Assignment page (applies to Element Detail only). Using the Standard Page you can control whether the group of Additional Overrides field are to be displayed or not. Using a Custom Page you specify what page you want displayed and any additional search criteria required to transfer to this page.

Enter standard element override specifications while indicating if you want the Supporting Element Override fields to appear the same on the Element Detail or the Positive Input - Details pages, or both.

Note. The page is similar to the Configuration by Category page.

See Entering Common Element Override Settings.

Click to jump to top of pageClick to jump to parent topicEntering Common Element Override Settings

Access the Configuration by Category page (Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Elements, Payroll Elements, Configuration by Category, Configuration by Category).

Note. The preceding exhibit shows the Configuration by Category page. This page is very similar to the Configuration by Element page.

Country

Displays the country for which you are configuring the element override pages.

Category

When you access the Configuration by Category page, the system displays the category of elements (earnings or deductions) for which you are modifying the element override components.

Note. You define element categories on the Category Types page.

You assign categories to elements on the element name page (GP_PIN).

Entry Type

Displays the entry type for which you are modifying the element override components.

Valid values are:

  • Earnings

  • Deductions

Note. Entry Type may be left blank (if the same configuration is desired for all elements of a category whether they are Earnings or Deductions, define a single setup for this Category leaving the Entry Type field empty.

Element Name

When you access the Configuration by Element page, the system displays the element for which you are modifying the element override page.

Override Frame Label Group Box Label

Use the following fields to define a descriptive label to replace the generic Supporting Element Overrides group box label on the Element Detail page and the Positive Input - Details page.

Note. The system references these values for delivered or standard supporting element override components.

Label Type

Select one of the following options:

  • Static Text

    If you select Static Text, you must enter a static label in the Label field.

  • Message Catalog

    If you select Message Catalog, you must specify the message set and message number of the new label.

    When you enter the message set and number, the system displays the associated label.

Message Set

Select the message set containing the label you want to display on the Element Detail page and the Positive Input - Details page.

This field becomes available when you select a Label Type of Message Catalog.

Message Number

Select the message number corresponding to the label you want to display on the Element Detail page and the Positive Input - Details page.

This field becomes available when you select a Label Type of Message Catalog.

Label

Enter the label you want to display on the Element Detail page and the Positive Input - Details page.

This field becomes available when you select a Label Type of Static Text.

Element Assignment Page Group Box Label

Use these fields to use the standard page or to point an entirely new component to replace the Element Detail page or the Positive Input - Details page. These give you additional flexibility to define fields, page labels, prompts, and other page elements.

Use Standard Page

Select if you want to configure, but not replace, the element override page for a specific element.

Use Alternate Page

Select to designate an alternate page and component to replace the Element Detail page and the Positive Input - Details page for a specific element.

If you select this option, you must enter the portal definition of the alternate component in the Content Reference Name field.

Note. You must create the alternate page, component and portal content reference prior to selecting it on this page.

See PeopleTools: PeopleSoft Application Designer Developer's Guide PeopleBook

Content Reference Name

Enter the name of the content reference you have created to replace the standard Element Detail page and the Positive Input - Details page.

This field is only available if you have indicated Use Alternate Page.

Show Additional Overrides

Select to display the existing fields in the Additional Overrides group box on the Element Detail page and the Positive Input - Details page.

This field is only relevant when Use Standard Page is indicated.

Click to jump to top of pageClick to jump to parent topicEntering Standard Page and Positive Input Overrides Settings

Use the fields in the Standard Page and Positive Input Overrides group box to specify the same element override modification rules for both the earning/deduction assignment entries, and positive input entries. Specifically, use the Element tab and the Controls tab to define:

Display Order

Enter a sequence number to define the order in which the override elements appear on the Element Detail page and the Positive Input - Details page.

Note. Override elements will be listed in ascending display order.

Override applies to

Enter one of the following values:

  • Both to define supporting element override changes that apply equally to both the Element Detail page and the Positive Input - Details page.

  • Element Assignment to modify the Element Details page (accessible through the Element Assignment By Payee component and the Payee Assignments by Element component).

  • Positive Input to modify the Positive Input - Details page (accessible through the positive input components).

Entry Type

Enter the kind of supporting element for which you want to enter override on the Element Detail page and the Positive Input - Details page.

The only Entry Type available for override with Element Assignments is Variable. For Positive Input, you can choose either SystemElem or Variable.

Element Name

Enter the name of the element corresponding to the specified entry type.

Only elements that are set up to allow overrides at the payee level are included in the prompt.

In addition, no monetary type variable elements are allowed if option Element Assignment or Both on Overrides applies to. Overrides that apply to Positive Input only allow entry of Monetary variables.

Override required with

Valid values are:

  • Both: Select to make the element required on the Element Detail page and the Positive Input - Details page.

  • Element Assignment: Select to make the element required on the Element Detail page.

  • Positive Input: Select to make the element required on the Positive Input - Details page.

    When selected, a user cannot save the Element Detail and/or the Calendar ID Override Detail page without having to enter a value for this element.

    Note. Zero is not considered an actual value for a numeric field, so if you make a numeric element required, a user cannot enter zero for that element on the Element Detail or Calendar Override Details page.

Edit Type

Use this field to associate prompt table edits with the supporting element specified in the Element Name field.

Enter one of the following values:

  • No Prompt

    Select if you do not want to associate a table edit with the supporting element.

  • Xlat Value

    Select if you want to associate a translate table edit with the supporting element.

    If you select this option, you must identify the translate table in the Prompt View Name field.

  • Yes/No

    Select if you want to associate a Yes/No edit with the supporting element.

    If you select Yes/No, a check box will appear next to the field for the supporting element override on the Element Detail page and the Positive Input - Details page.

  • Prompt

    Select if you want to associate a prompt table edit with the supporting element.

    If you select this option, you must identify the prompt view in the Prompt View Name field.

Field Label Type

Select one of the following options:

  • Description

    If you select Description, the supporting element short description appears in the Field Label as display only.

  • Element Name

    If you select Element Name,the Field Label is blank and display only.

  • Static Text

    If you select Static Text, you must enter an alphanumeric value up to 30 characters in length in the Field Label.

Note. The element will be presented on the Element Assignment Detail or Calendar Override page using the elements description or name as label.

Field Label

When Field Label Type of Static Text is selected, you must enter an alphanumeric string between 1 and 30 characters in length. This text will be used as Label when presenting this field on the Element Detail and/or Calendar ID Override page.

Access the Configuration by Element page.

Click to jump to top of pageClick to jump to parent topicEntering Configuration for Element Assignment Page Only

As noted earlier the Element level configuration may be done for Earning or Deduction that allows overrides at the Payee (Element Assignment) level, or the Positive Input (Calendar ID Overrides) level, but not both. In the case of an element that does not allow overrides at the Positive Input level the configuration page will be rendered as follows.

Access the Configuration by Element page (Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Elements, Payroll Elements, Configuration by Element, Configuration by Element).

Element Assignment Page Group Box Label

Use the following fields to define a descriptive label to replace the generic Supporting Element Overrides group box label on the Element Detail page.

Note. The system references these values for delivered or standard supporting element override components.

Label Type

Select one of the following options:

  • Static Text

    If you select Static Text, you must enter a static label in the Label field.

  • Message Catalog

    If you select Message Catalog, you must specify the message set and message number of the new label.

    When you enter the message set and number, the system displays the associated label.

Message Set

Select the message set containing the label you want to display on the Element Detail page.

This field becomes available when you select Message Catalog as the option for field Label Type.

 

Message Number

Select the message number corresponding to the label you want to display on the Element Detail page.

This field becomes available when you select Message Catalog as the option for field Label Type.

 

Label

Enter the label you want to display on the Element Detail page.

This field becomes available when you select Static Text as the option for field Label Type.

Element Assignment Page Overrides

Use the fields in the Element Assignment Page Overrides group box to specify the same element override modification rules for the earning/deduction assignment entries. Specifically, use the Element tab and the Controls tab to define:

Display Order

Enter a sequence number to define the order in which the override elements appear on the Element Detail page.

Note. Override elements will be listed in ascending display order.

Element Name

Enter the name of the element corresponding to the specified entry type.

Only elements that are set up to allow overrides at the payee level are included in the prompt. In addition, no monetary type variable elements are allowed.

Override required with

Valid values are:

  • Both: Select to make the element required on the Element Detail page and the Positive Input - Details page.

  • Element Assignment: Select to make the element required on the Element Detail page.

  • Positive Input: Select to make the element required on the Positive Input - Details page.

    When selected, a user cannot save the Element Detail and/or the Calendar ID Override Detail page without having to enter a value for this element.

    Note. Zero is not considered an actual value for a numeric field, so if you make a numeric element required, a user cannot enter zero for that element on the Element Detail or Calendar Override Details page.

Edit Type

Use this field to associate prompt table edits with the supporting element specified in the Element Name field.

Enter one of the following values:

  • No Prompt

    Select if you do not want to associate a table edit with the supporting element.

  • Xlat Value

    Select if you want to associate a translate table edit with the supporting element.

    If you select this option, you must identify the translate table in the Prompt View Name field.

  • Yes/No

    Select if you want to associate a Yes/No edit with the supporting element.

    If you select Yes/No, a check box will appear next to the field for the supporting element override on the Element Detail page.

  • Prompt

    Select if you want to associate a prompt table edit with the supporting element.

    If you select this option, you must identify the prompt view in the Prompt View Name field.

Field Label Type

Select one of the following options:

  • Description

    If you select Description, the supporting element short description appears in the Field Label as display only.

  • Element Name

    If you select Element Name, the Field Label is blank and display only.

  • Static Text

    If you select Static Text, you must enter an alphanumeric value up to 30 characters in length in the Field Label.

Field Label

When Field Label Type or Static Text is selected, you must enter an alphanumeric string between 1 and 30 characters in length. This text will be used as Label when presenting this field on the Element Detail and/or Calendar ID Override page.

Click to jump to top of pageClick to jump to parent topicEntering Configuration for Positive Input Overrides Only

As noted earlier the Element level configuration may be done for Earning or Deduction that allows overrides at the Payee (Element Assignment) level, or the Positive Input (Calendar ID Overrides) level, but not both. In the case of an element that does not allow overrides at the Payee level the configuration page will be rendered as follows.

Access the Configuration by Element page (Set Up HRMS, Product Related, Global Payroll & Absence Mgmt, Elements, Payroll Elements, Configuration by Element, Configuration by Element).

Display Order

Enter a sequence number to define the order in which the override elements appear on the Positive Input - Details page.

Note. Override elements will be listed in ascending display order.

Element Entry Type

Enter the kind of supporting elements for which you want to enter overrides on the Positive Input - Details page.

Select from the following options:

  • Variable

  • SystemElem

Element Name

Enter the name of the element.

Only elements that are set up to allow overrides at the payee level are included in the prompt.

Override required with

Valid values are:

  • Both: Select to make the element required on the Element Detail page and the Positive Input - Details page.

  • Element Assignment: Select to make the element required on the Element Detail page.

  • Positive Input: Select to make the element required on the Positive Input - Details page.

    When selected, a user cannot save the Element Detail and/or the Calendar ID Override Detail page without having to enter a value for this element.

    Note. Zero is not considered an actual value for a numeric field, so if you make a numeric element required, a user cannot enter zero for that element on the Element Detail or Calendar Override Details page.

Edit Type

Use this field to associate prompt table edits with the supporting element specified in the Element Name field.

Enter one of the following values:

  • No Prompt

    Select if you do not want to associate a table edit with the supporting element.

  • Xlat Value

    Select if you want to associate a translate table edit with the supporting element. If you select this option, you must identify the translate table in the Prompt View Name field.

  • Yes/No

    Select if you want to associate a Yes/No edit with the supporting element. If you select Yes/No, a check box will appear next to the field for the supporting element override on the Positive Input - Details page.

  • Prompt

    Select if you want to associate a prompt table edit with the supporting element. If you select this option, you must identify the prompt view in the Prompt View Name field.

Field Label Type

Select one of the following options:

  • Description

    If you select Description, the supporting element short description appears in the Field Label as display only.

  • Element Name

    If you select Element Name, the Field Label is blank and display only.

  • Static Text

    If you select Static Text, you must enter an alphanumeric value up to 30 characters in length in the Field Label.

Note. The element will be presented on the Element Assignment Detail or Calendar Override page using the elements description or name as label.

Field Label

When Field Label Type of Static Text is selected, you must enter an alphanumeric string between 1 and 30 characters in length. This text will be used as Label when presenting this field on the Element Detail and/or Calendar ID Override page.

Click to jump to parent topicReviewing Standard Component Override Examples

To modify the appearance of an element override detail page, for either an earning/deduction assignment, or positive input entry, you can create a standard component override by selecting option Use Standard Page on the Element Assignment Page group box. For example, if you want to modify the appearance of the Supporting Element Overrides group box on both the Positive Input - Details page and the Element Detail page for a given element or element category, you could define using the Standard Page and Positive Input Overrides grid.

Note. To have the same fields apply or appear on the Positive Input - Details page you need select option Positive Input for field Override applies to. If you know you want the same fields to appear on both the Element Detail page and the Calendar Override Details page, select option Both for the field Override applies to.

Once you have defined the standard configuration, you can access the Element Assignment By Payee page (or the Payee Assignment By Element page) to assign or override a deduction element that falls within the element category of Superannuation:

You'll click the Element Name link for ER ADDLSPR and access the Element Detail page, where you will see the modified Supporting Element Overrides group box instead of the delivered group box:

Notice that above, the Supporting Element Overrides group box and fields are user-defined. The group box is now named Superannuation Override, and the fields within the group box have the user-defined labels we defined previously on the Standard Page and Positive Input Overrides grid. Also note that on the Element Assignment Page group box, since the Show Additional Overrides check box was selected, that following the Superannuation Override group box is the group box for Additional Overrides. If the check box was deselected, this group box would not appear at all.

Note. In our example, because the option Element Assignment was selected for field Overrides applies to, the delivered Positive Input - Details page (accessible through the positive input pages) will not be modified.

Click to jump to parent topicReviewing Alternate Component Override Examples

To replace an element override detail page altogether (for earning/deduction assignment overrides only), you can create a "replacement" alternate component in PeopleSoft Application Designer, and then create a configuration rule for an element or element category that points to the replacement component. For example, if you want to replace the override details page for the PENSION AL 1 element with a component of your own design, you could define as follows:

Enter your replacement component's content reference name:

Once you have defined the replacement component, you can access the Element Assignment By Payee page (or the Payee Assignment By Element page) to assign or override the PENSION AL 1 element:

You'll click the Element Name link for PENSION AL 1 and access a detail page for the element, where you will see the following replacement component instead of the delivered Element Detail page:

Notice the page title, group box titles, and all of the field labels for this page (HC_GPFR_GAR_DAT_GBL) are user-defined. This page was built by the user in PeopleSoft Application Designer.