Create new indicator form

  • Release version: Washingtondc
  • Updated August 1, 2024
  • 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

    The Create New Indicator form in Application Portfolio Management allows users to assess applications or capabilities by establishing various indicators within the Enterprise Architecture framework. This functionality is essential for evaluating performance and making informed decisions based on the collected data.

    Show full answer Show less

    Key Features

    • Name: Specify the indicator's name.
    • Short Description: Provide a brief overview of the indicator.
    • Result Limit: Set a maximum number of records displayed for performance optimization.
    • Category: Associate the indicator with a relevant category.
    • Direction: Choose whether to minimize or maximize values based on business needs.
    • Unit: Define the unit type for indicator scores (e.g., percentages, currencies).
    • Automatic Refresh Interval: Determine how often the scores are updated.
    • Order: Define the positioning of the indicator relative to others.

    Data Source Configuration

    Users can configure the data source for indicators through:

    • Performance Analytics: Collects scores from existing Performance Analytics indicators.
    • Custom Script: Write a custom script to gather data from other applications.
    • Query Condition: Filter data from a selected table.
    • Assessments: Evaluate and rank records based on defined scoring criteria.
    • Indicators: Add child indicators that contribute data to a parent indicator.

    Click Through Section

    • Click Through URL Navigation Type: Choose how to view indicator details (new window, same window, or dialog box).
    • Click Through URL Script: Assign a script to enable direct access to indicator data in related applications or dashboards.

    Key Outcomes

    By utilizing the Create New Indicator form, ServiceNow customers can effectively evaluate their applications and capabilities, streamline data access, and enhance decision-making processes through well-defined indicators and metrics. This ensures better performance management and operational efficiency within the Enterprise Architecture framework.

    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.