Поделиться через

  • Статья

Использование расширенных свойств поля в кубе Hyperion Essbase (построитель отчетов 2.0)

Модуль обработки данных Hyperion Essbase поддерживает расширенные свойства полей. Расширенные свойства полей — это свойства, предоставленные дополнительно к поддерживаемым службами Reporting Services свойствам полей, доступные для конкретного источника данных, помимо свойств Value и IsMissing, и поддерживаемые модулем обработки данных. Расширенные свойства не отображаются в области Данные отчета как часть коллекции полей набора данных для отчета. Включить значения расширенных свойств поля в отчет можно, добавив выражения, использующие встроенную коллекцию Fields, которая указывает их по именам.

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

Для обращения к стандартному расширенному свойству в выражении применяется следующий синтаксис.

  • Fields!ИмяПоля.ИмяСвойства

  • Fields!ИмяПоля("ИмяСвойства")

Работа со свойствами поля

Расширенные свойства полей получаются одновременно с полями набора данных отчета при выполнении запроса многомерных выражений при помощи поставщика данных платформы Microsoft.NET Framework для Hyperion Essbase. Поля и свойства измерений и ячеек, указываемые в запросе многомерных выражений, извлекаются из источника данных.

Свойства поля делятся на следующие категории.

  • Свойства поля, которые поддерживаются многими поставщиками данных и сопоставлены со стандартными свойствами поля набора данных для отчета. Например, стандартное свойство Value набора данных для отчета представляет свойство по умолчанию для значения меры или измерения в источнике данных. Значение меры по умолчанию является числовым значением. Значением измерения по умолчанию является понятный пользователю заголовок. Для включения в текстовое поле значения по умолчанию используется следующее выражение: =Fields!<FieldName>.Value.

  • Стандартные свойства поля поддерживаются большинством поставщиков данных и указываются в запросах многомерных выражений к набору данных для отчета. Например, свойство измерения MEMBER_UNIQUE_NAME многомерного выражения сопоставлено со стандартным свойством UniqueName поля набора данных для отчета. Для включения в текстовое поле уникального имени используется следующее выражение: =Fields!<FieldName>.UniqueName.

  • Пользовательские свойства полей поддерживаются поставщиками данных и могут быть указаны в базовом запросе многомерных выражений для набора данных отчета, однако не отражаются в области наборов данных отчета в виде полей. Например, Long Names — это свойство элемента, определенное для уровня измерения. Для включения в текстовое поле этого значения используйте выражение =Fields!<FieldName>("Long Names"). Имена полей в выражении учитывают регистр символов.

Имя расширенного свойства поля появляется в подсказке, если задержать указатель мыши над любым полем в области метаданных конструктора запросов. Дополнительные сведения об использовании конструктора запросов для исследования данных см. в разделе Пользовательский интерфейс конструктора запросов Hyperion Essbase (построитель отчетов 2.0).

Дополнительные сведения об использовании полей и их свойств в выражениях см. в разделе Применение встроенных коллекций в выражениях (построитель отчетов 2.0).

ПримечаниеПримечание

Значения расширенных свойств полей доступны только в том случае, когда они включены в многомерное выражение, а источник данных предоставляет эти значения в момент выполнения отчета и получения им данных. Затем можно ссылаться на эти значения свойства Field из любого выражения с помощью синтаксиса, описанного в следующем разделе. Но поскольку эти поля относятся только к этому поставщику данных и не являются частью языка определения отчетов, изменения в этих значениях не сохраняются вместе с определением отчета.

Стандартные свойства полей

В следующей таблице представлен список стандартных свойств поля, которые можно использовать для источника данных Hyperion Essbase.

Свойство

Тип

Описание или ожидаемое значение

Value

Object

Указывает значение данных поля.

Для свойства измерения оно сопоставлено с параметром MEMBER_CAPTION. Для меры оно сопоставлено со значением данных.

IsMissing

Boolean

Указывает, найдено ли поле в полученном наборе данных.

FormattedValue

String

Возвращает форматированное значение для ключевой цифры.

В многомерном выражении сопоставляется с FORMATTED_VALUE.

BackgroundColor

String

Возвращает фоновый цвет, определенный для поля в базе данных.

В многомерном выражении сопоставляется с BACK_COLOR.

Color

String

Возвращает цвет текста, определенный для элемента в базе данных.

В многомерном выражении сопоставляется с FORE_COLOR.

UniqueName

String

Возвращает полное имя уровня.

В многомерном выражении сопоставляется с MEMBER_UNIQUE_NAME.

Пользовательские свойства

Для обращения к пользовательскому расширенному свойству в выражении применяется следующий синтаксис.

  • Fields!ИмяПоля("ИмяСвойства")

В следующей таблице приведен список пользовательских свойств поля, которые могут быть использованы для источника данных Hyperion Essbase.

Свойство

Тип

Описание или ожидаемое значение

FORMAT_STRING

String

Определяется для меры, это FormattedValue, доступное в виде типа String.