Partager via


Opérateurs de requête de date/heure "Plus de" et date d'exercice dans FetchXML

<<<<<<< HEAD

 

316ff239058ebc6d1913a91a56df7c56300e207e

Date de publication : novembre 2016

S’applique à : Dynamics CRM 2015

Une requête FetchXML dans Mise à jour de Microsoft Dynamics CRM 2015 et de Microsoft Dynamics CRM Online 2015 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

<condition attribute="<AttributeName>" operator="olderthan-x-minutes" value="<VALUE>" />

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

<condition attribute="<AttributeName>" operator="olderthan-x-hours" value="<VALUE>" />

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

<condition attribute="<AttributeName>" operator="olderthan-x-days" value="<VALUE>" />

Plus de X semaines

<condition attribute="<AttributeName>" operator="olderthan-x-weeks" value="<VALUE>" />

Plus de X mois

<condition attribute="<AttributeName>" operator="olderthan-x-months" value="<VALUE>" />

Plus de X années

<condition attribute="<AttributeName>" operator="olderthan-x-years" value="<VALUE>" />

Notes

Hormis la clause Plus de X mois, toutes les autres clauses Plus de sont disponibles si vous utilisez Microsoft Dynamics CRM Online et que votre instance de Dynamics 365 a été mise à jour vers la Mise à jour 1 de CRM Online 2015.

Voir aussi

Récupérer les données avec des requêtes
Générer des requêtes avec FetchXML
Utilisez une jointure externe gauche dans FetchXML afin de rechercher des enregistrements « pas dans »

© 2017 Microsoft. Tous droits réservés. Copyright