RCA employee sort order callout

The RCA employee sort order callout allows customers to implement custom logic for sorting employees in the Relief Calling Area (RCA). This can be useful when employees must be contacted for open relief shifts in a specific order to satisfy company policy or collective bargaining agreements. Customers implementing this callout create an implementation for RcaEmployeeSortCalloutService to define the logic for custom sort orders. The bean ID for this custom service implementation is specified in the RCA_SORT_SVC registry parameter.

The implementation for this callout receives these data objects as inputs: the shifts selected in RCA, the employees returned based on the selection criteria, and the sort order the user has selected. The service can support multiple custom sort orders. Custom sort orders must be added to the Relief Calling Sort Order maintenance form to enable customers to select them in RCA. When adding custom sort orders to this maintenance form, the Sort Order field defines the string that is passed to the service as an input when a user selects a custom sort order.

The callout implementation returns a sorted list of employee IDs. A validation is run against the returned list to ensure that it includes the same employees as the input list. The validation fails if there is a mismatch between the number of employees in the sorted list and the input list. It also fails if different employees are returned in the sorted list. When the validation fails, an error message is displayed to the user, and the employees in RCA are sorted using the Alphanumeric sort option. A system error occurs if an un-handled exception occurs in the callout implementation for any reason.

See RCA_SORT_SVC.