К статье
Практический материал

Другое · 7 мин

Многострочная строка в 1С: способы создания и проверки

Как сделать многострочную строку в 1С: способы переноса строк, проверка отображения и типичные ошибки при работе с текстом для форм, отчётов и печатных форм

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

Наиболее распространённый путь — склеивание фрагментов оператором «+» с вставкой символов возврата каретки и перевода строки. В разных релизах платформы может использоваться комбинация Simvol(13) и Simvol(10), а также другие варианты в зависимости от настроек и назначения текста. Перед внедрением в рабочую базу рекомендуется проверить поведение на копии или в тестовой информационной базе.

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

Что считать многострочной строкой в 1С

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

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

Создание переноса строки программно

Базовый приём состоит в конкатенации частей строки и вставке между ними символов переноса. Примерный вид выражения: «Первая строка» + Simvol(13) + Simvol(10) + «Вторая строка». Точный порядок и набор символов зависят от релиза и требуемого вида переноса, поэтому результат следует сверять с ожидаемым отображением в форме или отчёте.

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

Порядок действий
  1. 1
    Определите, где будет использоваться многострочная строка: форма, отчёт, сообщение или файл.
  2. 2
    Выберите способ вставки переноса под ваш релиз платформы и проверьте его в конфигураторе.
  3. 3
    Соберите строку через конкатенацию или загрузите готовый текст из внешнего источника.
  4. 4
    Выведите результат в целевом объекте и визуально убедитесь в наличии переносов.
  5. 5
    Проверьте поведение строки в условиях, поиске и записи, если она участвует в логике программы.

Источники текста: файлы, шаблоны и таблицы

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

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

Отображение в формах, отчётах и печати

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

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

Контрольные точки

Как проверить результат

Отображение в форме или отчёте
Норма

Переносы видны в ожидаемых местах

Тревожный признак

Текст идёт сплошной строкой или переносы отображаются как символы

Сравнение строк в условии «=»
Норма

Равные многострочные строки распознаются как одинаковые

Тревожный признак

Одинаковые по виду строки сравниваются как разные

Запись и чтение из файла
Норма

Переносы сохраняются после выгрузки и загрузки

Тревожный признак

Появляются лишние или пропадают нужные переносы

Ограничения, риски и типичные ошибки

Главное ограничение — нельзя просто нажать Enter внутри строковой константы в кавычках и ожидать, что платформа примет такой код. Нужно использовать конкатенацию или внешние источники. Также невидимые символы переноса могут ломать условия сравнения: две строки выглядят одинаково, но не совпадают из-за разного порядка Simvol(13) и Simvol(10).

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

Типичные ошибки
01
Перенос каретки внутри кавычек в редакторе кода вместо использования Simvol и конкатенации.
02
Сравнение многострочных строк без учета невидимых символов переноса.
03
Загрузка текста из файла без проверки кодировки, что портит отображение переносов.

Как выбрать подходящий способ

Если строк всего несколько и они формируются в коде, достаточно конкатенации с Simvol(13) и Simvol(10). Для длинных шаблонов, писем и выгрузок лучше использовать готовые файлы или шаблоны, где переносы уже расставлены. Если текст выводится в печатную форму, дополнительно проверьте настройки поля и макета, иначе переносы могут пропасть при выводе.

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

Итог

Что важно запомнить

Многострочная строка в 1С создается склеиванием с символами переноса или загрузкой готового текста; результат обязательно проверяется в форме, отчёте и при сравнении.

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

Можно ли нажать Enter внутри кавычек в модуле 1С?

Обычно нет: встроенный язык не принимает перенос строки внутри строковой константы в кавычках. Нужно собирать строку из частей через оператор «+» с вставкой символов переноса или использовать готовый текст из файла.

Какие символы использовать для переноса строки?

Чаще всего применяется комбинация Simvol(13) и Simvol(10), но точный набор зависит от релиза платформы и задачи. Проверьте нужный вариант в конфигураторе на тестовом примере перед использованием в работе.

Почему две одинаковые многострочные строки не сравниваются?

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

Нужно ли настраивать форму для отображения переносов?

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

Безопасно ли менять макеты печатных форм для многострочного текста?

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