---
sourceDocument: Australia Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/now-intelligence

 Release :

    - australia

ft:locale :

    - de-DE

ft:publication_title :

    - Australia Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# getGap(String indicator, Object onDate)

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

* Freigeben Version: Australia
* 
* Aktualisiert 12. März 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

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. |
[Tabelle : 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. |
[Tabelle : 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;

**Zugehörige Konzepte**   

* [PAFormulaUtils API](https://servicenow-prod.fluidtopics.net/Ra9O4KxXs3o~oQVzrm73_Q "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.")  
**Zugehörige Verweise**   

* [getChange(String indicator, Object fromDate, Object toDate)](https://servicenow-prod.fluidtopics.net/ubh5lMQPzl1LQ155PCH2pg "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/hXfoXXnMlPttpWaa~UE~vg "Returns the percentage of change in the score of an indicator between two specified dates.")
* [getCurrentAggregateID()](https://servicenow-prod.fluidtopics.net/vCcFK3YBA5_fVOy_Gi4ODQ "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/qa2eahd8Vg87kOAlphvELQ "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/EDbjNfxx1E8dcOVv080Pzw "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/9yoslbwpqelRAsvLwFMagA "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/OP1kFy5zZCoYL00h1XIy0Q "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/NHlD_o2yPdj0tXuNoi7wOg "Returns the global target associated with the specified indicator for the specified date.")
* [getPersonalTarget(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/0zDQVUU8ahU32AXMlFSJAQ "Returns the personal target associated with the specified indicator for the specified date.")
* [getScore(String indicator, Object onDate)](https://servicenow-prod.fluidtopics.net/ttQgOcdtqO8Rf0m_cS4Vtg "Returns the score of the specified indicator for the specified date.")