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