--- sourceDocument: Xanadu Platform Analytics sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/now-intelligence Release : - xanadu ft:locale : - en-US ft:publication_title : - Xanadu Platform Analytics ft:clusterId : - par bundleId : - par workflow : - Platform --- # Single score report # Single score report {#ariaid-title1} * Release version: Xanadu * * Updated October 7, 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 6 minutes to read Single score reports display a single value that is key to your business. Add single score reports to dashboards and configure them to update in real time.{#c_SingleScoreCharts__ph_jdm_pgc_lpb} Note: This topic refers to Reporting in the Core UI. If your instance is migrated to Platform Analytics experience, see [Create a single score data visualization in the Visualization Designer or on a dashboard](https://servicenow-prod.fluidtopics.net/s~WICggoeiSVfGltgVaVZQ "Use a single score to show a value as a number or percentage. Visualize how the value compares to a target or benchmark, to track progress, or to identify areas for improvement."). Single score reports which include [dynamic conditions](https://www.servicenow.com/docs/access?context=r_UsingTheDynamicOperator&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US) added at the report level will not show real-time updates on dashboards unless manually refreshed, or upon a page refresh. The real-time dashboard widget relies on the record watcher to know when an update has been made in order for the single score widget to auto-refresh. However, dynamic conditions aren't supported as part of the record watcher. See further explanation in [Create a real-time score visualization for a score widget](https://servicenow-prod.fluidtopics.net/rYxwyrWgnlYsMGkm8a9lFQ "To see the current score, use a real-time score visualization in a score widget. You can also show a trend line of scores."). Figure 1. Single score report that has been added to a dashboard ![A single score report that has been added to a dashboard]() Note: This report type cannot be run as a scheduled report. This data visualization is supported on the mobile platform. For more information see [Single score reports for mobile](https://www.servicenow.com/docs/access?context=mobile-reporting-single-score&version=xanadu&pubname=xanadu-mobile&ft:locale=en-US) and [Mobile dashboard preview](https://www.servicenow.com/docs/access?context=mobile-dashboard-preview&version=xanadu&pubname=xanadu-mobile&ft:locale=en-US). ## Create a single score report {#ariaid-title2} Create a single score chart to display a metric or score that is key to your business. The value updates in real time on a dashboard. ### Before you begin Role required: itil, report_user. ### Procedure 1. Perform one of the following actions: * On an upgraded instance that has not been fully migrated to Platform Analytics, navigate to AllReportsCreate New. * On a new instance or one that has been fully migrated to Platform Analytics, navigate to AllPlatform Analytics AdministrationUsage and governanceReports and select New. {#t_CreateASingleScoreChart__choices_wjj_z4z_42c} 2. On the Data tab, give the report a name that reflects the information being grouped. 3. Select the applicable source for the report. | Option | Description | | Data source | Also called a report source, a data source is a table with filters applied to provide a single source of information for all users. For more information, see [Report sources](https://servicenow-prod.fluidtopics.net/QQ9qR_HtMUisYy~f~8Kt0w#c_ReportSources "Report sources are predefined data sets for creating reports."). Note: If you select a data source used by existing reports, a notification prompts you to view them. | | Table | The raw data from a table with no filters applied. When you select a table, its short description appears below the table name. For trend reporting, you can also select a remote table, which aggregates, in memory, data retrieved from an external source. Then select a Trend by field option to aggregate its data. To learn more about remote tables, see [Retrieving external data using remote tables and scripts](https://www.servicenow.com/docs/access?context=remote-tables&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) | | External import | Choose an existing imported report source, or select the Upload icon (![Upload icon]()) to import a new file. See [Create a report from an imported Microsoft Excel document](https://servicenow-prod.fluidtopics.net/d75T_7SmDH5J1uB4jY2Zfw "You can import Excel spreadsheets (.xlsx files) of data maintained outside of your instance and create reports from those files."). | | MetricBase | MetricBase enables you to collect, retain, analyze, and visualize custom time series data on the ServiceNow AI Platform. For more information, see [MetricBase](https://www.servicenow.com/docs/access?context=metricbase&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US). | |-|-| {#t_CreateASingleScoreChart__choicetable_t31_tst_1x} 4. Select Next. 5. On the Type tab, enter Single score in the filter, select the report type, and click Next. The application shows a preliminary version of the report. To view the updated report at any time, select Run. 6. On the Configure tab, fill in the following fields and select Next. {#t_CreateASingleScoreChart__table_k3f_gpm_fs__entry__2} | Field | Description | |-|-| | Configure function field | Configure fields based on calculation of multiple inputs including arithmetic functions. For more information, see [Report on function fields](https://servicenow-prod.fluidtopics.net/iyxA5tkjQ6sEXDrRejhocw "While regular fields store a value in the database, a function field displays the results of a database query. The function field generates the value based on computations of other fields and constants. You can use these fields in reports and data visualizations as you would other fields."). Function field results are calculated when the report is run. You can use the results for aggregations and grouping. You have to save the report before you can configure function fields. Configured function fields appear in the Group by and Additional group by lists after you save the report. | | Aggregation | Computational method for aggregating report data. The default is Count, which displays the number of records selected. Note: A single score chart displays only the aggregate value. If you select Count Distinct, only unique records are counted. For example, you want to generate a report with a distinct number of users who have one or more of the roles in a given list of roles. Users with more than one role would be counted twice unless you use Count Distinct. If you select Average, Sum, or Count Distinct, a list of fields from the selected Table appears. You may further be able to aggregate on fields from extended tables. See [How to report on extended tables.](https://servicenow-prod.fluidtopics.net/sTKYkU8BlGjtGq5o389oIQ#t_AccessFieldExtendedTable "Learn how to include fields from tables that extend the Task table in a single report. For example, you could include both incidents and problems in a single report.") Select a field to aggregate by from this list. For example, if you select a duration field, such as Business duration on the Incident table, the aggregated data is expressed in days, hours, and minutes. If you select an integer field, such as the Priority field, the data is expressed as a number. You may further be able to aggregate on fields from extended tables. See [How to report on extended tables.](https://servicenow-prod.fluidtopics.net/sTKYkU8BlGjtGq5o389oIQ#t_AccessFieldExtendedTable "Learn how to include fields from tables that extend the Task table in a single report. For example, you could include both incidents and problems in a single report.") | | Set Value Formatting | Enables you to configure how to show numerical values in reports, including decimal precision, rounding, minimum and maximum duration units, and abbreviations for duration units. See [Value formatting in reports](https://servicenow-prod.fluidtopics.net/AtIreDMjQHHIo~Tns9Vtyg#value-formatting-reports "In most reports, you can configure how numerical values look when you publish the report."). Note: Decimal precision does not work on currency fields. | [Table 1. Configuration tab] {#t_CreateASingleScoreChart__table_k3f_gpm_fs} Note: Currency fields default to two decimal places. With the Set Value Formatting option, you can configure decimal precision for 0-4 decimal places. 7. **Optional:** To limit the information displayed in the report, select the filter icon (![]()) and specify conditions to filter the report data. To learn how to construct conditions, see [Condition builder](https://www.servicenow.com/docs/access?context=c_ConditionBuilder&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US). Note: In aggregated and list reports, language-dependent filter conditions may return zero results on localized instances. 8. On the Style tab, fill in the fields as appropriate to configure the appearance of the report. 9. Select Save to continue editing the visualization, or Save and close to return to the Analytics Center main screen. {#t_CreateASingleScoreChart__steps_jgf_gpm_fs} ### What to do next * Select the Report info icon (![]()) and add a description of the report. * Select the sharing icon (![]()) to open the Sharing menu. On this menu, you can share the report with users and groups, add the report to a dashboard, and publish the report to the web. {#t_CreateASingleScoreChart__ol_hjc_tw4_mcb} ## Single score report style options {#ariaid-title3} Change the look of your single score report. When you create or edit a report, click the Style tab for options to configure the look of your report. The options are organized under two or more of the following tabs: General, Title, Legend, and Axis. To see how the report looks with the changed settings, click Save. {#single-score-chart-style-options__table_h1l_1jh_yq__entry__2} | Field | Description | |-|-| | General || | Display Zero | Check box to display the number 0 when the value of the report is zero. Clear this check box to display an error message when the value of the cell is 0. Applicable when Aggregation is Count or Count Distinct. | | Default color | Color of the score in the chart. | | Drilldown view | List view to show when a user selects a segment of a report for which no drilldown report type is specified. This view is also used when the user reaches the lowest drilldown level of a report. See [Configure the list layout](https://www.servicenow.com/docs/access?context=t_ConfigureTheListLayout&version=xanadu&pubname=xanadu-platform-administration&ft:locale=en-US) . If you specify a Report drilldown, Drilldown view is ignored. For more information, see [Define a report drilldown](https://servicenow-prod.fluidtopics.net/UtouGuO90NBdaO59lctiyQ#t_DefineAReportDrilldown "You can define a report drilldown to enable reporting users to view subsets of the report data. When you define a report drilldown, it applies only to the report for which you define it."). | | Edit coloring rules | Click this hyperlink to configure how values are colored in the report. You can create rules to define which colors are used based on operators and values. For example, you can specify that any value greater than 5 displays in red. See [Create coloring rules for single score reports](https://servicenow-prod.fluidtopics.net/ABwHehwq0vuclk2bbYJxmw "Configure rules for how numerical values are displayed in single score reports, to highlight why a value is important."). | | Title || | Show chart title | When the chart title is shown for the report. * Never: Never show the chart title. * Report only: Shows the chart title on reports. * Always: Shows the chart title on reports, dashboards, and landing pages. | | Chart title | The chart title has a maximum length of 40 characters. If no title is entered, the report name is used for the title. This field appears when Report only or Always is selected from the Show chart title list. | | Size of the chart title | Size of the chart title in pixels. This field appears when Report only or Always is selected from the Show chart title list. | | Chart title color | Color of the chart title. This field appears when Report only or Always is selected from the Show chart title list. | | Title horizontal alignment | How the chart title is aligned horizontally. This field is available when the Custom chart title position option is cleared. | | Title vertical alignment | How the chart title is aligned vertically. This field appears when Custom chart title position is cleared. | [Table 2. Single score chart style options] {#single-score-chart-style-options__table_h1l_1jh_yq} *[\>]: and then