Skip to main content

ServiceNow GlideRecord: initialize versus newRecord

initialize documentation > Creates an empty record within the current GlideRecord that is suitable for population before an insert
> isNewRecord=false before insert, gs.info(gr.Active) is empty before .insert()





newRecord documentation Creates a GlideRecord, sets the default values for the fields, and assigns a unique ID to the record
> i
sNewRecord=true before insert,  gs.info(gr.Active) is populated before .insert()



>fairly helpful video link here

in a nutshell,
isNewRecord() allows you to query values / perform validation before the insert (e.g. if you wanted to include conditions) and populates the records holding the values in memory
in the rare case for example you wanted to create/update a related record (e.g. in a custom table) BEFORE the insert operation, newRecord() enables values to be referenced

example:

var gr=new record ('incident)';

gr.initialize() / gr.newRecord()

gs.print(gr.active);
gs.print(gr.sys_id);
gs.print(gr.number);
gs.print();

gr.insert();

===

from Chuck Tomasi in this article,

"

  • initialize(): Creates an empty record suitable for population before an insert.
  • newRecord(); Creates a GlideRecord, set the default values for the fields and assign a unique id to the record.


Try these two in scripts background and you'll see that initialize gives no value to opened_at, whereas newRecord does.


var inc = new GlideRecord('incident');

inc.initialize();

gs.print(inc.opened_at.getDisplayValue());


var inc = new GlideRecord('incident');

inc.newRecord();

gs.print(inc.opened_at.getDisplayValue());


I have always trusted newRecord more since learning about this a few years ago."



(ServiceNow )

Comments

Popular posts from this blog

URL link in addInfoMessage

var ga=new GlideAjax('gld_HR_ajax'); ga.addParam('sysparm_name', 'checkEmployeeNumber_hrProfile'); ga.addParam('sysparm_hrprofilenumber', g_form.getValue('number')); ga.addParam('sysparm_employeenumber', newValue); ga.getXMLAnswer(function(answer) { if (answer!='undefined' && answer!=''){ var navURL="<a style='text-decoration:underline;color:blue' href=hr_profile.do?sysparm_query=number=" + answer + ">" + answer + "</a><img width='3' src='images/s.gif'/>"; var sMsg='The employee number entered already exists on another HR Profile ' + navURL; //alert(sMsg); g_form.showErrorBox('employee_number', 'error - please check'); g_form.addInfoMessage(sMsg); } });

GlideRecord setValue

setValue(String name, Object value) Sets the specified field to the specified value. Normally a script would do a direct assignment, for example,  gr.category = value . However, if in a script the element name is a variable, then  gr.setValue(elementName, value)  can be used. When setting a value, ensure the data type of the field matches the data type of the value you enter. This method cannot be used on journal fields. If the value parameter is null, the record is not updated, and an error is not thrown https://developer.servicenow.com/app.do#!/api_doc?v=madrid&id=r_GlideRecord-setValue_String_Object