---
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


---

# getGap(String indicator, Object onDate)

# getGap(String indicator, Object onDate) {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Returns the global target gap for the specified indicator on the specified
date.
The gap is the difference between the score on the specified date and the target. For an indicator with the MAXIMIZE direction, the gap is calculated as the score minus the target. For an indicator with the MINIMIZE direction or no direction, the gap is calculated as the target minus the score. {#PAFU-getGap_S_O__table_am3_ryk_mfb__entry__3}

| Name | Type | Description |
|-|-|-|
| indicator | String | Unique identifier of the indicator for which to provide the gap information. |
| onDate | Object | Date of the score to use to compare against the target score. |
[Table 1. Parameters]

{#PAFU-getGap_S_O__table_am3_ryk_mfb} {#PAFU-getGap_S_O__table_bm3_ryk_mfb__entry__2}

| Type | Description |
|-|-|
| Number | Difference between the score on the specified date and the global target score. |
[Table 2. Returns]

{#PAFU-getGap_S_O__table_bm3_ryk_mfb}  
Example:

    var a = pa.getGap($[[% of open overdue incidents]], score_start) / pa.getGlobalTarget($[[% of open overdue incidents]],score_start);
    var b = pa.getGap($[[Average age of last update of open incidents]], score_start) / pa.getGlobalTarget($[[Average age of last update of open incidents]], score_start);
    var c = pa.getGap($[[Number of open incidents]], score_start) / pa.getGlobalTarget($[[Number of open incidents]], score_start);
    var res = 100 - (100 * (a + b + c) / 3);
    res;

**Related concepts**   

* [PAFormulaUtils API](https://servicenow-prod.fluidtopics.net/jW9tCQXaNoAGNn13PQ5tkg "The PAFormulaUtils API enables you to obtain a value that was calculated in the Analytics Hub and use that value as input for a formula.")  
**Related reference**   

* [getChange(String indicator, Object fromDate, Object toDate)](https://servicenow-prod.fluidtopics.net/FGl4hsn2y9EZmrpdAWNSDA "Returns the change in the score of an indicator between two specified dates.")
* [getChangePercentage(String indicator, Object fromDate, Object toDate)](https://servicenow-prod.fluidtopics.net/rkfVEQmujlgYPjenHH6xjg "Returns the percentage of change in the score of an indicator between two specified dates.")
* [getCurrentAggregateID()](https://servicenow-prod.fluidtopics.net/AFISri81HvylNEj11KUNew "Returns the time series aggregate identifier (sys_id) from the indicator of the current formula. The sys_id is returned dynamically, as the selection in the Analytics Hub changes.")
* [getCurrentBreakdownID()](https://servicenow-prod.fluidtopics.net/QSWdIIrf5yFaMxnhWNrrqg "Returns the level 1 breakdown identifier (sys_id) from the indicator of the current formula. The sys_id is returned dynamically, as the selection in the Analytics Hub changes.")
* [getCurrentBreakdownLevel2ID()](https://servicenow-prod.fluidtopics.net/AJudusXKGYHXVd3ntD3t1Q "Returns the level 2 breakdown identifier (sys_id) from the indicator of the current formula. The sys_id is returned dynamically, as the selection in the Analytics Hub changes.")
* [getCurrentElementID()](https://servicenow-prod.fluidtopics.net/C546iFba6DSSFqAsBL62ng "Returns the level 1 breakdown element identifier (sys_id) from the indicator of the current formula. The sys_id is returned dynamically, as the selection in the Analytics Hub changes.")
* [getCurrentElementLevel2ID()](https://servicenow-prod.fluidtopics.net/yr0R44XQQxV7CPoYA5lZgg "Returns the level 2 breakdown element identifier (sys_id) from the indicator of the current formula. The sys_id is returned dynamically, as the selection in the Analytics Hub changes.")
* [getGlobalTarget(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/kFixc5RvzpGlLY0AwQhV1Q "Returns the global target associated with the specified indicator for the specified date.")
* [getPersonalTarget(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/pc9WOjWFfVXq4CA40IK~cQ "Returns the personal target associated with the specified indicator for the specified date.")
* [getScore(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/xzipk~lohUNIGyymEUXtaA "Returns the score of the specified indicator for the specified date.")