Как при открытии журнала подчиненных документов получить документ-основание в 1С 7.7?

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

Чтобы программно ограничить интервал журнала при его открытии, сначала необходимо определить, для какого именно документа пользователь запрашивает подчиненные. Однако при интерактивном открытии привычные инструменты (например, Форма.Параметр или функция ТекущийДокумент()) в событии ПриОткрытии() возвращают пустое значение. Разберем по шагам, как решить эту проблему и корректно получить документ-основание.

Выясним причину: почему стандартные методы не работают?

Проанализируем поведения платформы при вызове журнала подчиненных документов:

1. Интерактивный вызов без параметров: Когда пользователь нажимает правой кнопкой мыши на строке общего журнала и выбирает пункт «Подчиненные документы», платформа не передает контекст родительского документа через Форма.Параметр. Этот реквизит остаётся не задействованным.
2. Неопределенность текущего документа: В момент выполнения предопределенной процедуры ПриОткрытии() самого журнала выборка строк еще не сформирована, поэтому функция ТекущийДокумент() не содержит ссылочных данных.

Решение: использование встроенного метода ПодчинениеДокументу()

В платформе 1С 7.7 для работы с журналом подчиненных документов предусмотрен специализированный метод ПодчинениеДокументу(). Данный метод доступен исключительно в контексте модуля формы журнала подчиненных документов.

Рассмотрим синтаксис функции:

ПодчинениеДокументу(<Докум>, <ФлагАвтоСменыПодчинен>)

Параметры функции:

1. <Докум> (необязательный) — значение типа «Документ», подчиненные записи которого должен отобразить журнал. Если параметр не указан, функция не меняет текущего родителя, а возвращает ссылку на текущий документ-основание.
2. <ФлагАвтоСменыПодчинен> (необязательный) — флаг автоматического обновления отображения журнала при смене документа-владельца (1 — включено, 0 — выключено).

Возвращаемое значение: значение типа «Документ» — текущий документ-основание, для которого сформирован журнал.

Пример программной реализации

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

Процедура ПриОткрытии()
    Перем ДокументОснование;
    
    // Получаем документ, по которому открывается список подчиненных
    ДокументОснование = ПодчинениеДокументу();
    
    // Проверяем, выбран ли документ-основание
    Если ПустоеЗначение(ДокументОснование) = 0 Тогда
        // Устанавливаем начальную дату интервала равной дате документа-основания,
        // а конечную дату — текущей рабочей дате
        УстановитьИнтервал(ДокументОснование.ДатаДок, РабочаяДата());
    КонецЕсли;
КонецПроцедуры

Разберем подробнее, как работает приведенный код:

1. При вызове журнала система выполняет процедуру ПриОткрытии().
2. Функция ПодчинениеДокументу() без параметров возвращает ссылку на документ, выбранный пользователем в исходном журнале.
3. С помощью ПустоеЗначение() проверяется корректность полученной ссылки.
4. Метод УстановитьИнтервал() сужает период поиска подчиненных документов от даты самого документа-основания до текущей рабочей даты. Это предотвращает сканирование всей таблицы журнала за прошлые годы и существенно ускоряет работу программы.

Дополнительные рекомендации по оптимизации

Чтобы окончательно исключить зависания при просмотре структуры подчиненности, обратите внимание на следующие моменты:

1. Обработка изменения интервала пользователем: Пользователь может попытаться расширить интервал вручную. Чтобы избежать сплошного сканирования базы, можно перехватить процедуру ПриУстановкеИнтервала(ДатаНач, ДатаКон) в модуле журнала и отменять установку слишком широкого периода с помощью СтатусВозврата(0).
2. Использование внешних обработок: Если требуется отображать подчиненность в виде наглядного дерева с произвольной группировкой, вместо стандартного журнала подчиненных документов часто применяют обработку (например, «Дерево документов»), вызов которой выполняется с передачей контекста через ОткрытьФорму("Отчет.ДеревоДокументов", ДокументСсылка).