Как вывести кавычку в 1С: от простых символов до сложных конструкций

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

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

———

1. Базовые способы ввода кавычек в 1С для пользователей

Если вам нужно просто ввести кавычку в поле документа, справочника или отчета, используйте стандартные методы Windows. В большинстве случаев достаточно скопировать символ из другого источника или использовать комбинации клавиш.

Для прямых кавычек («») в русской раскладке:

• 🔹 Нажмите Shift + 2 (верхняя кавычка «)
• 🔹 Нажмите Shift + Э (нижняя кавычка »)

Для одинарных кавычек (‘’) или англйиских кавычек (""):

• 🔹 Переключитесь на английскую раскладку и нажмите Shift + ' (верхняя одинарная)
• 🔹 Для двойных английских кавычек используйте Shift + "

Если кавычки не отображаются корректно в печатной форме, проверьте шрифт документа — некоторые шрифты (например, Courier New) могут заменять «умные» кавычки на прямые.

⚠️ Внимание: В полях ввода 1С:Предприятие иногда блокируется вставка специальных символов через буфер обмена. В этом случае используйте клавиатурные комбинации или вводите символы через Таблицу символов Windows (Win + .).

2. Вывод кавычек в коде 1С: синтаксис и экранирование

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

Примеры корректного синтаксиса:

// Вывод двойной кавычки
Сообщить("Это пример ""кавычки"" в строке");

// Вывод одинарной кавычки (апострофа)
Сообщить("Это пример ''одинарной'' кавычки");

// Комбинированный пример
Запрос = Новый Запрос;
Запрос.Текст = "ВЫБРАТЬ
|   Наименование КАК ""Наименование товара""
|ИЗ
|   Справочник.Номенклатура КАК Номенклатура";

Обратите внимание:

• 🔹 В запросах 1С кавычки экранируются удвоением только внутри строковых литералов. В именах полей (после КАК) используются прямые кавычки без экранирования.
• 🔹 В 1С 8.3.20+ поддерживается альтернативный синтаксис с использованием | для многострочных строк, где экранирование не требуется.

⚠️ Внимание: Если вы формируете JSON или XML в 1С, экранирование кавычек должно соответствовать стандартам этих форматов. Например, в JSON двойные кавычки внутри строки заменяются на \", а не удваиваются.

Удвоены ли кавычки внутри строковых литералов?|Проверены ли кавычки в именах полей запроса?|Совпадает ли тип кавычек с требованиями выходного формата (JSON/XML)?|Тестировался ли код на разных версиях платформы?-->

3. Кавычки в печатных формах и отчетах

При разработке печатных форм или отчетов кавычки часто используются для оформления реквизитов (например, «Наименование», “Количество”). Здесь важно учитывать:

• 🔹 Тип кавычек должен соответствовать стандартам оформления документов (ГОСТ Р 7.0.97-2016 рекомендует использовать «ёлочки» для русских текстов).
• 🔹 Шрифт может автоматически заменять прямые кавычки (") на «умные» («»), что иногда приводит к искажениям при экспорте в PDF.

Пример настройки кавычек в конструкторе печатной формы:

1. Откройте макет печатной формы в режиме редактирования.
2. Добавьте текстовый элемент с нужным символом (например, «).
3. Установите шрифт, поддерживающий «умные» кавычки (например, Times New Roman или Arial).
4. При необходимости зафиксируйте символ в коде макета через ПараметрыМакетов.УстановитьПараметр("Кавычка", "«").

Если кавычки отображаются некорректно при печати:

1. Проверьте настройки принтера (иногда драйвер заменяет символы).
2. Экспортируйте документ в PDF и проверьте результат — это поможет исключить проблему принтера.
3. Используйте универсальные символы (например, U+00AB для « и U+00BB для »), если шрифт их поддерживает.

4. Работа с кавычками в запросах и SQL

В запросах 1С и SQL-выражениях кавычки играют ключевую роль — они обозначают строковые литералы и имена объектов. Ошибки здесь приводят к синтаксическим ошибкам или некорректной выборке данных.

Основные правила:

Типичные ошибки и решения:

• 🔹 Ошибка: Ошибка при выполнении запроса: Неожиданный символ '"'
  Причина: Неудвоенная кавычка внутри строкового литерала.
  Решение: Замените "Товар "Премиум"" на "Товар ""Премиум"" ".
• 🔹 Ошибка: Имя поля с кавычками не распознается.
  Причина: Лишние кавычки в имени поля после КАК.
  Решение: Используйте КАК "Наименование", а не КАК ""Наименование"".

ТекстЗапроса = СтрЗаменить(ТекстЗапроса, """", """""");

Это заменит все одиночные кавычки на удвоенные.-->

5. Кавычки в JSON и XML: особенности экранирования

При обмене данными через JSON или XML кавычки требуют специального экранирования, отличного от правил 1С. Это актуально для интеграций с внешними системами, REST API или веб-сервисами.

Сравнение форматов:

Для автоматизации экранирования используйте функции:

// Экранирование для JSON
Функция ЭкранироватьДляJSON(Строка)
Возврат СтрЗаменить(СтрЗаменить(Строка, """", ""\""), "\", ""\\");
КонецФункции

// Экранирование для XML
Функция ЭкранироватьДляXML(Строка)
Возврат СтрЗаменить(Строка, """", """);
КонецФункции

⚠️ Внимание: При работе с HTTP-Сервисами 1С или REST API неверное экранирование кавычек может привести к ошибке 500 Internal Server Error. Всегда проверяйте формируемый JSON/XML через инструменты вроде Postman или JSONLint.

6. Продвинутые сценарии: динамическое формирование строк с кавычками

В сложных алгоритмах (например, при генерации динамических запросов или SQL-скриптов) кавычки могут становиться источником трудноуловимых ошибок. Рассмотрим типичные задачи и решения.

Задача 1: Формирование списка значений с кавычками для запроса.

Решение — использование СтрСоединить() с экранированием:

СписокЗначений = Новый Массив;
СписокЗначений.Добавить("Товар ""А""");
СписокЗначений.Добавить("Товар ""Б""");

// Формируем строку для запроса
ТекстУсловия = "ГДЕ Наименование В ('" + СтрСоединить(СписокЗначений, "', '") + "')";
// Результат: ГДЕ Наименование В ('Товар ""А""', 'Товар ""Б""')

Задача 2: Генерация SQL-скрипта с именами полей в кавычках (для PostgreSQL).

Решение — обертка имен в кавычки с экранированием существующих:

Функция ОбернутьИмяДляSQL(ИмяПоля)
Возврат """" + СтрЗаменить(ИмяПоля, """", """""") + """";
КонецФункции

// Пример использования
ИмяПоля = "Наименование""Товара""";
SQLТекст = "SELECT " + ОбернутьИмяДляSQL(ИмяПоля) + " FROM table";
// Результат: SELECT "Наименование""Товара""" FROM table

Задача 3: Вывод кавычек в HTML-документах (например, для почтовых шаблонов).

Решение — замена на HTML-сущности:

ТекстHTML = СтрЗаменить(ИсходныйТекст, """", """);
ТекстHTML = СтрЗаменить(ТекстHTML, "«", "«");
ТекстHTML = СтрЗаменить(ТекстHTML, "»", "»");

7. Типичные ошибки и их диагностика

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

Ошибка 1: Ошибка компиляции: Неожиданный конец строки

Причина: Незакрытая кавычка в строковом литерале.

Диагностика:

• 🔹 Проверьте парность кавычек в строке.
• 🔹 Используйте подсветку синтаксиса в конфигураторе — незакрытые строки обычно подсвечиваются красным.

Ошибка 2: Кавычки отображаются как ? или □ в печатной форме.

Причины и решения:

• 🔹 Неподдерживаемый шрифт: Замените шрифт на Arial или Times New Roman.
• 🔹 Кодировка документа: Установите кодировку UTF-8 при экспорте в PDF.
• 🔹 Проблема принтера: Экспортируйте документ в XPS или PDF для проверки.

Ошибка 3: В запросе не работает условие с кавычками.

Пример ошибочного кода:

ТекстЗапроса = "ВЫБРАТЬ * ИЗ Документ.ЗаказПокупателя ГДЕ Комментарий = "Срочно!"";
// Ошибка: кавычка в значении "Срочно!" не удвоена.

Исправленный вариант:

ТекстЗапроса = "ВЫБРАТЬ * ИЗ Документ.ЗаказПокупателя ГДЕ Комментарий = ""Срочно!""";

Ошибка 4: При обмене данными JSON парсится некорректно.

Причина: Неэкранированные кавычки в значениях.

Решение: Всегда используйте СтрЗаменить() для экранирования перед формированием JSON:

Значение = "Товар ""Премиум"" класс";
ЗначениеДляJSON = СтрЗаменить(Значение, """", ""\"");

8. Автоматизация работы с кавычками: полезные функции

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

Функция 1: Экранирование для строковых литералов 1С.

Функция ЭкранироватьКавычкиДля1С(Строка) Экспорт
Возврат СтрЗаменить(Строка, """", """""");
КонецФункции

Функция 2: Экранирование для JSON.

Функция ЭкранироватьДляJSON(Строка) Экспорт
Строка = СтрЗаменить(Строка, """", ""\"");
Строка = СтрЗаменить(Строка, "\", ""\\");
Строка = СтрЗаменить(Строка, "/", ""\/");
Строка = СтрЗаменить(Строка, Chr(8), ""\b"");  // Backspace
Строка = СтрЗаменить(Строка, Chr(12), ""\f""); // Формирующая табуляция
Строка = СтрЗаменить(Строка, Chr(10), ""\n""); // Перевод строки
Строка = СтрЗаменить(Строка, Chr(13), ""\r""); // Возврат каретки
Строка = СтрЗаменить(Строка, Chr(9), ""\t"");  // Табуляция
Возврат Строка;
КонецФункции

Функция 3: Форматирование текста с кавычками для печатных форм (замена прямых кавычек на «ёлочки»).

Функция ЗаменитьКавычкиНаЕлочки(Строка) Экспорт
Строка = СтрЗаменить(Строка, """", "«»");
Строка = СтрЗаменить(Строка, "'", "‘’");
Возврат Строка;
КонецФункции

Функция 4: Проверка корректности экранирования в динамически сформированном запросе.

Функция ПроверитьЭкранированиеВЗапросе(ТекстЗапроса) Экспорт
// Проверяем, что все кавычки внутри строковых литералов удвоены
Если СтрЧислоВхождений(ТекстЗапроса, """") Mod 2 <> 0 Тогда
Возврат Ложь; // Нечетное количество кавычек — ошибка
КонецЕсли;

// Проверяем, что нет одиночных кавычек внутри строк (кроме экранированных)
Если СтрНайти(ТекстЗапроса, """") > 0 Тогда
// Ищем кавычку, после которой нет другой кавычки (не экранированная)
Если СтрНайти(ТекстЗапроса, """") = СтрНайти(ТекстЗапроса, """""") Тогда
Возврат Ложь;
КонецЕсли;
КонецЕсли;

Возврат Истина;
КонецФункции

Рекомендации по использованию:

• 🔹 Разместите функции в общем модуле с правом вызова Экспорт.
• 🔹 Для часто используемых сценариев (например, формирование JSON) создайте процедуры-обертки, которые автоматически экранируют все поля.
• 🔹 Тестируйте функции на крайних случаях: пустые строки, строки только из кавычек, многоуровневые вложенные кавычки.

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

———

FAQ: Частые вопросы по работе с кавычками в 1С

SQLТекст = "INSERT INTO Table (Name) VALUES ('" + СтрЗаменить(Имя, "'", "''") + "')";

Сообщить("Внимание! ""Кавычки"" в сообщении экранируются удвоением.");

Сообщить(|
|Текст сообщения с кавычками: "пример".
|Вторая строка: 'ещё пример'.
|);