Steuerdatum und "älter als"-Datums-/Zeit-Abfrageoperatoren in FetchXML
Veröffentlicht: Januar 2017
Gilt für: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Eine FetchXML-Abfrage in Microsoft Dynamics 365 (online und lokal) kann spezielle Steuerdatumswerte und älter als-Klauseln für Datums- und Uhrzeitwerte in Abfragen verwenden. Beispielsweise kann eine FetchXML-Abfrage alle Bestellungen finden, die im letzten Geschäftsmonat erfüllt wurden, oder dringende Anfragen mit hohem Schweregrad, die älter sind als 15 Minuten.
Hinweis
Die FetchXML-Abfrage verwendet die Einstellungen zum Geschäftsjahr der Organisation für alle Steuerdatumsabfragen.
In diesem Thema
Verwenden von Steuerdatum-Bedingungsoperatoren in FetchXML
Verwenden von "älter als"-Klauseln für Datums- und Uhrzeitwerte
Verwenden von Steuerdatum-Bedingungsoperatoren in FetchXML
Das folgende Beispiel zeigt einen FetchXML-Ausdruck, der alle Aufträge sucht, die in der letzten Buchhaltungsperiode erfüllt wurden, entsprechend der Einstellungen zum Geschäftsjahr der Organisation. Wenn die Organisation beispielsweise Geschäftsmonate verwendet, gibt die Abfrage Aufträge zurück, die im letzten Geschäftsmonat erfüllt wurden. Wenn die Organisation beispielsweise Geschäftsquartale verwendet, gibt die Abfrage Aufträge zurück, die im letzten Geschäftsquartal erfüllt wurden. Wenn die Organisation beispielsweise Geschäftshalbjahre verwendet, gibt die Abfrage Aufträge zurück, die im letzten Geschäftshalbjahr erfüllt wurden.
<fetch>
<entity name="order">
<attribute name="name"/>
<filter type="and">
<condition attribute="datefulfilled" operator="last-fiscal-period"/>
</filter>
</entity>
</fetch>
Das folgende Beispiel zeigt einen FetchXML-Ausdruck, der alle Firmen sucht, die im Geschäftsjahr 2013 erstellt wurden.
<fetch>
<entity name="account">
<attribute name="name"/>
<filter type="and">
<condition attribute="createdon" operator="in-fiscal-year" value="2013"/>
</filter>
</entity>
</fetch>
Das folgende Beispiel zeigt einen FetchXML-Ausdruck, der alle Verkaufschancen mit einem geschätzten Abschlussdatum in den folgenden drei Geschäftsjahren sucht, basierend auf den Einstellungen zum Geschäftsjahr der Organisation. Der Wert für x wird im Wertattribut des Bedingungstags angegeben.
<fetch>
<entity name="opportunity">
<attribute name="name"/>
<filter type="and">
<condition attribute="estimatedclosedate" operator="next-x-fiscal-years" value="3"/>
</filter>
</entity>
</fetch>
Das folgende Beispiel zeigt einen FetchXML-Ausdruck, der alle Aufträge sucht, die in der dritten Periode eines Geschäftsjahrs erfüllt wurden, entsprechend der Einstellungen zum Geschäftsjahr der Organisation. Der Wert für die Buchhaltungsperiode wird im Wertattribut des Bedingungstags angegeben. Wenn die Organisation Geschäftsmonate verwendet, gibt die Abfrage Ergebnisse von Monat drei zurück. Wenn die Organisation Geschäftsquartale verwendet, gibt die Abfrage Ergebnisse von Quartal drei zurück. Wenn die Organisation Geschäftshalbjahre verwendet, werden keine Ergebnisse zurückgegeben; es gibt nur zwei Halbjahre, und der Wert liegt daher außerhalb des Gültigkeitsbereichs.
<fetch>
<entity name="order">
<attribute name="name"/>
<filter type="and">
<condition attribute="datefulfilled" operator="in-fiscal-period" value="3"/>
</filter>
</entity>
</fetch>
Das folgende Beispiel zeigt einen FetchXML-Ausdruck, der alle Aufträge sucht, die in der dritten Periode von Geschäftsjahr 2013 erfüllt wurden, entsprechend der Einstellungen zum Geschäftsjahr der Organisation. Wenn die Organisation Geschäftsmonate verwendet, gibt die Abfrage Ergebnisse von Monat drei zurück. Wenn die Organisation Geschäftsquartale verwendet, gibt die Abfrage Ergebnisse von Quartal drei zurück. Wenn die Organisation Geschäftshalbjahre verwendet, werden keine Ergebnisse zurückgegeben; es gibt nur zwei Halbjahre, und der Wert liegt daher außerhalb des Gültigkeitsbereichs.
<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>
Das folgende Beispiel zeigt einen FetchXML-Aggregationsausdruck, der den Gesamtbetrag von erfüllten Aufträgen summiert und das Ergebnis nach Geschäftshalbjahr und Geschäftsjahr gruppiert.
<fetch aggregate="true">
<entity name="order">
<attribute name="totalamount" aggregate="sum" alias="total"/>
<attribute name="datefulfilled" groupby="true" dategrouping="fiscal-period"/>
</entity>
</fetch>
Verwenden von "älter als"-Klauseln für Datums- und Uhrzeitwerte
Im folgenden Beispiel wird ein FetchXML-Ausdruck gezeigt, der Vorfälle findet, die älter sind als 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>
Verwenden Sie die folgende Syntax, um verschiedene älter als-Klauseln in einem FetchXML-Ausdruck anzugeben.
Klausel |
Syntax |
|---|---|
Älter als x Minuten |
Hinweis Diese Klausel wird für Datums- und Zeitattribute mit DateOnly-Verhalten nicht unterstützt.Weitere Informationen:Datums- und Uhrzeitabfrageoperatoren für DateOnly-Verhalten werden nicht unterstützt |
Älter als x Stunden |
Hinweis Diese Klausel wird für Datums- und Zeitattribute mit DateOnly-Verhalten nicht unterstützt.Weitere Informationen:Datums- und Uhrzeitabfrageoperatoren für DateOnly-Verhalten werden nicht unterstützt |
Älter als x Tage |
|
Älter als x Wochen |
|
Älter als X Monate |
|
Älter als x Jahre |
|
Hinweis
Bis auf die Älter als x Monate-Klausel stehen alle anderen älter als-Klauseln nur zur Verfügung, wenn Sie CRM Online 2015-Update 1 oder Microsoft Dynamics 365 (lokal) verwenden.
Siehe auch
Abrufen von Daten mit Abfragen mithilfe von SDK-Assemblys
Abfragen erstellen mit FetchXML
Verwenden einer linken äußeren Verknüpfung in FetchXML für Abfragen nach Datensätzen, die „nicht in“ sind.
Microsoft Dynamics 365
© 2017 Microsoft. Alle Rechte vorbehalten. Copyright