Hiërarchische gegevens opvragen

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

Microsoft Dynamics CRM 2015 en Microsoft Dynamics CRM Online 2015 Update introduceert de mogelijkheid om bepaalde zelf-verwijzende één-op-veel entiteitsrelaties als hiërarchisch te definiëren. U kunt zoekacties schrijven die gerelateerde gegevens in deze hiërarchieën retourneren.

U kunt gebruikmaken van nieuwe queryvoorwaardeoperatoren om entiteiten op te vragen met expliciete hiërarchische relaties. Deze operatoren zijn alleen van toepassing op de entiteitsrelatie die specifiek als hiërarchisch relaties zijn gedefinieerd. U kunt nieuwe voorwaardeoperatoren gebruiken om deze hiërarchische gegevens op te halen wanneer u gegevens opvraagt met QueryExpression of FetchExpression.

Notitie

Het OData-eindpunt is niet gewijzigd ter ondersteuning van het opvragen van hiërarchische gegevens.

Voorwaardeoperatoren voor hiërarchische gegevens

Gebruik de volgende voorwaardeoperatoren om voorwaarden in te stellen wanneer u hiërarchische gegevens opvraagt.

FetchXML	ConditionOperator	Beschrijving
above	Above	Retourneert alle records in de bovenliggende lijn van de record waarnaar wordt verwezen.
eq-or-above	AboveOrEqual	Retourneert de record waarnaar wordt verwezen en alle records erboven in de hiërarchie.
under	Under	Retourneert alle onderliggende records onder de record waarnaar wordt verwezen in de hiërarchie.
eq-or-under	UnderOrEqual	Retourneert de record waarnaar wordt verwezen en alle onderliggende records in de hiërarchie.
not-under	NotUnder	Retourneert alle records die niet liggen onder de record waarnaar wordt verwezen in de hiërarchie.
eq-owneduseroruserhierarchy	OwnedByMeOrMyReports	Wanneer hiërarchische beveiligingsmodellen worden gebruikt, is dit gelijk aan de huidige gebruiker of de rapportagehiërarchie van deze gebruiker
eq-useroruserhierarchyandteams	OwnedByMeOrMyReportsAndTeams	Wanneer hiërarchische beveiligingsmodellen worden gebruikt, is dit gelijk aan de huidige gebruiker en zijn of haar teams of de rapportagehiërarchie van deze gebruiker en zijn of haar teams

Recursielimieten wanneer hiërarchische gegevens worden opgevraagd

Aangezien het opvragen van hiërarchische gegevens resource-intensief kan zijn, is er een standaardlimiet van 100 recursies bij voorwaarden voor hiërarchische query's met de voorwaardeoperatoren Above, AboveOrEqual, Under, UnderOrEqual en NotUnder.

Deze limieten kunnen worden aangepast met Windows PowerShell-opdrachten door middel van de installatiewebservice.Meer informatie:TechNet: De installatie beheren met Windows PowerShell.

OwnedByMeOrMyReports en OwnedByMeOrMyReportsAndTeams zijn hiërarchische beveiligingvoorwaardeoperatoren die afhankelijk zijn van de instelling Hiërarchiediepte in Instellingen > Beveiliging > Hiërarchiebeveiliging. De waarde van deze instelling wordt opgeslagen in het kenmerk Organization.MaxDepthForHierarchicalSecurityModel.

Het aantal hiërarchisch verwante onderliggende records ophalen

Gebruik het kenmerk rowaggregate in een FetchXML-gebaseerde query om het aantal hiërarchisch verwante onderliggende records op te halen. Wanneer deze waarde is ingesteld op CountChildren, wordt een waarde die het totale aantal onderliggende records voor de record omvat, opgenomen in de EntityCollection. De volgende query bevat bijvoorbeeld een totale AccountChildren-waarde die het aantal onderliggende accountrecords in de hiërarchische relatie vertegenwoordigt, waarbij de parameter {0} de AccountId van de bovenliggende record is.

<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>

Notitie

De totale waarde die wordt geretourneerd, vertegenwoordigt alle onderliggende records, inclusief records waartoe de gebruiker geen leestoegang heeft.

Zie ook

ConditionOperator
Aanpassen metagegevens van entiteitsrelaties
Bouw query's met FetchXML
Bouw query's met QueryExpression
FetchXML schema
Video: Hiërarchievisualisatie in Microsoft Dynamics CRM 2015

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht