Propriedades de campo estendidas em um tipo de conexão do Hyperion Essbase (SSRS)
A extensão de processamento de dados do Hyperion Essbase oferece suporte às propriedades de campo estendidas. As propriedades de campo estendidas são propriedades adicionais às propriedades de campo Value e IsMissing, suportadas pelo Reporting Services, que estão disponíveis na fonte de dados e são suportadas pela extensão de processamento de dados. As propriedades estendidas não são exibidas no painel Dados do Relatório como parte da coleção de campos de um conjunto de dados de relatório. Você pode incluir os valores da propriedade de campo estendida em seu relatório escrevendo as expressões que usam a coleção interna Campos que os especifica por nome.
As propriedades estendidas podem ser predefinidas ou personalizadas. As propriedades predefinidas são propriedades comuns para várias fontes de dados que são mapeadas para nomes de propriedade de campo específicos. Elas podem ser acessadas por nome pela coleção interna Campos. As propriedades personalizadas são definidas para cada provedor de dados e podem ser acessadas pela coleção interna de Campos apenas pela sintaxe que usa o nome da propriedade estendida como uma cadeia de caracteres.
Use uma das seguintes sintaxes para consultar as propriedades estendidas predefinidas em uma expressão:
Fields!FieldName.PropertyName
Fields!FieldName("PropertyName")
Trabalhando com propriedades de campo
As propriedades de campo estendidas são recuperadas junto com os campos de conjunto de dados de relatório quando você executa uma consulta MDX usando o Provedor de Dados do Microsoft .NET Framework do Hyperion Essbase. Os campos e as propriedades de dimensão e de célula na consulta MDX são recuperados a partir da fonte de dados.
As propriedades de campo correspondem às seguintes categorias:
Propriedades de campo para as quais normalmente existe suporte de vários provedores de dados e que são mapeadas para propriedades de campo predefinidas do conjunto de dados de relatório. Por exemplo, a propriedade Value predefinida do conjunto de dados de relatório representa a propriedade padrão do valor de uma medida ou dimensão na fonte de dados. O valor padrão para uma medida é um valor numérico. O valor padrão para uma dimensão é uma descrição amigável criada pelo usuário. Para incluir o valor padrão em uma caixa de texto, use a expressão =Fields!<FieldName>.Value.
Propriedades de campo predefinidas para as quais normalmente existe suporte de vários provedores de dados e que aparecem na consulta MDX subjacente a um conjunto de dados de relatório. Por exemplo, a propriedade de dimensão MDX MEMBER_UNIQUE_NAME é mapeada para a propriedade de campo predefinida do conjunto de dados de relatório UniqueName. Para incluir o valor de nome exclusivo em uma caixa de texto, use a expressão =Fields!<FieldName>.UniqueName.
Propriedades de campo personalizadas para as quais existe suporte de um provedor de dados e que aparecem na consulta MDX subjacente a um conjunto de dados de relatório, mas não aparecem no painel Conjuntos de Dados de relatório como campos daquele conjunto de dados. Por exemplo, Nomes Longos é uma propriedade do membro definida para um nível de dimensão. Para incluir o valor em uma caixa de texto, use a expressão =Fields!<FieldName>("Long Names"). Os nomes de campo na expressão fazem distinção de maiúsculas e minúsculas.
O nome de uma propriedade de campo estendida aparece na Dica de Ferramenta quando você para o mouse sobre um campo no painel Metadados no designer de consulta. Para obter mais informações sobre o designer de consulta que pode ser usado para explorar os dados subjacentes, consulte Interface de usuário do Designer de Consulta do Hyperion Essbase.
Para obter mais informações sobre como usar os campos e as propriedades de campo em uma expressão, consulte Usando coleções internas em expressões (Construtor de Relatórios 3.0 e SSRS).
.gif "Observação") Observação |
|---|
Os valores para essas propriedades de campo estendidas passarão a existir somente se eles forem incluídos na expressão MDX e a fonte de dados fornecer esses valores quando você executar e recuperar os dados de seus conjuntos de dados. Dessa forma, você poderá consultar esses valores da propriedade Field a partir de qualquer expressão usando a sintaxe descrita na seção seguinte. Entretanto, como esses campos são específicos para esse provedor de dados e não faz parte da linguagem de definição de relatório, as alterações que forem feitas nesse valor não serão salvas com a definição de relatório. |
Propriedades de campo predefinidas
A tabela a seguir fornece uma lista das propriedades de campo predefinidas que você pode usar para a fonte de dados do Hyperion Essbase.
Propriedade |
Tipo |
Descrição ou valor esperado |
|---|---|---|
Value |
Object |
Especifica o valor de dados do campo. Em uma propriedade de dimensão, é mapeada para MEMBER_CAPTION. Em uma medida, é mapeada para um valor de dados. |
IsMissing |
Boolean |
Indica se o campo foi encontrado no conjunto de dados resultante. |
FormattedValue |
String |
Retorna um valor formatado para o número chave. Mapeada a partir de FORMATTED_VALUE na expressão MDX. |
BackgroundColor |
String |
Retorna a cor do segundo plano definida no banco de dados para o campo. Mapeada a partir de BACK_COLOR na expressão MDX. |
Color |
String |
Retorna a cor do primeiro plano definida no banco de dados para o item. Mapeada a partir de FORE_COLOR na expressão MDX. |
UniqueName |
String |
Retorna o nome totalmente qualificado de um nível. Mapeada a partir de MEMBER_UNIQUE_NAME na expressão MDX. |
Propriedades personalizadas
Use a sintaxe a seguir para consultar as propriedades estendidas personalizadas em uma expressão:
- Fields!FieldName("PropertyName")
A tabela a seguir mostra a propriedade de campo personalizada que você pode usar para uma fonte de dados do Hyperion Essbase.
Propriedade |
Tipo |
Descrição ou valor esperado |
|---|---|---|
FORMAT_STRING |
String |
Definida em uma medida, FormattedValue está disponível como um tipo Cadeia de Caracteres. |