1С: Как получить подчиненные документы и связанные объекты

Работа с конфигурациями на платформе 1С:Предприятие часто требует не просто создания записей, а глубокого анализа связей между объектами. Когда пользователь или разработчик задается вопросом, как получить подчиненные документы, речь может идти о двух принципиально разных сущностях: либо о документах, созданных на основании текущего (цепочка оснований), либо о документах, которые породили движения регистра, связанные с текущим объектом. Понимание этой разницы критически важно для корректного построения логики программы.

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

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

Механизм связей «Основание» и цепочки документов

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

Однако цепочка может быть длинной. Документ А является основанием для Документа Б, который, в свою очередь, стал основанием для Документа В. Если вам нужно получить всю иерархию подчиненных документов, рекурсивный подход в запросе будет наиболее эффективным решением. Использование оператора ИЗ с условием по полю Основание позволяет быстро отфильтровать нужные записи без лишних циклов в коде.

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

• 🔗 Прямая связь через реквизит «Основание» работает быстрее всего и не требует сложных вычислений.
• 🔄 Рекурсивные запросы необходимы, если нужно получить всю глубину вложенности цепочки документов.
• ⚠️ Внимание: При удалении документа-основания связь может разрываться, если не настроено каскадное удаление или контроль целостности.

Использование метода GetMovement для анализа движений

Более сложный и профессиональный подход к поиску «подчиненных» сущностей лежит через анализ движений регистров. Метод GetMovement, доступный для объектов документов, позволяет получить набор записей движений, сформированных этим документом. Это ключевой инструмент для понимания того, как именно документ повлиял на итоги системы.

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

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

Движения = ДокументОбъект.GetMovement;
Пока Движения.Следующий Цикл
// Анализ каждого движения
Ключ = Движения.Регистр.КлючЗаписи;
КонецЦикла;

⚠️ Внимание: Метод GetMovement может работать медленно на больших объемах данных, если документ содержит тысячи строк в табличной части. Используйте его с осторожностью в высоконагруженных системах.

Поиск документов через виртуальные таблицы регистров

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

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

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

Тип таблицы	Назначение	Производительность
Таблица регистра	Чтение всех записей подряд	Низкая
Срез последних	Получение актуального состояния	Высокая
Обороты	Анализ изменений за период	Средняя
Остатки	Получение сальдо на дату	Высокая

Обработка фиктивных движений и служебных записей

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

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

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

Что такое фиктивные движения?

Фиктивные движения — это записи в регистрах, которые не влияют на итоговые суммы в отчетах для пользователя, но используются системой для контроля логики (например, блокировка товара при резерве). Они часто имеют признак «ФиктивноеДвижение» = Истина.

Оптимизация запросов при работе с большими объемами

Когда речь заходит о тысячах и миллионах записей, наивный подход к получению подчиненных документов становится неприемлемым. Циклический перебор документов в коде 1С «убивает» производительность сервера. Единственно верный путь — перенос логики отбора на сторону СУБД с помощью грамотно составленных запросов.

Использование временных таблиц в запросах позволяет предварительно отфильтровать нужный набор документов-источников, а затем одним джойном (ЛЕВОЕ СОЕДИНЕНИЕ) получить все связанные записи. Это снижает нагрузку на память и ускоряет выполнение кода в разы.

Также следует избегать использования функций в условиях отбора запроса, если это возможно. Функции, примененные к полям таблицы, часто препятствуют использованию индексов, что приводит к полному сканированию таблицы. Вместо ГОД(Период) = 2026 лучше использовать диапазон дат Период МЕЖДУ.. И...

• 🚀 Используйте временные таблицы для промежуточной фильтрации больших массивов данных.
• 📉 Избегайте функций в условиях WHERE, чтобы задействовать индексы базы данных.
• ⚠️ Внимание: Структура индексов в физической базе данных может отличаться от конфигурации, проверяйте план выполнения запроса.

⚠️ Внимание: Интерфейсы и методы работы с регистрами могут различаться в типовых конфигурациях (Бухгалтерия, УТ, ЗУП) и самописных решениях. Всегда проверяйте актуальность имен полей и таблиц в вашей конкретной версии платформы.

Типичные ошибки и способы их предотвращения

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

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

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

Как получить документы, введенные на основании, если реквизит пуст?

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

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

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

Влияет ли удаление документа-основания на подчиненные документы?

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

Какой метод быстрее: запрос или обход коллекции движений?

Запрос к базе данных почти всегда быстрее и эффективнее, чем обход коллекции движений в цикле, особенно при работе с большими объемами данных, так как запрос выполняется на стороне СУБД.