Fiscale datum en 'ouder dan'-queryoperators voor datum/tijd in FetchXML
Gepubliceerd: januari 2017
Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Een FetchXML-query in Microsoft Dynamics 365 (online en on-premises) kan speciale fiscale datumwaarden en ouder dan-componenten voor datum- en tijdwaarden gebruiken in query's. Zo kan een FetchXML-query alle orders vinden die in de afgelopen fiscale maand zijn uitgevoerd of urgente aanvragen met een hoge mate van ernst die ouder zijn dan 15 minuten.
Notitie
Bij alle query's met fiscale datumwaarden wordt in de query FetchXML gebruikgemaakt van de instellingen voor het fiscale jaar van de organisatie.
In dit onderwerp
Voorwaardelijke operators voor fiscale datumwaarden van FetchXML gebruiken
'Ouder dan'-componenten gebruiken voor datum- en tijdwaarden
Voorwaardelijke operators voor fiscale datumwaarden van FetchXML gebruiken
In het volgende voorbeeld wordt een FetchXML-expressie weergegeven waarmee alle orders worden gevonden die in de laatste fiscale periode zijn uitgevoerd, op basis van de instellingen voor het fiscale jaar van de organisatie. Als de organisatie bijvoorbeeld gebruikmaakt van fiscale maanden, retourneert de query orders die zijn uitgevoerd in de afgelopen fiscale maand. Als de organisatie gebruikmaakt van fiscale kwartalen, retourneert de query orders die zijn uitgevoerd in het afgelopen fiscale kwartaal. Als de organisatie gebruikmaakt van fiscale semesters, worden orders geretourneerd die zijn uitgevoerd in het afgelopen fiscale semester.
<fetch>
<entity name="order">
<attribute name="name"/>
<filter type="and">
<condition attribute="datefulfilled" operator="last-fiscal-period"/>
</filter>
</entity>
</fetch>
In het volgende voorbeeld wordt een FetchXML-expressie weergegeven waarmee alle accounts die zijn gemaakt in fiscaal jaar 2013 worden gevonden.
<fetch>
<entity name="account">
<attribute name="name"/>
<filter type="and">
<condition attribute="createdon" operator="in-fiscal-year" value="2013"/>
</filter>
</entity>
</fetch>
In het volgende voorbeeld wordt een FetchXML-expressie weergegeven waarmee alle verkoopkansen worden gevonden met een geschatte afsluitdatum in de volgende drie fiscale jaren, op basis van de instellingen voor het fiscale jaar van de organisatie. De waarde voor x is opgegeven in het waardekenmerk van de voorwaardencode.
<fetch>
<entity name="opportunity">
<attribute name="name"/>
<filter type="and">
<condition attribute="estimatedclosedate" operator="next-x-fiscal-years" value="3"/>
</filter>
</entity>
</fetch>
In het volgende voorbeeld wordt een FetchXML-expressie weergegeven waarmee alle orders worden gevonden die in periode drie van een willekeurig fiscaal jaar zijn uitgevoerd, op basis van de instellingen voor het fiscale jaar van de organisatie. De waarde voor boekingsperiode is opgegeven in het waardekenmerk van de voorwaardencode. Als de organisatie boekmaanden gebruikt, retourneert de query resultaten uit maand drie. Als de organisatie boekkwartalen gebruikt, retourneert de query resultaten uit kwartaal drie. Als de organisatie boeksemesters gebruikt, worden geen resultaten geretourneerd; er zijn slechts twee semesters en de meegeleverde waarde ligt derhalve buiten het bereik.
<fetch>
<entity name="order">
<attribute name="name"/>
<filter type="and">
<condition attribute="datefulfilled" operator="in-fiscal-period" value="3"/>
</filter>
</entity>
</fetch>
In het volgende voorbeeld wordt een FetchXML-expressie weergegeven waarmee alle orders worden gevonden die in periode drie van fiscaal jaar 2013 zijn uitgevoerd, op basis van de instellingen voor het fiscale jaar van de organisatie. Als de organisatie boekmaanden gebruikt, retourneert de query resultaten uit maand drie. Als de organisatie boekkwartalen gebruikt, retourneert de query resultaten uit kwartaal drie. Als de organisatie boeksemesters gebruikt, worden geen resultaten geretourneerd; er zijn slechts twee semesters en de meegeleverde waarde ligt derhalve buiten het bereik.
<fetch>
<entity name="order">
<attribute name="name"/>
<filter type="and">
<condition attribute="datefulfilled" operator="in-fiscal-period-and-year">
<value>3</value>
<value>2013</value>
</condition>
</filter>
</entity>
</fetch>
In het volgende voorbeeld wordt een FetchXML-samenvoegingsexpressie weergegeven waarmee het totaalbedrag wordt opgeteld van uitgevoerde orders en het resultaat wordt gegroepeerd per boeksemester en boekjaar.
<fetch aggregate="true">
<entity name="order">
<attribute name="totalamount" aggregate="sum" alias="total"/>
<attribute name="datefulfilled" groupby="true" dategrouping="fiscal-period"/>
</entity>
</fetch>
'Ouder dan'-componenten gebruiken voor datum- en tijdwaarden
In het volgende voorbeeld wordt een FetchXML-expressie weergegeven waarmee alle incidenten worden gevonden die ouder zijn dan 30 minuten.
<fetch>
<entity name="incident">
<attribute name="title" />
<attribute name="ticketnumber" />
<attribute name="createdon" />
<attribute name="incidentid" />
<filter type="and">
<condition attribute="createdon" operator="olderthan-x-minutes" value="30" />
</filter>
</entity>
</fetch>
Gebruik de volgende syntaxis om verschillende ouder dan-componenten in een FetchXML-expressie op te geven.
Component |
Syntaxis |
|---|---|
Ouder dan X minuten |
Notitie Deze component wordt niet ondersteund voor datum- en tijdkenmerken met DateOnly-gedrag.Meer informatie:Queryoperators voor datum en tijd worden niet ondersteund voor DateOnly-gedrag |
Ouder dan X uur |
Notitie Deze component wordt niet ondersteund voor datum- en tijdkenmerken met DateOnly-gedrag.Meer informatie:Queryoperators voor datum en tijd worden niet ondersteund voor DateOnly-gedrag |
Ouder dan X dagen |
|
Ouder dan X weken |
|
Ouder dan X maanden |
|
Ouder dan X jaren |
|
Notitie
Behalve de component Ouder dan X maanden zijn alle andere ouder dan-componenten alleen beschikbaar als u CRM Online 2015 Update 1 of Microsoft Dynamics 365 gebruikt (on-premises).
Zie ook
Gegevens ophalen met query's met SDK-assembly's
Bouw query's met FetchXML
Gebruik een left outer join in FetchXML voor het uitvoeren van query's voor records "niet in"
Microsoft Dynamics 365
© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht