Гиперссылка

Текст и изображение, помещенные в ячейку, могут являться гиперссылкой. При щелчке по содержимому такой ячейки будет выполняться заданное действие.

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

Курсор мыши при движении над гиперссылкой принимает вид указателя:

Для настройки параметров гиперссылки перейдите на вкладку «Гиперссылка» диалога форматирования:

Примечание. Настройка гиперссылки с помощью вкладки «Гиперссылка» доступна только при работе в инструменте «Отчеты».

Параметры гиперссылки

В группе «Параметры гиперссылки» задайте следующие настройки:

Примечание. Для отчета может использоваться единое оформление гиперссылок, которое задается на вкладке «Настройки» в окне «Параметры». По умолчанию для гиперссылки используется подчеркнутый текст синего цвета.

Действие гиперссылки

Щелчок по гиперссылке активизирует ее и приводит к выполнению заданного действия.

Для выполнения определенного действия при щелчке по гиперссылке в раскрывающемся списке «Требуемое действие» выберите один из вариантов:

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

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

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

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

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

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

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

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

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

Модуль. Из раскрывающегося списка выберите объект среды разработки, подключенный к регламентному отчету;

Процедура/Функция. В поле укажите имя макроса, который необходимо запустить при нажатии на гиперссылку.

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

обрабатывать ввод данных «на лету»;
выводить диалог подтверждения выполняемого действия;
выполнять дополнительные действия перед и/или после возникновения какого-либо события;
выводить информационные сообщения, содержащие определенную информацию (например, идентификатор измененного элемента управления, тип гиперссылки и т.д.) и др.

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

Макрос реализован в модуле/форме репозитория: <наименование макроса>;
Макрос реализован в одном из объектов сборки репозитория: <наименование макроса>;

Макрос реализован в одном из объектов .NET-сборки репозитория: <наименование класса>.<наименование макроса>.

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

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

Для выполнения примера предполагается наличие области данных или аналитической области данных с идентификатором «EaxObject», размещенных на активном листе регламентного отчета.

Этап 1. Создание макроса

Для создания макроса в окне «Навигатор объектов» выполните команду контекстного меню «Создать > Среда разработки > Модуль». Будет открыто окно среды разработки.

Добавьте ссылки на системные сборки: Dimensions, Express, Matrix, Pivot, Report, Tab, Ui. Для этого выполните команду «Сборка > Редактировать ссылки». В открывшемся окне «Ссылки сборки» на вкладке «Системные сборки» установите флажки напротив наименований необходимых сборок.

В окне среды разработки введите следующий код:

Sub AttributeValue (Row: Integer; Column: Integer);
Var
    rep: IPrxReport;
    tab: ITabSheet;
    sheet: IPrxTable;
    DataArea: IEaxDataAreaViews;
    grid: IEaxGrid;
    result_eax: IEaxDrillResult;
    result_prx: IPrxDrillCellResult;
    slice_eax: IEaxDataAreaPivotSlice;
    slice_prx: IPrxSlice;
    dim: IDimInstance;
    DimSelection: IDimSelection;
    dim_prx: IPrxSliceDimension;
    DimAttr: IDimAttributeInstance;

    DimElements: IDimElements;
    DataBinding: IPrxTableDataBinding;
    FocusedRow, FocusedColumn, dimInd, ind: Integer;
    AttrValue: Variant;
Begin
    rep := PrxReport.ActiveReport;
    sheet := rep.ActiveSheet As IPrxTable;
    tab := sheet.TabSheet;
     // индекс строки, в которой находится ячейка с фокусом:
    FocusedRow := Row;
     // индекс столбца, в котором находится ячейка с фокусом:
    FocusedColumn := Column;
     // === Аналитическая область данных ===
    DataArea := rep.DataArea.Views;
    grid := DataArea.FindById("EaxObject") As IEaxGrid;

    result_eax := grid.DrillCellResult(FocusedRow, FocusedColumn);
    If result_eax <> Null Then
        slice_eax := grid.Slice As IEaxDataAreaPivotSlice;
        dim := slice_eax.Pivot.LeftHeader.Dim(0);
        DimSelection := result_eax.Selection.FindByKey(dim.Key);
        WinApplication.InformationBox("Значение атрибута элемента: " + #10 + #13 + DimSelection.ToString);
    End If;
     // === Область данных ===
    DataBinding := (rep.ActiveSheet As IprxTable).DataBinding;
    result_prx := DataBinding.DrillCell(FocusedRow, FocusedColumn);
    If result_prx <> Null Then

        slice_prx := rep.DataSources.Item(0).Slices.Item(0);
        dim_prx := slice_prx.LeftHeader.Item(0);
        dimInd := slice_prx.Selection.IndexOfKey(dim_prx.Key);
        ind := result_prx.Coord.Item(dimind);
        DimAttr := dim_prx.Dimension.Attributes.Item(0);
        DimSelection := result_prx.Selection.Item(dimind);
        DimElements := DimSelection.Dimension.Elements;
        AttrValue := DimElements.AttributeValueO(ind, DimAttr);
        WinApplication.InformationBox("Значение атрибута элемента: " + #10 + #13 + AttrValue);
    End If;
End Sub AttributeValue;

После написания и сохранения модуля подключите его к отчету.

Этап 2. Подключение модуля к отчету

Для ячейки в регламентном отчете откройте окно «Формат ячейки». Перейдите на вкладку «Гиперссылка» и в соответствующих полях укажите наименования созданного модуля и процедуры:

Примечание. В рассматриваемом примере в качестве параметров процедуры указываются номера строки и столбца области данных: AttributeValue(3, 3).

Результат

Ячейка, содержащая гиперссылку, выглядит следующим образом:

Нажмите на ячейку с гиперссылкой.

В результате выполнения примера будут получены атрибуты элемента области данных по введённым координатам ячейки области данных. Например: