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