Elemento EntityType (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 EntityType é um tipo complexo que representa a estrutura de uma entidade de alto nível, como um cliente ou pedido, em um modelo de dados. O elemento bi:EntityType estende a definição de EntityType usada na Estrutura de Dados de Entidade.

Um elemento EntityType deve ser especificado para cada uma das entidades incluídas no modelo de dados. Os subelementos de EntityType descrevem as colunas e medidas na tabela. As relações entre as tabelas são incluídas no EntityContainer.

Elementos e atributos

A tabela a seguir lista os elementos e atributos que definem o elemento EntityType . Consulte também os atributos aplicáveis ao elemento EntityType .

Name	Obrigatório	Descrição
Sumário	No	Uma cadeia de caracteres que contém os possíveis tipos de dados em uma coluna. O valor é derivado do valor de DimensionAttributeTypeEnumType no modelo de dados. Se o valor de DimensionAttributeTypeEnumType for "ExtendedType", o valor de Contents será derivado do elemento ExtendedType de DimensionAttribute. O cliente não é necessário para responder a esses valores.
DefaultDetails	No	Uma lista de referências de propriedade que representam o conjunto de colunas na tabela. Consulte o elemento defaultdetails (CSDLBI).
DefaultImage	No	Uma referência a uma coluna que contém a imagem que ilustra a entidade. Em modelos multidimensionais, esse elemento corresponde a um atributo binário no atributo de dimensão. Se esse atributo estiver presente, o elemento deverá conter exatamente um elemento MemberRef. Consulte o elemento MemberRef (CSDLBI).
DefaultMeasure	No	Uma referência a uma medida na entidade que deve ser usada como o padrão ao fazer cálculos sobre a entidade. Se não for especificado, SUM será o padrão. Consulte o elemento MemberRef (CSDLBI).
DisplayKey	No	Uma lista de referências a colunas ou a extremidades de função que constituem um identificador forte que identifica exclusivamente uma instância de entidade. Consulte o elemento DisplayKey (CSDLBI).
Hierarquia	No	Uma lista de hierarquias no modelo. Consulte o elemento Hierarchy (CSDLBI).
ReferenceName	Yes	Um identificador que pode ser usado para fazer referência a essa entidade em uma consulta DAX (Expressões de Análise de Dados). Se esse atributo não estiver presente, será usado o nome do campo totalmente qualificado da entidade.
SortMembers	No	Uma lista de propriedades na qual classificar. O atributo SortDirection indica se a ordem é crescente ou decrescente.

Elemento Contents

O elemento Contents é um tipo simples que descreve o tipo de dados na entidade.

O conteúdo da entidade (coluna) pode ser qualquer um dos seguintes valores:

Valor	Descrição
Regular	Normalmente, não definido.
Hora	Atributos que representem períodos de tempo, como anos, semestres, trimestres, meses ou dias.
painel Geografia do app's selecionado	Atributos que representam informações geográficas, como cidades ou CEPs.
Organização	Atributos que representam informações organizacionais, como funcionários ou subsidiárias.
BillOfMaterials	Atributos que representam informações de estoque ou manufatura, como listas de peças para produtos.
Contas	Atributos que representam um plano de contas para fins de geração de relatórios financeiros.
Clientes	Atributos que representam informações do cliente ou de contato.
Produtos	Atributos que representam informações de produto.
Cenário	Atributos que representam informações de planejamento ou de análise estratégica.
Quantitative	Atributos que representam informações quantitativas.
Utilitário	Atributos que representam informações diversas.
Moeda	Contém dados e metadados de moeda.
Rates	Atributos que representam informações de taxa de câmbio.
Canal	Atributos que representam informações de canal.
Promoção	Atributos que representam informações de promoções de marketing.

Exemplo de tabela

O exemplo a seguir mostra a parte da representação CSDLBI na versão 1.1 da tabela Geography usada no modelo de tabela da AdventureWorks. A coluna RowNumber é uma coluna oculta gerada automaticamente como um identificador de linha em modelos de tabela e, portanto, tem o atributo Contents, RowNumber.

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

Exemplo multidimensional

O exemplo a seguir mostra os elementos EntityTypes na versão 1.1 da CSDLBI que representam uma parte de uma dimensão de tempo do cubo Operações da Contoso.

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

Partilhar via