Operatori di query "oltre" data/ora e data fiscale in FetchXML
Data di pubblicazione: gennaio 2017
Si applica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online
Una query FetchXML in Microsoft Dynamics 365 (online e locale) 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 |
``` xml
```
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 |
``` xml
```
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 |
|
Oltre X settimane fa |
|
Oltre X mesi fa |
|
Oltre X anni fa |
|
Nota
Ad eccezione della clausola Oltre X mesi fa, tutte le altre clausole di tipo oltre sono disponibili solo se utilizzi Aggiornamento 1 di CRM Online 2015 o Microsoft Dynamics 365 (locale).
Vedere anche
Recupera i dati con le query utilizzando gli assembly SDK
Creare query con FetchXML
Utilizzare un left outer join in FetchXML per eseguire query per i record "non contenuti" in un set
Microsoft Dynamics 365
© 2017 Microsoft. Tutti i diritti sono riservati. Copyright