Release 124 Notes

R124 Sprint: 1/9/2023 to 1/31/2023. To learn about product features that you may not recognize, contact ClientSpace Professional Services.

Release schedule

Release updates are implemented by the group, as indicated in the following table.

Enhancement

Enhancement groups are Change in Functionality, ClientSpace Premium (ClientSpace with additional modules), Advanced Administration, General, and Staffing.

ClientSpace Premium

ClientSpace API

Case

Enhancement

49491

Added New Method to ClientSpace API for Setting Active Status on Dataform

A new PATCH method has been added to the Dataform section of versions 1.0 and 2.0 of the ClientSpace API. The method sets the Active status on a dataform record.

Detailed documentation for client developers can be found in the Swagger interface by expanding the Dataform section and then expanding PATCH /api/dataform/v2.0/{tableName}/{id}/active/{active method.

Click Model to see model definitions as shown in the example below:

Click Example Value to view and copy sample code as shown in the example below:

General Enhancements

Case

Enhancement

55566

Updated Renew Benefit Plan Business Rule

The following updates were made to the Renew Benefit Plan business rule:

  • Added the ability to clone (i.e., copy) the new Underwriting Group field value (used for Gradient AI) to the new benefit plan.

  • Prior Renew Benefit Plan business rule logic is still applicable:

    • Values set to clone are copied when the Renew link is clicked in the Action Center Workflow section of the displayed Benefits Plan record.

    • The Renew link is only active when Benefit Plan status is Active and the Renewed From field is empty (indicating that the plan has never been renewed previously).

    • When the Renew link is clicked, a new plan is added in New status with all cloned values included in the new plan record.

  • Updated the Description section on the Renew Benefit Plan Rule Details page to reflect the addition of Underwriting Group to the copied fields and reformatted the list items in this section for improved readability.

55902

Updated the "Kill" Business Rule Method to Inactivate Underwriting Approval Record and Update Status

Previously, when the "Kill" workflow process was initiated on an RFP from the Pricing Console or from a Client Master record, underwriting approval records were not being inactivated and set to a status of "Dead". Now, the "Kill" business rule method has been updated to set all associated underwriting approval records to a status of "Dead". The underwriting approval records are also marked Inactive (i.e., the Active checkbox is cleared) and the Audit field of each underwriting approval record is updated with the status change details.

 

These changes affect the following Client Master business rules that use the Kill method:

  • Kill New

  • Kill Submitted

  • Kill Underwriting

  • Kill Approved

Additionally, the Rule Details window Description fields (System Admin > Advanced > Manage Rules) for each of the affected business rules have been updated to reflect these changes.

 

See PEO underwriting approval process.

57948

Removed the Employee Termination Tab from the Client Service Case and Inactivated COVID-19 Workflow Channel

The Employee Termination tab was added to the Client Service Case dataform to assist with offboarding workflow related to COVID-19 mass layoffs. Now that the Employee Termination tab is no longer widely used, it has been removed from the Client Service Case dataform. The form is still available as a Custom Link which is currently Inactive. Additionally, the COVID-19 workflow channel has been deactivated.

 

Note: In the referenced article below, "Offboarding Workflow", references to the Employee Termination tab attached to the Client Service Case dataform have been removed. However, there are still references to COVID-19 email templates. These templates will be deactivated in a future release of ClientSpace.

See Offboarding Workflow.

58286

Added a PEO ID Filter Field to More Search and a PEO ID Column to Support Multi-Tenant Users

A PEO ID filter field has been added to the More search of the following dashboards:

  • Clients

  • Employees

  • WC Claims

  • UI

Additionally, a PEO ID column was added to each of these dashboards. By default, the PEO ID column is hidden. Add it by clicking the down arrow on any column heading and selecting PEO ID on the Columns list.

See the example screen below showing the PEO ID More search option and PEO ID column:

Note: You must type the entire PEO ID in the More search filter field to return results. Typing a partial PEO ID will not return any results.

 

See Multi-tenant Environments in ClientSpace.

58343

Modified Single User Client Service Case Type Assignment to Require Backup User Assignment

Client Service Case Type configuration has been enhanced to require a backup assignment specification. Previously, when Single User was selected as the Default Assignment on a Client Service Case Type record, there was no backup assignment function for when a Default Assignment became invalid (i.e., Blank, Inactive or Expired). Now, when Single User is selected as the Default Assignment on a Client Service Case Type record, two new required fields are available:  Backup Assignment and Backup Assigned To. You must select Single User or Client Role as a Backup Assignment type and then select the "assigned to" individual or role in the Backup Assigned To field.

 

  • If the Backup Assignment is a Single User, the Backup Assigned To field selector allows you to select a Single User as shown in the example screen below:

  • If the Backup Assignment is a Client Role, the Backup Assigned To field selector allows you to select a Client Role as shown in the example screen below:

Note: Case Type Assignments with a Single User Default Assignment that were configured prior to this release will not have Backup Assignment and Backup Assigned To values set. We recommend updating these Case Type Assignment records with backup assignment information. However, if you do not update these records, missing or blank values are accounted for in the validation logic as outlined below.

 

The validation process when adding a new Client Service Case works as follows when the backup assignment is a Single User or Client Role:

  • Validation Step 1: If the Default Assignment on the Case Type Assignment record is Single User and that user is valid, the Assigned To user on the case displays the default assigned single user.

  • Validation Step 2: If the Default Assignment on the Case Type Assignment is Single User and that user becomes invalid, the Assigned To user on the case displays the user or role from Backup Assigned To field.

  • Validation Step 3: If the Backup Assigned To user or role is invalid, the Assigned To user on the case displays as the Manager of the responsible department from the Case Type category metadata associated with the case type. For example, if the Category field on the Case Type record for 401K is "Benefits", the system will check the Department Admin/Department Details record for "Benefits" and display the name shown in the Manager field as the Assigned To user on the case.

  • Validation Step 4: If no valid default assignments can be found, the Assigned To field will be left blank, and the following error message displays when you click Apply or Save on the case record: "There is no Assigned To selected and the associated case type does not have a default user selected. Please either set a default user on the case type or select an Assigned To user. "

See Configuring Case Types.

59723

Added Case Type Position Tags

ALERT:  This functionality supports future Employee Portal changes (to be determined) to allow filtering by Case Type.

A Case Type Position Tags multi-lookup field has been added to the External fieldset of the Client Service Case Type dataform:

The Case Type Position Tags field is Active by default. It allows you to choose which case types are visible to portal users by their PrismHR User Type. Both the Manager and Employee tags are set by default. To display a case type to only one group, remove one of the default tags from the Case Type Position Tags field as applicable on each Case Type record.

In addition to the new Case Type Position Tags multi-lookup field, the following changes were made to support this functionality: 

  • A new Case Type Position Tags lookup group has been added to System Admin > Lookups > Manage Groups. The lookup group contains two new values: Manager and Employee. Both the lookup group and values are marked as system-level elements and marked to include in the ClientSpace API.

  • The ClientSpace API was enhanced to consume this data to filter case types based on position classification.

See Configuring ClientSpace for the Employee Support Center.

60005

Info Bubble Descriptions for _SetFieldOnRelatedForm and _SetFieldFromRelatedForm Business Rule Methods Enhanced

The Info Bubble descriptions in the "Method Parameters" fieldset of the _SetFieldOnRelatedForm and _SetFieldFromRelatedForm business rule methods have been updated for clarity.

The following changes were made for _SetFieldOnRelatedForm:

  • TargetField - "The name of the field on the form defined by RelatedParentField that will be updated on execution of this rule."

  • RelatedParentField - "The parent form field on the triggering dataform that defines the related dataform that will act as the target form."

The following changes were made for _SetFieldFromRelatedForm:

  • RelatedParentField - "The parent form field on the triggering dataform that defines the related dataform that will act as the source form."

Staffing

Case

Enhancement

57523

Added Staffing Business Rule to Split the PrismHR Location Code into Two Fields

A new SplitStaffingLocationCode business rule has been added that splits the Location Code imported from PrismHR into two fields. The Location Code imported from the PrismHR API displays on the Client Location dataform in the "Location Information" fieldset of ClientSpace. For staffing clients, it is comprised of a Staffing Client ID and a Staffing Client Location or Department. When the business rule runs, the PrismHR Location Code is split into a Staffing Client ID and a Staffing Client Location and two, new corresponding fields located on the Client Location dataform ClientSpace in the "Staffing Location Information" fieldset are populated as shown in the example below:

Note: 

  • The SplitStaffingLocationCode business rule is Inactive by default.

  • The rule is only triggerable when the Contract Type on the Client Master is "Staffing".

  • The "Staffing Location Information" fieldset is part of the Staffing Implementation Group. This means that the fieldset does not display unless ClientSpace is configured to use the Staffing module.

  • The Location Code is split on a hyphen that must be found in the value imported. If this is not included, the value will not be split.

See Staffing Business Rule Methods.

57904

Staffing Placement "Location" Field is Now Required

Previously, the Location field on the Staffing Placement form was not a required field. Now that an enhancement has been made to display the Location Code portion of the location in the Staffing Placement field (which is located on the Comp Claim Claimant tab of the Worker's Compensation Comp Claim form), the Location field is required data entry.

 

Note: If the Location field was left blank on Staffing Placement records created in prior versions, the Location Code will not display in the Staffing Placement field and list values. This missing element will not prevent you from being able to select or access a Staffing Placement record. However, the missing element may restrict certain list searches as you will not be able to use the wildcard option to filter the Staffing Placement lookup list by Location Code. Completing the Location field on the Staffing Placement record resolves this issue. Refer to Case# 59974 for related details.

59475

Added Staffing Placement Fields to Server Data Proc 1 for Use in Workflow Conditions, Business Rules, and Email Templates on the Comp Claim Dataform

To support the need to generate worker's compensation workflows for the First Report of Injury (FROI) on staffing employees (plus various other use cases related to staffing employees), the following Staffing Placement form fields and related Comp Claim Claimant tab fields have been added to Server Data Proc 1 for use in building workflow condition expressions, retrieving "Replace" fields, creating email template conditions, and configuring business rules:

  • Division Code

  • Location Code

  • Placement ID

  • Position

  • Start Date (i.e., placement start date)

  • End Date (i.e., placement end date)

See Server Data Proc 1 for Workflow Channels, Email Template Tasks and Business Rules Triggered from Staffing Placement Dataform

59707

Added "Refresh Placement List" Link to Staffing Implementation Group

The Refresh Placement List link located in the Action Center of the Comp Claim dataform is now part of the Staffing Implementation Group. This means that the link does not display unless ClientSpace is configured to use the Staffing module.

See Refreshing the Staffing Placement List.

59758

Changed the Location Field Display Value and Lookup List Values to Include Location Code and Location Name for Staffing

When the Contract Type on the Client Master form is set to Staffing, the Location field display value and lookup list options show the Location Code with the Location Name next to it in parentheses. This display change affects the following dataforms:

  • Comp Claim Claimant

  • Staffing Placement

  • Certificate Of Insurance

  • Employment

The example image shows Location field display value and lookup list options on the Staffing Placement window:

If the Contract Type is not set to Staffing, the Location field display value and lookup list options only display the Location Name as in previous versions.

See Staffing Placement Dataform.

59974

Changed Staffing Placement Field Display Values and Lookup List Values to Include Location, Placement ID and Date Range

The Staffing Placement field on the Comp Claim Claimant tab of the Worker's Compensation Comp Claim form has been updated to display the Location Code, Placement ID (in parentheses), and placement date range (i.e., placement Start Date and End Date). These changes have been made to both the display value and the lookup list options as shown in the example below:

 

Note: 

  • Placement ID, Start Date, and End Date values come from the Staffing Placement form. The Location Code comes from the Client Location record related to the Staffing Placement form. If any of these field values are not entered, they will not display in the Staffing Placement field or lookup list values.

  • Type the tilde symbol () in a blank Staffing Placement field to display both Active and Inactive placements in the lookup list. "Inactive" displays at the end of inactive placements in parentheses as shown below:

  • Type the wildcard character/percent symbol (), followed by a partial Placement ID, Location Code , or date in a blank Staffing Placement field to filter the lookup list for the specified characters as shown below:

See Staffing Placement Dataform.

Fixes

Case

Issue summary

Resolution

59920

Incorrect Data Type on Number Hours Represented Field of Remuneration Dataform Caused 201 Error When Posting to SIDES

Previously, the data type of the Number Hours Represented field of the UI Claims > Remuneration dataform had a data type of integer that only allowed whole numbers to be entered and stored. This caused a 201 error to display when posting the Number Hours Represented to SIDES if the hours included a decimal amount for a fraction of an hour. Now, the data type of the field has been changed to decimal to allow the Number Hours Represented submitted to SIDES to include fractions of hours as a decimal amount.