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

Другое · 8 мин

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

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

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

Точное имя свойства зависит от конфигурации: в типовых решениях это могут быть «Товары», «Услуги», «СерииНоменклатуры» и другие. В коде нельзя угадывать имя; его нужно смотреть в свойствах документа в конфигураторе или через подсказку синтаксиса.

Разница между обычным и управляемым приложением важна: в модуле объекта доступ чаще через Объект или ЭтаОбъект, а в форме — через Элементы, ТекущиеДанные или свойство Объект формы. Ниже разобраны основные способы и границы безопасной работы.

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

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

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

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

Свойство объектаИмя табличной части

Смотрите в конфигураторе или подсказке синтаксиса

Статус документаПроведен или нет

Проводка часто ограничивает запись в табличную часть

Форма приложенияОбычное или управляемое

Выбор способа доступа зависит от типа формы

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

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

Доступ к табличной части в модуле документа

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

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

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

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

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

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

Работа с табличной частью в управляемой форме

В управляемой форме табличная часть отображается в элементе формы типа «Список» или «Таблица». Доступ к текущей строке часто осуществляется через Элементы.ИмяЭлемента.ТекущиеДанные. Для обхода всех строк лучше обращаться к данным объекта формы или к свойству Объект.

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

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

Выберите строку в элементе формы, получите ТекущиеДанные, измените поля и вызовите команду записи документа. Если форма открыта только для просмотра, изменения будут недоступны даже при наличии прав на документ.

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

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

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

Чтение строк выполняется циклом Для каждого Строка Из Объект.ИмяТабличнойЧасти Цикл. Внутри цикла доступны реквизиты строки, такие как номенклатура, количество, сумма или ставка налога, в зависимости от конфигурации.

bsl
Для каждого Строка Из Объект.Товары Цикл Строка.Количество = Строка.Количество + 1 КонецЦикла; Объект.Запись();

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

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

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

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

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

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

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

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

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

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

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

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

При массовой обработке документов работайте через серверные вызовы и транзакции. Это снижает риск частичной записи и повреждения данных при ошибке в середине обработки.

Итог

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

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

Как узнать точное имя табличной части?

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

Почему табличная часть пустая, хотя строки есть?

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

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

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

Что делать, если изменения не сохраняются?

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