Page History

This server class provides methods to operate database records.

SimpleRecord(tableName)

This method instantiates a SimpleRecord class object for a particular table.

Parameter(s):

Example:

<![CDATA[const taskRecord = new SimpleRecord('task');

REM attribute object

The SimpleRecord class has a special object for <![CDATA[Record Extended Models – rem_attr – containing information about the REM attributes. It is used to read and edit REM attributes values of the current record with other class methods as in the example below.

Parameter:

Return:

Example:

<![CDATA[const record = new SimpleRecord('task');
record.get('160638931615274614');
if (record.getReModelId()) {
    ss.info(record.rem_attr.description);
}

addOrCondition(property, operator, value)

This method appends a 2-or-3 parameter OR condition to an existing query. It works in conjunction with any of the addQuery() methods. In this method, you can use any preferred operator from the Condition Operators list, specified either in lowercase or in uppercase. Notice that you need to use the system name of the operator in your scripts.

You can also specify a RE model attribute of a specific table. To filter records, use the operators corresponding to the attribute type.

Parameter(s):

Return:

ExampleExamples:

<![CDATA[const record = new SimpleRecord('task');
record.addQuery('subject', 'like', 'not work')
record.addOrCondition('description', 'like', 'not work');
ss.info('Condition query: ' + record.getConditionQuery());
record.query();
// Info: Condition query: (subjectLIKEnot work)^OR(descriptionLIKEnot work)

It is possible to pass the SimpleRecord object as current.{reference_field_name} instead of the record ID as the addOrCondition() method value. The script example:

let record = new SimpleRecord('task');

record.

addQuery('subject', 'like', 'not work')
record.addOrCondition('166972638116358001:description', 'contains', 'not work');
ss.info('

Condition 

query: 

'

+ record.getConditionQuery());
record.query();

// Info: 

Condition 

query: 

(

addQuery(property, operator, value)

This method adds a condition to make a selection of records from the database. In this method, you can use any preferred operator from the Condition Operators list, specified either in lowercase or in uppercase. Note that you need to use system name of the operator in your scripts.

Parameter(s):

Return:

subjectLIKEnot work)^OR(166972638116358001:descriptionLIKEnot work)

const task = new SimpleRecord('task');
task.setLimit(1);
task.query();
if (!task.next()) {
  ss.info('No tasks found!');
  return;
}

const relatedTask

Example:

 = new SimpleRecord('task');

relatedTask.addQuery('

caller', 

task.caller);

relatedTask.

addOrCondition('

assigned_user', 

task.caller);

relatedTask.query();
ss.info('

Tasks count: ' + 

relatedTask.getRowCount());
// Info: Tasks 

count: 

122

addQuery(property, operator, value)

This method adds a condition to make a selection of records from the database. In this method, you can use any preferred operator from the Condition Operators list, specified either in lowercase or in uppercase. Note that you need to use system name of the operator in your scripts.

You can also specify a RE model attribute of a specific table. To filter records, use the operators corresponding to the attribute type. 

Parameter(s):

Return:

Examples:

 = new SimpleRecord('task');

task.addQuery('

active', 

true);

task.addQuery('

subject', '

like', 

'email');

task.

addQuery('sys_created_at', '<', '2019-04-01 00:00:00');
task.query();
ss.info('

Count: ' + 

task.getRowCount());
// Info: 

Count: 

const task

addEncodedQuery(condition)

This method adds encoded query and applies it to the current query method.

Parameter(s):

Return:

0

let record

Example:

<![CDATA[const currentUser = ss.getUser();
const reciever = new SimpleRecord('employeetask');
recieverrecord.addQuery('active166972638116358001:description', 'not truework');
if (currentUser.company.class === 'internal') {
    reciever.addEncodedQuery(`(company=${currentUser.getValue('company')})`);
} else {
    reciever.addEncodedQuery(`%28sys_db_table_id%3D158645243815904649%5Esys_created_byDYNAMIC156957117519820256%29`);
}
ss.info('Decoded condition: ' + reciever.getConditionQuery());
reciever.query(record.query();
ss.info("Total rows: " + record.getRowCount());
// Info: DecodedTotal condition: (active=1)^((sys_db_table_id=158645243815904649^sys_created_byDYNAMIC156957117519820256))

canCreate()

This method checks whether inserting new records in this table satisfies the <![CDATA[Access Control Rule (ACL).

Also, you can use this method in your UI Actions to adjust its visibility more precisely.

Return:

rows: 1

Example:

<![CDATA[current.canCreate();

canDelete()

This method checks whether deleting records in this table satisfies the <![CDATA[Access Control Rule (ACL).

Also, you can use this method in your UI Actions to adjust its visibility more precisely.

Return:

const task = new SimpleRecord('task');
task.setLimit(1);
task.query();
if (!task.next()) {
  ss.info('No tasks found!');
  return;
}

const otherTask = new SimpleRecord('task');
otherTask.addQuery('caller', task.caller);
otherTask.addQuery('sys_id', '!=', task.sys_id);
otherTask.query();
ss.info('Tasks count: ' + otherTask.getRowCount());
// Info: Tasks count: 720

addEncodedQuery(condition)

This method adds encoded query and applies it to the current query method.

You can also specify a RE model attribute of a specific table. To filter records, use the operators corresponding to the attribute type. 

Use curly brackets when setting a filter argument for the text fields of type String, Text, Translated Text, Conditions, and URL. Using parenthesis for the argument may cause a filter query error.

const subject = 'Hello, SimpleOne)';
const task = new SimpleRecord('task');
task.addEncodedQuery(`subjectLIKE${subject}`);
ss.info(task.getConditionQuery());
try {
    task.query();
} catch (e) {
   ss.error(e.message);
} 
// Info: (subjectLIKEHello, SimpleOne))
// Error: Condition query is invalid

Parameter(s):

Return:

Examples

Example:

<![CDATA[current.canDelete();

canRead()

This method checks whether reading records in this table satisfies the <![CDATA[Access Control Rule (ACL).

Also, you can use this method in your UI Actions to adjust its visibility more precisely.

Return:

Example:

<![CDATA[current.canRead();

canUpdate()

This method checks whether updating records in this table satisfies the <![CDATA[Access Control Rule (ACL).

Also, you can use this method in your UI Actions to adjust its visibility more precisely.

Return:

:

<![CDATA[current.canUpdate();

deleteMultiple()

This method allows deleting multiple records in a query selection. Please note that attachments cannot be deleted using this method.

Return:

Example:

<![CDATA[const record = new SimpleRecord('sys_activity_feed_item');
record.addQuery('content', 'isempty');
record.query();
ss.info(record.getRowCount());
ss.info(record.deleteMultiple());
// Info: 0
// Info: true

deleteRecord()

This method deletes the current record.

Return:

const currentUser = ss.getUser();
const receiver = new SimpleRecord('employee');
receiver.addQuery('active', true);
if (currentUser.company.class === 'internal') {
    receiver.addEncodedQuery(`(company=${currentUser.getValue('company')})`);
} else {
    receiver.addEncodedQuery(`%28sys_db_table_id%3D158645243815904649%5Esys_created_byDYNAMIC156957117519820256%29`);
}
ss.info('Decoded condition: ' + receiver.getConditionQuery());
receiver.query();
// Info: Decoded condition: (active=1)^((sys_db_table_id=158645243815904649^sys_created_byDYNAMIC156957117519820256))

Example:

<![CDATA[const taskreceier = new SimpleRecord('task');
taskreceiver.getaddQuery('155931135900000000active', true);
if (!task.sys_id) {
  return;
}
const isDeleted = task.deleteRecord();
if (isDeleted) {
  ss.info('Task with ID ' + task.sys_id + ' was deleted!');
  return;
}
ss.error(task.getErrors());

get(propertyOrValue, value)

This method loads an object from a database by the field value, or, in a specific case, by the sys_id.

Parameter(s):

String value of record <![CDATA[ID or property name. If it is equal to the property name, then the second parameter 'value' is mandatory.

receiver.addEncodedQuery('%28sys_db_table_id%3D158645243815904649%5E166972638116358001%3AdescriptionLIKEwork`);
ss.info('Decoded condition: ' + receiver.getConditionQuery());
receiver.query();
// Info: Decoded condition: (active=1)^((sys_db_table_id=158645243815904649^166972638116358001:descriptionLIKEwork))

canCreate()

This method checks whether inserting new records in this table satisfies the Access Control Rule (ACL).

Also, you can use this method in your UI Actions to adjust its visibility more precisely.

Return:

Example:

Return:

Example:

It is possible to pass the SimpleRecord object as current.{reference_field_name} instead of the record ID as the get() method value. The script example:

<![CDATA[const task = new SimpleRecord('task');
task.get('163663310116371174'); // get by ID

if (task.state == '18') { // Rejected
  const company = new SimpleRecord('org_company');
  company.get('c_website', task.c_customer_url); // get by Customer URL
  ss.eventQueue('notify.responsible', task, company.responsible.email);
}

<![CDATA[const task = new SimpleRecord('task');
task.setLimit(1);
task.query();
if (!task.next()) {
  ss.info('No tasks found!');
  return;
}

const user = new SimpleRecord('user');
user.get(task.caller);
user.language_id = '156628684306541141'; // English
ss.info(user.update());
// Info: 167515292501757147

getAttributes()

current.canCreate();

canDelete()

This method checks whether deleting records in this table satisfies the Access Control Rule (ACL).

Also, you can use this method in your UI Actions to adjust its visibility more precisely.

Return:

Example:

current.canDelete();

canRead()

This method checks whether reading records in this table satisfies the Access Control Rule (ACL).

Also, you can use this method in your UI Actions to adjust its visibility more precisely.

Return:

Example:

current.canRead();

canUpdate()

This method checks whether updating records in this table satisfies the Access Control Rule (ACL).

Also, you can use this method in your UI Actions to adjust its visibility more precisely.

Return:

Example:

current.canUpdate();

deleteMultiple()

This method allows deleting multiple records in a query selection. Please note that attachments cannot be deleted using this method.

Return:

Example:

<![CDATA[const userRecordrecord = new SimpleRecord('sys_activity_feed_item');
record.addQuery('content', 'isempty');
record.query();
ss.info(record.getUsergetRowCount());
ss.info(userRecordrecord.getAttributesdeleteMultiple());
// Info: {"sys_id":"155931135900000001","sys_created_at":"2019-09-30 00:00:00","sys_updated_at":"2021-06-28...

 0
// Info: true

deleteRecord()

This method returns the table title. If the title is not set, then returns namedeletes the current record.

Return:

Example:

<![CDATA[const currenttask = new SimpleRecord('task');
currenttask.get('163663310116371174155931135900000000');
ss.info(current.getClassDisplayValue());
// Info: Task

getConditionQuery()

This method returns current query condition.

Return:

Example:

<![CDATA[const task = new SimpleRecord('task');
const conditionif (!task.sys_id) {
  return;
}
const isDeleted = task.addQuery('state', '7'deleteRecord();
condition.addOrCondition('priority', '<', '3');
if (isDeleted) {
  ss.info('ConditionTask beforewith query:ID ' + task.getConditionQuery()sys_id + ' was deleted!');
task.query();  return;
}
ss.info('Condition after query: ' + error(task.getConditionQuerygetErrors());
// Info: Condition before query: (state=7)^OR(priority<3)
// Info: Condition after query:

get(propertyOrValue, value)

This method loads an object from a database by the field value, or, in a specific case, by the sys_id.

Parameter(s):

Return:

Return:

Example:

<![CDATA[const currenttask = new SimpleRecord('task');
currenttask.get('163663310116371174');
ss.info(current.getDisplayValue('caller'));
ss.info(current.getValue('caller'));
// Info: John Doe
// Info: 155931135900000001

If the record creating, updating or deleting fails, then this method will display an error message.

Use this method for control purposes if there any validation errors within your scripts.

Return:

 // get by ID

if (task.state == '18') { // Rejected
  const company = new SimpleRecord('org_company');
  company.get('c_website', task.c_customer_url); // get by Customer URL
  ss.eventQueue('notify.responsible', task, company.responsible.email);
}

const 

task = new SimpleRecord('

task');
task.setLimit(1);

task.query();
if (

!task.next()) {
  ss.info(

'No tasks found!');
  return;
}

const user = new SimpleRecord('user');
user.get(task.caller);
user.language_id = '156628684306541141'; // English
ss.info(user.update());
// Info: 167515292501757147

getAttributes()

This method returns an object with current record properties as keys and properties values as key values.

Return:

This method gets the field title.

Parameter(s):

Return:

Example:

<![CDATA[const currentuserRecord = ss.getUser();
const fieldLabel = current.getLabel('username');
ss.addErrorMessage('Field "' +  fieldLabel + '" cannot be blank'ss.info(userRecord.getAttributes());
// Field "Login" cannot be blank

Info: {"sys_id":"155931135900000001","sys_created_at":"2019-09-30 00:00:00","sys_updated_at":"2021-06-28...

getClassDisplayValue()

This method returns the table title. If the title is not set, then returns name

This method retrieves the ID of the <![CDATA[RE model related to the current record. To set a new model ID use the <![CDATA[setReModelId method.

Return:

Example:

<![CDATA[(function executeRule(current, previousconst current = null /*not null only when action is update*/) {
    if (current.getReModelId()) {
        const modelnew SimpleRecord('task');
current.get('163663310116371174');
ss.info(current.getClassDisplayValue());
// Info: Task

getConditionQuery()

This method returns current query condition.

Return:

Example:

const task = new SimpleRecord('sys_rmc_modeltask');
const condition       model.get(current.getReModelId()); // current model
        current.$$service = model.getValue('cmdb_service_id'); // pass service if field exists
    }
})(current, previous);

getRowCount()

This method gets the amount of items in a row.

= task.addQuery('state', '7');
condition.addOrCondition('priority', '<', '3');
ss.info('Condition before query: ' + task.getConditionQuery());
task.query();
ss.info('Condition after query: ' + task.getConditionQuery());
// Info: Condition before query: (state=7)^OR(priority<3)
// Info: Condition after query:

getDisplayValue(property) 

Anchor
getDisplayValue() getDisplayValue()

This method returns the value of display_by_ref field or record value. For example, for the reference field the entity name will be returned, but not the ID.

Parameter(s):

Return:

Example:

<![CDATA[const taskcurrent = new SimpleRecord('task');
taskcurrent.queryget('163663310116371174');
ss.addInfoMessageinfo(current.getDisplayValue('All Tasks Count: ' + task.getRowCount(caller'));
ss.info(current.getValue('caller'));
// Info: All Tasks CountJohn Doe
// Info: 2155931135900000001

getErrors()

This method gets the current table name.

Return:

 

Anchor
getErrors getErrors

If the record creating, updating or deleting fails, then this method will display an error message.

Use this method for control purposes if there any validation errors within your scripts.

Return:

Example:

<![CDATA[const currentrecord = new ss.getUser(SimpleRecord('user');
ss.info('/list/' + current.getTableName() + '/' + current.sys_id);const insertedRecordId = record.insert();
if (insertedRecordId == 0) {
  ss.info(record.getErrors());
}
// Info: /list/user/155931135900000001

 ["The \"\"First Name\" [first_name]\" field is mandatory. (record id: )",...

getLabel(property) 

Anchor
getLabel() getLabel

()

This method returns gets the title of the defined RE attributefield title.

Parameter(s):

Return:

Example:

<![CDATA[const current = new SimpleRecord('task'ss.getUser();
const fieldLabel = current.getgetLabel('163638951512716126username');
if (current.sys_id) {
    ss.info(current.rem_attr.getTitle('reviewed'));
}
// Info: Review completed

ss.addErrorMessage('Field "' +  fieldLabel + '" cannot be blank');
// Field "Login" cannot be blank

getReModelId() 

Anchor

getremodelid getremodelid

This method

retrieves the

ID of

the RE model related to the current record. To set a new model ID use the setReModelId method.

Return:

Example:

If the field is of the Reference or List types, then its sys_id value returns.

Parameter(s):

Return:

<![CDATA[const current = ss.getUser();
const user = new SimpleRecord('user');
user.addQuery('timezone_id', current.getValue('timezone_id'));
user.selectAttributes('sys_id');
user.query();
ss.info(user.getRowCount() + ' users have the same timezone as you');
// Info: 24 users have the same timezone as you

hasAttachment()

This method checks whether the record specified has an attachment or not.

Return:

(function executeRule(current, previous = null /*not null only when action is update*/) {
    if (current.getReModelId()) {
        const model = new SimpleRecord('sys_rmc_model');
        model.get(current.getReModelId()); // current model
        current.$$service = model.getValue('cmdb_service_id'); // pass service if field exists
    }
})(current, previous);

getRowCount()

This method gets the amount of items in a row.

Returns:

Example:

Example:

<![CDATA[const currenttask = new SimpleRecord('task');
currenttask.getquery('163663310116371174');
const hasAttach = current.hasAttachment();
if (!hasAttach) {
  ss.addErrorMessage('File should be attached');
  return;
}
current.state = '2'; // Open
current.update();

initialize()

This method populates all active empty fields with their predefined default values.

It works only for new records that were never saved and cannot be called repeatedly.

ss.addInfoMessage('All Tasks Count: ' + task.getRowCount());
// All Tasks Count: 2

getTableName()

This method gets the current table name.

Return:

Example:

<![CDATA[const taskRecordcurrent = new SimpleRecord('task'ss.getUser();
ss.info(taskRecord.getAttributes().caller);
taskRecord.initialize();
ss.info(taskRecord.getAttributes().caller);
'/list/' + current.getTableName() + '/' + current.sys_id);
// Info: 
/list/user/ Info: 155931135900000001

155931135900000001

getTitle(attribute) 

Anchor
getTitle() getTitle()

This method uses returns the field values title of the current record to insert a new one.If the record is not inserted then method returns '0' (zero) and adds an informative error message which can be obtained with getErrors() method.defined RE attribute.

Parameter:

Return:

Example:

<![CDATA[const newTaskcurrent = new SimpleRecord('task');
newTask.subject = 'Subtask';
const inserterTaskID = newTask.insert();
ss.info(`/record/task/${inserterTaskID}`);current.get('163638951512716126');
if (current.sys_id) {
    ss.info(current.rem_attr.getTitle('reviewed'));
}
// Info: /record/task/163675231910113745

isTableVcsEnabled()

This method checks whether the VCS enabled attribute is enabled against the specified table or not. 

Return:

Review completed

getValue(property) 

Anchor
getValue() getValue()

This method returns the value of the object property based on its name.

If the field is

of the Reference or List types, then its sys_id value returns.

Parameter(s):

Example:

<![CDATA[const current = new SimpleRecord('user');
ss.info(current.isTableVcsEnabled());
// Info: false

matchesCondition(condition)

This method checks whether the current record meets the condition in the current state.

Return:

<![CDATA[const taskcurrent = new SimpleRecord('task'ss.getUser();
task.descriptionconst user = new SimpleRecord('emaiouser');
ssuser.info(task.matchesCondition('descriptionLIKEemailaddQuery('timezone_id', current.getValue('timezone_id')); // false
task.description = 'email'user.selectAttributes('sys_id');
user.query();
ss.info(taskuser.matchesConditiongetRowCount('descriptionLIKEemail')); // true

 + ' users have the same timezone as you');
// Info: 24 users have the same timezone as you

hasAttachment()

This method returns checks whether the next record in the query. If this is the first call, this method returns the first record in query. If the query is empty, this method record specified has an attachment or not.

Return:

Example:

Record or Boolean

Example:

<![CDATA[const usercurrent = new SimpleRecord('usertask');
usercurrent.setLimitget(1'163663310116371174');
user.queryconst hasAttach = current.hasAttachment();
user.next();
ss.info(user.sys_id);
// Info: 100000000000000000

if (!hasAttach) {
  ss.addErrorMessage('File should be attached');
  return;
}
current.state = '2'; // Open
current.update();

initialize()

This method populates all active empty fields with their predefined default values.

It works only for new records that were never saved and cannot be called repeatedly.

This method is called automatically and implicitly at the first set operation (also known as "the setter").

Return:

Example:

const 

taskRecord = new SimpleRecord('task');

ss.info(taskRecord.getAttributes().caller);

taskRecord.initialize();
ss.info(taskRecord.getAttributes(

).

caller);
// 

Info: 

// Info: 155931135900000001

insert()

This method

uses the field values of the current record to insert a new one.

If the record is not inserted then method returns '0' (zero) and adds an informative error message which can be obtained with getErrors() method.

Return:

Example:

<![CDATA[const firstLognewTask = new SimpleRecord('task'sys_log');
newTask.subject = 'Subtask';
const inserterTaskID = newTask.insert();
ss.info(`/record/task/${inserterTaskID}`);
// Info: /record/task/163675231910113745

isTableVcsEnabled()

This method checks whether the VCS enabled attribute is enabled against the specified table or not. 

Return:

Example:

const current = new SimpleRecord('user'firstLog.orderBy('sys_created_at'); // oldest record first
firstLog.addQuery('message', 'like', 'Connection');
firstLog.setLimit(1);
firstLog.selectAttributes(['message', 'sys_created_at']);
firstLog.query();
firstLog.next();
ss.info(firstLog.sys_created_at + ' - ' + firstLog.message);
current.isTableVcsEnabled());
// Info: 2021-06-03 06:34:02 - IMAP IMAP (Default): Connection error: ...

false

matchesCondition(condition)

This method sorts the records in the descending order.Parameter(s):checks whether the current record meets the condition in the current state.

Return:

<![CDATA[const lastCommenttask = new SimpleRecord('sys_activities_stream_field');
lastComment.orderByDesc('sys_created_at'task');
task.description = 'emaio';
ss.info(task.matchesCondition('descriptionLIKEemail')); // newest record first
lastComment.setLimit(1);
lastComment.selectAttributes(['value', 'sys_created_by']);
lastComment.query();
lastComment.next();
ss.info(lastComment.sys_created_by.display_name + ': ' + lastComment.value);
// Info: John Doe: test

query()

false
task.description = 'email';
ss.info(task.matchesCondition('descriptionLIKEemail')); // true

next()

This method returns the next record in the query. If this is the first call, this method returns the first record in query. If the query is empty, this method returns 'false'.

Return:

Example:

<![CDATA[const tasksuser = new SimpleRecord('taskuser');
tasksuser.addQuery('sys_created_at', '>', '2020-01-01'setLimit(1);
tasksuser.orderBy('sys_created_at'query();
tasksuser.setLimitnext(2);
tasksss.queryinfo(user.sys_id);
while (tasks.next()) {
  ss.info('Task number: ' +  tasks.number);
}
// Info: Task number: TSK0000001
// Info: Task number: TSK0000003

selectAttributes(attributes)

This method is intended to optimize database queries. Sometimes, it is necessary to obtain only several object fields, not the whole object. Therefore, this method was added.

Do not use this method to select records that could be updated or deleted after selecting. Otherwise, some of the record field values may be lost when these records are updated or deleted. Or the action performed may throw an exception looking like this (the example text is given below):

// Info: 100000000000000000

const task = new SimpleRecord('task');
task.setLimit(1);
task.query();
// task.next();
ss.info(task.number);
// Error: Current record is not set.

orderBy(column)

This method sorts records in the ascending order.

Parameter(s):

Return:

Example:

<![CDATA[const recordfirstLog = new SimpleRecord('usersys_log');
recordfirstLog.selectAttributesorderBy('emailsys_created_at');
record.query( // oldest record first
firstLog.addQuery('message', 'like', 'Connection');
recordfirstLog.nextsetLimit(1);
ssfirstLog.info(record.getAttributes());
// Info: {"email":"john.doe@email.com","sys_id":"162423321917274937"}selectAttributes(['message', 'sys_created_at']);
firstLog.query();
firstLog.next();
ss.info(firstLog.sys_created_at + ' - ' + firstLog.message);
// Info: 2021-06-03 06:34:02 - IMAP IMAP (Default): Connection error: ...

orderByDesc(column)

This method sorts the records in the descending order.

Parameter(s):

Return:

Example:

<![CDATA[const recordlastComment = new SimpleRecord('usersys_activities_stream_field');
recordlastComment.selectAttributesorderByDesc(['email', 'username']);
record'sys_created_at'); // newest record first
lastComment.setLimit(1);
lastComment.selectAttributes(['value', 'sys_created_by']);
lastComment.query();
recordlastComment.next();
ss.info(record.getAttributes())lastComment.sys_created_by.display_name + ': ' + lastComment.value);
// Info: {"email":"john.doe@email.com","username":"john.doe","sys_id":"162423321917274937"}

setAbortAction(flag)

This method is used in business rules and sets a flag, indicating that the current operation (insert/update/delete) will be interrupted.

 John Doe: test

query()

This method applies query to the database selection. After this, it fills in the record set.

Return:

Example:

const tasks

Parameter(s):

Return:

Example:

<![CDATA[const current = new SimpleRecord('task');
currenttasks.getaddQuery('163663310116371174');
const hasAttach = current.hasAttachmentsys_created_at', '>', '2020-01-01');
tasks.orderBy('sys_created_at');
tasks.setLimit(2);
tasks.query();
ifwhile (!hasAttachtasks.next()) {
    ss.addErrorMessageinfo('File should be attached!');
    current.setAbortAction(trueTask number: ' +  tasks.number);
}
current.state = '2'; // Open
current.update();

setLimit(maxNumRecords)

This method limits the number of records selected by SimpleRecord query methods.

Parameter(s):

Return:

Example:

<![CDATA[const record = new SimpleRecord('user');
record.setLimit(3);
record.query();
ss.info(record.getRowCount());
// Info: 3

setMultipleValue(property,value)

This method sets the properties values for every entry in the current selection.

Parameter(s):

Return:

// Info: Task number: TSK0000001
// Info: Task number: TSK0000003

selectAttributes(attributes)

This method is intended to optimize database queries. Sometimes, it is necessary to obtain only several object fields, not the whole object. Therefore, this method was added.

Return:

Example:

<![CDATA[const taskrecord = new SimpleRecord('taskuser');
taskrecord.addQueryselectAttributes('state', '7email'); // Draft
taskrecord.query();
record.next();
ss.info(taskrecord.getRowCountgetAttributes());
task.setMultipleValue('state', '2'); // Open
// task.updateMultiple();

This method sets the ID of the defined <![CDATA[RE model. To get the model ID, use the <![CDATA[getReModelId method.

Parameter(s):

If the reModelId parameter is equal to 'null', the <![CDATA[REM, related to the record, will be detached. 

Return:

This method does not return a value.

Info: {"email":"john.doe@email.com","sys_id":"162423321917274937"}

Example:

const record = new SimpleRecord('user');
record.selectAttributes(['email', 'username']);
record.query();
record.next();
ss.info(record.getAttributes());
// Info: {"email":"john.doe@email.com","username":"john.doe","sys_id":"162423321917274937"}

setAbortAction(flag)

This method is used in business rules and sets a flag, indicating that the current operation (insert/update/delete) will be interrupted.

Parameter(s):

Return:

Example:

const current = new SimpleRecord('task');
current.get('163663310116371174');
const hasAttach = current.hasAttachment();
if (!hasAttach) {
    ss.addErrorMessage('File should be attached!');
    current.setAbortAction(true);
}
current.state = '2'; // Open
current.update();

setLimit(maxNumRecords)

This method limits the number of records selected by SimpleRecord query methods.

Parameter(s):

Return:

Example:

const record = new SimpleRecord('user');
record.setLimit(3);
record.query();
ss.info(record.getRowCount());
// Info: 3

setMultipleValue(property,value)

This method sets the properties values for every entry in the current selection.

Parameter(s):

Return:

const task = new SimpleRecord('task');
task.addQuery('state', '7'); // Draft
task.query();
ss.info(task.getRowCount());
task.setMultipleValue('state', '2'); // Open
// task.updateMultiple();

setReModelId(reModelId) 

Anchor
setremodelid setremodelid

This method sets the ID of the defined RE model. To get the model ID, use the getReModelId method.

Parameter(s):

If the reModelId parameter is equal to 'null', the REM, related to the record, will be detached. 

Return:

Example:

const task = new SimpleRecord('task');
task.get('163352033916904699');
if (task.getValue('service') === '164069027812962298') { // Email Server Service
    task.setReModelId('158569205818704980'); // Email Server Access Request
} else {
    task.setReModelId(null);
}
task.update();

Example:

(function executeRule(current, previous = null /*not null only when action is update*/ ) {
    // before rule triggered by service change

    ss.importIncludeScript('getRemAttributes');
    const rmc = new SimpleRecord('sys_rmc_model');
    rmc.addQuery('cmdb_service_id', current.getValue('service'));
    rmc.addQuery('active', true);
    rmc.selectAttributes('sys_id');
    rmc.setLimit(1);
    rmc.query();
    if (rmc.next()) {
        const previousModelAttributes = getRemAttributes(current);
        current.setReModelId(rmc.sys_id);
        const currentModelAttributes = getRemAttributes(current);

        Object.keys(previousModelAttributes).forEach(attributeName => {
            if (currentModelAttributes.hasOwnProperty(attributeName)) {
                current.rem_attr[attributeName] = previousModelAttributes[attributeName];
            }
        })
    } else {
        current.setReModelId(null);
    }

})(current, previous);

Example:

<![CDATA[const task = new SimpleRecord('task');
task.get('163352033916904699');
if (task.getValue('service') === '164069027812962298') { // Email Server Service
    task.setReModelId('158569205818704980'); // Email Server Access Request
} else {
    task.setReModelId(null);
}
task.update();

setValue(property, value) 

Anchor
setValue() setValue()

This method sets the value of the field in the current record.

Parameter(s):

Return:

Example:

<![CDATA[const task = new SimpleRecord('task');
task.setValue('subject', 'mail');
task.insert();

silentMode(enable)

This method is intended to update the record without executing any entities related to this record implementing the business logic, such as business rules, notifications, workflows, etc.

<![CDATA[const task = new SimpleRecord('task');
task.addQuery('active', false);
task.addQuery('approval_state', 'isempty');
task.query();
ss.info(task.getRowCount());
task.silentMode();
task.setMultipleValue('approval_state', 'not_requested'); // set Default Value
//task.updateMultiple();

update()

This method updates a database record.

Return:

Example:

<![CDATA[const current = new SimpleRecord('user');
current.get(ss.getUserId());
current.timezone_id = '156076775207670452'; // UTC
ss.info(current.update());
ss.info(current.getErrors());
// Info: 155931135900000001
// Info: []

updateMultiple()

This method updates all the selection entries.

Return:

<![CDATA[const task = new SimpleRecord('task');
task.addQuery('state', '0'); // Open
task.query();
ss.info(task.getRowCount());
task.setMultipleValue('state', '10'); // Canceled
// task.updateMultiple();