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