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

Другое · 9 мин

Как получить доступ к табличной части документа в 1С

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

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

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

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

Объект документа даёт прямую работу с данными, независимо от того, открыта ли форма на экране. Через него удобно читать и менять строки в серверном модуле, особенно при массовой обработке. Форма подходит, когда нужно отразить выделение пользователя, текущую строку или состояние элементов управления.

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

Как определить объект и форму документа

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

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

Сценарий: чтение в серверном модуле

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

Сценарий: чтение в клиентском модуле

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

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

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

Чтение строк табличной части через объект

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

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

Изменение и запись строк табличной части

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

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

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

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

Доступ через форму документа и элементы управления

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

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

Сценарий: работа с текущей строкой

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

Сценарий: работа с выделенными строками

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

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

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

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

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

Количество строк и значения ключевых колонок после записи
Норма

Данные совпадают с введенными

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

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

Флаг проведения и движения в регистрах
Норма

Документ в ожидаемом состоянии

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

Несоответствие остатков после корректировки

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

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

Типичные ошибки
01
Прямая правка проведенного документа без отмены проведения
02
Изменение формы без вызова записи объекта
03
Обращение к колонке без проверки наличия табличной части

Проверка результата и типичные ошибки

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

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

Способ доступаКогда подходитОграничение
Через объект документаЧтение и массовое изменение данных в модуляхТребует явной записи объекта
Через форму документаРабота с текущей или выделенной строкой в интерфейсеЗависит от режима формы и прав
Итог

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

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

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

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

В чем разница между доступом через объект и через форму?

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

Что делать, если строки табличной части не видны в форме?

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

Как проверить, что изменения в табличной части записались?

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