Как открыть документ из ячейки отчета в 1С 7.7?

← На главную

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

Разберем подробно, какие настройки необходимо выполнить в макете и модуле отчета, чтобы расшифровка работала корректно.

Шаг 1. Правильное заполнение свойства «Расшифровка»

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

Рассмотрим, что именно должно быть указано в свойстве Расшифровка для ячейки макета:

Если данные выбираются из таблицы значений, укажем выражение вида: тбЗначений.Док.ТекущийДокумент.
Если используется объект выборки документов (например, созданный через СоздатьОбъект("Документ")), укажем: Док.ТекущийДокумент.
Если данные формируются через запрос, в качестве расшифровки передадим группировку запроса с типом «Документ»: Запрос.Документ.ТекущийДокумент.

Важное условие: значение, передаваемое в расшифровку, обязательно должно иметь тип Документ и быть позиционировано на конкретном объекте базы данных (метод Выбран() должен возвращать 1).

Шаг 2. Включение режима «Только просмотр» для таблицы

Самая распространенная причина, по которой расшифровка не срабатывает (даже если курсор меняется на значок лупы), заключается в том, что табличный документ находится в режиме редактирования. По умолчанию double-click по ячейке переводит ее в режим ввода текста, а не вызывает обработку расшифровки.

Чтобы платформа перехватывала клик как команду расшифровки, перед выводом таблицы на экран необходимо перевести ее в режим просмотра с помощью метода ТолькоПросмотр().

Посмотрим на пример кода формирования отчета:


Таб = СоздатьОбъект("Таблица");
Таб.ИсходнаяТаблица("Макет");

// Заполнение и вывод секций таблицы
Пока Запрос.Группировка() = 1 Цикл
    Таб.ВывестиСекцию("Строка");
КонецЦикла;

// Включаем режим "Только просмотр" для корректной работы расшифровки
Таб.ТолькоПросмотр(1);
Таб.Показать("Отчет по документам");

Шаг 3. Программная обработка расшифровки (при необходимости)

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

Проанализируем пример такой процедуры:


Процедура ОбработкаЯчейкиТаблицы(Значение, ФлагСтандОбраб, Таблица, Адрес)
    Если ТипЗначенияСтр(Значение) = "Документ" Тогда
        Если Значение.Выбран() = 1 Тогда
            // Открываем форму документа программой
            ОткрытьФорму(Значение);
            // Отменяем стандартную обработку платформы
            ФлагСтандОбраб = 0;
        КонецЕсли;
    КонецЕсли;
КонецПроцедуры

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

Частые ошибки и способы их устранения

Выясним основные причины, почему документ может не открываться из отчета:

Таблица не переведена в режим просмотра: не вызван метод Таб.ТолькоПросмотр(1). Ячейка просто становится доступной для редактирования текста.
Объект не выбран: передан контекст документа, у которого Выбран() = 0 (например, неудачный поиск через НайтиДокумент()). Передавайте только позиционированные объекты.
Передана строка вместо объекта: в поле расшифровки случайно попало текстовое представление номера или даты документа. Проверяйте тип значения с помощью ТипЗначенияСтр().
Блокировка стандартной обработки: в процедуре ОбработкаЯчейкиТаблицы установлена переменная ФлагСтандОбраб = 0, но код открытия формы отсутствует.