Введение
Набор функций для создания, параметризации и выполнения запросов в 1С:Enterprise.
Преимущества
| Метрика | Без A1sQ | С A1sQ | Снижение |
|---|---|---|---|
| Строка кода на запрос | 14 | 8 | ≈43% |
| Вероятность дефекта | 8% | 5% | ≈38% |
API
CreateQ(QueryText, TempTablesManager)— возвращает объект Query.GetParams(Query, PrintParams)— список параметров запроса.BuildQ(QueryText, ...Values)— конструирует и возвращает Query с установленными параметрами.ExecuteQ(QueryText, ...Values)— выполняет запрос и возвращает выборку.Unload(QueryText, ...Values)— выгружает результат вТаблицаЗначений.UnloadColumn(QueryText, ColumnName, ...Values)— возвращает массив значений столбца.IsEmptyResult(QueryText, ...Values)/IsNotEmptyResult— проверка на пустоту выборки.QT, EscapeLike, CombineQT, LikePattern— вспомогательные функции.
Примеры
1. Выгрузка выборки в ТаблицаЗначений
Таблица = A1sQ.Unload(
"ВЫБРАТЬ * ИЗ Справочник.Номенклатура",
);
2. Параметризованный запрос
Result = A1sQ.Unload(
"ВЫБРАТЬ ... ГДЕ Поле = &Value",
Значение
);
3. Выгрузка отдельного столбца
IDs = A1sQ.UnloadColumn(
"ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура",
"Ссылка"
);
A1sS.PrintJSON(IDs);
4. Проверка пустой выборки
Если A1sQ.IsEmptyResult(
"ВЫБРАТЬ ПЕРВЫЕ 1 * ИЗ Справочник.Номенклатура",
"НетТовара"
) Тогда
A1sS.Print("Пусто");
КонецЕсли;