Date fiscale et opérateurs de requête plus anciens que datetime dans FetchXML

Une FetchXML requête dans Microsoft Dataverse peut utiliser des valeurs de date fiscale spéciales et des clauses plus anciennes que pour les valeurs de date et d’heure dans les requêtes. Par exemple, une FetchXML requête peut rechercher toutes les commandes exécutées au cours du dernier mois fiscal ou les cas urgents de grande gravité datant de plus de 15 minutes.

Notes

Pour toutes les requêtes de date fiscale, la FetchXML requête utilise les paramètres exercice de l’organisation.

Utilisation des FetchXML opérateurs conditionnels de date fiscale

L’exemple suivant montre une FetchXML expression qui recherche toutes les commandes exécutées au cours du dernier période fiscale, selon les paramètres 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 FetchXML expression qui recherche tous les comptes créés dans 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 FetchXML expression qui recherche toutes les opportunités dont la date de clôture est estimée au cours des trois prochains exercices, en fonction des paramètres exercice de l’organisation. La valeur pour x est spécifiée dans la colonne 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 FetchXML expression qui recherche toutes les commandes exécutées au cours de la troisième période de n’importe quel exercice, selon les paramètres exercice de l’organisation. La valeur pour la période fiscale est spécifiée dans la colonne 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 FetchXML expression qui recherche toutes les commandes exécutées au cours de la troisième période de exercice 2013, selon les paramètres 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 FetchXML expression d’agrégation qui additionne le montant total des commandes exécutées et regroupe 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 FetchXML qui recherche les incidents datant de plus de 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 anciennes que dans une FetchXML expression.

Plus de X minutes

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

Notes

Cette clause n’est pas prise en charge pour les colonnes de date et d’heure avec le comportement DateOnly. Pour plus d’informations, voir : 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 colonnes de date et d’heure avec le comportement DateOnly. Pour plus d’informations, voir : 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>" />  

Voir aussi

Interroger les données à l’aide du SDK pour .NET
Utiliser FetchXML pour construire une requête
Utilisez une jointure externe gauche dans FetchXML pour rechercher des enregistrements "pas dans"

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).