Operatori di query "oltre" data/ora e data fiscale in FetchXML

 

Data di pubblicazione: novembre 2016

Si applica a: Dynamics CRM 2015

Una query FetchXML in Aggiornamento di Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015 può utilizzare i valori speciali di data fiscale e le clausole di tipo oltre per i valori di data e ora nelle query. Ad esempio, una query FetchXML può cercare tutti gli ordini evasi nell'ultimo mese fiscale o i casi urgenti con gravità elevata creati da oltre 15 minuti.

Nota

Per tutte le query di data fiscale, la query FetchXML utilizza le impostazioni dell'anno fiscale dell'organizzazione.

In questo argomento

Utilizzo degli operatori condizionali di data fiscale FetchXML

Utilizzare le clausole di tipo "oltre" per i valori di data e ora

Utilizzo degli operatori condizionali di data fiscale FetchXML

Nell'esempio seguente viene illustrata un'espressione FetchXML che individua tutti gli ordini evasi nell'ultimo periodo fiscale, in base alle impostazioni dell'anno fiscale dell'organizzazione. Ad esempio, se l'organizzazione utilizza i mesi fiscali, la query restituisce gli ordini evasi nell'ultimo mese fiscale. Se l'organizzazione utilizza i trimestri fiscali, la query restituisce gli ordini evasi nell'ultimo trimestre fiscale. Se l'organizzazione utilizza i semestri fiscali, vengono restituiti gli ordini evasi nell'ultimo semestre fiscale.

<fetch>
 <entity name="order">
  <attribute name="name"/>
  <filter type="and">
   <condition attribute="datefulfilled" operator="last-fiscal-period"/>
  </filter>
 </entity>
</fetch>

Nell'esempio seguente viene illustrata un'espressione FetchXML che individua tutti gli account creati nell'anno fiscale 2013.

<fetch>
 <entity name="account">
  <attribute name="name"/>
  <filter type="and">
   <condition attribute="createdon" operator="in-fiscal-year" value="2013"/>
  </filter>
 </entity>
</fetch>

Nell'esempio seguente viene illustrata un'espressione FetchXML che individua tutte le opportunità con una data di chiusura stimata entro i successivi tre anni fiscali, in base alle impostazioni dell'anno fiscale dell'organizzazione. Il valore per x viene specificato nell'attributo valore del tag di condizione.

<fetch>
 <entity name="opportunity">
  <attribute name="name"/>
  <filter type="and">
   <condition attribute="estimatedclosedate" operator="next-x-fiscal-years" value="3"/>
  </filter>
 </entity>
</fetch>

Nell'esempio seguente viene illustrata un'espressione FetchXML che individua tutti gli ordini evasi nel terzo periodo di un anno fiscale, in base alle impostazioni dell'anno fiscale dell'organizzazione. Il valore del periodo fiscale viene specificato nell'attributo valore del tag di condizione. Se l'organizzazione utilizza i mesi fiscali, la query restituisce i risultati a partire dal terzo mese. Se l'organizzazione utilizza i trimestri fiscali, la query restituisce i risultati a partire dal terzo trimestre. Se l'organizzazione utilizza i semestri fiscali, non viene restituito alcun risultato; sono presenti solo due semestri e il valore specificato non è compreso nell'intervallo.

<fetch>
 <entity name="order">
  <attribute name="name"/>
  <filter type="and">
   <condition attribute="datefulfilled" operator="in-fiscal-period" value="3"/>
  </filter>
 </entity>
</fetch>

Nell'esempio seguente viene illustrata un'espressione FetchXML che individua tutti gli ordini evasi nel terzo periodo di un anno fiscale 2013, in base alle impostazioni dell'anno fiscale dell'organizzazione. Se l'organizzazione utilizza i mesi fiscali, la query restituisce i risultati a partire dal terzo mese. Se l'organizzazione utilizza i trimestri fiscali, la query restituisce i risultati a partire dal terzo trimestre. Se l'organizzazione utilizza i semestri fiscali, non viene restituito alcun risultato; sono presenti solo due semestri e il valore specificato non è compreso nell'intervallo.

<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>

Nell'esempio seguente viene illustrata un'espressione di aggregazione FetchXML che somma l'importo totale degli ordini evasi e raggruppa il risultato in base al semestre fiscale e all'anno fiscale.

<fetch aggregate="true">
 <entity name="order">
  <attribute name="totalamount" aggregate="sum" alias="total"/>
  <attribute name="datefulfilled" groupby="true" dategrouping="fiscal-period"/>
 </entity>
</fetch>

Utilizzare le clausole di tipo "oltre" per i valori di data e ora

Il seguente esempio indica una query FetchXML che trova gli incidenti creati da oltre 30 minuti.

<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>

Utilizza la sintassi seguente per specificare le varie clausole di tipo oltre in un'espressione FetchXML.

Clausola

Sintassi

Oltre X minuti fa

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

Nota

La clausola non è supportata per gli attributi di data e ora con comportamento DateOnly.Ulteriori informazioni:Gli operatori di query di data e ora non sono supportati per il comportamento DateOnly

Oltre X ore fa

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

Nota

La clausola non è supportata per gli attributi di data e ora con comportamento DateOnly.Ulteriori informazioni:Gli operatori di query di data e ora non sono supportati per il comportamento DateOnly

Oltre X giorni fa

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

Oltre X settimane fa

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

Oltre X mesi fa

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

Oltre X anni fa

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

Nota

Ad eccezione della clausola Oltre X mesi fa, tutte le altre clausole di tipo oltre sono disponibili solo se utilizzi Microsoft Dynamics CRM Online e hai aggiornato l'istanza di Dynamics 365 a Aggiornamento 1 di CRM Online 2015.

Vedere anche

Recuperare i dati con le query
Creare query con FetchXML
Utilizzare un left outer join in FetchXML per eseguire query per i record "non contenuti" in un set

© 2017 Microsoft. Tutti i diritti sono riservati. Copyright