Multiple Reviewers Schedule Posting

Make sure that a reviewer list containing the appropriate steps and stakeholders is configured in UKG Pro Workforce Management; assign to employees in People Information. See the Reviewer Lists topic.

Edit the Function Access Profile (FAP) assigned to stakeholders and set the Schedule Posted and Mark Schedule Unposted functions to Disallowed. See the Manager - Department Manager ACPs topic.

Configure generic workflow notifications that inform stakeholders about a schedule review or the occurrence of schedule posting errors. See the Generic notifications topic.

Examples include:

1. Log in to the appropriate tenant.

2. Go to Main Menu > Administration > Setup Data Manager.

3. Select the Source tenant where the Process Model resides, and select the template to copy. It is a .zip file. A message appears in the Source column: Source: Import from <filename>.zip.

4. Click Tap Review and Publish. The Publish Summary panel appears.

5. Review the Publish Summary panel. It lists the items that were extracted from the migration file. If you approve, click tap Publish with Comment or just Publish.

6. Click Tap Go to Publish History at the bottom of the panel to view the status of the data transfer. The Publish History page contains a table that lists the items you have published. If there were errors during the transfer, the button under the Errors column for that row is black.

7. To view details, click tap the appropriate row and click tap View Selected.

8. On the History for publish run page, click tap Show all to view the setup data that you published, and the errors that occurred, if any, listed by item type and name.

1. Go to Main Menu > Administration > Application Setup > Business Process setup > Process Models.

2. Select the MultipleReviewersSchedulePost_v3.1 process and click tap Edit. The process model enters edit mode.

3. Select the Decision Tables tab.

4. Click Tap Everyone's, and then select the decision table to edit.

5. Click Tap Decision Table Editor to add or update the rows in the table.

6. Click Tap Save and close.

7. Repeat steps for the following tables:

   Caution:

   • Values entered in the decision tables are case-sensitive, and must match configured values in the application.

   • Do not remove variables, variable names, or variable types from any decision table.

   • MultipleReviewersSchedulePost_v3_1_Parameters

     Allows configuration of the parameters used in the workflow.

     Multiple Reviewers Schedule Post Parameters decision table

     Multiple Reviewers Schedule Post Parameters decision table

     Parameter name	Description	Default value
     SilentApprovedAfter	Determines the amount of elapsed time before the form is automatically approved. The value must be formatted as HH:mm.	null
     ManagerNotification	Name of the notification sent to the posting manager and reviewers when a decline or approval occurs.	Multiple Reviewers Response Notification
     ErrorNotification	Name of the error notification sent to the configured email address, such as Admin.	Multiple Reviewers Schedule Posting Error Notification
     OrgPathNodesToDisplay	Number of levels of the organizational hierarchy to display.	2

   • MultipleReviewersSchedulePost_v3_1_InternalParameters

     Contains internal parameters for multiple reviewers schedule posting functionality.

     Multiple Reviewers Schedule Post Internal Parameters decision table

     Multiple Reviewers Schedule Post Internal Parameters decision table

     Parameter name	Description	Default value
     Admin	Internal user; do not change.	SERVICES-LEVEL3
     LocationActivitiVariableKey	Internal parameter; do not change. Key variable for location.	WFD_employees
     TimeframeActivitiVariableKey	Internal parameter; do not change. Key variable for timeframe.	WFD_timeframe
     PostingManagerPersonNumberActivitiVariableKey	Internal parameter; do not change. Key variable for the posting manager's person number.	initiator
     MaxEmployees	Internal parameter; do not change. Key variable that sets the upper limit on maximum number of employees for which this workflow can run.	200
     MaxDurationInDays	Internal parameter; do not change. Key variable that sets the upper limit on maximum number of days for which this workflow can run.	14

   • MultipleReviewersSchedulePost_v3_1_ReviewerListByLocation

     Used to specify the reviewer list for the designated location.

     Multiple Reviewers Schedule Post Reviewer List by Location decision table

     Multiple Reviewers Schedule Post Reviewer List by Location decision table

     Column name	Description
     Location	Identifies the location for which the reviewer list is retrieved. Wildcards are not supported.
     ReviewerList	Identifies the reviewer list. To disable the functionality, set ReviewerList= None. Reviewer list values must be configured in UKG Pro Workforce Management and must match the tenant default locale.
     RuleSeverity	Semicolon-separated list of schedule rule severity values that support the schedule rule violation functionality. To disable the functionality, set RuleSeverity= None. Supported values include: None(default) Warning Informational No Save
     EmployeeRules	Semicolon-separated list of employee rules that support the schedule rule violation functionality. To exclude employee rules from validation, set EmployeeRules= None. Employee rule values must be configured in UKG Pro Workforce Management and must match the tenant default locale.
     OrganizationRules	Semicolon-separated list of organization rules that support the schedule rule violation functionality. To exclude organization rules from validation, set OrganizationRules= None. Organization rule values must be configured in UKG Pro Workforce Management and must match the tenant default locale.
     RuleSelectionOperator	Determines whether EmployeeRules and OrganizationRules values are included or excluded during schedule rule validation. Supported values include: Include(default) — Include all EmployeeRules and OrganizationRules values during schedule rule validation. Exclude— Exclude all EmployeeRules and OrganizationRules values during schedule rule validation.

   • MultipleReviewersSchedulePost_v3_1_Locale Allows customization of the workflow form and notifications related to Multiple Reviewers Schedule Posting functionality for different locales.

     Multiple Reviewers Schedule Post Locale decision table

     Multiple Reviewers Schedule Post Locale decision table

     Variable name	Variable type	Description
     Locale Parameter Name	Text	Internal field label; do not change.
     Locale Policy	Text	Name of the locale policy for which the text applies. When the text applies to all locales, retain the empty value.
     Locale Message	Text	Text displayed in the workflow form or notification.
     Locale Description	Text	(Optional) Additional information.

     Note:

     • Localization of business process workflows remains optional, but is supported.​
     • You can translate some or all messages by adding lines to the table in their preferred translation for specific locales. Decision tables are scanned from top to bottom; therefore, place messages for the most commonly used Locale Policy at the top of the decision table and less-restrictive locale policies at the bottom.
     • Text within tags ("<>") must not be changed.
     • The decision table holds all messages represented with standard English labels; these apply to all locales when the Locale Policy is set to !=empty.
     • Names of the parameters in the decision table column ​Parameter Name must be used as is. If any parameter value needs to be localized for a different Locale Policy, copy the ​Parameter Name​ with the !=empty ​Locale Policy, add a new row to the decision table with the appropriate Locale Policy, and then add the localized value in the Message column.​
     • Decision tables support operators like "Contains," "Starts with," "Ends with," and "Is Not Empty." You can achieve your preferred results by following these examples:
       • To match any non-empty or any string (like *), use the "Is Not Empty" operator.
       • To match a string starting with "ABC" (like "ABC*"), use the "Starts with" operator and set the value to "ABC".
       • To match a string containing "English" as substring, use the "Contains" operator with the value "English".
     • The last row in the decision table must remain empty ("!=empty".)

     Locale Parameter Names

     Locale Parameter Names

     Locale parameter name value	Description
     Error_APIFailure	API call failed in the workflow.
     Error_BlankReviewerList	Reviewer steps are not present in reviewer list.
     Error_ConsecutiveReviewerNotSupported	Consecutive duplicate reviewers are configured in the reviewer list.
     Error_HyperfindTypeNotCorrect	Posting manager selected a Hyperfind/employee as Location & Hyperfind type.
     Error_InvalidSilentApprovedAfterFormat	Parameter 'SilentApprovedAfter' is not in HH:mm format.
     Error_LocationNotFound	No Reviewer List found for the selected location in the decision table.
     Error_MultipleLocationsSelected	User selected multiple locations.
     Error_ReportToNotFound	Posting manager does not have a Reports To assignment.
     Error_ReviewerListNotFound	Reviewer List does not exist in UKG Pro Workforce Management
     Error_ScriptFailure	Script failed in workflow.
     Error_SymbolicReviewerNotSupported	Reviewer list contains reviewer types other than manager, previous reviewer's manager, and named user.
     Label_AutoApproalTimer	Automatic approval timer label.
     Label_Location	Location in posting manager form label.
     Label_ManageSchedulePosting	Radio button option of manage scheduling posting label.
     Label_PostedJobsHeaderManageSchedulePostForm	Posted jobs header label.
     Label_QuickPost	Radio button option of quick post label.
     Label_ReviewerActionApprove	Reviewer action approve label.
     Label_ReviewerActionDecline	Reviewer action decline label.
     Label_ReviewerActionSubmitButton	Reviewer form submit button label.
     Label_ReviewerFormButtonApprove	Reviewer form approve button label.
     Label_ReviewerFormButtonDecline	Reviewer form decline button label.
     Label_ReviewerFormComment	Reviewer form comment section label.
     Label_ReviewerFormHeader	Reviewer form header label.
     Label_ReviewerFormLocation	Reviewer form location label.
     Label_ReviewerFormManager	Reviewer form manager label.
     Label_ReviewerFormTimeframe	Reviewer form timeframe label.
     Label_ReviewerListText	Reviewer list label.
     Label_ReviewerUserFormRadioButtonHeader	Reviewer user form radio button header label.
     Label_SchedulePostFormRadioButtonHeader	Schedule post form radio button header label.
     Label_SchedulePostReviewerFormRadioButtonHeader	Schedule post reviewer form radio button header label.
     Label_StepIndexHeader	Step in reviewer list form label.
     Label_Timeframe	Reviewer form timeframe label.
     Label_UnpostedJobsHeaderManageSchedulePostForm	Unposted jobs checkbox label.
     Label_UnselectedJobsInForm	Unselected jobs label.
     Message_GenericErrorString	Generic runtime error message.
     Message_SilentApprovalAutoComment	Automated approval comment default message.
     Message_SysAdminErrorString	System admin string message.
     Label_SchedulePostFormSubmitButton	Submit button for Schedule Post Form label (Form1).
     Label_ManageSchedulePostFormSubmitButton	Submit button for Manage Schedule Post Form label (Form2).
     Label_ReviewerListFormSubmitButton	Submit button for Reviewer List Form label (Form3).
     Label_FormHeading	User form name.
     Error_InValidHyperfindCountRange	Error that displays when the employee count exceeds <MaxEmployees> or the date range exceeds <MaxDurationInDays> days.
     Label_ViolationFormHeading	User form heading.
     Label_ViolationFormSubmitButton	Submit button label on violations form.
     Label_Warning	Rule severity - Warning label.
     Label_Informational	Rule severity - Informational label.
     Label_NoSave	Rule severity - No Save label.
     Error_SupportUserNotSupported	Support user access is not supported.
     Error_MultipleOrgNodeRefsNotSupported	Multiple org node references are not supported.
     Error_MultipleEmpGroupsAssignmentNotSupported	Multiple employee groups are not supported.
     Label_ErrorFormSubmitButton	Submit button label on error form.
     Label_CancelButtonThirdForm	Cancel button label on third form.
     Label_CancelButtonSecondForm	Cancel button label on second form.
     Label_UnpostedJobsHeaderReviewerForm	Unposted jobs header label on reviewer form.
     Label_PostedJobsHeaderReviewerForm	Posted jobs header label on reviewer form.

1. Go to Main Menu > Administration > Application Setup > Business Process setup > Process Models

2. Select the MultipleReviewersSchedulePost_v3.1 model, and then click tap Deploy.

3. Configure the fields on the business process page:

   • Template Categories= Scheduling Workflow

   • Status= Active

   • Action List= Hide

   • Tile List= Hide

   • GoTo List= Show

4. Click Tap Save, and then select Return.

5. Click Tap Refresh.