Другое · 7 мин
Создание строки в табличной части 1С:Предприятие
Пошаговая инструкция по добавлению строки в табличную часть документа или справочника в 1С:Предприятие, проверка результата и типичные ошибки.
Табличная часть в 1С:Предприятии представляет собой вложенный набор строк, привязанный к документу, справочнику или другому объекту конфигурации. Каждая строка содержит набор реквизитов, например номенклатуру, количество, сумму или характеристику. Создание строки означает добавление новой записи в этот набор с последующим заполнением её полей.
Строку можно создать двумя основными способами: вручную через пользовательскую форму или программно из кода конфигурации. Выбор способа зависит от того, где нужно добавить данные: в уже открытом документе, при проведении, в обработке загрузки или при изменении объекта извне. Ручной способ подходит для разовой работы пользователя, программный — для массового заполнения и автоматизации.
Перед созданием строки важно убедиться, что табличная часть доступна для редактирования. В некоторых формах строки блокируются после проведения документа, закрытия периода или установки флага только для чтения. Попытка добавить запись в заблокированную часть может привести к ошибке или игнорированию действия.
Что такое табличная часть и где создаются строки
Табличная часть относится к реквизитам объекта типа «Таблица значений» или «Табличная часть» в терминологии конфигуратора. Она отображается на форме как область со строками и столбцами, где каждая строка соответствует одной записи. У табличной части есть имя, например Товары, Серии, Платежи или СтатьиРасходов, и набор реквизитов строк.
Создавать строки можно в форме документа, справочника, акта, заказа или любой другой конфигурации, где предусмотрена такая часть. В конфигураторе табличная часть настраивается разработчиком, а пользователь работает с ней уже в готовом приложении. Если реквизит отсутствует в объекте, добавить строку в него невозможно без изменения конфигурации.
Создание строки вручную в форме документа
Откройте документ или справочник в режиме редактирования и найдите область табличной части. Обычно в нижней или правой части формы есть пустая строка или кнопка добавления. Нажатие на пустую строку или соответствующую команду создаёт новую запись, после чего можно заполнять её ячейки.
В некоторых формах добавление строки доступно только после выбора основного реквизита, например контрагента или склада. Если кнопка добавления неактивна, проверьте обязательные поля шапки документа и права доступа к объекту. После ввода данных строка сохраняется вместе с документом при записи или проведении.
- 1Откройте объект в режиме редактирования
- 2Найдите табличную часть и нажмите кнопку добавления или пустую строку
- 3Заполните реквизиты новой строки
- 4Запишите документ или объект
- 5Проверьте, что строка сохранилась после переоткрытия
Программное добавление строки в модуле объекта
В коде конфигурации строка добавляется методом Добавить() у соответствующей табличной части объекта. Например, в модуле документа можно обратиться к реквизиту Товары и вызвать у него метод добавления. Возвращаемое значение — ссылка на только что созданную строку, с которой можно сразу работать.
Примерный фрагмент кода в модуле объекта может выглядеть так:
НоваяСтрока = Объект.Товары.Добавить();
После создания строки остаётся заполнить её реквизиты. Обращение к полю строки выполняется через имя реквизита табличной части, например НоваяСтрока.Номенклатура или НоваяСтрока.Количество. Значения можно брать из переменных, форм, справочников или регистров.
Различия между модулем объекта и модулем формы
В модуле объекта работа идёт с данными напрямую, независимо от открытой формы. В модуле формы доступ к табличной части часто осуществляется через элементы формы, например Элементы.Товары.ТекущиеДанные или Элементы.Товары.Добавить(). Выбор модуля зависит от того, нужно ли изменять данные объекта или управлять отображением на форме.
Программное добавление уместно при обработке импорта, заполнении по шаблону, распределении сумм между строками или создании документов из внешних источников. При массовом вводе данных рекомендуется предварительно протестировать алгоритм на копии базы или ограниченном наборе документов.
Заполнение реквизитов новой строки
Каждая строка табличной части имеет реквизиты, определённые в конфигурации. Обязательные поля помечаются в конфигураторе, и при попытке записи без их заполнения система может выдать предупреждение. Перед заполнением уточните, какие реквизиты обязательны, а какие можно оставить пустыми.
Значения реквизитов могут быть типа строка, число, дата, справочник, документ, перечисление или булево значение. При программном заполнении следите за соответствием типов: запись текста в числовое поле или ссылки на несуществующий элемент вызовет ошибку. Используйте подходящие методы поиска справочников и документов, чтобы получить корректные ссылки.
Некоторые реквизиты строк вычисляются автоматически, например сумма по цене и количеству. В таких случаях ручное изменение вычисляемого поля может быть заблокировано или перезаписано при пересчёте. Порядок расчёта зависит от настроек конфигурации и событий объекта.
Проверка результата и сохранение
После добавления строки убедитесь, что она отображается в табличной части с введёнными значениями. Запишите документ или объект, затем откройте его повторно. Если строка сохранилась, данные остались на месте и не исчезли после переоткрытия, операция выполнена корректно.
Как проверить результат
Строка осталась в табличной части при повторном открытии
Строка исчезла или форма открывается без изменений
Объект записывается без предупреждений
Система требует заполнить поля или отменяет запись
Если строка не появляется, проверьте: открыт ли объект в режиме редактирования, доступна ли табличная часть, нет ли блокировки после проведения, заполнены ли обязательные поля шапки. Также убедитесь, что у текущего пользователя есть права на изменение объекта и его табличной части.
Ограничения, типичные ошибки и альтернативы
Нельзя добавить строку в табличную часть объекта, который находится в состоянии, запрещающем редактирование. Это может быть проведённый документ, закрытый период или объект с правами только на чтение. В таких случаях нужно либо отменить проведение, если это допустимо, либо создать новый документ на основе старого.
Частые ошибки: обращение к несуществующему реквизиту табличной части, попытка добавить строку без сохранения объекта, запись некорректных ссылок на справочники, игнорирование обязательных полей. Также часто забывают, что изменения в табличной части не сохраняются отдельно от основного объекта.
Если программное создание строки вызывает сложности, альтернативой может быть использование встроенных обработок заполнения, импорта данных или ручного ввода через форму. Выбор зависит от объёма данных, частоты операции и доступных прав доступа.
Что важно запомнить
Строку табличной части создают вручную или методом Добавить(), заполняют реквизиты и сохраняют объект; результат проверяют после повторного открытия.
Часто задаваемые вопросы
Можно ли добавить строку в табличную часть проведённого документа?
Обычно нет, если документ проведён и табличная часть заблокирована конфигурацией. Необходимо отменить проведение, внести изменения и провести документ повторно, если порядок учёта это позволяет.
Что делать, если новая строка не отображается после ввода?
Проверьте режим редактирования объекта, доступность табличной части, заполнение обязательных полей шапки и права пользователя. После записи обязательно откройте объект заново для подтверждения сохранения.
Нужно ли программировать добавление строки для разовой работы?
Не обязательно. Для разового ввода удобнее использовать форму с ручным добавлением строки. Программирование оправдано при регулярном массовом заполнении или интеграции с другими системами.
Сохраняются ли изменения в табличной части отдельно от документа?
Нет, табличная часть является частью объекта, и её изменения записываются вместе с основным документом или справочником. Отдельного сохранения только строк обычно не предусмотрено.