Как добавить текст в 1С: практическое руководство

Фраза «добавить текст в 1С» может означать несколько разных задач: ввести текстовое описание в документ или элемент справочника, создать текстовый файл, вставить текст в печатную форму или программно сформировать текст в модуле. Каждая из этих задач решается своим инструментом, и путаница между ними — главная причина вопросов у начинающих пользователей.

В пользовательском режиме (режиме «Предприятие») текст вводится в поля форм: комментарии, наименования, описания, многострочные поля. В режиме конфигуратора текст добавляется в макеты, модули и текстовые шаблоны. Программный вывод текста выполняется через объект «ТекстовыйДокумент» или функции формирования строк.

Ниже разобраны все основные сценарии: от простого ввода текста в поле документа до программной записи текстового файла. Инструкции применимы к типовым конфигурациям на платформе 1С:Предприятие 8.3, если в вашей конфигурации нет особых доработок интерфейса.

Ввод текста в поля документов и справочников

Самый частый сценарий — ввести текст в поле «Комментарий», «Дополнительная информация», «Наименование» или аналогичное. Для этого откройте нужный документ или элемент справочника, щёлкните мышью внутри текстового поля и наберите текст с клавиатуры. Сохранение происходит при записи объекта кнопкой «Записать» или «Записать и закрыть».

Однострочные поля не принимают перенос строки: нажатие Enter обычно завершает ввод или перемещает фокус на следующее поле. Многострочные поля (комментарии, описания) распознаются визуально — они вытянуты по вертикали и часто имеют полосу прокрутки. В таких полях перенос строки вставляется комбинацией Shift+Enter или Ctrl+Enter, в зависимости от настроек формы.

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

Работа с текстовым документом в режиме «Предприятие»

Платформа 1С включает встроенный редактор текстовых документов. В большинстве конфигураций он доступен через меню «Файл — Новый — Текстовый документ» либо через пункт «Все функции», если стандартное меню изменено. Открывшийся редактор позволяет набирать, редактировать и сохранять обычные текстовые файлы в формате .txt.

Этот инструмент полезен, когда нужно подготовить список значений для загрузки, сохранить выгруженные данные в текстовом виде или просмотреть файл, полученный из другой системы. Сохранение выполняется через «Файл — Сохранить как» с выбором папки и имени файла.

Обратите внимание на кодировку при сохранении: если текстовый файл будет читаться другой программой, несовпадение кодировок (UTF-8, ANSI, UTF-16) приведёт к отображению символов в виде нечитаемых знаков. Кодировка выбирается в диалоге сохранения файла.

Добавление текста в печатные формы и макеты

Текст на печатной форме (например, дополнительные условия в счёте или договоре) добавляется через редактирование макета. В типовых конфигурациях часть текстов можно изменить без конфигуратора — через настройки печатных форм, раздел «Дополнительные реквизиты» или шаблоны в карточке организации.

Если типовые настройки не позволяют изменить нужный текст, макет редактируется в конфигураторе: откройте конфигурацию, найдите нужный макет в ветке объекта (документа или справочника) и внесите текст в соответствующую область. Ячейки с параметрами (имена в угловых скобках или фигурных скобках) заполняются программно — не заменяйте их на статичный текст, иначе подстановка данных перестанет работать.

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

Программное формирование текста в коде

Для разработчиков основной инструмент — встроенный объект «ТекстовыйДокумент». Он позволяет создать текст построчно, сохранить его в файл или вывести пользователю. Типовой пример в модуле выглядит так:

Текст = Новый ТекстовыйДокумент;
Текст.ДобавитьСтроку("Первая строка отчёта");
Текст.ДобавитьСтроку("Вторая строка: " + ЗначениеПоля);
Текст.Записать("C:\Temp\result.txt", КодировкаТекста.UTF8);

Метод ДобавитьСтроку дописывает строку в конец документа, ВставитьСтроку позволяет добавить текст в произвольную позицию, а ЗаменитьСтроку — изменить существующую. Для чтения существующего файла используется метод Прочитать с указанием пути и кодировки.

Если нужно просто склеить несколько строк с переносами, удобнее использовать СтрШаблон для подстановки значений и символ перевода строки Символы.ПС. Это короче и читабельнее, чем последовательная конкатенация через оператор «+».

Сообщение = СтрШаблон("Документ №%1 от %2 проведён.", НомерДок, Формат(ДатаДок, "ДЛФ=D")); Сообщить(Сообщение);

Текстовые шаблоны и подсказки в конфигураторе

Разработчику часто нужно быстро вставить типовой фрагмент текста кода — цикл, условие, описание процедуры. Для этого в конфигураторе служат шаблоны текста: меню «Сервис — Шаблоны текста». Встроенные шаблоны вызываются по сочетанию Ctrl+Q после набора ключевого слова, а собственные шаблоны можно создать для повторяющихся конструкций.

Комментарии в коде добавляются двойным слэшем // — весь текст после него до конца строки не выполняется. Для быстрого комментирования выделенного блока используется Ctrl+Num /, снятие комментария — Ctrl+Shift+Num /. Это стандартный способ временно отключить фрагмент кода при отладке.

1. 1
   Откройте нужный документ из журнала документов.
2. 2
   Если документ проведён и поля недоступны — отмените проведение.
3. 3
   Щёлкните в поле «Комментарий» и наберите текст; для новой строки используйте Shift+Enter.
4. 4
   Нажмите «Записать» или «Провести», чтобы сохранить изменения.
5. 5
   Откройте документ повторно и убедитесь, что текст сохранился полностью.

Частые ошибки и ограничения

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

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

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

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

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

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

Часто задаваемые вопросы