You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

This server class provides methods to operate with database records.

initialize()

This method creates an empty object for the new database record.


Return:

TypeDescription
VoidThis method does not return a value


Example:

initialize
let incident = new SimpleRecord("incident");
incident.initialize();
incident.subject = "Network does not work";
incident.insert();

get(propertyOrValue, value)

Loads an object from a database based on the field value, or in a specific case by sys_id.


Parameter(s):

NameType
propertyOrValuename (value must be specified as well).
propertyOrValuemixed
valuemixed


Return:

TypeDescription
voidThis method does not return a value.


Example:

get
let incident = new SimpleRecord("incident");
incident.get( "subject" , "Network does not work" )
addQuery(property, operatorOrValue, value)

Описание: Добавляет условие для выборки из БД.

Принимает: property - string, operatorOrValue - оператор выбора (=, like, etc.) или значение - mixed. Опционально: value - mixed.

Возвращает: объект SimpleRecord, который выполняет обращение к методу.

Example:

let incident = new SimpleRecord("incident");

incident.addQuery( "active", true );
incident.addQuery( "subject" , "LIKE" , "сеть" );
incident.addQuery( "sys_created_at" , "<" , "2019-04-01 00:00:00" );

incident.query();

query()

Описание: Выполняет запрос по выборке из БД на основе $this->query. Заполняет набор записей.

Принимает: Ничего.

Возвращает: Ничего.

next()

Описание: Возвращает следующую запись из списка.

Принимает: Ничего.

Возвращает: Record | bool(если новый запрос то возвращает первую или false).

Example:

let incident = new SimpleRecord("incident");

incident.query();

while ( incident.next() ){

ss.info( incident.sys_id);

}

getValue(property)

Описание: Синоним для геттера.

Принимает:string (поле, которое нужно вернуть).

Возвращает: mixed.

getClassDisplayValue(property)

Описание: Возвращает title таблицы. Если title не задан, возвращает name.

Принимает:Ничего.

Возвращает:string.

Example:

let incident = new SimpleRecord("incident");
ss.info( incident.getClassDisplayValue() );

getDisplayValue(property)

Описание: Возвращает отображаемое значение поля или записи(поле display_by_ref) (например,  для reference поля вернется не ID, а имя сущности).

Принимает:string.

Возвращает:mixed.

Example:

let incident = new SimpleRecord("incident");

incident.get(5236);
ss.info( incident.getDisplayValue( "caller_id" ) );

getLabel(property)

Описание: Возвращает заголовок поля.

Принимает: string.

Возвращает: string.

Example:

let incident = new SimpleRecord("incident");

incident.get(5236);
ss.info( incident.getLabel( "caller_id" ) );


setValue(property, value)

Описание: Устанавливает значение поля в текущей записи.

Принимает:property - string, value - mixed.

Возвращает: Ничего.

Example:

let incident = new SimpleRecord('incident');

incident.setValue("subject" , "Help me");

incident.insert();

getTableName()

Описание: Возвращает имя текущей таблицы.

Принимает:Ничего.

Возвращает: string.

let incident = new SimpleRecord('incident');

ss.info( incident.getTableName() ); // incident

insert()

Описание: Создает запись в БД.

Принимает:Ничего.

Возвращает: integer (sys_id созданной записи).

Example:

let incident = new SimpleRecord('incident');

incident.insert();

update(reason)

Описание: Обновляет запись в БД.

Принимает:string (причина обновления).

Возвращает: integer (sys_id обновленной записи).

Example:

let incident = new SimpleRecord('incidnet');

incident.get(5246);

incident.subject += " (repair)";

incident.update();

addEncodedQuery(condition)

Описание: Добавляет закодированный запрос к другим запросам, которые могли быть установлены. (не переносить, работает не верно, необходимо править)

Принимает:string.

Возвращает: Ничего.

deleteRecord(recordSetId)

Описание: Удаляет текущую запись.

Принимает:integer.

Возвращает: bool.

Example:

let incident = new SimpleRecord('incident');

incident.get(5236);

incident.deleteRecord();

deleteMultiple()

Описание: Удаляет несколько записей, которые удовлетворяют условию запроса. Этот метод не удаляет вложения. Не используйте deleteMultiple() для таблиц с зависимыми полями. Всегда удаляйте каждую запись отдельно. Кроме того, не используйте этот метод с методом setLimit() при работе с большими таблицами.

Принимает: ничего.

Возвращает: bool.

Example:

let incident = new SimpleRecord('incident');

incident.addQuery( 'subject' , "LIKE" , "network" );

incident.query();

incident.deleteMultiple();

getCurrentRecord()

Описание: Возвращает текущую запись. (не переносить, внутренний метод)

Принимает:ничего.

Возвращает: Record|false.

orderBy(column)

Описание: Определяет столбец orderBy.
Вызовите этот метод более одного раза, чтобы упорядочить по нескольким столбцам.
Результаты расположены в порядке возрастания, см. OrderByDesc (имя строки), чтобы упорядочить записи в порядке убывания.

Принимает: string.

Возвращает: Ничего.

Example:

let incident = new SimpleRecord('incident');

incident.orderBy('subject');

incident.query();

orderByDesc(column)

Описание: Определяет нисходящий порядок по столбцу.

Принимает: string.

Возвращает: Ничего.

Example:

let incident = new SimpleRecord('incident');

incident.orderByDesc('subject');

incident.query();

setLimit(maxNumRecords)

Описание: Устанавливает ограничение на количество записей, извлекаемых по запросу SimpleRecord.

Принимает: integer.

Возвращает: Ничего.

Example:

let incident = new SimpleRecord('incident');

incident.setLimit(30);

incident.query();

addOrCondition(property, operatorOrValue, value)

Описание: Добавляет условие OR параметра 2 или 3 к существующему запросу. Используется вместе с addQuery.

Принимает: property - string, operatorOrValue - оператор выбора (=, like, etc.) или значение - mixed. Опционально: value - mixed.

Возвращает:объект SimpleRecord, который выполняет обращение к методу.

Example:

let incident = new SimpleRecord('incident');
incident.addQuery( 'contact_type' , 'email' ).addOrCondition( 'number' , 'INC0000006');
incident.query();

Method descrtiption


Parameter(s):

NameType



Return:

TypeDescription



Example:



  • No labels