Перевод перечисления в строку для запроса 1С: от теории к практике

Работа с перечислениями в запросах 1С часто сталкивается с необходимостью преобразовать набор значений в строку — будь то для условий В(), динамического формирования SQL-запроса или отладки. Классические методы вроде СтрСокрЛП() работают не всегда: они игнорируют пустые элементы, не учитывают экранирование символов и могут ломать синтаксис при вставке в запрос. В этой статье разберём 5 надёжных способов конвертации перечислений в строки, сравним их производительность и покажем, как избежать типичных ошибок при работе с динамическими запросами.

Особое внимание уделим нюансам: почему ВЫРАЗИТЬ() иногда возвращает неожиданные результаты, как правильно экранировать кавычки в строках для SQL, и почему использование функции СтрСоединить() без обработки пустых значений может привести к синтаксическим ошибкам в сложных запросах. Материал будет полезен как начинающим разработчикам 1С, так и опытным специалистам, оптимизирующим производительность систем с большими массивами данных.

Почему стандартные методы не всегда работают

На первый взгляд, задача кажется тривиальной: взять массив или перечисление и "склеить" его элементы в строку. Однако в контексте запросов 1С возникают подводные камни:

• 🔹 СтрСокрЛП() — пропускает пустые значения, что искажает логику условий В().
• 🔹 СтрСоединить() — не экранирует специальные символы (например, кавычки в строках).
• 🔹 Прямая вставка в запрос — может привести к SQL-инъекциям или ошибкам синтаксиса.
• 🔹 ВЫРАЗИТЬ() — не всегда корректно обрабатывает составные типы (например, СправочникСсылка.Номенклатура).

Рассмотрим пример: у вас есть массив кодов номенклатуры ["001", "002", "", "004"], который нужно передать в условие ГДЕ Номенклатура.Код В(...). Если использовать СтрСокрЛП(Массив, ","), результат будет "001,002,004" — пустое значение пропадёт, и запрос вернёт некорректные данные. А если в кодах есть кавычка (например, "O'Reilly"), то прямая вставка сломает SQL-синтаксис.

⚠️ Внимание: При работе с динамическими запросами в 1С:Предприятие 8.3.20+ учитывайте, что механизм ВЫРАЗИТЬ() может вести себя по-разному в зависимости от режима совместимости платформы. Проверяйте поведение в вашей версии!

Способ 1: СтрСоединить() с предварительной обработкой

Самый простой, но требующий осторожности метод. Подходит для массивов примитивных типов (строк, чисел), если в них гарантированно нет специальных символов.

МассивЗначений = Новый Массив();
МассивЗначений.Добавить("001");
МассивЗначений.Добавить("002");
МассивЗначений.Добавить(""); // Пустое значение
МассивЗначений.Добавить("004");

// Обработка пустых значений и экранирование кавычек
Для Каждого Элемент Из МассивЗначений Цикл
Если ПустаяСтрока(Элемент) Тогда
Элемент = "NULL"; // Замена на NULL для SQL
Иначе
Элемент = СтрЗаменить(Элемент, "'", "''"); // Экранирование кавычек
КонецЕсли;
КонецЦикла;

СтрокаДляЗапроса = "('" + СтрСоединить(МассивЗначений, "', '") + "')";

Результат: "('001', '002', NULL, '004')" — готовая строка для условия В(). Этот способ работает быстро, но требует ручной обработки:

• 🔸 Замена пустых значений на NULL (или исключение их из массива).
• 🔸 Экранирование кавычек для SQL.
• 🔸 Добавление кавычек вокруг каждого элемента.

⚠️ Внимание: Если в массиве есть значения с запятыми (например, составные коды), этот метод приведёт к ошибке синтаксиса. В таких случаях используйте ВЫРАЗИТЬ() или ЗначениеВСтрокуВнутр().

Способ 2: ВЫРАЗИТЬ() — универсальный, но не идеальный

Функция ВЫРАЗИТЬ() предназначена для преобразования значений в строку, пригодную для вставки в запрос. Она автоматически обрабатывает:

• 🔹 Экранирование специальных символов.
• 🔹 Преобразование типов (даты, булевы значения, ссылки).
• 🔹 Пустые значения (заменяет на NULL).

Пример использования:

Массив = Новый Массив();
Массив.Добавить(Справочники.Номенклатура.НайтиПоНаименованию("Товар 1"));
Массив.Добавить(Справочники.Номенклатура.НайтиПоНаименованию("Товар 2"));

СтрокаДляЗапроса = ВЫРАЗИТЬ(Массив);

Результат будет выглядеть как "(&Товар1, &Товар2)", где &Товар1 — это параметры запроса. Однако у метода есть ограничения:

Для массивов ссылок лучше комбинировать ВЫРАЗИТЬ() с ручной обработкой:

СтрокаПараметров = "";
Для Каждого Элемент Из Массив Цикл
Если СтрокаПараметров <> "" Тогда
СтрокаПараметров = СтрокаПараметров + ", ";
КонецЕсли;
СтрокаПараметров = СтрокаПараметров + ВЫРАЗИТЬ(Элемент);
КонецЦикла;

Способ 3: ЗначениеВСтрокуВнутр() — для сложных типов

Когда в массиве есть составные типы (структуры, соответствия, объекты), ни СтрСоединить(), ни ВЫРАЗИТЬ() не справятся. Здесь поможет ЗначениеВСтрокуВнутр() — она рекурсивно преобразует любые данные в строку, пригодную для хранения или отладки.

Пример:

СтруктураДанных = Новый Структура();
СтруктураДанных.Вставить("Код", "A100");
СтруктураДанных.Вставить("Наименование", "Товар \"Супер\"");
СтруктураДанных.Вставить("Цена", 100.50);

МассивСтруктур = Новый Массив();
МассивСтруктур.Добавить(СтруктураДанных);

// Преобразуем каждую структуру в строку
СтрокаДляЛога = "";
Для Каждого Элемент Из МассивСтруктур Цикл
СтрокаДляЛога = СтрокаДляЛога + ЗначениеВСтрокуВнутр(Элемент) + Символы.ПС;
КонецЦикла;

Результат будет выглядеть так:

Код = "A100";
Наименование = "Товар ""Супер""";
Цена = 100.5;

Это удобно для отладки, но не подходит для вставки в запрос. Чтобы адаптировать вывод для SQL, потребуется дополнительная обработка:

• 🔸 Удаление лишних символов (точки с запятой, переводы строк).
• 🔸 Замена внутренних кавычек на экранированные.
• 🔸 Форматирование под синтаксис В().

Способ 4: Использование временных таблиц

Если массив данных большой (тысячи элементов), то преобразование его в строку может быть неэффективным. В таких случаях лучше:

1. 🔢 Загрузить данные во временную таблицу.
2. 🔢 Использовать её в основном запросе через ВЫБРАТЬ ... ИЗ &ВременнаяТаблица.

Пример:

// Создаём временную таблицу
ВременнаяТаблица = Новый ВременнаяТаблица;
ВременнаяТаблица.Колонки.Добавить("КодНоменклатуры");

// Заполняем данными
Для Каждого Код Из МассивКодов Цикл
Строка = ВременнаяТаблица.Добавить();
Строка.КодНоменклатуры = Код;
КонецЦикла;

// Используем в запросе
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Товары.Наименование
|ИЗ
|   Справочник.Номенклатура КАК Товары
|ГДЕ
|   Товары.Код В (ВЫБРАТЬ КодНоменклатуры ИЗ &ВременнаяТаблица)";

Запрос.УстановитьПараметр("ВременнаяТаблица", ВременнаяТаблица);
Результат = Запрос.Выполнить();

Преимущества метода:

• 🔹 Нет ограничений на размер массива.
• 🔹 Безопасно для SQL-инъекций.
• 🔹 Поддерживает сложные условия (например, ВЫБРАТЬ РАЗЛИЧНЫЕ).

⚠️ Внимание: Временные таблицы потребляют память сервера. Не забывайте очищать их после использования, особенно в циклах или фоновых заданиях. В 1С:Предприятие 8.3.18+ временные таблицы автоматически уничтожаются после выполнения запроса, но в старых версиях это нужно делать вручную.

Способ 5: Кастомная функция с обработкой всех случаев

Для проектов, где преобразование массивов в строки используется часто, имеет смысл написать универсальную функцию. Она должна:

1. 🔢 Обрабатывать пустые значения.
2. 🔢 Экранировать специальные символы.
3. 🔢 Поддерживать разные типы данных (строки, числа, ссылки, даты).
4. 🔢 Возвращать строку в формате, совместимом с В().

Пример реализации:

Функция МассивВСтрокуДляЗапроса(Массив, Разделитель = ", ", ТипЗначений = Неопределено) Экспорт
Результат = "";
РазделительИспользован = Ложь;

Для Каждого Элемент Из Массив Цикл
Если Результат <> "" Тогда
Результат = Результат + Разделитель;
РазделительИспользован = Истина;
КонецЕсли;

Если ЗначениеЗаполнено(Элемент) Тогда
// Обработка ссылок
Если ТипЗнч(Элемент) = Тип("СправочникСсылка") Тогда
Если ТипЗначений <> Неопределено Тогда
Результат = Результат + ВЫРАЗИТЬ(Элемент.УникальныйИдентификатор());
Иначе
Результат = Результат + "'" + СтрЗаменить(Элемент.Наименование, "'", "''") + "'";
КонецЕсли;
ИначеЕсли ТипЗнч(Элемент) = Тип("Строка") Тогда
Результат = Результат + "'" + СтрЗаменить(Элемент, "'", "''") + "'";
ИначеЕсли ТипЗнч(Элемент) = Тип("Число") Или ТипЗнч(Элемент) = Тип("Булево") Тогда
Результат = Результат + Элемент;
ИначеЕсли ТипЗнч(Элемент) = Тип("Дата") Тогда
Результат = Результат + "'" + Формат(Элемент, "ДЛФ=DT") + "'";
Иначе
Продолжить; // Пропускаем необрабатываемые типы
КонецЕсли;
Иначе
Результат = Результат + "NULL";
КонецЕсли;
КонецЦикла;

Если Не РазделительИспользован Тогда
Возврат "NULL"; // Если массив пуст или все элементы пустые
Иначе
Возврат Результат;
КонецЕсли;
КонецФункции

Использование:

Массив = Новый Массив();
Массив.Добавить("O'Reilly");
Массив.Добавить(100);
Массив.Добавить(Справочники.Номенклатура.НайтиПоНаименованию("Товар 1"));
Массив.Добавить("");

Строка = МассивВСтрокуДляЗапроса(Массив);
// Результат: "'O''Reilly', 100, &Параметр1, NULL"

Эта функция покрывает 90% случаев и может быть расширена для специфических типов данных вашего проекта.

Сравнение производительности методов

Выбор метода зависит не только от удобства, но и от производительности. Ниже приведена сравнительная таблица для массива из 1000 элементов (тесты проводились на 1С:Предприятие 8.3.21):

Выводы:

• 🔹 Для малых массивов (до 100 элементов) подходит любой метод.
• 🔹 Для больших данных (тысячи элементов) оптимальны временные таблицы.
• 🔹 ВЫРАЗИТЬ() удобен, но может генерировать избыточные параметры.
• 🔹 Кастомная функция — золотой стандарт для проектов с частым использованием.

Типичные ошибки и как их избежать

Даже опытные разработчики допускают ошибки при работе с перечислениями в запросах. Рассмотрим топ-5 проблем и их решения:

1. Пропуск пустых значений. Если массив содержит Неопределено или пустые строки, СтрСокрЛП() их проигнорирует, что исказит логику запроса.

   Решение: Заменяйте пустые значения на NULL или исключайте их явно:

   Массив = Массив.НайтиЗначение(Неопределено, Истина); // Удаляем Неопределено

2. Неэкранированные кавычки. Строки с кавычками (например, O'Reilly) ломают SQL-синтаксис.

   Решение: Всегда используйте СтрЗаменить(Строка, "'", "''").

3. Несовпадение типов. Если в массиве смешаны строки и числа, ВЫРАЗИТЬ() может сгенерировать некорректные параметры.

   Решение: Приводите все элементы к одному типу или обрабатывайте их по отдельности.

4. SQL-инъекции. Прямая вставка пользовательского ввода в запрос опасна.

   Решение: Используйте параметры запроса (&Параметр) или временные таблицы.

5. Переполнение строки. В 1С ограничение на длину строки — 2 Гб, но на практике проблемы начинаются уже с 100+ Кб.

   Решение: Для больших данных используйте временные таблицы или пакетную обработку.

Если РегВыражение("['"";]", СтрСоединить(Массив, "")).Найти() Тогда
// В массиве есть кавычки или точки с запятой — требуется экранирование
КонецЕсли;

FAQ: Частые вопросы

ЗначенияПеречисления = Перечисления.СтатусыДокумента.Значения();
СтрокаДляЗапроса = МассивВСтрокуДляЗапроса(ЗначенияПеречисления);

Запрос.УстановитьПараметр("П1", Значение1);
Запрос.УстановитьПараметр("П2", Значение2);

СтрокаJSON = ЗаписатьJSON(Массив);
// Далее нужно парсить JSON и формировать строку для запроса