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

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

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

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

  • Fields!FieldName.PropertyName

  • Fields!FieldName("PropertyName")

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

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

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

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

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

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

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

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

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

Значения расширенных свойств полей доступны только в том случае, когда они включены в многомерное выражение, а источник данных предоставляет эти значения в момент выполнения отчета и получения им данных. Затем можно ссылаться на эти значения свойства 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!FieldName("PropertyName")

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

Свойство

Тип

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

FORMAT_STRING

String

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