Formula Parameters in Time Rule Templates and Rules

Formulas contain parameters that time repository rules use to provide actual values to the formulas. You configure formula parameters when you create rule templates. Your settings affect the values people select or enter when creating rules with the rule template.

Display Sequence

You can specify the order that the parameters appear when people create rules with the template. The lower the number, the higher the parameter appears in the list. The actual values set in the template don't show when people create rules.

Formula Parameter Name

The name of the formula parameter that you see in the rule template comes from the formula. You can't change the parameter name because it uniquely identifies the parameter in the formula.

Parameter Type

The parameter type specifies the expected format of the value set in rules created with the template. You type selections include value set; fixed text, number, and date; time category; exclude; and message. If you don't want the parameter to appear in rules created with the template, select Exclude.

Required

You specify whether rules created with the template need to use the parameter. You select Yes or No when you create the rule template. People creating rules with the template see your selection as a read-only value.

Value Set

You can see the Value Set parameter setting only if Parameter Type is Value set. The value set that you select decides the values that people can select from when they create rules with the template. They see the values that make up the parameter drop-down list, but they don't see the name of the value set. For example, the available value set HRC_YES_NO includes the values Yes and No. People creating rules see those values in the parameter drop-down list. They don't see HRC_YES_NO anywhere in the Rule Parameters section.

Display Name

The display name is the read-only name for the parameter in rules created with the template. By default, the display name is the formula parameter name. For example, many time formulas have a parameter named WORKED_TIME_CONDITION of type Time category. This parameter identifies which time entries the formula should consider as part of the validation or processing. People creating rules with the template select a time category from a drop-down list. It might make more sense for them to see the display name Time Category or Time to Consider instead of the actual parameter name WORKED_TIME_CONDITION.

Value

People creating rules with the template select or enter the actual value that parameter passes to the formula depending on your parameter settings. For example, if a parameter uses the HRC_YES_NO value set, one rule created with the template could have the parameter pass the value Yes. Another rule created with the same template could have the parameter pass the value No.