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