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

← На главную

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

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

Способ 1. Использование скрытой колонки со ссылкой и события «Выбор»

Рассмотрим классический способ, когда в таблице формы (табличной части обработки или динамическом списке) присутствуют две колонки:

Строковая колонка (например, РеализацияТоваровУслуг) — отображает нужный нам произвольный текст, сформированный программно или в запросе.
Ссылочная колонка (например, Ссылка) — содержит прямую ссылку на документ. В свойствах элемента формы для этой колонки снимаем флаг Видимость, чтобы не загромождать интерфейс.

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

Посмотрим на пример реализации с использованием универсального асинхронного метода платформы ПоказатьЗначение:


&НаКлиенте
Процедура ТаблицаДокументовВыбор(Элемент, ВыбраннаяСтрока, Поле, СтандартнаяОбработка)
    
    СтандартнаяОбработка = Ложь;
    
    ТекущиеДанные = Элемент.ТекущиеДанные;
    Если ТекущиеДанные <> Неопределено И ЗначениеЗаполнено(ТекущиеДанные.Ссылка) Тогда
        ПоказатьЗначение(, ТекущиеДанные.Ссылка);
    КонецЕсли;
    
КонецПроцедуры

Разберем важные нюансы этого кода:

Инструкция СтандартнаяОбработка = Ложь; отключает стандартное платформенное действие (например, попытку открыть на редактирование строковую ячейку).
Проверка ТекущиеДанные <> Неопределено обязательна, так как при клике по пустой области таблицы или заголовку свойство вернет Неопределено, что без проверки приведет к аварийному завершению работы формы.
Метод ПоказатьЗначение является универсальным: он автоматически определяет тип переданной ссылки и открывает основную форму соответствующего объекта метаданных.

Способ 2. Открытие документа через метод «ОткрытьФорму»

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


&НаКлиенте
Процедура ТаблицаДокументовВыбор(Элемент, ВыбраннаяСтрока, Поле, СтандартнаяОбработка)
    
    СтандартнаяОбработка = Ложь;
    
    ТекущиеДанные = Элемент.ТекущиеДанные;
    Если ТекущиеДанные <> Неопределено И ЗначениеЗаполнено(ТекущиеДанные.Ссылка) Тогда
        ПараметрыФормы = Новый Структура("Ключ", ТекущиеДанные.Ссылка);
        ОткрытьФорму("Документ.РеализацияТоваровУслуг.ФормаОбъекта", ПараметрыФормы);
    КонецЕсли;
    
КонецПроцедуры

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

Способ 3. Оформление ячейки в виде гиперссылки

Чтобы пользователь мог перейти к документу не по двойному щелчку, а по одиночному клику, строковую колонку можно оформить как гиперссылку. Разберем по шагам, как это настроить:

В дереве элементов формы выберем поле ввода строковой колонки.
В палитре свойств установим флаг Гиперссылка.
Для этого поля добавим обработчик события НажатиеГиперссылки.

Посмотрим на пример кода для данного события:


&НаКлиенте
Процедура РеализацияТоваровУслугНажатиеГиперссылки(Элемент, СтандартнаяОбработка)
    
    СтандартнаяОбработка = Ложь;
    
    ТекущиеДанные = Элементы.ТаблицаДокументов.ТекущиеДанные;
    Если ТекущиеДанные <> Неопределено И ЗначениеЗаполнено(ТекущиеДанные.Ссылка) Тогда
        ПоказатьЗначение(, ТекущиеДанные.Ссылка);
    КонецЕсли;
    
КонецПроцедуры

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

Способ 4. Подмена текста через «Условное оформление»

Если в таблице используется только одна колонка с типом ДокументСсылка.РеализацияТоваровУслуг, можно обойтись без создания скрытых полей и программных обработчиков событий. Платформа позволяет переопределить выводимый текст ячейки через механизм условного оформления.

Рассмотрим, как настроить условное оформление динамического списка или формы:

Перейдем в свойства формы или динамического списка к пункту Условное оформление.
Добавим новый элемент оформления.
В секции Оформление включим свойство Текст и укажем желаемое представление (или настроим вычисление).
В секции Оформляемые поля выберем колонку со ссылкой на документ.

При таком подходе колонка сохраняет все базовые свойства ссылки (стандартное контекстное меню, открытие по двойному клику, кнопку выбора), но отображает требуемый пользовательский текст.