Propriedades de Campo Estendidas para uma Base de Dados de Serviços de Análise (SSRS)

A extensão de processamento de dados SQL Server Analysis Services suporta propriedades de campo estendidas. Propriedades de campo estendidas são propriedades além das propriedades de campo Value e IsMissing que estão disponíveis na fonte de dados e suportadas pela extensão de processamento de dados. As propriedades estendidas não aparecem no painel de Dados de Relatório como parte da recolha de campo para um conjunto de dados de relatório. Pode incluir valores de propriedades de campo alargados no seu relatório, escrevendo expressões que os especifiquem pelo nome usando a coleção Fields incorporada.

As propriedades estendidas incluem propriedades predefinidas e propriedades personalizadas. Propriedades pré-definidas são propriedades comuns a múltiplas fontes de dados que são mapeadas para nomes específicos de propriedades de campos e podem ser acedidas através da coleção Fields incorporada por nome. As propriedades personalizadas são específicas para cada fornecedor de dados e só podem ser acedidas através da coleção Fields incorporada através da sintaxe, usando o nome da propriedade estendida como uma cadeia.

Quando utiliza o designer de consultas MDX dos Serviços de Análise em modo gráfico para definir a sua consulta, um conjunto pré-definido de propriedades de células e dimensões é automaticamente adicionado à consulta MDX. Só pode usar propriedades estendidas que estejam especificamente listadas na consulta MDX no seu relatório. Dependendo do seu relatório, pode querer modificar o texto padrão do comando MDX para incluir outras dimensões ou propriedades personalizadas definidas no cubo. Para mais informações sobre campos alargados disponíveis nas fontes de dados dos Serviços de Análise, consulte Criação e Utilização de Valores de Propriedade (MDX).

Trabalhar com Propriedades de Campo num Relatório

As propriedades de campo estendidas incluem propriedades pré-definidas e propriedades específicas do fornecedor de dados. As propriedades dos campos não aparecem com a lista de campos no painel de Dados de Relatório , embora estejam na consulta construída para um conjunto de dados; Portanto, não pode arrastar propriedades do campo para a superfície de design do seu relatório. Em vez disso, deve arrastar o campo para o relatório e depois alterar a propriedade Valor do campo para a propriedade que pretende usar. Por exemplo, se os dados da célula de um cubo já foram formatados, pode usar a propriedade do campo FormattedValue usando a seguinte expressão: =Fields!FieldName.FormattedValue.

Para se referir a uma propriedade estendida que não está pré-definida, use a seguinte sintaxe numa expressão:

• Fields!FieldName("PropertyName")

Propriedades de campo pré-definidas

Na maioria dos casos, propriedades de campo pré-definidas aplicam-se a medidas, níveis ou dimensões. Uma propriedade de campo pré-definida deve ter um valor correspondente armazenado na fonte de dados dos Serviços de Análise. Se um valor não existir, ou se especificar uma propriedade de campo apenas de medida num nível (por exemplo), a propriedade devolve um valor nulo.

Pode usar qualquer uma das seguintes sintaxes para se referir a uma propriedade predefinida de uma expressão:

• Campos! FieldName.PropertyName

• Fields!FieldName("PropertyName")

A tabela seguinte apresenta uma lista de propriedades de campo pré-definidas que pode utilizar.

Exemplo de Propriedades Estendidas

Para ilustrar propriedades estendidas, a seguinte consulta MDX e o conjunto de resultados incluem várias propriedades de membros disponíveis a partir de um atributo dimensional definido para um cubo. As propriedades membros incluídas são MEMBER_CAPTION, UNIQUENAME, Properties ("Day Name"), MEMBER_VALUE, PARENT_UNIQUE_NAME e MEMBER_KEY.

Esta consulta MDX corre contra o cubo AdventureWorks2025 na base de dados DW AdventureWorks2025, incluída com as bases de dados de exemplo AdventureWorks2025.

WITH MEMBER [Measures].[DateCaption]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_CAPTION'   
   MEMBER [Measures].[DateUniqueName]   
      AS '[Date].[Date].CURRENTMEMBER.UNIQUENAME'   
   MEMBER [Measures].[DateDayName]   
      AS '[Date].[Date].Properties("Day Name")'   
   MEMBER [Measures].[DateValueinOriginalDatatype]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_VALUE'   
   MEMBER [Measures].[DateParentUniqueName]   
      AS '[Date].[Date].CURRENTMEMBER.PARENT_UNIQUE_NAME'   
   MEMBER [Measures].[DateMemberKeyinOriginalDatatype]   
      AS '[Date].[Date].CURRENTMEMBER.MEMBER_KEY'   
SELECT {  
   [Measures].[DateCaption],   
   [Measures].[DateUniqueName],   
   [Measures].[DateDayName],   
   [Measures].[DateValueinOriginalDatatype],  
   [Measures].[DateParentUniqueName],  
   [Measures].[DateMemberKeyinOriginalDatatype]  
   } ON COLUMNS , [Date].[Date].ALLMEMBERS ON ROWS   
FROM [Adventure Works]  
  

Quando executa esta consulta num painel de consulta MDX, obtém um conjunto de resultados com 1158 linhas. As primeiras quatro linhas são apresentadas na tabela seguinte.

As consultas MDX padrão construídas usando o MDX Query Designer em modo gráfico incluem apenas MEMBER_CAPTION e UNIQUENAME para propriedades de dimensão. Por defeito, estes valores são sempre do tipo de dados String.

Se precisar de uma propriedade membro no seu tipo de dados original, pode incluir uma propriedade adicional MEMBER_VALUE ao modificar a instrução MDX padrão no designer de consultas em texto. Na seguinte simples instrução MDX, MEMBER_VALUE foi adicionado à lista de propriedades dimensionais a recuperar.

SELECT NON EMPTY {[Measures].[Order Count]} ON COLUMNS,   
NON EMPTY { ([Date].[Month of Year].[Month of Year] ) }   
DIMENSION PROPERTIES   
   MEMBER_CAPTION, MEMBER_UNIQUE_NAME, MEMBER_VALUE ON ROWS   
FROM [Adventure Works]  
CELL PROPERTIES   
   VALUE, BACK_COLOR, FORE_COLOR,   
   FORMATTED_VALUE, FORMAT_STRING,   
   FONT_NAME, FONT_SIZE, FONT_FLAGS  

As primeiras quatro linhas do resultado no painel de Resultados MDX aparecem na tabela seguinte.

Embora as propriedades façam parte da instrução MDX select, elas não aparecem nas colunas do conjunto de resultados. No entanto, os dados estão disponíveis para um relatório através da funcionalidade de propriedades estendidas. Num painel de resultados de consulta MDX no SQL Server Management Studio, podes clicar duas vezes na célula e ver os valores das propriedades da célula se estiverem definidos no cubo. Se clicar duas vezes na primeira célula de Contagem de Ordem que contém 1.379, verá uma janela pop-up com as seguintes propriedades da célula:

Se criar um conjunto de dados de relatório com esta consulta e associar o conjunto a uma tabela, poderá ver a propriedade VALUE predefinida de um campo, por exemplo, =Fields!Month_of_Year!Value. Se definires esta expressão como a expressão de ordenação para a tabela, os resultados serão ordenar a tabela alfabeticamente por mês porque o campo Valor usa um tipo de dado String . Para ordenar a tabela de modo a que os meses estejam na ordem em que ocorrem no ano com o primeiro de janeiro e o último dezembro, use a seguinte expressão:

=Fields!Month_of_Year("MEMBER_VALUE")  

Isto ordena o valor do campo no seu tipo de dado inteiro original a partir da fonte de dados.

Conteúdo relacionado

• Expressões (Construtor de Relatórios e SSRS)
• Coleções Incorporadas em Expressões (Construtor de Relatórios e SSRS)
• Coleção de Campos de Conjunto de Dados (Construtor de Relatórios e SSRS)