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