Dados hierárquicos de consulta

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

O Microsoft Dynamics 365 (online e local) introduz a capacidade de definir relacionamentos de entidade um-para-muitos de autorreferenciamento como hierárquicos. É possível escrever consultas que devolvem dados relacionados nessas hierarquias.

Você pode aproveitar os novos operadores de condição da consulta para consultar entidades com relacionamentos hierárquicos explícitos. Os operadores apenas se aplicam ao relacionamento de entidade definido especificamente como um relacionamento hierárquico. Você pode usar novos operadores de condição para recuperar os dados hierárquicos ao consultar usando o QueryExpression ou FetchExpression.

Observação

O ponto de extremidade OData não foi alterado para suportar a consulta de dados hierárquicos.

Operadores de condição para dados hierárquicos

Use os seguintes operadores para definir condições ao consultar dados hierárquicos.

FetchXML	ConditionOperator	Descrição
above	Above	Retorna todos os registros na linha de ascendência hierárquica do registro referenciado.
eq-or-above	AboveOrEqual	Retorna o registro referenciado e todos os registros acima deles na hierarquia.
under	Under	Retorna todos os registro secundários abaixo dos registros referenciados na hierarquia.
eq-or-under	UnderOrEqual	Retorna o registro referenciado e todos os registros referenciados abaixo dele na hierarquia.
not-under	NotUnder	Retorna todos os registro não abaixo dos registros referenciados na hierarquia.
eq-owneduseroruserhierarchy	OwnedByMeOrMyReports	Quando os modelos de segurança hierárquicos são usados, igualiza o usuário atual ou sua hierarquia de relatório
eq-useroruserhierarchyandteams	OwnedByMeOrMyReportsAndTeams	Quando os modelos de segurança hierárquicos são usados, igualiza o usuário atual e suas equipes ou sua hierarquia de relatório e suas equipes

Limites de recursão ao consultar dados hierárquicos

Como a consulta de dados hierárquicos pode ser intensa para o recurso, há um limite de 100 condições permitidas de recursões para consultas hierárquicas usando a condição AboveOrEqual, Above, UnderUnderOrEqual e NotUnder.

Esses limites podem ser definidos usando os comandos do Windows PowerShell pelo serviço Web de implantação.Para obter mais informações:TecnNet: Administre a implantação usando o Windows PowerShell.

OwnedByMeOrMyReports e OwnedByMeOrMyReportsAndTeams são operadores de condição de segurança hierárquicos que dependem da configuração da Profundidade da Hierarquia que pode ser encontrada em Configurações > Segurança > Segurança da hierarquia. O valor dessa configuração é armazenado no atributo Organization.MaxDepthForHierarchicalSecurityModel.

Recupere o número de registros secundários relacionados hierarquicamente

Use o atributo rowaggregateem uma consulta baseada emFetchXML para recuperar o número de registros secundários relacionados hierarquicamente. Quando esse valor é definido para CountChildren, um valor que inclui o número total de registros secundários para o registro está incluído no EntityCollection. Por exemplo, a consulta a seguir incluirá um valor de agregação do AccountChildren que representa o número de registros de conta secundária no relacionamento hierárquico onde o parâmetro {0} representa AccountId do registro primário.

<fetch distinct='false' no-lock='false' mapping='logical'>
  <entity name='account'>
    <attribute name='name' />
    <attribute name='accountid' />
    <attribute name='accountid' rowaggregate='CountChildren' alias='AccountChildren'/>
    <filter type='and'>
      <condition attribute='accountid' operator='under' value='{0}' />
    </filter>
  </entity>
</fetch>

Observação

O valor agregado retornado representa todos os registros secundários, incluindo os que o usuário não pode ter acesso de leitura.

Confira Também

ConditionOperator
Personalizar metadados do relacionamento entre entidades
Criar consultas com FetchXML
Criar consultas com QueryExpression
FetchXML schema
Vídeo: Visualização da Hierarquia no Microsoft Dynamics CRM 2015

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais