Гиперссылка

Гиперссылка не вызывает действие при срабатывании.

При выборе данного действия появляется поле «Имя файла», в котором необходимо указать файл, который будет открываться при активации гиперссылки. Для указания файла нажмите кнопку  «Обзор», расположенную в этом поле. Будет открыто стандартное окно выбора файла.

При выборе данного действия появляется поле «Ссылка». Введите в нём требуемый адрес ссылки, по которой будет осуществлен переход при нажатии на гиперссылку.

При выборе данного действия появляется раскрывающийся список «Листы отчета» Выберите в нём лист, на который будет осуществлен переход при нажатии на гиперссылку.

При выборе данного действия появится поле «Описание диапазона». Введите в нём диапазон ячеек, который будет выделяться при нажатии на ссылку. Доступные варианты ввода диапазона:

• для описания прямоугольной области укажите через двоеточие сначала адрес верхней левой ячейки, с которой начинается диапазон, а затем адрес нижней правой ячейки, на которой заканчивается диапазон;

• если необходимо позиционирование на одной ячейки, то укажите только её адрес;

• для описания комбинированной области через точку с запятой («;») укажите адреса прямоугольных областей и отдельных ячеек, из которых состоит данная область.

При выборе данного действия появляется раскрывающийся список «Объекты отчета». Выберите в нём объект, на который будет осуществлён переход при нажатии на ссылку. Объектами являются диаграммы, карты, рисунки и т.д.

При выборе данного действия появляется раскрывающийся список «Объекты репозитория». Выберите в нём объект репозитория, который будет открываться при нажатии на гиперссылку.

При выборе данного действия появляются дополнительные поля:

• Модуль. Выберите модуль среды разработки, подключенный к регламентному отчёту;

• Процедура/функция. Укажите имя процедуры/функции, которую необходимо запустить в настольном приложении при нажатии на гиперссылку;

• JS-функция. Укажите имя js-функции, которую необходимо запустить в веб-приложении при нажатии на гиперссылку. Это может быть как системная, так и пользовательская js-функция. Наименование функции указывается в виде:

Наименование функции (пользовательские параметры, args)

Параметры:

Пользовательские параметры. Требуемые параметры;

Args. Аргументы функции.

Сигнатура функции:

function <Наименование функции>(пользовательские параметры, args)

{

…

}

Пример функции:

function testHyperlink(type, args)

{

debugger;

console.log(type);

console.log(args);

}

Примечание. Допускается указывать только имя процедуры/функции или только имя js-функции. В данном случае гиперссылка будет работать только в настольном или только в веб-приложении.

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

• Report. Параметр для управления отчётом;

• ReportOdId. Идентификатор отчёта;

• DataEntryForm. Параметр для управления формой ввода. Доступен только для форм ввода;

• DataArea. Параметр для управления табличной областью. Доступен только для форм ввода.

Пример функции при использовании в форме ввода:

function addAttachmentsTB(row, col, args)

{

           var rep = args.Report;

           var da = args.DataArea;

           var grid = da.getGridView();

           var tabSheet = grid.getTabSheet();

           var tabSheetRange = tabSheet.getCell(row, col);

           attachFile(da, tabSheetRange);

}

Подключённый к регламентному отчёту модуль позволяет:

• обрабатывать ввод данных «на лету»;

• выводить диалог подтверждения выполняемого действия;

• выполнять дополнительные действия перед и/или после возникновения какого-либо события;

• выводить информационные сообщения, содержащие определенную информацию (например, идентификатор измененного элемента управления, тип гиперссылки и т.д.) и др.

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

• модуле/форме репозитория: <наименование процедуры/функции>;

• одном из объектов сборки репозитория: <наименование процедуры/функции>.

Примечание. Сигнатура процедуры/функции может содержать параметры.

Для получения представления о создании гиперссылки обратитесь к разделу «Пример создания гиперссылки».