Как корректно добавить название организации, содержащее кавычки, в запрос 1С?

← На главную

При работе с платформой 1С:Предприятие часто возникает необходимость фильтровать данные по наименованиям объектов, которые сами по себе содержат специальные символы, например, двойные кавычки. Рассмотрим типичную ситуацию, когда требуется выбрать организацию с наименованием вида "ООО"ТОК-КЕН"" и передать ее в качестве параметра запроса или использовать непосредственно в тексте запроса. Подобная задача может показаться нетривиальной из-за особенностей синтаксиса экранирования кавычек в языке 1С и различий в работе со строковыми и ссылочными типами данных.

Мы с вами проанализируем проблему, выясним причины возникновения ошибок и предложим несколько надежных способов ее решения, начиная от правильного экранирования строковых литералов и заканчивая лучшими практиками работы со ссылочными типами данных в запросах 1С. Мы подробно рассмотрим каждый шаг, приведем примеры кода и объясним, почему те или иные подходы являются предпочтительными.

1. Основная проблема: Экранирование кавычек в строковых литералах 1С

Первая и наиболее очевидная трудность заключается в том, как правильно записать строковый литерал, который сам содержит двойные кавычки. В большинстве языков программирования, и 1С не исключение, символ, используемый для обрамления строки, должен быть "экранирован" (то есть, как-то обозначен, чтобы компилятор или интерпретатор понимал, что это часть строки, а не ее конец), если он встречается внутри самой строки.

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

Давайте посмотрим на пример: если нам нужно представить строку "ООО"ТОК-КЕН"", то ее корректное строковое представление в коде 1С будет выглядеть так:

ИмяОрганизацииСКавычками = "ООО""ТОК-КЕН""";

Обратите внимание: каждая одиночная двойная кавычка внутри строки (перед "ТОК" и после "КЕН") была удвоена. Это указывает 1С, что это не конец строки, а символ кавычки, который должен быть включен в строку.

Изначальная попытка автора темы, Запрос.УстановитьПараметр("Организация", ООО"ТОК-КЕН");, является синтаксически некорректной, так как 1С воспринимает ООО как начало строки, а "ТОК-КЕН" как ее окончание, после чего следует необработанный текст, что приводит к ошибке синтаксиса.

В качестве альтернативы удвоению кавычек можно использовать функцию Символ(34), где 34 — это ASCII-код символа двойной кавычки. Однако для строковых литералов непосредственно в коде или запросах удвоение кавычек ("") является более распространенным и интуитивно понятным способом, улучшающим читаемость кода.


ИмяОрганизацииЧерезСимвол = "ООО" + Символ(34) + "ТОК-КЕН" + Символ(34); // Выглядит сложнее для восприятия

Мы рекомендуем придерживаться правила удвоения кавычек для простоты и единообразия.

2. Типы данных в запросах 1С: Строка против Ссылки

Вторая, не менее важная проблема, которую мы видим в диалоге, связана с типами данных. Автор уточняет в сообщении 10, что поле Организация в регистре имеет ссылочный тип на справочник "Организации". Это критически важно для правильного построения запроса.

Когда мы пытаемся сравнить ссылочный тип (объект справочника) со строкой (наименованием организации), как в примере ГДЕ СрезПоследних.Организация = "ООО""ТОК-КЕН""", СУБД 1С не сможет выполнить это сравнение корректно. Ссылка — это уникальный идентификатор объекта в базе данных, а строка — это просто текстовое представление.

Для успешного сравнения в запросе нам необходимо либо:

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

Мы подробно рассмотрим оба подхода.

3. Решение 1: Фильтрация по наименованию ссылочного поля в запросе

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

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


ТекстЗапроса = "ВЫБРАТЬ
    |    СрезПоследних.Поле1,
    |    СрезПоследних.Поле2
    |ИЗ
    |    РегистрСведений.НашРегистр.СрезПоследних КАК СрезПоследних
    |ГДЕ
    |    СрезПоследних.Организация.Наименование = ""ООО""ТОК-КЕН""""";

Запрос = Новый Запрос(ТекстЗапроса);
Результат = Запрос.Выполнить().Выгрузить();

В данном случае мы напрямую в тексте запроса указываем СрезПоследних.Организация.Наименование, что позволяет нам сравнить строковое представление наименования организации с нашей корректно экранированной строкой "ООО""ТОК-КЕН""". Этот метод будет работать, но имеет свои нюансы, которые мы должны учитывать:

Надежность: Поиск по наименованию менее надежен, чем поиск по уникальному идентификатору или ссылке. Если в базе данных появятся две организации с одинаковым наименованием, или наименование организации будет изменено, запрос может вернуть неверные данные или перестать работать. Мы всегда должны помнить о потенциальном "человеческом факторе" или внешних изменениях данных.
Производительность: Сравнение по строковому полю (особенно если оно не индексировано или не является основным полем поиска в регистре) может быть менее производительным для больших объемов данных по сравнению со сравнением ссылок или заранее найденных идентификаторов. Для СУБД сравнение ссылок, как правило, оптимизировано лучше.

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

4. Решение 2: Получение ссылки на объект и передача ее как параметра (Рекомендуемый подход)

Наиболее надежный, гибкий и производительный способ решения данной задачи, особенно когда речь идет о ссылочных типах, это сначала получить саму ссылку на объект справочника, а затем передать эту ссылку в запрос как параметр. Этот подход был предложен в сообщении 6 и является лучшей практикой при работе с ссылочными типами в запросах 1С.

Мы разберем шаги, которые мы должны выполнить для реализации этого метода:

Получение ссылки на организацию: Мы используем стандартный метод НайтиПоНаименованию() глобального объекта Справочники.Организации. Важно при этом передать в метод корректно экранированное наименование, которое мы уже научились формировать.
Проверка на существование: Всегда проверяйте, что ссылка была найдена (то есть, не является Неопределено), прежде чем использовать ее. Это предотвратит ошибки выполнения запроса, если организация с таким наименованием не существует в базе данных, и позволит корректно обработать такую ситуацию.
Установка параметра запроса: После того как мы убедились, что ссылка найдена, мы передаем ее в параметр запроса с помощью метода Запрос.УстановитьПараметр().
Использование параметра в запросе: В тексте запроса используем установленный параметр для сравнения с полем ссылочного типа.

Рассмотрим пример кода, демонстрирующий этот подход:


// 1. Корректно экранируем наименование организации для поиска
ИмяОрганизацииДляПоиска = "ООО""ТОК-КЕН""";

// 2. Получаем ссылку на организацию по наименованию
// Используем метод НайтиПоНаименованию() глобального объекта Справочники.Организации
СсылкаНаОрганизацию = Справочники.Организации.НайтиПоНаименованию(ИмяОрганизацииДляПоиска);

// 3. Проверяем, что организация была найдена. Это критически важный шаг для стабильности.
Если СсылкаНаОрганизацию <> Неопределено Тогда
    
    // 4. Создаем новый объект запроса
    Запрос = Новый Запрос;
    
    // 5. Формируем текст запроса, используя параметр для сравнения ссылок
    ТекстЗапроса = "ВЫБРАТЬ
        |    СрезПоследних.Поле1,
        |    СрезПоследних.Поле2,
        |    СрезПоследних.Организация.Наименование КАК НаименованиеОрганизации // Можем вывести наименование для информации
        |ИЗ
        |    РегистрСведений.НашРегистр.СрезПоследних КАК СрезПоследних
        |ГДЕ
        |    СрезПоследних.Организация = &ОрганизацияПараметр"; // Сравниваем ссылки, а не строки!
        
    Запрос.Текст = ТекстЗапроса;
    
    // 6. Устанавливаем параметр запроса, передавая найденную ссылку.
    // 1С корректно обработает сравнение ссылок.
    Запрос.УстановитьПараметр("ОрганизацияПараметр", СсылкаНаОрганизацию);
    
    // 7. Выполняем запрос и обрабатываем результат
    Результат = Запрос.Выполнить().Выгрузить();
    Сообщить("Данные по организации '" + ИмяОрганизацииДляПоиска + "' найдены. Количество записей: " + Результат.Количество());
    
Иначе
    // Обработка ситуации, когда организация не найдена
    Сообщить("Организация с наименованием '" + ИмяОрганизацииДляПоиска + "' не найдена. Проверьте правильность наименования.");
КонецЕсли;

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

Точное совпадение: Мы сравниваем уникальные ссылки на объекты, что исключает ошибки, связанные с дублированием наименований (даже если появятся две организации с одинаковым наименованием, у них будут разные ссылки) или их изменением. Ссылка остается неизменной, даже если наименование объекта меняется.
Производительность: Сравнение ссылок, как правило, происходит значительно быстрее, чем сравнение строк, особенно на больших объемах данных, так как ссылки являются индексируемыми полями и оптимизированы для быстрого поиска в СУБД.
Читаемость и поддерживаемость: Код становится более читаемым, а логика — более прозрачной. Разделение логики поиска объекта и его использования в запросе упрощает отладку и модификацию, поскольку каждая часть кода выполняет свою четко определенную задачу.
Обработка отсутствия объекта: Явная проверка на Неопределено позволяет нам корректно отреагировать, если организация не найдена, вместо того чтобы получить ошибку выполнения запроса.

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

5. Использование параметров запроса — неотъемлемая часть хорошего кода

Независимо от того, как мы получаем значение для фильтрации (строка с наименованием или ссылка на объект), всегда рекомендуется использовать параметры запроса с помощью метода Запрос.УстановитьПараметр(). Это одна из фундаментальных рекомендаций по написанию качественного кода в 1С. Мы подробно рассмотрим преимущества этого подхода.

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

Предотвращение SQL-инъекций: Хотя в 1С язык запросов отличается от прямого SQL, принцип защиты от "инъекций" остается актуальным. Передача значений через параметры гарантирует, что эти значения будут обработаны как данные, а не как часть синтаксиса запроса. Это делает ваш код более безопасным и устойчивым к некорректным входным данным.
Повышение читаемости кода: Текст запроса становится чище и понятнее, без громоздких строковых конкатенаций или сложных экранирований внутри самого текста запроса. Когда мы видим &Параметр, мы сразу понимаем, что это переменное значение, которое будет установлено извне.
Упрощение поддержки: Изменение значения параметра не требует изменения самого текста запроса, что делает код более гибким и легким для модификации. Если потребуется изменить критерий отбора, мы просто меняем значение параметра, а не переписываем часть запроса.
Автоматическая обработка типов: 1С автоматически преобразует тип значения, передаваемого через параметр, к требуемому типу в запросе (насколько это возможно), что снижает вероятность ошибок типов. Например, если вы передаете число, а в запросе ожидается дата, 1С попытается выполнить преобразование, или выдаст понятную ошибку, если преобразование невозможно.
Кэширование запросов: Система 1С может оптимизировать выполнение запросов с параметрами, кэшируя план выполнения. При каждом новом вызове с тем же текстом запроса, но разными значениями параметров, СУБД не нужно заново анализировать и компилировать запрос, что улучшает производительность.

Пример, как мы бы могли передать строку с экранированными кавычками через параметр, если бы поле в регистре было строковым (а не ссылочным):


// Корректно экранируем наименование
ИмяОрганизацииПараметр = "ООО""ТОК-КЕН""";

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

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

Мы видим, что даже в случае строкового сравнения, использование параметра значительно улучшает код, делая его чище и надежнее.

6. Практические советы: Конструктор запросов и пользовательский ввод

При разработке важно также учитывать следующие аспекты, которые могут существенно упростить вашу работу и повысить надежность решений:

Конструктор запросов в конфигураторе: При создании сложных запросов или отладке существующих, активно используйте конструктор запросов, доступный в конфигураторе 1С. Конструктор запросов часто помогает с правильным синтаксисом и параметризацией. Он может подсказать правильное экранирование (хотя для встроенных в текст запроса строк с кавычками он может потребовать ручного вмешательства), помочь сформировать условия для ссылочных полей (предлагая выбор полей, таких как .Наименование, .Код и т.д.), что предотвратит многие синтаксические ошибки. Это мощный инструмент для визуального построения и проверки запросов, который значительно экономит время и снижает вероятность ошибок. Мы рекомендуем формировать основную структуру запроса в конструкторе, а затем дополнять его специфической логикой в коде.
Пользовательский ввод организации: В сообщении 13 была предложена отличная идея, которая является лучшей практикой для пользовательских интерфейсов. Если ваша задача решается в пользовательском интерфейсе (например, в отчете, обработке или форме документа), добавьте реквизит типа "СправочникСсылка.Организации" (или аналогичный ссылочный тип) на форму. Это позволит пользователю выбрать организацию из стандартного списка справочника, и вы получите не строковое наименование, а сразу ссылку на объект СправочникСсылка.Организации. Это наиболее надежный, дружественный к пользователю и безопасный способ, так как он полностью исключает проблемы с ручным вводом наименований, их возможными ошибками или сложностями с экранированием. Когда пользователь выбирает организацию, вы можете передать эту ссылку напрямую в параметр запроса.
```
// Пример кода в обработке/отчете, где на форме добавлен реквизит
// с именем ОрганизацияВыборПользователя и типом СправочникСсылка.Организации.
// Предполагается, что пользователь уже выбрал организацию.

Если ЗначениеЗаполнено(ОрганизацияВыборПользователя) Тогда
    Запрос = Новый Запрос;
    Запрос.Текст = "ВЫБРАТЬ
        |    СрезПоследних.Поле1,
        |    СрезПоследних.Поле2,
        |    СрезПоследних.Организация.Наименование КАК НаименованиеОрганизации
        |ИЗ
        |    РегигистрСведений.НашРегистр.СрезПоследних КАК СрезПоследних
        |ГДЕ
        |    СрезПоследних.Организация = &ОрганизацияПараметр"; // Сравниваем напрямую с выбранной ссылкой
    
    // Передаем ссылку, выбранную пользователем, в параметр запроса
    Запрос.УстановитьПараметр("ОрганизацияПараметр", ОрганизацияВыборПользователя);
    
    Результат = Запрос.Выполнить().Выгрузить();
    Сообщить("Данные по выбранной организации получены. Количество записей: " + Результат.Количество());
Иначе
    Сообщить("Выберите организацию для отбора, чтобы выполнить запрос.");
КонецЕсли;
```
Мы видим, что в этом случае проблема экранирования кавычек в наименовании полностью исчезает, так как мы работаем непосредственно с объектом-ссылкой, который уже гарантированно существует в базе данных и имеет корректный тип.

Заключение

Мы с вами подробно рассмотрели, как эффективно работать с наименованиями организаций, содержащими кавычки, при построении запросов в 1С:Предприятии. Главные уроки, которые мы вынесли из анализа проблемы и предложенных решений:

Экранирование кавычек: Всегда удваивайте двойные кавычки внутри строкового литерала, если они являются частью самой строки (например, "ООО""ТОК-КЕН"""). Это фундаментальное правило синтаксиса 1С.
Типы данных: Внимательно относитесь к типам полей в запросе. Если поле является ссылочным, сравнивайте его со ссылкой, а не со строкой. Попытка прямого сравнения строки и ссылки почти всегда приведет к некорректному результату или ошибке.
Поиск по ссылке: Предпочтительно сначала найти ссылку на объект по наименованию (используя методы типа Справочники.Организации.НайтиПоНаименованию()), а затем передать эту ссылку в запрос. Этот подход обеспечивает надежность, производительность и устойчивость к изменениям данных.
Параметры запроса: Всегда используйте Запрос.УстановитьПараметр() для передачи любых значений в запрос. Это улучшает безопасность, повышает читаемость кода, упрощает его поддержку и позволяет 1С лучше оптимизировать выполнение запросов.
Пользовательский интерфейс: Для пользовательского ввода данных об организации используйте поля выбора ссылочного типа. Это исключает проблемы с ручным вводом наименований и их экранированием, предоставляя пользователю удобный и безошибочный способ выбора.

Применяя эти подходы, мы сможем создавать надежные, эффективные и легко поддерживаемые решения в 1С:Предприятии, избегая распространенных ошибок при работе со строковыми и ссылочными данными.