Range calculator scripts

Release version: Zurich

Updated July 31, 2025

2 minutes to read

Summarize

Summarized using AI

Summary of Range calculator scripts

Range calculator scripts in ServiceNow allow you to define and handle range restrictions and parent record updates within timeline pages. These scripts are implemented as script includes and enable dynamic calculation of date ranges and updating related parent records based on changes to child records.

Show full answer Show less

Key Features

ExampleUpdateParentsRangeCalculator: Automatically updates parent records (such as releases) when a child record's (such as a sprint) timeline span is moved or resized. It ensures parent start and end dates are adjusted to encompass the child's new timeline.
ExampleMinRangeCalculator: Calculates the earliest start date and latest end date among related child records for a given parent record. This is useful for determining the minimal range span of dependent records.
ExampleMaxRangeCalculator: Similar to the MinRangeCalculator, but focuses on retrieving the maximal date range details for a specified child record within its parent context.
Common utility functions getTimeMs and getTimeObject are used across scripts to convert dates to milliseconds and vice versa, facilitating precise date calculations.

Practical Application for ServiceNow Customers

These scripts enable customers to maintain accurate and consistent timeline data across related records, such as sprints and releases in Agile development modules. By implementing these examples or customizing them, you can ensure that parent record dates automatically reflect changes made to child records, improving data integrity and timeline visualization.

Using these scripts reduces manual updates and errors in scheduling data, supports better reporting, and enhances the usability of timeline views in your ServiceNow instance.

You can specify a script include that calculates range restrictions and processes parent updates in a timeline page.

Range Calculator Scripts

Following are three examples of script includes that help specify range restrictions.

ExampleUpdateParentsRangeCalculator

Updates parent records when a child record span is moved or resized in the timeline.

var ExampleUpdateParentsRangeCalculator = Class.create();
ExampleUpdateParentsRangeCalculator.prototype = {
initialize: function() { },
updateParents: function(id, table, startDate, endDate){
 if (table == "rm_sprint"){
   var releaseID;
   var sprint = new GlideRecord(table);
   sprint.addQuery('sys_id', id);
   sprint.query();
   if (sprint.next())
     releaseID = sprint.release + "";
   if (releaseID) {
         var now_GR = new GlideRecord("rm_release_scrum");
         gr.addQuery("sys_id", releaseID);
         gr.query();
         if (gr.next()) {
           if (startDate  && startDate < this.getTimeMs(gr.start_date))
               gr.start_date = this.getTimeObject(startDate); 
           if (endDate && endDate > this.getTimeMs(gr.end_date))
              gr.end_date = this.getTimeObject(endDate);
              gr.update();
         }
    }
  }
},  
getMinRangeDetails: function(id, table){ return [-1, -1, "", ""]; },
getMaxRangeDetails: function(id, table){ return [-1, -1, ""]; },
getTimeMs: function(date){ 
  return new GlideScheduleDateTime(date).getMS(); },
getTimeObject: function(timeMS) { 
  var gdt = new GlideDateTime(); 
  gdt.setNumericValue(timeMS); 
  return gdt; },
logMessage: function(message){ gs.log(message); },
type: 'ExampleUpdateParentsRangeCalculator'
}

In this example, the span is identified based on the id and table from function(id, table, startDate, endDate).

ExampleMinRangeCalculator

Defines the earliest start date and the latest end date for a specified span.

var ExampleMinRangeCalculator = Class.create();
  ExampleMinRangeCalculator.prototype = {
      initialize: function() { },
      updateParents: function(id, table, startDate, endDate){ },
      getMinRangeDetails: function(id, table){
           var min = -1;
           var max = -1;
           var minID = "";
           var maxID = "";
           if (table == "rm_release_scrum"){
                    var now_GR = new GlideRecord("rm_sprint");
                    gr.addQuery("release", id);
                    gr.query();
                    while(gr.next()){
                         var start = this.getTimeMs(gr["start_date"]);
                         var end = this.getTimeMs(gr["end_date"]);
                         var id = gr["sys_id"];
                         if (min == - 1 || start <= min){
                                if (start != min)
                                     minID = "";
                         min = start;
                         minID += "," + id;
                         }
                         if (max == -1 || end >= max){
                                    if (end != max)
                                            maxID = "";
                                    max = end;
                                    maxID += "," + id;
                            }  
                     }
            }
        return [min, max, minID, maxID];
},
getMaxRangeDetails: function(id, table){ return [-1, -1, ""]; },
getTimeMs: function(date){ return new GlideScheduleDateTime(date).getMS(); },
getTimeObject: function(timeMS) { 
  var gdt = new GlideDateTime(); 
  gdt.setNumericValue(timeMS); 
  return gdt; },
logMessage: function(message){ gs.log(message); },
type: 'ExampleUpdateParentsRangeCalculator'
}

ExampleMaxRangeCalculator

Defines the earliest start date and the latest end date for a specified span.

var ExampleMaxRangeCalculator = Class.create();
ExampleMaxRangeCalculator.prototype = {
   initialize: function() { },
   updateParents: function(id, table, startDate, endDate){ },
   getMinRangeDetails: function(id, table){ return [-1, -1, "", ""]; },
   getMaxRangeDetails: function(id, table){
      if (table == "rm_sprint"){
         var sprint = new GlideRecord(table);
         sprint.addQuery('sys_id', id);
         sprint.query();
         if (sprint.next())
            releaseID = sprint.release + "";
         if (releaseID) {
            var now_GR = new GlideRecord("rm_release_scrum");
            gr.addQuery("sys_id", releaseID);
            gr.query();
            if (gr.next())
               return [this.getTimeMs(gr.start_date),
                this.getTimeMs(gr.end_date), gr.sys_id];
         }
      }
      return [-1, -1, ""];
   },
   getTimeMs: function(date){ return new ScheduleDateTime(date).getMS(); },
   getTimeObject: function(timeMS) { 
     var gdt = new GlideDateTime();
     gdt.setNumericValue(timeMS); 
     return gdt; },
   logMessage: function(message){ gs.log(message); },
   type: 'ExampleUpdateParentsRangeCalculator'
}

Use the following two functions to obtain the correct start and end dates in the three example script includes provided for reference.

getTimeMs: function(date){
        return new ScheduleDateTime(date).getMS();
    }

getTimeObject: function(timeMS) {
        var gdt = new GlideDateTime();
        gdt.setNumericValue(timeMS);
        return gdt;
    }