Elemento Property (CSDLBI)

Artigo
10/31/2023

Importante: este documento está arquivado. Para obter as informações mais recentes, consulte Open Specification [MS-CSDLBI]: Formato de arquivo de definição de esquema conceitual com anotações de Business Intelligence.

O elemento Property na CSDLBI é um tipo complexo que fornece adições ao elemento CSDL Property, como suporte dos modelos de dados de business intelligence.

Elementos e atributos

A tabela a seguir lista os elementos e atributos que definem o elemento CSDLBI Property.

Name	Obrigatório	Descrição
Sumário	No	Uma cadeia de caracteres que contém o LCID da solicitação.
DefaultAggregationFunction	Yes	Uma cadeia de caracteres que especifica a função de agregação que deverá ser usada se os cálculos forem executados no atributo e nenhuma outra função tiver sido especificada. Se não for especificada, será usada a agregação padrão do modelo, que geralmente é SUM.
GroupingBehavior	No	Um valor que especifica como os resultados da consulta são agrupados. O conteúdo do atributo é definido pelo tipo simples TGroupingBehavior (veja a tabela abaixo).
OrderBy	No	Uma referência a outra propriedade dentro do modelo que define a ordem de classificação para os valores da propriedade em questão. Os valores para as duas propriedades DEVEM ter um mapeamento de um para um. Caso contrário, o comportamento da classificação será indefinida. Se esse elemento for omitido, as propriedades serão classificadas com base em seus valores.
Stability	No	Um atributo que especifica a estabilidade dos valores da propriedade entre operações de atualização. Esse atributo não é definido pelos usuários, mas é emitido pelo ambiente no tempo de design apenas para valores instáveis. Ele sempre é aplicado a colunas que contêm um número de linha e a colunas que contêm fórmulas que geram resultados indeterminados, como NOW() ou RAND(). Os valores desse atributo são listados na tabela abaixo, que descreve o tipo simples Stability.

GroupingBehavior

A tabela a seguir lista os valores do tipo simples GroupingBehavior.

Valor	Descrição
GroupOnValue	Agrupe pelo valor do atributo xthe.
GroupOnEntityKey	Agrupe pela chave de entidade.

O exemplo a seguir ilustra o uso desses dois valores. Suponha que a consulta foi criada para retornar deduções da folha de pagamento de um determinado usuário, especificado por nome. Supondo que o banco de dados contenha dois usuários com o mesmo nome, mas diferentes identificadores de banco de dados, os resultados da consulta serão diferentes, o que dependerá de qual valor de atributo será aplicado à coluna:

GroupOnValue: os resultados da consulta incluem as deduções de folha de pagamento de ambos os usuários, totalizados juntos.
GroupOnEntityKey: os resultados da consulta incluem as deduções da folha de pagamento para cada usuário, mas listados individualmente.

Stability

A tabela a seguir lista os valores do tipo simples de estabilidade .

Valor	Descrição
Estável	A propriedade permanece constante entre operações de atualização.
RowNumber	A propriedade contém um número de linha.
Volátil	A propriedade pode não permanecer constante entre operações de atualização.

Exemplo de tabela

O XML a seguir mostra a representação, na versão 1.1 da CSDLBI, de algumas propriedades no exemplo de modelo de tabela da AdventureWorks.

  
<EntityType   
   Name="DimEmployee">  
   <Key>  
      <PropertyRef   
      Name="RowNumber" />  
   </Key>  
  
   <Property   
      Name="RowNumber"   
      Type="Int64"   
      Nullable="false">  
   <bi:Property   
      Hidden="true"   
      Contents="RowNumber"   
      Stability="RowNumber" />  
   </Property>  
  
   <Property   
      Name="EmployeeKey"   
      Type="Int64">  
   <bi:Property />  
   </Property>  
….  
</bi:EntityType>  
</EntityType>

Exemplo multidimensional

O exemplo a seguir, na versão 1.1 da CSDLBI, mostra algumas propriedades das colunas no modelo de dados que representa o cubo Operações da Contoso. Observe que as anotações de BI não são exigidas nem aplicadas à maioria das colunas, somente àquelas que exigem tratamento especial na camada de apresentação.

  
<EntityType   
   Name="Bike">  
  
   <Key>  
      <PropertyRef Name="RowNumber" />  
   </Key>  
  
   <Property   
      Name="RowNumber"   
      Type="Int64"   
      Nullable="false">  
   <bi:Property   
      Hidden="true"   
      Contents="RowNumber"   
      Stability="RowNumber"   
   />  
   </Property>  
  
   <Property   
      Name="ProductAlternateKey"   
      Type="String"   
      MaxLength="Max"   
      Unicode="true"   
      FixedLength="false">  
   <bi:Property />  
   </Property>

Compartilhar via