SimpleRecord Client-Side

 Этот класс используется для работы с базой данных, предоставляя способы использования функциональных возможностей этого класса в скриптах на стороне клиента, например, в скриптах политики пользовательского интерфейса.

SimpleRecord API включает в себя записи и поля.

В этом классе клиентские запросы обрабатываются на сервере. Это значит, что необходимо выполнить запрос с клиентского сервера, чтобы получить данные записи.

Некоторые приложения не предоставляют SimpleRecord на стороне клиента. В этом случае создайте Script Include или используйте REST API.

addQuery()

Используйте данный метод для фильтрации записей в соответствии с настроенными условиями (поле, оператор, значение). Так же данный метод возвращает записи, в которых поле равно значение (или находится в списке значений). 

С этим методом можно использовать любой оператор из списка Condition Operators. Используйте системное название оператора в скрипте.

Возвращаемое значение:

Пример:

const record = new SimpleRecord('task');
record.addQuery('number', 'like', 'TSK');
record.addQuery('subject', 'startswith', 'Email');
record.query(() => {
    while (record.next()) {
        console.log(record.number); // TSK0000128
    }
});

deleteRecord(responseFunction)

Используйте этот метод для удаления текущей записи.

Параметры:

Возвращаемое значение:

Пример:

const taskRecord = new SimpleRecord('task');
taskRecord.get('123456789012345678', () => {
    taskRecord.deleteRecord(callback);
});

function callback(response) {
    const answer = response.responseXML.documentElement.getAttribute('answer');
    if (answer == '1') {
        console.log('Запись удалена');
    } else {
        console.log(answer);
    }
}

get(recordId, callback)

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

Параметры:

Возвращаемое значение:

Пример:

const record = new SimpleRecord('user');
record.get(s_user.userID, () => {
    console.log(record.email); // admin@admin.ru
});

getTableName()

Данный метод возвращает название текущей страницы. 

Возвращаемое значение:

Пример:

const record = new SimpleRecord('user');
record.get(s_user.userID, () => {
    console.log(record.getTableName()); // user
});

hasNext()

Используйте этот метод, чтобы определить, существуют ли еще записи в этой выборке.

Возвращаемое значение:

Пример:

const record = new SimpleRecord('user');
record.get(s_user.userID, () => {
    console.log(record.hasNext()); // true
});

insert(responseFunction)

Используйте данный метод, чтобы добавить новую запись.

Параметры:

Возвращаемое значение:

Пример:

const newRecord = new SimpleRecord('task');
newRecord.subject = 'Client-side insert';
newRecord.insert((response) => {
    const answer = response.responseXML.documentElement.getAttribute('answer');
    console.log(answer);
})

next()

Используйте этот метод для перехода к следующей записи.

Возвращаемое значение:

Пример:

const record = new SimpleRecord('task');
record.addQuery('number', 'like', 'TSK');
record.addQuery('subject', 'startswith', '[SWD-10');
record.query(() => {
    while (record.next()) {
        console.log(record.number); // TSK0000128
    }
});

orderBy(column)

Используйте данный метод, чтобы указать столбец для упорядочивания. Вызывайте метод несколько раз для того, чтобы упорядочить записи по нескольким столбцам. 

Параметры:

Возвращаемое значение:

Пример:

const record = new SimpleRecord('task');
record.addQuery('number', 'like', 'TSK');
record.orderBy('number');
record.query(() => {
    while (record.next()) {
        console.log(record.number); // >TSK0000128  >TSK0000129  >TSK0000130 ...
    }
});

query(callback)

Этот метод выполняет запрос с 0 и более параметров в любом порядке. Он использует любую пару литералов как пару запроса (поле:значение) и любую функцию как функцию ответа.

Не создавайте синхронный вызов запросов. Вызов становится синхронным, если запрос выполняется без функции ответа. В этом случае счет не отображается, пока не появится ответ на запрос.

Параметры:

Возвращаемое значение:

Пример:

const record = new SimpleRecord('user');
record.addQuery('sys_id', s_user.userID);
record.query(() => {
    if (record.next()) {
        console.log(record.email); // admin@admin.ru
    }
});

setLimit(maxQuery)

Используйте этот метод, чтобы установить количество записей в запросе.

Параметры:

Возвращаемое значение:

Пример:

const record = new SimpleRecord('task');
record.addQuery('number', 'like', 'TSK');
record.orderBy('sys_created_at'); // very first record
record.setLimit(1);
record.query(() => {
    while (record.next()) {
        console.log(record.number); // TSK0000002 
        //...
    }
});

setValue(fieldName, value)

Используйте этот метод, чтобы задать значение поля.

Параметры:

Возвращаемое значение:

Пример:

const record = new SimpleRecord('task');
record.setValue('subject', 'Another type of prop assignement');
record.insert((response) => {
    const answer = response.responseXML.documentElement.getAttribute('answer');
    console.log(answer);
})