Список версий МТ

Главная

api.sql

Работа с SQL запросами к базе данных

//Пример занесения данных в кеш
function salesId_qm10() {
    var rows = [];
    //строка запроса
    var strQuery = "\n" +
    "SELECT dj.id \n" +
    "FROM [DocJournal] dj \n" +
    "INNER JOIN [drSales] dr ON dr.[idDoc] = dj.[id]\n" +
    "WHERE dr.[Quantity] > 10 \n";
    if (api.sql.exec(strQuery)){
        rows = api.sql.rows();
    }
    return rows;
}

Methods

api.sql.exec(str) → Boolean
api.sql.field(index) → String
api.sql.fieldCount() → Number
api.sql.first() → Boolean
api.sql.isError() → Boolean
api.sql.last() → Boolean
api.sql.next() → Boolean
api.sql.rows() → Array.<Object>
api.sql.value(nameOrIndex) → *
api.sql.valueToBool(nameOrIndex) → Boolean
api.sql.valueToDateTime(nameOrIndex) → Date
api.sql.valueToId(nameOrIndex) → ID
api.sql.valueToInt(nameOrIndex) → Number
api.sql.valueToReal(nameOrIndex) → Number
api.sql.valueToString(nameOrIndex) → String

Methods description

exec(str) → Boolean

Выполнить запрос

 ВНИМАНИЕ: строка SQL запроса должна начинаться с SQL команды (SELECT, UPDATE и т.д.)

Parameters:
Name Type Description
str String

SQL запрос
Return:
Boolean -

Признак успешности выполнения запроса

field(index) → String

Название поля

Parameters:
Name Type Description
index Number

Номер поля
Return:
String -

Название поля

fieldCount() → Number

Количество полей в текущей записи

Return:
Number

first() → Boolean

Установить текущей первую запись из результата запроса

Return:
Boolean -

Признак успешности выполнения

isError() → Boolean

Признак появления ошибки

Return:
Boolean

last() → Boolean

Установить текущей последнюю запись из результата запроса

Return:
Boolean -

Признак успешности выполнения

next() → Boolean

Установить текущей следующую запись из результата запроса

Return:
Boolean -

Признак успешности выполнения

rows() → Array.<Object>

Результат запроса

Return:
Array.<Object> -

Список записей

value(nameOrIndex) → *

Значение поля текущей записи

Parameters:
Name Type Description
nameOrIndex String | Number

Название или индекс поля
Return:
*

valueToBool(nameOrIndex) → Boolean

Значение поля текущей записи в логической форме

Parameters:
Name Type Description
nameOrIndex String | Number

Название или индекс поля
Return:
Boolean

valueToDateTime(nameOrIndex) → Date

Значение поля текущей записи в виде даты и времени

Parameters:
Name Type Description
nameOrIndex String | Number

Название или индекс поля
Return:
Date

valueToId(nameOrIndex) → ID

Значение поля текущей записи в виде ID

Parameters:
Name Type Description
nameOrIndex String | Number

Название или индекс поля
Return:
ID

valueToInt(nameOrIndex) → Number

Значение поля текущей записи в целочисленном виде

Parameters:
Name Type Description
nameOrIndex String | Number

Название или индекс поля
Return:
Number

valueToReal(nameOrIndex) → Number

Значение поля текущей записи в виде числа с плавающей точкой

Parameters:
Name Type Description
nameOrIndex String | Number

Название или индекс поля
Return:
Number

valueToString(nameOrIndex) → String

Значение поля текущей записи в виде строки

Parameters:
Name Type Description
nameOrIndex String | Number

Название или индекс поля
Return:
String