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