getGap(String indicator, Object onDate)

  • Release version: Australia
  • Updated March 12, 2026
  • 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.
    Table 1. Parameters
    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 2. Returns
    Type Description
    Number Difference between the score on the specified date and the global target score.

    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;