Creating the PSA Analytics App from the App Template
The following templates are used to create dashboards in PSA Analytics:
- FinancialForce PSA Analytics
- PSA Analytics Embedded Dashboards
The app template for FinancialForce PSA Analytics enables you to generate an app that contains dashboards and datasets. The PSA Analytics app template design wizard allows you to customize several values in your app before it is generated.
The app template for PSA Analytics Embedded Dashboards enables you to generate an app that contains dashboards optimized for embedding in PSA workspaces and pages. This app contains copies of the datasets held in your primary PSA Analytics app.
For more information about dashboards and datasets, see the Salesforce Help for Analytics.
The length of time for your first PSA Analytics app to be generated depends on the volume of information stored within your PSA app and whether you have turned on specific features in Analytics, such as Data Sync and Incremental Load. Typically, you can expect the app to be generated within 10 minutes.
By default, the Data Sync and Incremental Load features are turned off in Analytics. Turning these features on can improve the performance of the app template generation. If the app takes a long time to be generated, contact Customer Support. Refer to the Salesforce Help for Analytics for more information about these features.
To create an app using the PSA Analytics template:
- Click Create in Analytics Studio.
- Click App.
- Select the FinancialForce PSA Analytics template, then click Continue.
- Provide your answers to each question. See below for a list of the questions included in the wizard.
- Name your app, then click Create.
Your app is now available on the App Launcher page. You can view the app from the Analytics tab, or edit it from the Analytics Studio.
By default, when you generate an app the sharing settings are set to private. To give access to other users, click . This opens the app's Give Access tab. For more information about sharing Analytics apps, see the Salesforce Help.
You must first create your primary PSA Analytics app. This contains the datasets that are copied into your PSA Analytics Embedded Dashboards app.
No app template design wizard is used in the creation of this app. It is activated using Feature Console. For more information, see Enabling PSA Embedded Dashboards with Feature Console.
When you create a new PSA Analytics app you can customize several parameters by selecting the required value in the app template wizard. To enable additional features you need to answer the questions prompted by the app template wizard during the app creation, update or reconfiguration. Settings marked with an asterisk (*) are mandatory.
Settings |
|
Description |
---|---|---|
Step 1. Enable the existing PSA object sharing model for the data displayed in PSA Analytics. |
Select whether you want to apply the existing PSA object security model to your PSA Analytics app or not. If you enable the existing sharing model, users can only view records related to the objects they have access to. If you do not enable the existing sharing model, all users with access to Analytics that share the app can view the data for all PSA records. PSA Analytics supports sharing with Salesforce public groups and their member users. If a group contains any subgroups, you have to share the access to each child group separately. For more information, see PSA Analytics Object Sharing Model. |
|
Step 2. Select the start month of your fiscal year. |
PSA Analytics uses your time period records or your org configuration to identify which month you have assigned as the start of your fiscal year. You can accept the suggested month or you can manually select the start month of your fiscal year from the drop-down list in this section of the app wizard. The value you select determines the date ranges for the fiscal quarters and fiscal years displayed in PSA Analytics. |
|
Step 3. Create the Revenue Forecast dataset | * | Choose whether to create the Revenue Forecast dataset. This dataset is used by the Revenue Forecast and Revenue Forecast (Embedded) dashboards. These enable you to embed analytics to display key revenue forecasting key performance indicators (KPIs), including comparisons of forecast versions. This dashboard requires you to ensure the necessary data is available in your org's data environment. For more information about the data requirements, see Preparing the Data Environment for PSA Analytics. To create the Revenue Forecast (Embedded)dashboard, you must enable the PSA Analytics Embedded Dashboards feature in Feature Console. For more information, see |
Step 3. Create the Billing Forecast Summaries and the Billing Forecast Details datasets and the Billing Forecasts dashboard | * |
Choose whether to create the Billing Forecast Summaries and the Billing Forecast Details datasets and the Billing Forecasts dashboard. This dashboard allows you to visualize your PSA Enhanced Services Forecasting data in Analytics and drill down into the data to gather business insights. This dashboard requires you to ensure the necessary data is available in your org's data environment. For more information about the data requirements, see Preparing the Data Environment for PSA Analytics. |
Step 3. Create the Project Margin dataset and the Total Project Margin (Workspace) dashboard | * |
Choose whether to create the Project Margin dataset and the Total Project Margin (Workspace) dashboard. This dashboard can be integrated with the project manager workspace in Lightning PSA, enabling your project managers to get a smart vision of their total margins for their assigned projects. This dashboard requires you to ensure the necessary data is available in your org's data environment. For more information about the data requirements, see Preparing the Data Environment for PSA Analytics. |
Step 3. Create the Utilization Results dataset | * |
Choose whether to create the Utilization Results dataset. This dataset is used by the Utilization Analytics and Utilization Analytics (Embedded) dashboards. These enable you to visualize detailed information about your resources' scheduled or actual hours logged and calendar hours.
This dashboard requires you to ensure the necessary data is available in your org's data environment. For more information about the data requirements, see Preparing the Data Environment for PSA Analytics To create this dashboard, you must enable the PSA Analytics Embedded Dashboards feature in Feature Console. For more information, see |
Step 4. Select additional fields from the Project object to import. |
Select one or more additional fields from the Project object to include in your PSA Analytics datasets. These are stored on the following datasets:
If you decided to enable additional features in the previous wizard question, the additional fields from are also added to the optional datasets that contain project data:
To properly visualize the data in Analytics, ensure that the integration user and the user have the necessary permissions to view the selected fields. If you select a field that is a lookup to an object outside of PSA, the integration user also requires a license that provides access to that object. |
|
Step 4. Select additional fields from the Contacts object to import. |
Select one or more additional fields from the Contacts object to include in your PSA Analytics datasets. These are stored on the following datasets:
To properly visualize the data in Analytics, ensure that the integration user and the user have the necessary permissions to view the selected fields. If you select a field that is a lookup to an object outside of PSA, the integration user also requires a license to that object. |
|
Step 4. Append a suffix to the custom fields labels. | * |
Choose to append the custom fields you import into the PSA Analytics App with a suffix tag to easily identify them. The suffix also identifies the object from which these custom fields are extracted. For example, if you import a custom field named "Location" from the PSA Project object, the field appears in PSA Analytics as "Location [ProjectCustomField]". |
When you run the PSA Analytics app template to create an app, a dataflow is generated. This dataflow is named according to the app name you provide. During the app creation, you can use the app template wizard to enable several optional features such as additional dashboards and datasets.
The following dashboards, datasets, and lenses are generated:
Key:
S = Standard Component
O = Optional Component
Dashboard |
|
Description |
---|---|---|
Overview | S | Enables you to view the most relevant key performance indicators (KPIs) for the current fiscal quarter and navigate to a more detailed view of each KPI by opening their respective dashboard. |
Billings | S |
Provides detailed information about the scheduled and actual bill rate and billings. By default this dashboard graphs display information for the current fiscal quarter. |
Utilization | S | Provides detailed information about the scheduled and actual utilization rate, the total utilization hours and the utilization percentage. By default this dashboard graphs display information for the current fiscal quarter. |
Backlog | S |
Enables you to view detailed information about your scheduled and unscheduled backlog. By default this dashboard graphs display data for the current fiscal quarter. |
Capacity | S | Enables you to view the available capacity hours and the contrast between scheduled vs remaining capacity hours. By default this dashboard graphs display data for the current fiscal quarter. |
Capacity Demand and Planning | S | Enables you to view the utilization of resources by Region, Practice or Group, and view a breakdown of the demand for a role in your selected date range by Assigned, Held Requests, Unheld Requests and Remaining. |
Project Burnup, Project Burnup (Embedded) | S | Track changes in scope for your projects and how much work has been delivered and billed, and use predictive analytics to view velocity trends in your projects. |
Billings Forecasts | O |
The Totals tab enables you to view and compare the expected, best case, and worst case scenarios for your services forecasts and their distribution. The Comparison tab enables you to compare your selected forecast calculation with one of its previous versions. This tab also enables you to extract valuable insights by breaking down the difference between the current and previous versions. By default this dashboard graphs display the latest forecast calculation generated in PSA. |
Total Project Margin (Workspace) | O | Enables project managers to view their assigned project's actuals and their expected project margins. This dashboard does not appear in the overview and, by default it displays an accurate prediction for the next four months. |
Revenue Forecast | O | This dashboard enables you to embed analytics to display revenue forecasting key performance indicators (KPIs), including comparisons of forecast versions. |
Utilization Analytics | O | Provides detailed information about your resources' scheduled or actual hours logged and calendar hours. |
Utilization Analytics Capacity and Demand Planning | O | This dashboard enables you to view demand and capacity of roles by Region, Practice or Group, and view a breakdown of capacity for your selected date range by Assigned, Held Requests, Unheld Requests and Available Capacity. |
Skills Capacity Planning | O | The Skills Capacity Planning dashboard enables you to view available capacity by skill/certification, using data derived from the Project Reporting, Utilization Results, and Resource Skills datasets. |
Dataset |
|
Description |
---|---|---|
Backlog | S | The Backlog dataset is used by the dashboard of the same name and it stores fields associated with the Backlog Details object in PSA such as scheduled hours, remaining hours as well as fields from other associated objects. For more information about which fields are included in the Backlog dataset, see Backlog Dataset PSA Analytics Output Fields. |
Billing Forecast Details | O | The Billing Forecast Details dataset is used by the Billing Forecasts dashboard and it stores fields associated with the forecast calculation in PSA such as the forecast record name and owner name, the region, practice and group information, and the actuals, schedule and unscheduled values. For more information about which fields are included in the Billing Forecast Details dataset, see Billing Forecast Details Dataset PSA Analytics Output Fields. |
Billing Forecast Summaries | O |
The Billing Forecast Summaries dataset is used by the Forecasts dashboard and it stores fields associated with the forecast calculation in PSA such as the forecast summary type, the creation name and date of the calculation, and the values associated with the calculation. For more information about which fields are included in the Billing Forecast Summaries dataset, see Billing Forecast Summaries Dataset PSA Analytics Output Fields. |
Billings | S |
The Billings dataset accesses information from the Billings field, which is stored in objects such as Milestones, Est Vs Actuals, Expenses, Miscellaneous Adjustments, and Timecards. The dataset also includes fields from other objects such as Projects, Users, and Contacts as well as additional fields relating to Billings. For more information about the fields that are included in the Billings dataset, see Billings Dataset PSA Analytics Output Fields. |
Capacity | S |
The Capacity dataset is used by the dashboard of the same name and it stores fields associated with the Utilization Detail object in PSA such as scheduled hours, remaining hours as well as fields from other associated objects. In order to prevent unwanted data duplication, this dataset only uses records that have the Is Report Master checkbox selected in PSA, we recommend you that your Utilization Calculations have the Is Report Master checkbox selected before running the dataflow. For more information about which fields are included in the Capacity dataset, see Capacity Dataset PSA Analytics Output Fields. |
Currency ISO Code | S |
The Currency ISO Code dataset uses the currency associated with the analytics integration user to display the ISO code for the currency shown in the dashboards. This dataset is used by all of the PSA Analytics dashboards except Utilization and Capacity (Hours). For more information about the fields that are included in the Currency ISO Code dataset, see Currency ISO Code Fields. |
Project Margin | O |
The Project Margin dataset is used by the dashboard of the same name and it stores fields associated with the actuals calculation in PSA such as total costs, billings value, and project manager name. For more information about which fields are included in the Project Margin dataset, see Project Margin Dataset PSA Analytics Output Fields. |
Project Reporting | S |
The Project Reporting dataset includes fields from the Timecard Split, Milestone, Est vs Actuals, Expense, Miscellaneous Adjustment, Budget, Assignment and Project objects in PSA as well as other associated objects. For information about which fields are included in the Project Reporting dataset, see Project Reporting Dataset PSA Analytics Output Fields. |
Resource Skills | S |
The Resource Skills dataset includes fields from the Skill / Certification, Skill / Certification Rating objects in PSA as well as other associated objects. For more information about which fields are included in the Resource Skills dataset, see Resource Skills Dataset PSA Analytics Output Fields. |
Revenue Forecast | O |
The Revenue Forecast dataset includes fields from the Revenue Forecast Version Detail, Revenue Forecast Version and Revenue Forecast objects in PSA as well as other associated objects. For more information about which fields are included in the Revenue Forecast dataset. see Revenue Forecast Dataset PSA Analytics Output Fields. |
Utilization | S |
The Utilization dataset stores fields associated with the Utilization Detail object in PSA, this object is generated by the Utilization Calculation. In order to prevent unwanted data duplication, this dataset only uses records that have the Is Report Master checkbox selected in PSA, we recommend that your Utilization Calculations have the Is Report Master checkbox selected before running the dataflow. The dataset also includes fields from the Contact object in Salesforce. For information about which fields are included in the Utilization dataset, seeUtilization Dataset PSA Analytics Output Fields. |
Utilization Results | O |
The Utilization Results dataset stores fields associated with the Utilization Result object in PSA. This object is generated by the Utilization Run. For information about which fields are included in the Utilization Results dataset, see Utilization Results Dataset PSA Analytics Output Fields. |
PSA Analytics Lenses
By default, six lenses are provided with PSA Analytics. In addition, you can create your own lenses from one of the included datasets. For assistance, contact your implementation consultant.
When you enable the PSA Analytics Embedded Dashboards app in Feature Console, the following dashboards are created:
Package |
App Template | Dashboards | Datasets |
---|---|---|---|
Business Analytics | PSA Analytics Embedded Dashboards |
Revenue Forecast (Embedded) Utilization Analytics (Embedded)
|
Revenue Forecast Utilization Results |
Refer to the table below for guidance on resolving any errors encountered while creating your PSA Analytics app.
Example Error Message |
Resolution |
---|---|
In the [node name] the [object API name] doesn't exist or isn't accessible to the Integration user. | Assign the required licenses and permission sets to the Integration User. |
To create this app, you need a FinancialForce PSA license and permission to view the objects within it. | Assign a PSA license to the administrator installing the app. |