Opérateurs de requête de date/heure "Plus de" et date d'exercice dans FetchXML
Date de publication : janvier 2017
S’applique à : Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Une requête FetchXML dans Microsoft Dynamics 365 (Online et local) peut utiliser des valeurs de date d'exercice spéciales et les clauses Plus de pour les valeurs de date et d'heure dans les requêtes. Par exemple, une requête FetchXML peut rechercher les commandes exécutées au cours du dernier mois de l'exercice ou les incidents urgents avec une sévérité élevée qui sont antérieurs à 15 minutes.
Notes
Pour toutes les requêtes de date d'exercice, la requête FetchXML utilise les paramètres de l'exercice de l'organisation.
Contenu de la rubrique
Utilisation des opérateurs conditionnelles de date fiscale FetchXML
Utilisation des clauses "Plus de" pour les valeurs de date et d'heure
Utilisation des opérateurs conditionnelles de date fiscale FetchXML
Cet exemple montre une expression FetchXML qui recherche toutes les commandes exécutées au cours de la dernière période fiscale, selon les paramètres de l’exercice de l’organisation. Par exemple, si l’organisation utilise des mois fiscaux, la requête retourne les commandes exécutées au cours du dernier mois de l’exercice. Par exemple, si l’organisation utilise des trimestres fiscaux, la requête retourne les commandes exécutées au cours du dernier trimestre de l’exercice. Par exemple, si l’organisation utilise des semestres fiscaux, la requête retourne les commandes exécutées au cours du dernier semestre de l’exercice.
<fetch>
<entity name="order">
<attribute name="name"/>
<filter type="and">
<condition attribute="datefulfilled" operator="last-fiscal-period"/>
</filter>
</entity>
</fetch>
L’exemple suivant montre une expression FetchXML qui recherche tous les comptes créés au cours de l’exercice 2013.
<fetch>
<entity name="account">
<attribute name="name"/>
<filter type="and">
<condition attribute="createdon" operator="in-fiscal-year" value="2013"/>
</filter>
</entity>
</fetch>
L’exemple suivant montre une expression FetchXML qui recherche toutes les opportunités avec une date de clôture estimée au cours des trois exercices suivants, selon les paramètres d’exercice de l’organisation. La valeur de x est spécifiée dans l’attribut de valeur de la balise de condition.
<fetch>
<entity name="opportunity">
<attribute name="name"/>
<filter type="and">
<condition attribute="estimatedclosedate" operator="next-x-fiscal-years" value="3"/>
</filter>
</entity>
</fetch>
L’exemple suivant montre une expression FetchXML qui recherche toutes les commandes exécutées au cours de la période trois de tout exercice, selon les paramètres d’exercice de l’organisation. La valeur de la période fiscale est spécifiée dans l’attribut de valeur de la balise de condition. Si l’organisation utilise des mois fiscaux, la requête renvoie les résultats du mois trois. Si l’organisation utilise des trimestres fiscaux, la requête renvoie les résultats du trimestre trois. Si l’organisation utilise des semestres fiscaux, aucun résultat n’est renvoyé ; il n’y a que deux semestres et la valeur fournie est donc hors limite.
<fetch>
<entity name="order">
<attribute name="name"/>
<filter type="and">
<condition attribute="datefulfilled" operator="in-fiscal-period" value="3"/>
</filter>
</entity>
</fetch>
L’exemple suivant montre une expression FetchXML qui recherche toutes les commandes exécutées au cours de la période trois de l’exercice 2013, selon les paramètres d’exercice de l’organisation. Si l’organisation utilise des mois fiscaux, la requête renvoie les résultats du mois trois. Si l’organisation utilise des trimestres fiscaux, la requête renvoie les résultats du trimestre trois. Si l’organisation utilise des semestres fiscaux, aucun résultat n’est renvoyé ; il n’y a que deux semestres et la valeur fournie est donc hors limite.
<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>
L’exemple suivant montre une expression d’agrégation FetchXML qui totalise le montant des commandes exécutées et classe le résultat par semestre fiscal et exercice.
<fetch aggregate="true">
<entity name="order">
<attribute name="totalamount" aggregate="sum" alias="total"/>
<attribute name="datefulfilled" groupby="true" dategrouping="fiscal-period"/>
</entity>
</fetch>
Utilisation des clauses "Plus de" pour les valeurs de date et d'heure
L'exemple suivant montre un objet FetchXML qui recherche les incidents antérieurs à 30 minutes.
<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>
Utilisez la syntaxe suivante pour spécifier diverses clauses Plus de dans une expression FetchXML.
Clause |
Syntaxe |
|---|---|
Plus de X minutes |
Notes Cette clause n'est pas prise en charge pour les attributs de date et heure avec le comportement DateOnly.Pour plus d'informations :Opérateurs de requête de date et d'heure non pris en charge pour le comportement DateOnly |
Plus de X heures |
Notes Cette clause n'est pas prise en charge pour les attributs de date et heure avec le comportement DateOnly.Pour plus d'informations :Opérateurs de requête de date et d'heure non pris en charge pour le comportement DateOnly |
Plus de X jours |
|
Plus de X semaines |
|
Plus de X mois |
|
Plus de X années |
|
Notes
Hormis la clause Plus de X mois, toutes les autres clauses Plus de sont disponibles si vous utilisez Mise à jour 1 de CRM Online 2015 ou Microsoft Dynamics 365 (en local).
Voir aussi
Extraire les données avec des requêtes à l'aide des assemblys du SDK
Générer des requêtes avec FetchXML
Utilisez une jointure externe gauche dans FetchXML afin de rechercher des enregistrements « pas dans »
Microsoft Dynamics 365
© 2017 Microsoft. Tous droits réservés. Copyright