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

Другое · 6 мин

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

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

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

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

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

Что такое табличная часть и где она используется

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

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

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

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

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

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

1c
НоваяСтрока = Объект.ТабличнаяЧасть.Добавить(); НоваяСтрока.Реквизит = Значение;

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

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

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

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

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

Отображение новой строки
Норма

Строка остаётся в таблице после сохранения

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

Строка исчезает или не появляется

Запись объекта
Норма

Объект сохраняется без ошибок

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

Ошибка обязательного реквизита или блокировка записи

Проверка результата и обязательные поля

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

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

Ограничения, права доступа и риски

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

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

Типичные ошибки
01
Попытка добавить строку в форме только для просмотра — команда недоступна
02
Игнорирование обязательных реквизитов строки — объект не записывается
03
Изменение проведённого документа без понимания последствий — возможны ошибки в отчётах

Типичные ошибки и что делать

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

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

Итог

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

Добавляйте строки только в режиме редактирования, заполняйте обязательные реквизиты, сохраняйте объект и проверяйте результат перед работой с данными.

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

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

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

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

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

Что делать, если добавленная строка исчезает после сохранения?

Скорее всего, объект не был записан, произошла отмена транзакции или сработало ограничение конфигурации. Проверьте сообщения системы, обязательные реквизиты и права на запись объекта.

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

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