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

Другое · 7 мин

Как записать в табличную часть документа в 1C

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

Табличная часть документа в 1C предназначена для хранения нескольких однородных строк, связанных с одним документом. Например, в документе «Заказ покупателя» табличная часть может содержать номенклатуру, количество, цену и сумму по каждой позиции. Каждая строка табличной части — это отдельный объект с набором реквизитов, который существует только в рамках документа.

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

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

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

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

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

1c
Объект = Документы.ЗаказПокупателя.СоздатьДокумент();
Строка = Объект.Товары.Добавить();
Строка.Номенклатура = Номенклатура;
Строка.Количество = 10;
Объект.Записать();

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

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

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

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

Добавление и заполнение строк табличной части

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

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

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

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

Открытый документ
Норма

Табличная часть содержит добавленные строки с верными реквизитами

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

Строки отсутствуют или реквизиты пустые

Регистры после проведения
Норма

Движения соответствуют строкам табличной части

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

Расхождения между табличной частью и регистрами

Сохранение, проведение и проверка результата

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

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

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

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

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

Типичные ошибки
01
Изменение проведенного документа без отмены проведения может нарушить регистры
02
Обращение к строке по индексу после удаления предыдущих строк ведет к неверным данным

Альтернативные способы и выбор варианта

Запись в табличную часть может выполняться непосредственно в форме документа, в модуле документа или во внешней обработке. Форма удобна для ручного ввода, а программная запись — для импорта, обмена данными и автоматизации. Выбор зависит от того, кто инициирует изменение и какое количество строк требуется обработать.

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

Итог

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

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

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

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

Что делать, если запись документа с табличной частью выдает ошибку?

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

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

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

Как проверить, что данные в табличной части сохранились?

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

Какие ограничения бывают у табличной части?

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