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