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

Другое · 7 мин

Табличная часть документа в 1С: создание и настройка

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

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

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

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

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

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

Что такое табличная часть и зачем она нужна

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

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

Как добавить табличную часть в конфигурации

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

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

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

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

Настройка реквизитов строк и свойств колонок

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

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

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

Отображение на форме документа и работа с пользователем

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

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

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

Программное заполнение и проверка данных

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

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

Типичные ошибки
01
Создание табличного поля на форме без табличной части в конфигурации
02
Отсутствие проверки обязательных реквизитов перед записью
03
Редактирование структуры на производственной базе без копии

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

Частые ошибки и контроль перед вводом в эксплуатацию

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

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

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

Открытие документа с табличной частью
Норма

Строки отображаются и сохраняются

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

Строки отсутствуют или не сохраняются

Проведение документа
Норма

Движения формируются без ошибок

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

Ошибка записи или некорректные остатки

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

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

Итог

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

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

Нужно ли программировать табличную часть, если она уже есть в конфигурации?

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

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

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

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

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

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

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