Reviewing Elements of Column Designer

Objectives

After completing this lesson, you will be able to:
  • Identify the elements of the Column Designer.
  • Describe the custom field attributes.
  • Identify the operators and functions for a formula.
  • Create custom views and re-label budget rows.

Column Designer

The order in which the fields are displayed and grouped on the worksheet is determined in Plan SetupDesign worksheetColumn Designer. This is also where you can create custom fields to be added to the plan.

The Column Designer screen is displayed.

Column Designer is where the administrator can arrange the visible aggregate fields. These fields are the total section configured under label names and visibility page.

Although relabeling settings are also available in column designer, it is best to use Label names and visibility page.

Data pulled from Master user file (UDF) can also be added using column designer. It will be added as a custom field.

Custom Fields

Custom fields allow you to add data to the worksheet according to your organizations requirements. Custom fields can be added at all levels of Variable Pay form.

Assignment Level Custom Fields (or ALCF) refers to any custom fields that are added outside of entry level. Assignment level custom fields give greater flexibility in setting up complex calculations at any level of the variable pay form. One use case for ALCF is when customer requires different guidelines that will differ based on assignment information. Without ALCF, this will require creating multiple Variable Pay plans, as Variable Pay allows only for one set of guidelines to be set on data at the entry level. When using ALCF, it is important to know the levels of on which you can create custom fields. Lower levels can reference data at higher levels and higher levels can aggregate data from lower levels.

Custom Field Attributes

AttributeDescription
Column NameDescribes the column name. Column names can be custom-ized. We suggest you rename the columns to use names that your customer is familiar with.
Enable Help Text

Could be used to provide context to better understand the significance of the column.

  • A maximum of 50 fields can be set up with help text per template.
  • A limit of 256 characters per help text is enforced.
  • URL links are not supported.
Read-onlyYou can configure the column in read-only mode on the worksheet.
Column AlignmentThe column alignment setting in the column designer will manage the column header, the field values and the total at the bottom of the column in the worksheet, and in Executive Review page.
Column Width

Enter a number to set the width of the column. The unit of measurement is automatically determined based on the type of data that displays in this column.

  • For enumerated fields, the default width is 6. Enter a value based on the longest enum value to avoid having it trun-cated. If left blank, the system uses the default value of 6.
Hide this column on the formSelect this option if you dont want the column to be visible on the form.
ReloadableSelect this option when you want data in this column to up-date when the data is updated in the UDF. By design, reload-able only works with read-only fields. To improve system performance, there is a setting to update reloadable fields only when "Update All Worksheets" is run, instead of when-ever the form is opened. The setting can be enabled in Plan Settings → Advanced Settings
Exportable hidden columnSelect this option if you want the hidden column to display in exported files.
Column IdThis ID is the unique identifier which identifies the field as a standard field with specific predefined properties. For stand-ard fields, the column ID is not configurable.
Import KeySome standard fields are imported in the user data file. These standard imported fields have a default import key in downloaded CSV file. If the import key is customizable, this field can be populated by data from the user import data file using a field other than the default import field. Field mapping can be UDF column header or data-field-Id for Employee History Data for ALCF.
Column Type
  • String - Any alphanumeric set of characters
  • Money - Numeric currency values only
  • Percent - Percentage values only
  • Amount-Numeric values only
  • Date - Calendar date values only
  • Username - User ID values only. Can be used to pass the user ID as a variable, which the system uses to retrieve and display the full name of the employee in one column on the worksheet. If an invalid user ID is passed, the sys-tem retrieve the full name of the employee, and displays only the invalid user ID
Formula

You enter the formula you want to use in this column. You can insert fields in your formula by selecting the ones you want from the Use a field drop down menu.

Set the Read-only option to Yes.

Make sure the Import Key option is empty. Import keys can’t be used with formulas.

Validation

Your choice determines how the system validates the infor-mation you add to editable fields. You can apply validations to compare numeric entries you enter to specific values or range of values.

The following fields apply to the standard validation:

  • No validation -This option is available for all column types.
  • Set a value range - When users enter values outside the range you define for this field, the system displays an er-ror message. This option is only available for the column types Money, Percent, and Amount.
  • Set enumerated values - The values are displayed as dropdown.
Custom ValidationYou can set up validation for up to 10 entry level custom fields for a variable pay template. The custom validation supports read-only, string fields. You can configure a warning or error messages for the validation but only error messages appear for the planners.
ReportableSelect this choice if you want the field to be available in Table reports. (The limit of reportable fields is 40 custom text fields, 100 custom numeric fields, and 5 custom date fields. Standard fields are automatically included in Table reports.)
Enable Rules Eligibility

Typically used in conjunction with using percentOfCustomField budget mode.

You can enable up to 20 fields on a compensation template to be available for eligibility rules, then apply them on the Eligibility page. The following custom field types are supported: money, amount, string, date, decimal, and percent.

TranslatableAn option available when a String-type custom field is used in an EC-integrated plan. This setting allows to pull the translated value mapped to Employee Central.
Calculate TotalAvailable for column types Money and Amount. Select this choice if you want to display the sum of all values in the col-umn in the Group Total.
Money FormatYou can select the rate type associated with the money for-mat that you want to use for the column.
Import SourceDefines where to pull the data, either UDF or EHD. Applicable to ALCF.
Aggregate FieldAmount pulled from lower level. Applicable to ALCF.

Operators

When creating a formula, the system allows the use of different operators. Based on the formula, all of the following are valid operators:

To perform this calculation (Operation) ...Use this symbol in your formula (Operator) ...
Add+
Subtract-
Multiply*
Divide/
Calculate Remainder (Mod)%
Logical AND&&
Logical OR||
Logical NOT!
Less than<
Greater than>
Less than equal to<=
Greater than equal to>=
Logical EQUAL==
Logical NOT EQUAL!=

Functions

You can also create complex formulas. To do so, you can add the functions shown in the following table to your formula:

You can use this operator …For the following …
lookup('lookup_table_name', key1...key5, outputIndex)

Must have a string_literal as the first argument to indicate the lookup table name, the lookup keys must be of string type, and outputIndex is an integer from 1 to 5.

The lookup function always returns a string. To use it in a numeric operation, you need to wrap it with toNumber.

toNumber(string_value)Convert String data to Number. If the string_value submitted for your formula is not a number, the formula evaluation will fail.
toString(number_value)Converts Number data to String.
if(cond, value1, value2)

The entry for cond can be any expression that evaluates to a true or false Boolean value.

The entries for value1 and value2 can be of type String, Number, or Date, but they must both be of the same type.

toDate(string_value, date_format)

Converts a date string, based on the format to a date object.

The entry for date_format can be a string literal (for example, mm/dd/yyyy) or a variable.

dateDiff(date1, date2)Returns the number of days that are different between the two given date values. Only returns an integer value; fractional days are discarded.
round('up'|'down'|'halfUp', value)

Rounds the given value to the nearest integer, based on the chosen rounding mode.

When you round a number up, the number is rounded away from zero. For example, 5.5 is rounded to 6. Similarly, -5.5 is rounded to -6.

When you round a number down, the number is rounded towards zero. For example, 5.5 is rounded to 5. Similarly, -5.5 is rounded to -5.

When you round a number halfUp, if the number has a decimal value of .5 or greater, the number is rounded up to the next integer if positive or down to the next integer if negative. If the number has a decimal value less than .5, the number is rounded down if positive and rounded up if the number is negative.

Column Grouping

Fields can be put into groups with a group name and color. Grouping the columns make worksheet more cohesive and easier to look at.

Column Group Settings

  • Column name: Label visible in the worksheet.
  • Grouping ID: Unique identifier visible in the XML. Use letters, no special characters.
  • Initial State: Column behavior when opening the form for the first time. Can be set to expanded or collapsed.
  • Displayed column when collapsed: One column can be set to be visible even when group is collapsed.
  • Group color: Background color for the columns.

Budget Fields

This is where the budget rows are relabeled.

Custom Views

Administrators can configure which portlets are viewable on the form. It provide planners direct access to view portlets from People Profile (PP3) in the Variable Pay worksheet. The ability to view employee details such as compensation history, rating history or bonus history facilitates better decision making for planners. Viewing permissions will respect Role Based permission set for the planner. Administrators need to define the section and block Id in order for portlets to be visible on the form.

The Spot Incentives screen is displayed.