Create new indicator form

  • Release version: Yokohama
  • Updated January 30, 2025
  • 3 minutes to read
    • Summarize
    Summarized using AI
    This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.

    Summary of Create new indicator form

    This guide details how to create an application or capability indicator within the indicator framework in ServiceNow's Enterprise Architecture. Indicators help assess applications or capabilities by measuring various metrics, enabling better management and decision-making.

    Show full answer Show less

    Key Features

    • Indicator Definition: Define the indicator's name, short description, category, direction (whether to minimize or maximize values), unit of measurement, and automatic refresh interval for score updates.
    • Result Limit: Set a maximum number of records to display when running associated scripts, improving performance by limiting data processed.
    • Order: Specify the indicator's position relative to others within an application or capability view.
    • Data Source Configuration: Choose where indicator data originates from, such as:
      • Performance Analytics: Collect scores from existing Performance Analytics indicators.
      • Custom Script: Write scripts to pull data from other applications. An example script demonstrates querying active business applications and counting related incidents within a date range.
      • Query Condition: Filter data from a selected table.
      • Assessments: Evaluate and score records, useful for generating assessable records and viewing survey assessment results.
      • Indicators: Add dependent child indicators that roll up data to a parent indicator, such as consolidating incidents, problems, and changes into a total issue count.
    • Performance Analytics Indicator Settings: When using Performance Analytics as a data source, select the relevant indicator and ensure collection frequencies are properly aligned to avoid errors.
    • Normalized Script: Use standardized scripts to evaluate and score applications or capabilities based on normalized metrics from assessments, queries, custom scripts, or Performance Analytics.
    • Click Through Configuration: Define how users access detailed indicator data through URL navigation types (new window, same window, or dialog box) and associate scripts for quick access to related applications or dashboards.

    Practical Application

    ServiceNow customers can use this form to create tailored indicators that provide insights into application and capability performance. By configuring data sources and scripts, customers can automate data collection and scoring aligned with organizational goals. The configurable click-through feature enhances user experience by linking indicator results directly to actionable data or dashboards.

    Create an application or capability indicator to assess applications or capabilities within the indicator framework.

    Table 1. Create new indicator form fields
    Field Description
    Name Name of the application or capability indicator.
    Short description Short summary of the application or profile indicator.
    Result limit The maximum number of records an indicator displays when running an associated script. This enables better performance of Enterprise Architecture by not processing too many records.
    Category Category that the indicator is associated with.
    Direction Business applications or capabilities with maximum or minimum values.
    • Select Minimize if lower values are better.
    • Select Maximize if higher values are better.
    Unit The type of unit in which indicator scores are displayed. Units can be numbers, percentages, currencies, quantities of time, or any other entity you define.
    Automatic refresh interval The refresh interval to update the indicator scores within the defined time range.
    Order The position of the indicator in the sequential order of all other indicators while accessing an application or capability.
    Table 2. Data source configuration section fields
    Field Description
    Data source

    Defines the location from which the indicator receives data.

    • Performance Analytics: Collects scores from indicators created in Performance Analytics. See Performance Analytics indicators.
    • Custom Script: Allows you to write a script that collects data from another application. Beneath the Data Source field, a sample script appears. Customize the script as needed. An example custom script is:
      var results = {};
 var applications = [];
 var incidentCount = 0;
 
 var applicationsGr = new GlideRecord("cmdb_ci_business_app");
 applicationsGr.addQuery('active', true);
 applicationsGr.query();
 //for each application get incident count at business service level
 while(applicationsGr.next()) {
    incidentCount = 0;
    
    var gr = new GlideRecord("incident");
    gr.addEncodedQuery("opened_atBETWEEN"  + startDate  + "@" +   endDate);
    gr.addQuery('cmdb_ci_business_app', applicationsGr.getUniqueValue());   
    gr.query();
    
    incidentCount = gr.getRowCount();
    var appInfo = {};
    appInfo.appId = applicationsGr.getUniqueValue();
    appInfo.weight = incidentCount;
    applications.push(appInfo);
    }
 results.applications = applications;
 results;
    • Query Condition: Allows you to select a table to run filters on to obtain data.
    • Assessments: Allows you to evaluate, score, and rank records by assessing records in a table. See Create metric types and generate assessable records. To view results of survey assessments within APM, see Generate survey assessments and view results within APM.
    • Indicators: Allows you to add dependent child indicators. Through the child indicators, data is gathered to the parent indicator.

      For example, if the parent indicator is number of issues, the dependent indicators can be number of incident counts, number of problems, and changes. These dependent indicators are child indicators and the number of incidents, problems, and changes recorded are consolidated up to the parent indicator as the number of issues.
    Indicator The Indicator field appears when Performance Analytics is selected from the Data source list.

    Indicators are statistics that are used to measure current conditions and forecast trends.

    Note:
    If the collection frequency of the application indicator isn’t greater than the frequency at which the data of the Performance Analytic indicator are generated, then the system displays an error message: Frequency of the indicator must always be greater than or equal to the frequency of the datasource configuration indicator. For more information, see Collection of PA indicator score data.
    Default breakdown Name of the Performance Analytics breakdown.
    Normalized script A script to evaluate and score business applications and capabilities using standardized metrics. It involves using indicators that provide a normalized score for the condition they are evaluating. These indicators can be based on assessments, query conditions, custom scripts, or performance analytics.
    Table 3. Click Through section fields
    Field Description
    Click through URL navigation type Select whether to view the application or capability indicator details in a new window, in the same window, or in a dialog box.
    Click through URL script The script associated with an indicator that allows users to select a URL and view the indicator data in a related application or dashboard. This enables quick access to relevant information, or actions related to the indicator data.