Setting Up Utilities in Global Payroll for Brazil
To set up utilities in Global Payroll for Brazil, use the Define Variable Attributes BRA (GPBR_COMP_VARS) and the Map Elements to Component BRA (GPBR_ELEM_MAP) components.
This topic provides an overview of element mapping and discusses how to set up utilities in Global Payroll for Brazil.
Note: This setup is optional and is designed to help technical people manipulate PIN numbers during development.
|
Page Name |
Definition Name |
Usage |
|---|---|---|
|
GPBR_COMP_VARS |
Define the variables for components to be used on the Map Elems to Comp/Rcd BRA page to define the variable type. |
|
|
Map Elems to Comp/Rcd BRA Page (map elements to component/record BRA page) |
GPBR_ELEM_MAP |
Set up the mapping to the fields and variables of an element which are used during development in the components interface objects. |
The element map plays a critical role when packaging and moving elements and data to other databases.
PIN numbers are used in PeopleCode, component interfaces, and reports to refer to global elements. The PIN number is a consecutive number so it can change between databases or releases; therefore, there is a need to create a utility during development so that the PIN number is not hard-coded. Using the utility also ensures consistency between the PIN number changes.
There are two ways to map an element:
By record
By component
Select record when you need to map a record field into a core Global Payroll element.
Select component when the mapping doesn't depend on a record field; instead, it depends on some behavior on the page, for example, the record is used in more than one place and must map to different core Global Payroll elements.
If you select to map an element by component, you may want to define your component variables on the Define Variable Attributes BRA page before you define your element mapping.
PeopleCode Function Example
When you need to use a PIN number in the PeopleCode, use this function to obtain the corresponding PIN number:
Declare Function Get_Pin_Num PeopleCode GPBR_DERIVED_EM.PIN_NUM FieldFormula;
&Record_Name = "GPBR_LOAN";
&Date_Pin_Num = Get_Pin_Num ("R", &Record_Name, "DATE");Use the Define Variable Attributes BRA page (GPBR_COMP_VARS) to define the variables for components to be used on the Map Elems to Comp/Rcd BRA page to define the variable type.
Navigation:
This example illustrates the fields and controls on the Define Variable Attributes BRA page.
Field or Control |
Description |
|---|---|
Variable Name |
Enter the name of the variable. This can be any name you want to use during PeopleCode development. |
Variable Type |
Select the variable type. Values include Character, Date, Date Time, Image, Long Char, Numeric, Signed Number and Time. Note: Once you have defined your component variables, you can map your elements on the Map Elems to Comp/Rcd BRA page. |
Use the Map Elems to Comp/Rcd BRA (map elements to component/record) page (GPBR_ELEM_MAP) to set up the mapping to the fields and variables of an element which are used during development in the components interface objects.
Navigation:
This example illustrates the fields and controls on the Map Elems to Comp/Rcd BRA page.
If you choose to map your elements by component, you may want to define your component variables before you map your elements.
Field or Control |
Description |
|---|---|
Type |
The key type that your mapping applies to appears here. Values include Other and Field. |
Map Value |
Select the field or value to which you want to map. If you selected Record as the key type, you can select the record fields. If you selected Component as the key type, then you can select the variables defined for the component. |
Entry Type |
Select the element type on which you want to transform your field or variable. Values are Accumulator, Bracket - Numeric, Count, Deduction, Earnings, Formula - Numeric, Rate Code, Rate Code - Amount, Hrly+Amt, Variable - Numeric, Variable - Pointer, and Variable - Dec+Char+Date+Ptr. The values available depend on the map value type. For example, if you select a character map value, then you can select only character values. Note: Although you can see System Element - Numeric as a value, you cannot select it. The entry type cannot be a system element or a constant. |
Name |
Select the name of the element. |
The PeopleSoft system delivers a query that you can run to view the names of all delivered elements designed for Brazil. Instructions for running the query are provided in the PeopleSoft HCM: Global Payroll product documentation.