Upgrading to PSA Spring 2024
This page describes the changes to make when upgrading to Spring 2024.
See the Upgrade Steps section under each feature for details of any action required. If you don't want to use or upgrade an optional feature, you can skip the upgrade steps for that feature. To perform upgrade steps in your org, you must be assigned administrator permissions.
See the Included in This Feature section under each feature for details of items such as objects, fields, or buttons that have been added in this release.
For information on new features and changes to existing features in Spring 2024, see New Features and Enhancements in PSA Spring 2024.
Lightning Experience
The following table explains the Lightning component types.
Type | Description | Visualforce Buttons or Actions |
---|---|---|
Lightning app pages | Direct replacements for existing pages or parts of pages. | The equivalent existing Visualforce buttons or actions that any PSA Lightning component types replaced in this release have been removed from the object page layouts. If you are upgrading to any Lightning component types in this PSA release, you might need to manually remove any Visualforce buttons or actions from any page layouts that have not already been removed. |
PSA Actions components |
Components that contain multiple PSA Lightning actions to open new Lightning windows or existing Visualforce pages. The components are included in the relevant default record pages. |
|
PSA Lightning actions | Actions that open new Lightning windows. These are included in the default object page layouts. | |
PSA Lightning components | Components that deliver specific functionality. These are included in the relevant default record pages. |
Upgrade Steps
To upgrade Lightning components to Spring 2024 for your users, take the following actions.
Action |
Further Information |
---|---|
Assign the PSA - Lightning Component Apex Class Access permission set to the user profiles of users who will use Lightning components. |
Assigning and Removing Permission Sets Permission Sets and Other Technical Documentation For information on assigning permission sets to single or multiple users, see the Salesforce Help |
To use the Certinia record pages instead of your own, activate the Certinia record pages in the Lightning App Builder. You have the following options:
|
For information on activating Lightning Experience record pages, see the Salesforce Help |
To continue to use your own record pages, you can add the following to them:
|
PSA Lightning Components |
To use any new PSA Lightning actions, add them to your object page layouts. | For information on adding quick actions to page layouts in Lightning Experience, see the Salesforce Help |
Enhancements to Work Planners
Upgrade Steps
No upgrade steps are required to upgrade this feature to Spring 2024.
Included in this Feature
This section details the items that have been added in this release.
Fields
Field |
App Page |
Further Information |
---|---|---|
Availability | Work Planner | Work Planner Lightning Component Fields |
Redesigned Resource Request Page for User Experience and Optimal Resource Assignment
Upgrade Steps
To upgrade this feature to Spring 2024, take the following actions.
Action |
Further Information |
---|---|
Edit your Resource Request page. | "Lightning App Builder" in the Salesforce Help. |
In the Lightning App Builder, change the page template to Header and One Region and map the existing Right Sidebar to the new Main Region. |
"Page templates" in the Salesforce Help |
Delete the existing tabs that contain the following deprecated components:
|
|
Remove the standard Tabs component that contains the PSA Resource Filter, PSA Contact Card, and PSA Actions: Resource Request Details components. |
"Lightning App Builder" in the Salesforce Help. |
Add a tab in the main region, and then drag the PSA Resourcing component from the Custom list on to the tab. | |
Click Save, and exit the Lightning App Builder. | |
Update any permissions that you have for resource managers by adding read access to the Utilization Target field on the Contact object. |
Permission Sets and Other Technical Documentation, and click the Permissions link. |
Included in this Feature
This section details the items that have been added in this release.
Permission Sets
Permission Set |
Description |
Further Information |
---|---|---|
PSA - Staff Resource Requests | Added read access to the Utilization Target field on the Contact object. | Resource Request Lightning Page and Component Permissions |
Resource Optimizer Enhancements
Upgrade Steps
No upgrade steps are required to upgrade this feature to Spring 2024.
Included in this Feature
This section details the items that have been added in this release.
Fields
Field |
App Page |
Further Information |
---|---|---|
Resource Must Match | Resource Optimizer | Using Resource Optimizer |
Utilization Analytics Improvements
Utilization Analytics Security
Upgrade Steps
To upgrade this feature to Spring 2024, take the following action.
Action |
Further Information |
---|---|
Ensure the View All Utilization field is available in the PSA Permission Control layout. Contact your administrator, if the field is not available in the layout. |
|
Ensure the following fields are available in the PS Cloud Analytics Setup layout. Contact your administrator, if the fields are not available in the layout.
|
|
Add Read and Edit permissions for the View All Utilization field on the Permission Control object of the PSA Manage Configuration permission set. |
|
Provide the following access on the PS Cloud Analytics Integration User Read Access permission set:
|
|
Add Read and Edit access for the following fields on the PS Cloud Analytics Setup object:
|
|
Update your PS Cloud Core Analytics app |
Updating Your PS Cloud Core Analytics App in Creating an App from the PS Cloud Core Analytics Template |
Included in this Feature
This section details the items that have been added or updated in this release.
Fields
Field |
Object |
Further Information |
---|---|---|
View All Utilization |
Permission Control |
Permission Sets
Permission Set |
Description |
Further Information |
---|---|---|
PSA Manage Configuration |
Added Read and Edit access for the View All Utilization field on the Permission Control object. |
In the PSA Permissions window, select Permission Changes from the Contents pane. Scroll down to the Updates to Permission Sets table and click the link in the View Changes column for the relevant permission set. A list of all changes made to this permission set in this release is displayed.
|
PS Cloud Analytics Integration User Read Access |
|
|
PS Cloud Analytics Setup |
Added Read and Edit access for the following fields on the PS Cloud Analytics Setup object:
|
For more information, see Upgrading to PS Cloud Analytics Spring 2024.
Utilization Results Reports
Upgrade Steps
No upgrade steps are required to upgrade this feature to Spring 2024.
Included in this Feature
Reports
Report |
Further Information |
---|---|
PSA 4 Months Historical Util Results |
|
PSA Hist Util Results By Month |
|
PSA Hist Util Results By Week |
|
PSA Sched Util Results By Month |
|
PSA Sched Util Results By Week |
Utilization Run Processed Object
Upgrade Steps
No upgrade steps are required to upgrade this feature to Spring 2024.
Included in this Feature
Objects
Object |
Further Information |
---|---|
Utilization Run Processed |
Fields
Field |
Further Information |
---|---|
Assignment |
|
Resource Request |
|
Utilization Run |
Deprecated APIs
API |
Further Information |
---|---|
isUtilizationAnalyticsTransaction API |
The is UtilizationAnalyticsTransaction API in the Utilization Analytics Service has been deprecated because it is no longer in use. |
Permission Sets
Permission Set |
Description |
Further Information |
---|---|---|
PSA Utilization Analytics |
|
In the PSA Permissions window, select Permission Changes from the Contents pane. Scroll down to the Updates to Permission Sets table and click the link in the View Changes column for the relevant permission set. A list of all changes made to this permission set in this release is displayed.
|
Deprecations
Upgrade Steps
No upgrade steps are required to upgrade this feature to Spring 2024.
Included in this Feature
Deprecated Fields
Field |
Further Information |
---|---|
DEPRECATED: Utilization Run |
|
DEPRECATED: Utilization Run |
Enhancements to Delivery Tracker
Upgrade Steps
No upgrade steps are required to upgrade this feature to Spring 2024.
Actuals Performance Improvements
Processing Transaction Deltas in Continuous Mode
Upgrade Steps
To upgrade this feature to Spring 2024, take the following action.
Action |
Further Information |
---|---|
Import the new configuration options from the PSA Administration page. To do so:
|
Importing Configuration Settings |
|
|
Delete the scheduled transaction delta batch job. |
|
Add the custom Async Job Records tab to monitor the asynchronous job. | Monitoring Asynchronous Jobs |
Included in this Feature
This section details the items that have been added in this release.
Buttons
Button |
Object |
Further Information |
---|---|---|
Resume Processing |
Actuals |
This button displays in Visualforce pages in continuous mode when you have enabled the AbortActualsCalculateDeltaContinuous configuration option, and you have unprocessed transaction deltas |
Configuration Options
Configuration Option |
Configuration Group |
Further Information |
---|---|---|
UseActualsCalculateDeltaContinuous |
Actuals |
|
AbortActualsCalculateDeltaContinuous |
||
TransactionDeltaTrigger | ASM Triggers | ASM Triggers |
Permission Sets
Permission Set |
Description |
Further Information |
---|---|---|
PSA - Recalculate Actuals | We have provided access to the Act_BatchProcessesController class. | Permission Sets and Other Technical Documentation |
PSA - Recalculate Project Actuals | ||
PSA - Recalculate Resource Actuals | ||
PSA - Recalculate Actuals |
We have added Read access for the following fields on the Async Job Record object:
We have added Read and Edit access for the following fields on the Async Job Record object:
|
Objects
Object | Description | Further Information |
---|---|---|
Async Job Records | Allows you to monitor the status of asynchronous jobs. | Async Job Records Fields |
Display Resource Availability Information in Gantt
Upgrade Steps
To upgrade this feature to Spring 2024, take the following action.
Action |
Further Information |
---|---|
Add the following fields to any custom permission sets you are using for Gantt:
These fields are present in the packaged PSA - Manage Gantt and Project Tasks permission set. |
Included in this Feature
This section details the items that have been updated in this release.
Permission Sets
Permission Set |
Description |
Further Information |
---|---|---|
PSA - Manage Gantt and Project Tasks |
We have added Read access for the following fields:
|
In the PSA Permissions window, select Permission Changes from the Contents pane. Scroll down to the Updates to Permission Sets table and click the link in the View Changes column for the relevant permission set. A list of all changes made to this permission set in this release is displayed.
|
Display Resource Information on the Project Task Board
Upgrade Steps
No upgrade steps are required to upgrade this feature to Spring 2024.
Track Consumption of Individual Budgets
Upgrade Steps
To upgrade this feature to Spring 2024, take the following action.
Action |
Further Information |
---|---|
Work through the fields listed below (Fields) and add them to the page layouts of the respective objects. | For information on editing page layouts, see the Salesforce Help. |
By default, the Budget Allocation Layout includes fields to specify a customer purchase order budget and one internal budget. If you expect to proportionally split cost values between two or three internal budgets, add the following fields to the Budget Allocation Layout page layout:
|
|
Add the Budget Allocations related list to your project page layout. |
Included in this Feature
This section details the items that have been added in this release.
Custom Objects
Object Label | Description |
Further Information |
---|---|---|
Budget Allocation | Links milestones and timecard splits to customer purchase order budgets and internal budgets. | Budget Allocation Fields |
Fields
Field |
Object |
Further Information |
---|---|---|
Amount Consumed | Budget | Budget Fields |
Customer Reference | ||
Budget Allocation | Milestone | Milestone Fields |
Budget Allocation | Timecard Split | Timecard Split Fields |
Customer Reference | Billing Event | Billing Event Fields |
Customer Reference | Billing Event Item | Billing Event Item Fields |
Automatically Split Billing Events That Would Breach the Billing Cap
Upgrade Steps
To upgrade this feature to Spring 2024, take the following action.
Action |
Further Information |
---|---|
Ensure that the Disable Billing Closer to Cap field in the Billing Settings custom setting is deselected. | Billing Settings |
If you are not using the Billing Event Lightning Page, add the Release quick action to the page layout used by the Lightning page that is assigned to your users. | For information on adding quick actions to page layouts in Lightning Experience, see the Salesforce Help. |
Included in this Feature
This section details the items that have been added or updated in this release.
Fields
Custom Setting |
Field |
Further Information |
---|---|---|
Billing Settings | Disable Billing Closer to Cap | Billing Settings |
Lightning Actions
Lightning Action |
Page Layout |
Further Information |
---|---|---|
Release | Billing Event Layout | Releasing Single Billing Events When Billing Is Capped |
Project Assignments Breakdown
Upgrade Steps
Action |
Further Information |
---|---|
Ensure that relevant users are assigned the Certinia - PSA - Project Manager permission set group. | Project Assignments Breakdown Fields |
Included in this Feature
This section details the items that have been added or updated in this release.
Lightning Components
Component |
Lightning Page |
Further Information |
---|---|---|
PSA Project Assignments Breakdown | Project Lightning Page | Project Assignments Breakdown Fields |
Fields
Custom Setting |
Field |
Further Information |
---|---|---|
Project Financials Settings | Timecard Statuses - Hours | Project Financials Settings |
Improvements to Delegated Time and Expense Entry
Upgrade Steps
No upgrade steps are required to upgrade this feature to Spring 2024.
Time Entry Start and End Times
Upgrade Steps
To upgrade this feature to Spring 2024, take the following action.
Action |
Further Information |
---|---|
[Optional] To enable entering time in Start and End Times mode for your users, you must:
Your Start and End Times value is now available to select from the Available Time Entry Modes picklist on the Work Calendar. To enable the Start and End Times mode for users, you must:
|
Included in this Feature
This section details the items that have been added or updated in this release.
Permission Sets
Permission Set |
Field |
Further Information |
---|---|---|
PSA - Start and Stop Timers | Location | Setting up Start and End Times Mode for Timecards |
Project Location | ||
Travel |
Fields
Field |
Object |
Further Information |
---|---|---|
End Time | Timecard | Time Entry Lightning Component Fields |
Start Time | ||
Available Time Entry Modes: Start and End Time | Work Calendar | Work Calendar Fields |
Filtering Resources by Distance
Upgrade Steps
To upgrade this feature to Spring 2024, take the following action.
Action |
Further Information |
---|---|
Before trying to set up Google API keys in your org, ensure that you have a Google account and a geocoding API key. You can obtain this from the Google Maps Platform. | Setting up PSA to Filter Resources by Distance |
Ensure that you have Google Maps activated to enable the geocoding services in your org. | |
Ensure that the Googlemaps_api remote site setting is activated. | |
Ensure that the Work Address fields on the Resource Request page are not blank. To auto-populate the Latitude and Longitude values on the Resource Request page, ensure that Geocoding Services are enabled in the PSA Administration tab. | |
Ensure that you have activated the Geocodes for Contact Mailing Address. | |
Select Show Distance Filter in the Resource Filter panel of Lightning App Builder for the PSA Resourcing component. This is deselected by default. | Resourcing Lightning Component Properties |
Add the Maximum Distance and Distance Unit fields to relevant page layouts, profiles, and permission sets. You would also need the Work Address fields on the resource requests page and the Mailing Address fields on the Contact page. | For more information on how to do this, see the Salesforce Help. |
Permission Checks for Resource Request Set
To upgrade this feature to Spring 2024, take the following action.
Action |
Further Information |
---|---|
To enable users to use the Actions | Manage Resource Request Set action on the Resource Request page, ensure that the following permissions sets are assigned to users and set the correct access in them:
|
Salesforce Standard Objects and Fields Permissions in the PSA Technical Pack. |
Ensure the following permissions for the relevant users:
|
Included in this Feature
This section details the items that have been added or updated in this release.
Fields
Field |
Object |
Further Information |
---|---|---|
Maximum Distance | Resource Request | Resource Request Fields |
Distance Unit |
Lightning Component Properties
Name | Description | Further Information |
---|---|---|
Maximum Distance | The maximum limit of the distance between the location of the resource and the resource request site. | |
Distance Unit | The unit of distance. | |
Show Distance Filter | If selected, the location based resourcing is enabled and the Maximum Distance and Distance Unit fields are visible in the Resource Filter component. This is deselected by default. |
Permission Sets
Permission Set | Description | Further Information |
---|---|---|
PSA - Manage Resource Requests for an Opportunity |
|
In the PSA Permissions window, select Permission Changes from the Contents pane. Scroll down to the Updates to Permission Sets table and click the link in the View Changes column for the relevant permission set. A list of all changes made to this permission set in this release is displayed.
|
PSA - Manage Resource Requests for a Project |
Enhancements to PSA Mobile Application
Upgrade Steps
To upgrade this feature to Spring 2024, take the following action.
Action |
Further Information |
---|---|
You must create appropriate approval processes on objects in your org to enable your users to approve or reject records. The system assigns records to users through an active approval process. |
Included in this Feature
This section details the items that have been added in this release.
Lightning Components
Component |
Description |
Further Information |
---|---|---|
PSA Mass Approval Mobile | Approve, reject, or reassign single or multiple expense report approval requests and timecard approval requests on your mobile application. | PSA Lightning Components |
PSA Manage Skills and Certifications Mobile | Manage Skills and Certifications on your mobile application. |
Lightning Component Properties
Component |
Description |
Further Information |
---|---|---|
Allow Reassign | Enable or disable the reassign approval requests functionality. By default, this functionality is set to false. | Mass Approval Mobile Lightning Component Properties |
Component Title | Title for the PSA Mass Approval component. | |
Detail View Field Set API Name | Enter the API name of the Field Set that contains the fields you want to display on the detail view. | |
Filter Field Set API Name | Enter the API name of the Field Set that contains the fields you want to provide for filtering. | |
List View Field Set API Name | Enter the API name of the Field Set that contains the fields you want to display on the list view and to use for sorting. | |
Object API Name | The API name of the object that you want to provide the records for approval. | |
Record Batch Size | The maximum number of records to be approved or rejected in a single batch. |
Buttons
Buttons Added in Spring 2024
Button | Location | Further Information |
---|---|---|
Approve |
|
|
Close |
||
Filter |
||
Reassign |
||
Reject |
||
Select |
||
Sort |
||
Add |
|
Skills Management Fields |
Close |
|
|
Edit |
|
|
Delete |
|
Lightning Tabs
Lightning Tabs Added in Spring 2024
Tabs | Description | Further Information |
---|---|---|
Expense Reports to Approve | Allows you to approve, reject, or reassign single or multiple expense report approval requests on your mobile phone. | Setting up the PSA Mobile Application |
Timecards to Approve | Allows you to approve, reject, or reassign single or multiple timecard approval requests on your mobile phone. | |
Manage Skills and Certifications | Allows you to manage your skills and certifications on your mobile phone. |
Release Content
Upgrade Steps
To upgrade this feature to Spring 2024, take the following action.
Action |
Further Information |
---|---|
Reset the metrics of the Release Overview prompt to ensure that users see this prompt again with its updated content if they have previously dismissed or completed it. |
Monitor In-App Guidance in Lightning Experience in the Salesforce Help |
Activate the Time Entry Page TH prompt. | Managing Certinia In-App Guidance |
Deactivate any deprecated prompts that are active in your org. |
Included in this Feature
This section details the items that have been added or updated in this release.
In-App Guidance
Name |
App |
Tab |
Type |
Active |
Created |
---|---|---|---|---|---|
DEPRECATED: Approve or Reject Timecards | PSA | Approve Multiple Timecards | Docked | No | Spring 2021 |
DEPRECATED: Release Overview | PSA | Home | Docked | No | Fall 2020 |
DEPRECATED: Time Entry Page TH | PSA | Time Entry | Floating | No | Fall 2020 |