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

Compare with Current View Page History

« Previous Version 5 Next »

This server class provides methods to operate with database records.

initialize()

This 


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();
initialize()

Описание: Создает пустой объект для новой записи в таблицу.

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

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

Example:

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

get(propertyOrValue, value)

Описание: Загружает объект из БД по значению какого-нибудь поля, или в частном случае по sys_id..

Принимает:propertyOrValue - имя поля или его значение - mixed. Опционально: value -  mixed.

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

Example:

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);

}

__get(property) - не нужно

Описание:Геттер. Возвращает поле текущей записи по его имени.

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

Возвращает: mixed (значение поля).

__set(property, value) - не нужно

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

Принимает:property - string (поле для заполнения), value - mixed (значение поля).

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

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();


  • No labels