Как создать текстовое поле в 1С: пошаговая инструкция 2026

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

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

1. Способы создания текстового поля в 1С: когда какой использовать

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

📝 Через конфигуратор — самый простой метод для статичных полей в справочниках или документах. Подходит, если поле нужно один раз добавить и больше не изменять.
💻 Программно в модуле формы — когда поле должно появляться динамически (например, при выборе определённого типа документа).
🔄 Через расширение конфигурации — если нужно добавить поле в типовую конфигурацию без её модификации (актуально для обновляемых решений).
📄 В печатной форме — для вывода текста в документах (договорах, счетах). Здесь часто используют ТекстДокумента вместо простой строки.
🔗 Через внешнюю обработку — если поле временное и не должно сохраняться в базе (например, для тестовых целей).

Например, если вам нужно добавить поле "Примечание" в документ "Заказ клиента", достаточно первого способа. А если поле должно появляться только для определённых контрагентов — потребуется программное решение. Далее разберём каждый метод подробно.

2. Добавление текстового поля через конфигуратор: пошаговая инструкция

Это базовый метод, который подходит для 90% задач. Рассмотрим на примере добавления поля "Комментарий" в справочник "Номенклатура":

Откройте конфигуратор (1Cv8.exe /config или через меню Файл → Конфигуратор).
В дереве объектов найдите раздел Справочники → Номенклатура.
Перейдите на вкладку Данные и нажмите Добавить реквизит.
Задайте имя реквизита (например, Комментарий) и выберите тип Строка.
На вкладке Формы откройте форму элемента справочника и добавьте поле ввода (Поле ввода из палитры элементов).
Привяжите поле к реквизиту: в свойствах элемента укажите Данные → Комментарий.
Сохраните конфигурацию (Ctrl+S) и обновите базу (Конфигурация → Обновить конфигурацию базы данных).

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

☑️ Проверка перед сохранением конфигурации

Имя реквизита без пробеловТип данных соответствует задачеПоле привязано к реквизиту в формеКонфигурация сохранена и обновлена

Выполнено: 0 / 4

3. Программное создание текстового поля в модуле формы

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

Процедура КонтрагентПриИзменении(Элемент) // Удаляем поле, если оно уже было создано ранее Если ЭлементыФормы.Свойство("ДопИнформация") Тогда ЭлементыФормы.Удалить("ДопИнформация"); КонецЕсли; // Проверяем условие (например, контрагент с ИНН 1234567890) Если Объект.Контрагент.ИНН = "1234567890" Тогда // Создаём новое текстовое поле ПолеВвода = ЭлементыФормы.Добавить("ДопИнформация", Тип("ПолеВвода"), Истина); ПолеВвода.Вид = ВидПоляВвода.ПолеВвода; ПолеВвода.Данные = Новый ОписаниеОповещения("ДопИнформация", ЭтотОбъект); ПолеВвода.Подсказка = "Укажите дополнительные сведения для этого контрагента"; ПолеВвода.Высота = 50; // Многострочное поле ПолеВвода.МногострочныйРежим = Истина; // Размещаем поле под полем "Контрагент" ПолеВвода.Верх = ЭлементыФормы.Контрагент.Низ + 5; ПолеВвода.Лево = ЭлементыФормы.Контрагент.Лево; ПолеВвода.Ширина = ЭлементыФормы.Контрагент.Ширина; КонецЕсли;

КонецПроцедуры

Ключевые моменты:

🔹 Используйте ЭлементыФормы.Удалить(), чтобы избежать дублирования поля при повторном срабатывании события.
🔹 Для многострочного поля установите свойства МногострочныйРежим = Истина и задайте Высота.
🔹 Привязка данных осуществляется через Новый ОписаниеОповещения, где первый параметр — имя реквизита в объекте.

💡

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

4. Типы данных для текстовых полей: Строка vs ТекстДокумента

В 1С есть два основных типа для работы с текстом, и их выбор критически важен для корректной работы:

Тип данных	Макс. длина	Поддержка форматирования	Где использовать	Пример кода
`Строка`	2 ГБ (теоретически), но на практике ограничено настройками СУБД	Нет	Краткие комментарии, названия, адреса	`Новый Реквизит("Примечание", Новый ОписаниеТипов("Строка", Новый КвалификаторыСтроки(100)))`
`ТекстДокумента`	Не ограничено	Да (шрифты, цвета, таблицы)	Договора, письма, технические задания	`Новый Реквизит("ТекстДоговора", Новый ОписаниеТипов("ТекстДокумента"))`
`ХранилищеЗначения`	2 ГБ	Нет, но можно хранить бинарные данные	Для больших текстовых блоков без форматирования	`Новый Реквизит("БольшойТекст", Новый ОписаниеТипов("ХранилищеЗначения"))`

Ошибка многих разработчиков — использовать Строка для длинных текстов (например, описаний товаров). Это приводит к обрезке данных при превышении лимита. Если текст может быть больше 1000 символов, лучше сразу закладывать ТекстДокумента или ХранилищеЗначения.

Что будет если превысить лимит строки?

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

Для изменения максимальной длины строки используйте конструктор:

Новый Реквизит("Описание",
Новый ОписаниеТипов("Строка", Новый КвалификаторыСтроки(1000)));

5. Распространённые ошибки и как их избежать

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

❌ Поле не сохраняется в базе — проверьте, что реквизит добавлен не только в форму, но и в объект конфигурации (справочник/документ).
❌ Текст обрезается при выводе — увеличьте длину строки в свойствах реквизита или используйте ТекстДокумента.
❌ Не работает многострочный режим — убедитесь, что установлены свойства МногострочныйРежим = Истина и Высота > 20.
❌ Проблемы с кодировкой — при программном создании поля явно укажите кодировку: ПолеВвода.КодировкаТекста = КодировкаТекста.UTF8.
❌ Поле не обновляется при изменении данных — проверьте привязку данных в свойствах элемента формы (Данные → ИмяРеквизита).

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

ПолеВвода.Высота = 100; // Для мобильной версии лучше указать фиксированную высоту

💡

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

6. Продвинутые приёмы: шаблоны, автозаполнение, валидация

Текстовые поля в 1С могут быть не просто статичными элементами, а интерактивными инструментами. Рассмотрим три полезных сценария:

6.1. Автозаполнение по шаблону

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

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
Объект.ТекстДоговора = Новый ТекстДокумента;
Объект.ТекстДоговора.ДобавитьСтроку("ДОГОВОР №" + Объект.Номер);
Объект.ТекстДоговора.ДобавитьСтроку("г. Москва, " + ТекущаяДата());
Объект.ТекстДоговора.ДобавитьСтроку("");
Объект.ТекстДоговора.ДобавитьСтроку("1. ПРЕДМЕТ ДОГОВОРА");
КонецПроцедуры

6.2. Валидация введённого текста

Чтобы ограничить ввод только цифрами или определенными символами:

Процедура КомментарийПриИзменении(Элемент)
Если НЕ РегВыражение.Проверка(Объект.Комментарий, "[А-Яа-яЁё0-9\s.,-]+") Тогда
Сообщить("Допустимы только русские буквы, цифры и знаки ,.-", СтатусСообщения.Важное);
Объект.Комментарий = "";
КонецЕсли;
КонецПроцедуры

6.3. Динамическое изменение подсказки

Подсказка может меняться в зависимости от контекста:

Процедура ТипДокументаПриИзменении(Элемент) Если Объект.ТипДокумента = Перечисление.ТипыДокументов.Счёт Тогда ЭлементыФормы.Комментарий.Подсказка = "Укажите причину корректировки счета"; ИначеЕсли Объект.ТипДокумента = Перечисление.ТипыДокументов.Накладная Тогда ЭлементыФормы.Комментарий.Подсказка = "Опишите особенности отгрузки"; КонецЕсли;

КонецПроцедуры

7. Работа с текстовыми полями в управляемых формах vs обычных формах

В 1С:Предприятие 8.3 есть два типа форм: управляемые (рекомендуемые) и обычные (устаревшие). Подходы к созданию текстовых полей в них отличаются:

Аспект	Управляемые формы	Обычные формы
Создание поля через код	`ЭлементыФормы.Добавить()`	`Элементы.Добавить()`
Привязка к данным	`Новый ОписаниеОповещения("ИмяРеквизита", ЭтотОбъект)`	`Элемент.Значение = Объект.ИмяРеквизита`
Многострочный режим	Свойство `МногострочныйРежим`	Свойство `Многострочный`
Обработка событий	На сервере и клиенте разделены	Все события обрабатываются на клиенте

Пример создания поля в обычной форме:

Поле = Элементы.Добавить("МоёПоле", Тип("ПолеВвода"));
Поле.ТипЗначения = Новый Тип("Строка");
Поле.Значение = Объект.МоёПоле;

В управляемых формах тот же код будет выглядеть иначе:

Поле = ЭлементыФормы.Добавить("МоёПоле", Тип("ПолеВвода"), Истина);
Поле.Данные = Новый ОписаниеОповещения("МоёПоле", ЭтотОбъект);

💡

В управляемых формах для динамического изменения свойств поля (например, видимости) используйте метод УстановитьДействие() вместо прямого обращения к свойствам.

FAQ: Ответы на частые вопросы

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

Есть два способа:

В конфигураторе: в свойствах реквизита установите флаг Обязательное.

Программно: в модуле объекта добавьте проверку перед записью:

Процедура ПередЗаписью(Отказ)
Если ПустаяСтрока(Объект.Комментарий) Тогда
Сообщить("Поле 'Комментарий' обязательно для заполнения!", СтатусСообщения.Важное);
Отказ = Истина;
КонецЕсли;
КонецПроцедуры

Можно ли в текстовое поле вставить картинку или таблицу?

Да, но только если поле имеет тип ТекстДокумента. Пример вставки таблицы:

Текст = Новый ТекстДокумента;
Таблица = Текст.ДобавитьТаблицу(2, 2);
Таблица.Ячейка(0,0).Текст = "Товар";
Таблица.Ячейка(0,1).Текст = "Количество";
Таблица.Ячейка(1,0).Текст = "Стул";
Таблица.Ячейка(1,1).Текст = "10";

Для вставки картинки используйте метод ДобавитьКартинку().

Как ограничить количество символов в текстовом поле?

Используйте свойство МаксимальнаяДлина (для типа Строка):

ПолеВвода.МаксимальнаяДлина = 500; // Ограничение в 500 символов

Для ТекстДокумента ограничение можно реализовать только программно, отслеживая длину текста в событии ПриИзменении.

Почему текстовое поле не отображается в печатной форме?

Частые причины:

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

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

Как сделать текстовое поле только для чтения?

Установите свойство ТолькоПросмотр:

ЭлементыФормы.МоёПоле.ТолькоПросмотр = Истина;

Для динамического управления (например, только для определённых ролей):

ЭлементыФормы.МоёПоле.ТолькоПросмотр = НЕ ГлобальныйКонтекст.Пользователь.Роли.Содержит(Роли.Администратор);

Как создать текстовое поле в 1С: 5 способов для разных задач