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

Другое · 7 мин

Добавление строки в табличную часть 1С: инструкция и нюансы

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

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

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

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

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

Как добавить строку вручную

Откройте форму документа или справочника, содержащего табличную часть, и перейдите в режим редактирования. Найдите раздел с таблицей, над которой обычно расположены команды «Добавить», «Удалить» и «Копировать». Нажмите «Добавить», чтобы внизу таблицы появилась пустая строка.

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

Порядок действий вручную
  1. 1
    Откройте документ или справочник и перейдите в режим редактирования
  2. 2
    Найдите табличную часть и нажмите кнопку «Добавить»
  3. 3
    Заполните реквизиты новой строки
  4. 4
    Сохраните документ и проверьте Appearance строки в списке

Открытие формы и переход в редактирование

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

Как добавить строку программно

В модуле формы обращение к табличной части обычно выполняется через имя элемента формы, например Элементы.ТабличнаяЧасть.Объект или через коллекцию строк объекта. Для добавления используется метод Добавить(), который возвращает ссылку на новую строку, после чего её реквизиты заполняются напрямую.

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

Разница между модулем формы и модулем объекта

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

Когда строка не добавляется: ограничения и права

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

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

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

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

Новая строка видна в таблице после добавления
Норма

Строка отображается и доступна для редактирования

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

Строка отсутствует или форма выдаёт ошибку при сохранении

Документ сохраняется без сообщений об обязательных реквизитах
Норма

Запись прошла успешно, данные остаются после переоткрытия

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

Форма требует заполнить поля или отменяет запись

Проверка результата и сохранение

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

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

Типичные ошибки
01
Добавление строки в форме только на просмотр — изменения не сохраняются
02
Заполнение реквизитов до вызова метода Добавить() — данные не попадают в таблицу
03
Правка проведённого документа без отмены проведения — может нарушить остатки и регистры

Типичные ошибки и как их исправить

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

Другая ошибка — заполнение реквизитов строки, которая не была добавлена в коллекцию, или запись объекта до создания строки. Тогда данные теряются при закрытии формы. Также не стоит добавлять строки напрямую в проведённые документы без понимания влияния на движения по регистрам; лучше использовать корректировки или новые документы.

Сравнение вариантов

Ручное добавление через кнопку

Подходит для разового ввода пользователем; ограничено скоростью и возможностью ошибок при заполнении

Программное добавление через код

Подходит для автоматизации и импорта; требует понимания модуля формы или объекта и правильного места вызова записи

Копирование существующей строки

Удобно при повторяющейся структуре; нужно вручную скорректировать уникальные реквизиты

Альтернативы и связанные действия

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

Иногда вместо добавления строки проще скопировать существующую строку и изменить нужные реквизиты, особенно если структура повторяется. Удаление строки выполняется противоположной командой «Удалить», но перед удалением стоит проверить, не используются ли данные строки в других документах или регистрах.

Итог

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

Строку добавляют вручную кнопкой «Добавить» или программно методом Добавить(), затем заполняют реквизиты и сохраняют документ; проверяют права, режим редактирования и отсутствие ошибок при записи.

Можно ли добавить строку в проведённый документ?

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

Почему кнопка «Добавить» неактивна?

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

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

Да, новая строка существует в памяти формы до записи объекта. Без сохранения изменения исчезнут при закрытии формы или переходе к другому документу.

Что делать, если программа выдаёт ошибку при сохранении?

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