Release 130 Notes

R130 Sprint: 7/3/2023 to 7/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

61286

Updated ClientSpace API Version 1.0 Documentation

ClientSpace API Version 1.0 documentation has been updated in the Swagger interface using the documentation standards in ClientSpace API Version 2.0. To view the Help, client developers can expand the API category and then click the method to view the method details.

Improvements include:

  • Ensuring that all methods have a proper description.

  • Ensuring that all methods include proper implementation notes, model definitions, and example values (as applicable) in the method details.

Other ClientSpace Premium

Case

Enhancement

60669

Client Profitability Merge Enhancements

The following new fields have been added to the Payroll_New tab of the Client Profitability Report merge (System AdminOutputs > Merges >Client Profitability) Excel template:

 

Excel Cell Number Field Label Other Notes
D6 Total Gross Wages Column header. D7 through D11 values display under this header.
D7 N/A Displays Regular Gross Wages (PBGrossWagesRegular) in the Total Gross Wages column, Regular row.
D8 N/A Displays Special Gross Wages (PBGrossWagesSpecial) in the Total Gross Wages column, Special row.
D9 N/A Displays "M" Wages (PBGrossWagesM) in the Total Gross Wages column, M row.
D10 N/A Displays "Other" Wages (PBGrossWagesOther) in the Total Gross Wages column, Other row.
D11 N/A Displays Total Gross Wages (PBTotalGrossWages) in the Total Gross Wages column, Count of Payroll Batches row.
F21 Batch Type Column header. Batch Type displays under this header.
G21 Batch Number Column header. Batch Number displays under this header.
H21 WSE Paid Column header. The number of employees being paid in a batch displays under this header.
61184

Company Data Merge Enhancement

The Company Data merge report procedure (peo_merge_excel_companydata) now sets the value in the Client Report State column using the following logic:

  • Step 1: Check the Client Report State checkbox on the State Master record.

    • If checked (i.e., "True"), set Client Report State to "True"

    • If unchecked (i.e., "False"), go to Step 2.

  • Step 2: Check the Client SUTA Reporting checkbox on the State Legal Entity.

    • If checked (i.e., "True"), set Client Report State to "True".

    • If unchecked (i.e., "False"), set Client Report State to "False".

See Merges.

61856

Gradient AI Health Benefits API - Coverage Type Validation Change

Previously, ClientSpace validated the coverage types of census data submitted to Gradient AI. This sometimes caused submission issues as not all coverage types in the file were represented in the client's offered plans.

 

Now, _GAICensusValidation triggers an error if there is no data in the Coverage Type column.

Error message reads "Coverage Type is required."

Gradient AI  validates the specific coverage types upon submission of the census data. If Gradient AI finds that specific coverage types are invalid, the Status field on the Gradient AI Health Results record (Benefits Batch dataform > Gradient AI Health Results link) is updated to "Failed" and validation error details are written to the Log field.

 

Note: ClientSpace validation of other census data requirements such as the presence of valid subscribers and underwriting groups is unaffected by this change.

See Gradient AI Health Benefits.

62307

Employer Contributions Enhancements on Offered Benefits Plan

The following new Employer Contribution methods were added:

  • Added Manually Set Dollars option to the Contribution Method field of the Offered Benefits Plan record. When Manually Set Dollars is selected, the percentage fields in the Employer Contributions section are disabled. This allows you to enter the dollar amounts only and ClientSpace calculates the percentages for you.

  • The Manually Set Percentages option in the Contribution Method field has been updated and when selected, the dollar amount fields in the Employer Contributions section are now disabled. This allows you to enter the percentages only and ClientSpace calculates the dollar amounts for you.

Note: If you import offered benefits, and you have set the Contribution Method field of the Offered Benefits Plan record in ClientSpace to Manually Set Dollars, your import file must contain the dollar amounts as ClientSpace calculates the percentages in this instance. If you have the Contribution Method set to Manually Set Percentages, your import file must contain the percentages as ClientSpace calculates the dollar amounts in this instance.

The following new business rule was also added: SetContributions. SetContributions updates the contributions in the same way as manual entries are updated. For instance, if you set a Contribution Method of Manually Set Dollars and you import the dollar amounts, the business rule calculates the corresponding percentages.

See Setting Employer Contributions.

Advanced Administration

Case

Enhancement

53981

Added Field Set Collapse/Expand Functionality

A new optional field, Field Set Default, has been added to Dataform Admin (System Admin > Advanced > Dataform Admin). This setting allows you to control whether fields within a field set are visible or collapsed within the field set container when the form loads. Once the form loads, users can toggle between expanding and collapsing field sets where a Field Set Default has been applied.

Note: 

  • With this update, when you add a new field set, the Field Set Default setting is automatically set to Expanded. You can change the setting to Collapsed or you can clear the field. When the field is cleared (i.e., empty or blank), all fields in the field set display just as they did prior to this change with no ability to expand or collapse field sets.

  • The Field Set Default setting affects the field display only. Dataform field validation still occurs on fields contained within field sets that are collapsed. Additionally, this setting does not interfere with workflow channel configurations that reference fields in collapsed field sets.

See Adding Dataform Fields.

56823

Added the Ability to use Replace fields on Numeric Field Types

Previously, you could create a workflow item that set a numeric field value on a cloned dataform to blank (i.e., None) or to a Specific Value when triggered. Now, a From a Field on a Form option has been added to the Options dialog window (i.e., source picker modal), allowing you to set a numeric field value on a newly cloned dataform to a numeric field value present on a selected source form.

Note: 

  • Numeric datatype fields are defined in ClientSpace with a field properties Element Type of Integer, Decimal, Money, or Percent.

  • The default option on the Options dialog window is None except on previous workflow item configurations where a Specific Value was set. The previous configurations are preserved with this update.

See Step 2: Content.

57029

Auto-Create Workspace by PrismHR Import API

Previously, when the Can Create Workspaces checkbox was checked in PEO Configuration and the ongoing nightly import ran, if no active workspace was found for an imported Client Number, ClientSpace created a new workspace. This was a global setting that was applied to every import API. With PrismHR API imports in multi-tenant environments (where there are multiple PrismHR API configurations and where the Client Number may not be unique), there is a need to flag which PrismHR API imports should auto-create workspaces and which should not (to prevent potential duplicate workspaces).

Now, to support this requirement:

  • You can specify a CanCreateWorkspaces API parameter in PrismHR API import map detail settings (System Admin > Advanced > API Configuration) to inform the system which PrismHR API import feeds can create workspaces.

     

    When PrismHR nightly imports run, ClientSpace evaluates each import file to determine if the PEOID in the import file matches the Secondary ID entered on the API Configuration record. If there is a match, ClientSpace then references the CanCreateWorkspaces parameter to determine if a workspace should be created using the following logic:

    • If the CanCreateWorkspaces parameter is set to a value of 1 and the Client Number does not already exist for the PEOID, a new workspace is created.

    • If the CanCreateWorkspaces parameter is set to a value of 0 or is blank, a new workspace is not created.

  • Additionally, the Can Create Workspaces checkbox in PEO Configuration (System Admin > Administrative Data > PEO Configuration) has been renamed Create Workspace From Import. The functionality still creates a new workspace if no active workspace is found for an imported Client Number but now only works for non-Prism imports.

Note: With this update, if the PEO Configuration setting, Create Workspace from Import checkbox (formerly Can Create Workspaces checkbox) is found to be checked, existing PrismHR API configurations will be updated with the CanCreateWorkspaces API parameter set to 1. This will preserve your current functionality.

See Ongoing Imports: Configuring the API for Import Map Details and Multi-tenant Environments in ClientSpace.

57306

Added "Only Trigger Once" Email Template Enhancement

An Only Trigger Once checkbox has been added to Email Template configuration (System Admin > Email Templates) on the Step 4: Conditions tab. When this option is selected, the email template is only triggered once per dataform record when the conditions are first met. This feature may be useful in cases where:

  • The information being sent never changes. Only one notification is required.

  • The information being sent changes so frequently that triggering the email template more than once could result in a cascade of too many emails being sent in succession which may cause a recipient to overlook or ignore an important notification.

See Step 4: Conditions.

57735

Added OSHA Process Email Template

An OSHAProcessEmail template has been added (System AdminEmail Templates). The template supports and enhances existing OSHA Mass Creation/Distribution functionality by sending OSHA300 and OSHA300A files to the OSHA Contact when the OSHA process successfully runs.

 

Note: The OSHA Contact is set on the Client Teams page which can be accessed from the Client Team widget.

 

The email is triggered when both OSHA300 and OSHA300A fields on the OSHA Forms dataform are NOT EMPTY.

62574

Enhanced Custom Link Security Icon

The Custom Link (System AdminAdvanced > Custom Links) Security icon in the Action Center now turns red when the link is associated with at least one role and remains black when the link is not associated with a role.

See Configuring Link Security.

63941

Added Help Center Widget

The Help Center Widget allows you to make your organization's external online documentation, such as a Help Center, Knowledge Base or Wiki, searchable from the ClientSpace Home page. Your documentation system remains its own external project. ClientSpace queries the system from within a widget frame. The widget frame is a customizable Search page with a built-in Search field. See the example below:

Help Center Widget Example

Users can enter keywords and phrases in the Search field and then click the Search button (or press the Enter key on the keyboard) to initiate a search of the documentation system. Search results display in new browser tab.

 

Note: 

  • Configuration by a global administrator is required.

  • Your global administrator can optionally customize the background color of the widget Search page to make it match your organization's branding colors, add a logo, adjust font sizes, etc. The example image shown above reflects several customizations including the addition of an image, adjustments to font colors, font sizes and the background color. If no customizations are made, the default settings are a white background with black text.

  • Your organization can display unlimited Help Center widgets, each pointing to a different Help system.

See Widget: Help Center.

General Enhancements

Case

Enhancement

59765

Watch Item: Freeze Review Date Enhancement

Previously, when a user or a process updated a Watch List item, the Review Date of the pinned item automatically updated to the current date. Now, when pinning a Watch List item, a new Freeze Review Date option on the Select Review Date window is available. When the checkbox is checked, the system preserves the original Review Date after a pinned record is updated. When the checkbox is unchecked, the system updates the Review Date to the current date after a pinned record is updated.

Select Review Date window with Freeze Review Data option checked

See Widget: Watch.

61622

Enhanced Email Datatype Validation

Previously, validation of email addresses entered on dataforms and in searches only checked for partial formatting of the email string. Now, email addresses on dataforms and searches are checked to ensure that both the format and domain name are valid. Dataform validation occurs when initially entering an email address as well as when editing a saved email address. Attempting to save a dataform with an invalid email address results in the following error: 

"Email is not valid email on the {dataform name} tab."

Note: Blank values are allowed unless the field is required.

Fixes

Case

Issue summary

Resolution

63873

Offered Benefits Plan Calculations Issue

Previously, when you changed the Rate Group on an Offered Benefits Plan record, the fields in the Employer Contributions field set were calculated using the previously selected rates. Now, when you change the Rate Group on an Offered Benefits Plan record, the Employer Contributions fields recalculate using the newly selected rates.