A1sQ — запросы от текста до готовых данных

// Намерение: Создаёт Fluent-обёртку для работы с запросами.
// Граница: Обязательных параметров нет; все параметры необязательны (2).
// Результат: DataProcessor.A1sDP_Q.

// Способ 1: Пустая обёртка + Builder
ТЗ = A1sQ.On()
    .Select("Ссылка, Наименование")
    .From("Справочник.Номенклатура")
    .Where("НЕ ПометкаУдаления")
    .WhereEq("Родитель", РодительСсылка)
    .OrderBy("Наименование")
    .Top(100)
    .Unload();
// Способ 2: С готовым текстом запроса
ТЗ = A1sQ.On("ВЫБРАТЬ * ИЗ Справочник.Номенклатура ГДЕ Родитель = &Parent")
    .Param("Parent", РодительСсылка)
    .Unload();
// Способ 3: С TempTablesManager
TTM = A1sQ.GetTemps();
A1sQ.On(TTM)
    .Text("ВЫБРАТЬ * ПОМЕСТИТЬ ВТ_Данные ИЗ Справочник.Номенклатура")
    .Execute();
ВТ_Данные = A1sQ.UnloadTemp(TTM, "ВТ_Данные");
// Способ 4: Проверка существования
Если A1sQ.On()
    .Select("Ссылка")
    .From("Справочник.Номенклатура")
    .WhereEq("Наименование", "Товар")
    .Exists() Тогда ...
// Способ 5: Получение скаляра
Количество = A1sQ.On()
// … пример сокращён; полная сигнатура и контракт сохранены

// Намерение: Создаёт объект Query и задаёт текст и менеджер временных таблиц.
// Граница: Обязательных параметров нет; все параметры необязательны (2).
// Результат: Query.

q = A1sQ.CreateQ("SELECT * FROM Справочник.Номенклатура");

// Намерение: Создаёт объект Query, устанавливает текст, менеджер временных таблиц и параметры. При включенном AutoTemps создаёт TempTablesManager, если в тексте запроса есть ключевые слова (например, ПОМЕСТИТЬ или INTO).
// Граница: Обязательных параметров нет; все параметры необязательны (11).
// Результат: Query.

Результат = A1sQ.NewQ();

// Намерение: Упрощённая обёртка для NewQ с автоматическим TempTablesManager (если есть ПОМЕСТИТЬ/INTO).
// Граница: Обязательные параметры: QueryText
// Результат: Query.

Простое создание
q = A1sQ.NewQ("ВЫБРАТЬ * ИЗ Справочник.Номенклатура");
Пример 2: С параметром
q = A1sQ.NewQ("ВЫБРАТЬ * ИЗ Справочник.Номенклатура ГДЕ Ссылка = &Ref", , RefValue);
Пример 3: Авто TempTablesManager по ключевым словам
q = A1sQ.NewQ("ВЫБРАТЬ ... ПОМЕСТИТЬ ВТ_Товары", , , , , , , , , Истина);
Пример 4: Использование короткой обёртки Q
q = A1sQ.Q("ВЫБРАТЬ ... ПОМЕСТИТЬ ВТ_Результат", Параметр);
Пример 5: Явное указание TempTablesManager
tmp = A1sQ.GetTemps();
q = A1sQ.NewQ("ВЫБРАТЬ * ИЗ ВТ_Данные ГДЕ Поле = &Value", tmp, "TestValue");
Пример 6: Несколько параметров
q = A1sQ.NewQ("ВЫБРАТЬ * ИЗ Таблица ГДЕ Поле1 = &P1 И Поле2 = &P2", , Value1, Value2);

// Намерение: Быстрая проверка синтаксиса запроса через QueryWizard.
// Граница: Обязательные параметры: QueryText
// Результат: Boolean.

Успешно = A1sQ.IsValid("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура");

// Намерение: Проверяет запрос с выводом ошибки при необходимости.
// Граница: Обязательные параметры: QueryText
// Результат: Boolean.

использования:
If A1sQ.Validate("ВЫБРАТЬ * ИЗ Справочник.Номенклатура") Then
    A1sS.Print("Запрос корректен");
Else
    A1sS.Print("Запрос содержит ошибки");
EndIf;

// Намерение: Создаёт Query с автоматическим созданием TempTablesManager.
// Граница: Обязательных параметров нет; все параметры необязательны (2).
// Результат: Query.

Результат = A1sQ.CreateQWithTemps();

// Намерение: Создаёт Query, использующий существующий TempTablesManager из другого Query.
// Граница: Обязательные параметры: QueryText, SourceQuery
// Результат: Query.

Результат = A1sQ.CreateAndLoad("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура", SourceQuery);

// Намерение: Улучшенная версия CreateQ с дополнительными проверками TempTablesManager.
// Граница: Обязательных параметров нет; все параметры необязательны (3).
// Результат: Query.

Автоматическое создание TempTablesManager
q1 = A1sQ.CreateQWithTemps("SELECT 1 AS Field INTO TempTable");
Пример 2: Разделение TempTablesManager между запросами
q1 = A1sQ.CreateQWithTemps("SELECT 1 AS ID INTO TempTable");
q2 = A1sQ.CreateAndLoad("SELECT * FROM TempTable", q1);
Пример 3: Улучшенное создание с автоматическим менеджером
q = A1sQ.CreateQEnhanced("SELECT * FROM TempTable", , True);

// Намерение: Создаёт Query с предварительной проверкой синтаксиса запроса.
// Граница: Обязательных параметров нет; все параметры необязательны (3).
// Результат: Query.

Результат = A1sQ.CreateQSafe();

// Намерение: Возвращает массив параметров у Query.
// Граница: Обязательные параметры: Query
// Результат: Array.

q = A1sQ.CreateQ("SELECT * FROM Таблица WHERE Поле = &Val");
q = A1sQ.NewQ("SELECT * FROM Таблица WHERE Поле = &Val");
params = A1sQ.GetParams(q, True);

// Намерение: Извлекает имена параметров из текста запроса (&Param).
// Граница: Обязательные параметры: QueryText
// Результат: Structure.

txt = "SELECT * FROM Т WHERE x=&X AND y=&Y";
st = A1sQ.GetQParams(txt);
// st содержит {X:Undefined, Y:Undefined}

// Намерение: Формирует структуру параметров по списку ключей и до 8 значений.
// Граница: Обязательные параметры: KeyString
// Результат: Structure.

st = A1sQ.ParseParams("X,Y","a","b");
// st={X:"a", Y:"b"}

// Намерение: Устанавливает в Query параметры из структуры.
// Граница: Обязательные параметры: Query
// Результат: Query.

q = A1sQ.CreateQ(txt);
q2 = A1sQ.SetQParams(q, Новый Структура("X,Y",1,2));

// Намерение: Создаёт Query, анализирует параметры и присваивает им значения.
// Граница: Обязательные параметры: QueryText, KeyString
// Результат: Query.

@example.1.A1sQ.BuildQ {
q = A1sQ.BuildQ("SELECT * FROM T WHERE f=&F",123);
}
@example.2.A1sQ.BuildQ {
q = A1sQ.BuildQ("SELECT * FROM T WHERE a=&A AND b=&B",1,2);
}

// Намерение: Выполняет запрос и возвращает выборку.
// Граница: Обязательные параметры: QueryText
// Результат: Selection.

@example.1.A1sQ.BuildQ {
/ Текст запроса
QueryText =
"ВЫБРАТЬ
|	АктивностьСеансовПользователей.ИдентификаторЗаданияДляОстановки КАК ИдентификаторЗаданияДляОстановки,
|	АктивностьСеансовПользователей.ДатаПоследнейАктивностиУниверсальная КАК ДатаПоследнейАктивностиУниверсальная
|ИЗ
|	РегистрСведений.АктивностьСеансовПользователей КАК АктивностьСеансовПользователей
|ГДЕ
|	АктивностьСеансовПользователей.Организация = &Организация
|	И АктивностьСеансовПользователей.Пользователь = &Пользователь";
/ Создание запроса с параметрами
Query = BuildQ(QueryText, Источник.Организация, ТекущийПользователь);
/ Выполнение запроса
Выборка = Query.Выполнить().Выбрать();
@example.1.A1sQ.BuildQ }

// Намерение: Автоматически определяет необходимость экранирования параметров в запросе.
// Граница: Обязательные параметры: QueryText, Parameters
// Результат: Structure.

Данные = A1sQ.ProcessQueryParams("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура", Параметры);

// Намерение: Выполняет запрос и возвращает выборку.
// Граница: Обязательные параметры: QueryText
// Результат: Selection.

@example.1.A1sQ.ExecuteQ {
/ Текст запроса
QueryText =
"ВЫБРАТЬ
|	АктивностьСеансовПользователей.ИдентификаторЗаданияДляОстановки КАК ИдентификаторЗаданияДляОстановки,
|	АктивностьСеансовПользователей.ДатаПоследнейАктивностиУниверсальная КАК ДатаПоследнейАктивностиУниверсальная
|ИЗ
|	РегистрСведений.АктивностьСеансовПользователей КАК АктивностьСеансовПользователей
|ГДЕ
|	АктивностьСеансовПользователей.Организация = &Организация
|	И АктивностьСеансовПользователей.Пользователь = &Пользователь";
/ Выполнение запроса с параметрами
Выборка = ExecuteQ(QueryText, Источник.Организация, ТекущийПользователь);
@example.1.A1sQ.ExecuteQ }

// Намерение: Возвращает первую строку из выборки запроса.
// Граница: Обязательные параметры: Selection
// Результат: Variant.

s = A1sQ.ExecuteQ("ВЫБРАТЬ 1 КАК Число"); //▶️
r = A1sS.FirstRow(s); //▶️
If r <> Undefined Then //⚡
    A1sS.Print("Первое значение: " + r.Число); //▶️
EndIf;

// Намерение: Выполняет запрос и возвращает первую строку выборки или Undefined.
// Граница: Обязательные параметры: QueryText
// Результат: Selection.

row = A1sQ.FirstRowQ("ВЫБРАТЬ ПЕРВЫЕ 1 Ссылка ИЗ Справочник.Пользователи ГДЕ ИдентификаторПользователяИБ = &UID", UserUID);
Пользователь = ?(row = Undefined, Справочники.Пользователи.ПустаяСсылка(), row.Ссылка);

// Намерение: Выполняет запрос и возвращает единственное значение из первой строки и первого столбца.
// Граница: Обязательные параметры: QueryText
// Результат: Variant.

Count = A1sQ.ValueQ("ВЫБРАТЬ КОЛИЧЕСТВО(*) ИЗ Справочник.Номенклатура", 0);
MaxDate = A1sQ.ValueQ("ВЫБРАТЬ МАКСИМУМ(Дата) ИЗ Документ.Продажа", '00010101');

// Намерение: Безопасное выполнение запроса с автоэкранированием.
// Граница: Обязательные параметры: QueryText
// Результат: Selection.

Результат = A1sQ.ExecuteQSafe("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура");

// Намерение: Безопасная выгрузка с автоэкранированием.
// Граница: Обязательные параметры: QueryText
// Результат: ValueTable.

Таблица = A1sQ.UnloadSafe("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура");

// Намерение: Проверяет существование записей по запросу (оптимизированная версия IsNotEmptyResult).
// Граница: Обязательные параметры: QueryText
// Результат: Boolean.

If A1sQ.ExistsQ("ВЫБРАТЬ * ИЗ Справочник.Номенклатура ГДЕ Наименование = &Name", "Товар") Then
    Message("Товар найден");
EndIf;

// Намерение: Выполняет запрос подсчета количества записей.
// Граница: Обязательные параметры: QueryText
// Результат: Number.

По имени таблицы
Count = A1sQ.CountQ("Справочник.Номенклатура", "НЕ ПометкаУдаления");
Пример 2: По готовому запросу
Count = A1sQ.CountQ("ВЫБРАТЬ КОЛИЧЕСТВО(*) ИЗ Справочник.Номенклатура ГДЕ Родитель = &Parent", , ParentRef);

// Намерение: Получает структуру полей таблицы или временной таблицы через запрос без строк.
// Граница: Обязательные параметры: TableName
// Результат: ValueTable.

Таблица = A1sQ.GetTableStructure("Справочник.Номенклатура");

// Намерение: Возвращает СписокЗначений из результата запроса.
// Граница: Обязательные параметры: QueryText
// Результат: ValueList.

Результат = A1sQ.ValuesQ("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура");

// Намерение: Выполняет запрос и выгружает выбранную колонку в массив.
// Граница: Обязательные параметры: QueryText
// Результат: Array.

Массив = A1sQ.ArrayQ("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура");

// Намерение: Выполняет запрос и формирует структуру ключ → значение.
// Граница: Обязательные параметры: QueryText
// Результат: Structure.

Данные = A1sQ.StructureQ("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура");

// Намерение: Выполняет запрос и формирует соответствие ключ → значение.
// Граница: Обязательные параметры: QueryText
// Результат: Map.

Данные = A1sQ.MapQ("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура");

// Намерение: Группирует строки результата по значению указанного поля.
// Граница: Обязательные параметры: QueryText, GroupField
// Результат: Structure.

Данные = A1sQ.GroupedQ("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура", "Наименование");

// Намерение: Выполняет несколько независимых запросов последовательно и возвращает результаты в структуре. Внимание: запросы выполняются по отдельности, временные таблицы между ними не доступны! Для выполнения настоящих пакетных запросов (с ВТ) используйте UnloadBatch.
// Граница: Обязательные параметры: QueriesMap
// Результат: Structure.

Queries = New Structure;
Queries.Insert("Товары", "ВЫБРАТЬ * ИЗ Справочник.Номенклатура ГДЕ Родитель = &Parent");
Queries.Insert("Услуги", "ВЫБРАТЬ * ИЗ Справочник.Номенклатура ГДЕ ЭтоГруппа = ЛОЖЬ И ВидНоменклатуры = &ServiceType");

Params = New Structure;
Params.Insert("Parent", ParentRef);
Params.Insert("ServiceType", ServiceTypeRef);

Results = A1sQ.UnloadMultiple(Queries, Params);
// Results.Товары - таблица товаров
// Results.Услуги - таблица услуг

// Намерение: Проверяет, что результат запроса пуст.
// Граница: Обязательные параметры: QueryText
// Результат: Boolean.

If IsEmptyResult("ВЫБРАТЬ ПЕРВЫЕ 1 * ИЗ Справочник.Номенклатура ГДЕ Наименование = &Наименование", "Тестовая номенклатура") Then
   // Выборка пуста, записи не найдены
   Сообщить("Записи с таким наименованием не найдены.");
Else
   // Выборка содержит данные
   Сообщить("Записи с таким наименованием найдены.");
EndIf

// Намерение: Проверяет, что результат запроса не пуст.
// Граница: Обязательные параметры: QueryText
// Результат: Boolean.

If IsNotEmptyResult("ВЫБРАТЬ ПЕРВЫЕ 1 * ИЗ Справочник.Номенклатура ГДЕ Наименование = &Наименование", "Тестовая номенклатура") Then
   // Выборка не пуста, записи найдены
   Сообщить("Записи с таким наименованием найдены.");
Else
   // Выборка пуста, записи не найдены
   Сообщить("Записи с таким наименованием не найдены.");
EndIf

// Намерение: Выполняет запрос и выгружает таблицу значений.
// Граница: Обязательные параметры: QueryText
// Результат: ValueTable.

Таблица = A1sQ.Unload("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура");

// Намерение: Проверяет, пуста ли ТаблицаЗначений.
// Граница: Обязательные параметры: Data
// Результат: Boolean.

Пустая таблица
vt = Новый ТаблицаЗначений;
A1sS.Print(IsEmptyTable(vt)); // TRUE
Пример 2: Таблица с данными
vt = Новый ТаблицаЗначений;
vt.Колонки.Добавить("Число");
r = vt.Добавить(); r.Число = 1;
A1sS.Print(IsEmptyTable(vt)); // FALSE

// Намерение: Выгружает из результата запроса один столбец в массив.
// Граница: Обязательные параметры: QueryText, ColumnName
// Результат: Array.

/ Текст запроса
QueryText =
"ВЫБРАТЬ
|  Хозрасчетный.Ссылка КАК СчетУчета
|ИЗ
|  ПланСчетов.Хозрасчетный КАК Хозрасчетный
|ГДЕ
|  НЕ Хозрасчетный.ЗапретитьИспользоватьВПроводках
|  И Хозрасчетный.Ссылка В ИЕРАРХИИ(&СчетаУчета)
|  И НЕ Хозрасчетный.Ссылка В ИЕРАРХИИ (&СчетаИсключений)
|
|УПОРЯДОЧИТЬ ПО
|  Хозрасчетный.Порядок";
/ Выгрузка колонки
ColumnValues = UnloadColumn(QueryText, "СчетУчета", СчетаУчета, СчетаИсключений);
/ Пример использования результата
Для Каждого Значение Из ColumnValues Цикл
   Сообщить(Значение);
КонецЦикла;

// Намерение: Универсальная функция поиска с автоматическим построением условий.
// Граница: Обязательные параметры: TableName, SearchFields, SearchString
// Результат: Structure.

Данные = A1sQ.BuildSearchQuery("Справочник.Номенклатура", "Наименование", "молоко");

// Намерение: Выполняет поиск и возвращает ValueList для выбора.
// Граница: Обязательные параметры: TableName, SearchFields, ValueField, PresentationField, SearchString
// Результат: ValueList.

Результат = A1sQ.SearchForChoice("Справочник.Номенклатура", "Наименование", "Наименование", "Наименование", "молоко");

// Намерение: Автоматизированная функция для ОбработкаПолученияДанныхВыбора.
// Граница: Обязательные параметры: TableName, SearchFields, PresentationFields, SearchParams
// Результат: ValueList.

Результат = A1sQ.AutoChoiceData("Справочник.Номенклатура", "Наименование", "Наименование", Параметры);

// Намерение: Упрощённая функция для стандартной ОбработкаПолученияДанныхВыбора. Использовать в процедуре: ДанныеВыбора = A1sQ.StandardChoiceProcessing(Параметры, "Справочник.Номенклатура", "Наименование", "Наименование, Артикул");
// Граница: Обязательные параметры: Parameters, TableName, SearchFields, PresentationFields
// Результат: ValueList.

Результат = A1sQ.StandardChoiceProcessing(Параметры, "Справочник.Номенклатура", "Наименование", "Наименование");

// Намерение: Быстрый поиск по справочнику с минимальными параметрами.
// Граница: Обязательные параметры: CatalogName, SearchString
// Результат: ValueList.

Результат = A1sQ.QuickCatalogSearch("Номенклатура", "молоко");

// Намерение: Быстрый поиск по документу.
// Граница: Обязательные параметры: DocumentName, SearchString
// Результат: ValueList.

Результат = A1sQ.QuickDocumentSearch("РеализацияТоваровУслуг", "молоко");

// Намерение: Примеры использования новых функций поиска.
// Граница: Параметров нет.
// Результат: —.

A1sQ.ShowSearchExamples();

// Намерение: Цепочка запросов с передачей TempTablesManager между ними.
// Граница: Обязательные параметры: Queries
// Результат: Array.

QueriesArray = New Array;
QueriesArray.Add(New Structure("Text", "ВЫБРАТЬ * ИЗ Справочник.Номенклатура ПОМЕСТИТЬ ВТ_Товары"));
QueriesArray.Add(New Structure("Text,Params", "ВЫБРАТЬ * ИЗ ВТ_Товары ГДЕ Родитель = &Parent", New Structure("Parent", ParentRef)));
Results = A1sQ.ChainQ(QueriesArray, True);

// Намерение: Конструктор запросов в fluent-стиле.
// Граница: Обязательные параметры: Fields
// Результат: QueryBuilder.

Построитель = A1sQ.Select("Ссылка, Наименование");

// Намерение: Устанавливает источник данных для QueryBuilder.
// Граница: Обязательные параметры: Builder, TableName
// Результат: QueryBuilder.

Построитель = A1sQ.From(Построитель, "Справочник.Номенклатура");

// Намерение: Добавляет условие WHERE для QueryBuilder.
// Граница: Обязательные параметры: Builder, Condition
// Результат: QueryBuilder.

Построитель = A1sQ.Where(Построитель, "НЕ ПометкаУдаления");

// Намерение: Добавляет параметр для QueryBuilder.
// Граница: Обязательные параметры: Builder, ParamName, ParamValue
// Результат: QueryBuilder.

Построитель = A1sQ.WithParam(Построитель, "Родитель", Родитель);

// Намерение: Добавляет сортировку для QueryBuilder.
// Граница: Обязательные параметры: Builder, OrderFields
// Результат: QueryBuilder.

Построитель = A1sQ.OrderBy(Построитель, "Наименование");

// Намерение: Добавляет ограничение ПЕРВЫЕ для QueryBuilder.
// Граница: Обязательные параметры: Builder, Count
// Результат: QueryBuilder.

Построитель = A1sQ.Top(Построитель, 20);

// Намерение: Строит и выполняет запрос из QueryBuilder.
// Граница: Обязательные параметры: Builder
// Результат: Query.

fluent-стиля:
Query = A1sQ.Select("Ссылка, Наименование")
           .From("Справочник.Номенклатура")
           .Where("НЕ ПометкаУдаления")
           .Where("Родитель = &Parent")
           .WithParam("Parent", ParentRef)
           .OrderBy("Наименование")
           .Top("10")
           .Build();

Result = Query.Execute().Unload();

// Намерение: Постраничное выполнение запроса.
// Граница: Обязательные параметры: QueryText, PageSize, PageNumber
// Результат: Structure.

Page = A1sQ.PagedUnload(
    "ВЫБРАТЬ Ссылка, Наименование ИЗ Справочник.Номенклатура ГДЕ НЕ ПометкаУдаления",
    20,  // размер страницы
    1    // первая страница
);

Message("Найдено записей: " + Page.Total);
Message("Есть еще страницы: " + Page.HasMore);
// Page.Data содержит ValueTable с результатами

// Намерение: Экспорт результата запроса в JSON.
// Граница: Обязательные параметры: QueryText
// Результат: String.

JSON = A1sQ.UnloadToJSON("ВЫБРАТЬ Ссылка, Наименование ИЗ Справочник.Валюты ГДЕ НЕ ПометкаУдаления");
A1sS.Print(JSON);

// Намерение: Профилировщик запросов - измеряет время выполнения.
// Граница: Обязательные параметры: QueryText
// Результат: Structure.

Profile = A1sQ.ProfiledUnload(
    "ВЫБРАТЬ * ИЗ Справочник.Номенклатура ГДЕ Родитель = &Parent",
    "LoadNomenclature",
    ParentRef
);

If Profile.Duration > 1000 Then
    Message("Медленный запрос: " + Profile.Duration + "мс");
EndIf;

// Намерение: Выгружает из TempTablesManager одну временную таблицу по имени.
// Граница: Обязательные параметры: TempManager, TableName
// Результат: ValueTable.

Таблица = A1sQ.UnloadTemp(МенеджерВТ, "Справочник.Номенклатура");

// Намерение: Выгружает все временные таблицы из TempTablesManager в структуру.
// Граница: Обязательные параметры: TempManager
// Результат: Structure.

@example.1.A1sQ.Unload {
/ Текст запроса
QueryText =
"ВЫБРАТЬ
|	АктивностьСеансовПользователей.ИдентификаторЗаданияДляОстановки КАК ИдентификаторЗаданияДляОстановки,
|	АктивностьСеансовПользователей.ДатаПоследнейАктивностиУниверсальная КАК ДатаПоследнейАктивностиУниверсальная
|ИЗ
|	РегистрСведений.АктивностьСеансовПользователей КАК АктивностьСеансовПользователей
|ГДЕ
|	АктивностьСеансовПользователей.Организация = &Организация
|	И АктивностьСеансовПользователей.Пользователь = &Пользователь";
/ Выполнение запроса с параметрами и выгрузка данных
ТаблицаЗначений = Unload(QueryText, Источник.Организация, ТекущийПользователь);
@example.1.A1sQ.Unload }

// Намерение: Возвращает новый менеджер временных таблиц для использования в нескольких запросах.
// Граница: Параметров нет.
// Результат: TempTablesManager.

МенеджерВТ = A1sQ.GetTemps();

// Намерение: Создаёт временную таблицу из ТаблицыЗначений и возвращает её имя.
// Граница: Обязательные параметры: TTManager, Table
// Результат: String | Undefined.

Результат = A1sQ.TT_Create(МенеджерВТ, Таблица);

// Намерение: Возвращает пустую ТаблицуЗначений со схемой колонок временной таблицы.
// Граница: Обязательные параметры: TTManager, TTName
// Результат: ValueTable.

Таблица = A1sQ.TT_Columns(МенеджерВТ, "TTName");

// Намерение: Проверяет наличие временной таблицы в менеджере.
// Граница: Обязательные параметры: TTManager, TTName
// Результат: Boolean.

Успешно = A1sQ.TT_Exists(МенеджерВТ, "TTName");

// Намерение: Проверяет наличие одной колонки во временной таблице.
// Граница: Обязательные параметры: TTManager, TTName, ColumnName
// Результат: Boolean.

Успешно = A1sQ.TT_HasColumn(МенеджерВТ, "TTName", "Наименование");

// Намерение: Проверяет наличие набора колонок во временной таблице.
// Граница: Обязательные параметры: TTManager, TTName, ColumnNamesStr
// Результат: Boolean.

Успешно = A1sQ.TT_HasColumns(МенеджерВТ, "TTName", "Наименование");

// Намерение: Гарантированно очищает (FASTTRUNCATE) одну временную таблицу.
// Граница: Обязательные параметры: TempManager, TableName
// Результат: Boolean.

Успешно = A1sQ.DestroyTemp(МенеджерВТ, "Справочник.Номенклатура");

// Намерение: Гарантированно очищает (FASTTRUNCATE) все временные таблицы в менеджере.
// Граница: Обязательные параметры: TempManager
// Результат: Boolean.

Успешно = A1sQ.DestroyAllTemps(МенеджерВТ);

// Намерение: Очищает все временные таблицы и сбрасывает TempTablesManager, освобождая ресурсы.
// Граница: Обязательные параметры: Знач TempManager
// Результат: —.

A1sQ.ResetTempManager(МенеджерВТ);

// Намерение: Собирает запрос через QT и устанавливает параметры.
// Граница: Обязательные параметры: Fields, FromWhere
// Результат: Query.

q = A1sQ.BuildByQT("Ссылка", "Справочник.Номенклатура", "Наименование = &Имя", "Товар");

// Намерение: Выполняет запрос, собранный через QT.
// Граница: Обязательные параметры: Fields, FromWhere
// Результат: Selection.

s = A1sQ.ExecuteByQT("Ссылка", "Справочник.Номенклатура", "ПометкаУдаления = ЛОЖЬ");

// Намерение: Выполняет QT-запрос и выгружает таблицу значений.
// Граница: Обязательные параметры: Fields, FromWhere
// Результат: ValueTable.

ТЗ = A1sQ.UnloadByQT("Ссылка", "Справочник.Номенклатура", "Наименование = &Имя", "Товар 1");

// Намерение: Быстрая сборка текста запроса: SELECT WhatToSelect FROM FromWhereSelect [WHERE Condition].
// Граница: Обязательные параметры: WhatToSelect, FromWhereSelect
// Результат: String.

Текст = A1sQ.QT("Ссылка, Наименование", "Справочник.Номенклатура", "НЕ ПометкаУдаления");

// Намерение: Экранирует специальные символы для оператора LIKE.
// Граница: Обязательные параметры: SearchString
// Результат: String.

БезопасныйФрагмент = A1sQ.EscapeLike("100% молоко");

// Намерение: Формирует текст разделителя между частями запроса.
// Граница: Параметров нет.
// Результат: String.

Разделитель = A1sQ.QuerySeparator();

// Намерение: Формирует текст оператора UNION ALL между двумя запросами.
// Граница: Обязательных параметров нет; все параметры необязательны (2).
// Результат: String.

Текст = A1sQ.CombineQT(ЧастиЗапроса);

// Намерение: Формирует шаблон LIKE с процентами и экранированием.
// Граница: Обязательные параметры: SearchString
// Результат: String.

Шаблон = A1sQ.LikePattern("молоко", "Contains");

// Намерение: Собирает текст условия WHERE из массива строк-условий. Фильтрует пустые строки, чтобы избежать некорректных конструкций типа "ГДЕ И ".
// Граница: Обязательные параметры: ConditionsArray
// Результат: String.

Текст = A1sQ.BuildWhere("НЕ ПометкаУдаления");

// Намерение: Проверяет наличие реквизита в табличной части метаданных.
// Граница: Обязательные параметры: Metadata, TPName, FieldName
// Результат: Boolean.

Успешно = A1sQ.TP_HasField(Параметры, "Товары", "Наименование");

// Намерение: Возвращает массив имён реквизитов табличной части.
// Граница: Обязательные параметры: Metadata, TPName
// Результат: Array.

Массив = A1sQ.TP_Fields(Параметры, "Товары");

// Намерение: Проверяет, что строка табличной части содержит все необходимые реквизиты и обязательные поля заполнены.
// Граница: Обязательные параметры: Metadata, TPName, Row
// Результат: Boolean.

Проверка строки с обязательными полями "Номенклатура,Количество"
Строка = Новый Структура("Номенклатура,Количество", "Товар1", 5);
Результат = A1sQ.TP_ValidateFields(Метаданные.Документы.ЗаказПокупателя, "Товары", Строка, "Номенклатура,Количество");
Ожидается Истина
Пример 2: Обязательное поле "Количество" не заполнено
Строка2 = Новый Структура("Номенклатура,Количество", "Товар1", Неопределено);
Результат2 = A1sQ.TP_ValidateFields(Метаданные.Документы.ЗаказПокупателя, "Товары", Строка2, "Номенклатура,Количество");
Ожидается Ложь
Пример 3: Отсутствует поле "Цена"
Строка3 = Новый Структура("Номенклатура,Количество", "Товар1", 10);
Результат3 = A1sQ.TP_ValidateFields(Метаданные.Документы.ЗаказПокупателя, "Товары", Строка3, "Номенклатура,Количество,Цена");
Ожидается Ложь

// Намерение: Возвращает описание типа реквизита табличной части.
// Граница: Обязательные параметры: Metadata, TPName, FieldName
// Результат: TypeDescription | Undefined.

Результат = A1sQ.TP_GetFieldType(Параметры, "Товары", "Наименование");

// Намерение: Выполняет тесты функций временных таблиц TT_*.
// Граница: Параметров нет.
// Результат: —.

A1sQ.Тест_TT_Функции();

// Намерение: Выполняет тесты функций метаданных табличных частей TP_*.
// Граница: Параметров нет.
// Результат: —.

A1sQ.Тест_TP_Функции();

// Намерение: Выполняет тесты для A1sQ.
// Граница: Параметров нет.
// Результат: Boolean.

Успешно = A1sQ.SelfTest();

// Намерение: Самотестирование функций ByQT (Build/Execute/Unload).
// Граница: Параметров нет.
// Результат: Boolean.

Успешно = A1sQ.SelfTest_ByQT();

// Намерение: Формирует текст запроса для получения остатков по указанному бухгалтерскому регистру и дополнительному условию.
// Граница: Обязательных параметров нет; все параметры необязательны (2).
// Результат: String.

стандартный остаток за период
txt = A1sA.GetBalancesQueryText("", "Хозрасчетный");
Message(txt);
Пример 2: с дополнительным условием (по складу)
condition = "И Остатки.Склад = &Склад";
txt = A1sA.GetBalancesQueryText(condition, "Хозрасчетный");
Message(txt);

// Намерение: Выполняет пакет запросов и возвращает массив выборок (Selection).
// Граница: Обязательные параметры: QueryText
// Результат: Array.

Массив = A1sQ.ExecuteBatch("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура");

// Намерение: Выполняет пакет запросов и выгружает каждый результат в таблицу значений.
// Граница: Обязательные параметры: QueryText
// Результат: Array.

Массив = A1sQ.UnloadBatch("ВЫБРАТЬ Ссылка ИЗ Справочник.Номенклатура");

// Намерение: Универсальная функция для выборки документов по сложным условиям. Позволяет получить ссылки на документы одного или нескольких видов за указанный период с дополнительными фильтрами.
// Граница: Обязательные параметры: DocumentTypes, StartDate, EndDate
// Результат: Array.

Массив = A1sQ.SelectDocs(Документ, StartDate, EndDate);

// Намерение: Универсальная функция для выборки элементов справочника по условиям. Позволяет получить ссылки на элементы справочника с использованием гибких фильтров.
// Граница: Обязательные параметры: CatalogName
// Результат: Array.

Массив = A1sQ.SelectCatalogItems("Номенклатура");