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

Другое · 6 мин

Как добавить данные в табличную часть документа 1С

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

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

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

Способы добавления строк в табличную часть

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

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

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

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

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

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

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

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

Работа с формой и текущими данными

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

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

Проведенные документы и ограничения

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

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

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

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

Количество строк в сохраненном документе
Норма

Совпадает с введенным

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

Меньше ожидаемого или строки отсутствуют

Итоговые суммы
Норма

Сходятся с исходными данными

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

Отклоняются или нулевые

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

Сформированы корректно

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

Отсутствуют или некорректны

Импорт и загрузка больших объемов

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

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

Типичные ошибки
01
Добавлена строка, но документ не сохранен, изменения потеряны
02
Указано значение справочника, которого нет в базе, запись отклоняется
03
Редактирование проведенного документа без отмены проведения ломает движения

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

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

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

Итог

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

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

Можно ли добавить строку в табличную часть уже проведенного документа?

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

Чем отличается добавление строки в форме от программного добавления?

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

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

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

Нужно ли делать резервную копию перед массовой загрузкой в табличные части?

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

Можно ли править табличную часть напрямую в базе данных?

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