Operadores de consulta de fecha fiscal y anteriores a fecha y hora en FetchXML

Una consulta FetchXML en Microsoft Dataverse puede usar valores de fecha fiscal especiales y cláusulas más antiguas que para valores de fecha y hora en las consultas. Por ejemplo, una consulta FetchXML puede encontrar todos los pedidos cumplidos en el último mes fiscal o casos urgentes de alta gravedad que tengan más de 15 minutos.

Nota

Para todas las consultas de fecha fiscal, la consulta FetchXML utiliza la configuración año fiscal de la organización.

Uso de operadores condicionales de fecha fiscal FetchXML

El siguiente ejemplo muestra una expresión FetchXML que busca todos los pedidos cumplidos en el último período fiscal, según la configuración año fiscal de la organización. Por ejemplo, si la organización usa meses fiscales, la consulta devolverá los pedidos completados durante el último mes fiscal. Si la organización usa trimestres fiscales, la consulta devolverá los pedidos completados durante el último trimestre fiscal. Si la organización usa semestres fiscales, se obtendrán los pedidos completados durante el último semestre fiscal.

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

El siguiente ejemplo muestra una expresión FetchXML que busca todas las cuentas creadas en año fiscal 2013.

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

El siguiente ejemplo muestra una expresión FetchXML que busca todas las oportunidades con una fecha de cierre estimada en los próximos tres años fiscales, según la configuración año fiscal de la organización. El valor de x se especifica en la columna de valor de la etiqueta de condición.

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

El siguiente ejemplo muestra una expresión FetchXML que busca todos los pedidos cumplidos en el período tres de cualquier año fiscal, según la configuración año fiscal de la organización. El valor del período fiscal se especifica en la columna de valor de la etiqueta de condición. Si la organización usa meses fiscales, la consulta ofrecerá resultados a partir del mes número tres. Si la organización usa trimestres fiscales, la consulta ofrecerá resultados a partir del trimestre número tres. Si la organización usa semestres fiscales, no se mostrará ningún resultado; solo hay dos semestres, y el valor proporcionado está por lo tanto fuera de rango.

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

El siguiente ejemplo muestra una expresión FetchXML que busca todos los pedidos cumplidos en el período tres de año fiscal 2013, según la configuración año fiscal de la organización. Si la organización usa meses fiscales, la consulta ofrecerá resultados a partir del mes número tres. Si la organización usa trimestres fiscales, la consulta ofrecerá resultados a partir del trimestre número tres. Si la organización usa semestres fiscales, no se mostrará ningún resultado; solo hay dos semestres, y el valor proporcionado está por lo tanto fuera de rango.

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

El siguiente ejemplo muestra una expresión de agregación FetchXML que suma la cantidad total de pedidos cumplidos y agrupa el resultado por semestre fiscal y año fiscal.

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

Uso de cláusulas "más antiguo de" para valores de fecha y hora

El siguiente ejemplo muestra un FetchXML que busca incidentes que tienen más de 30 minutos.

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

Utilice la siguiente sintaxis para especificar varias cláusulas más antiguas que en una expresión FetchXML .

Más antiguo de X minutos

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

Nota

Esta cláusula no se admite para las columnas de fecha y hora con el comportamiento de DateOnly. Más información: Operadores de consulta de fecha y hora no admitidos en el comportamiento DateOnly

Más antiguo de X horas

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

Nota

Esta cláusula no se admite para las columnas de fecha y hora con el comportamiento de DateOnly. Más información: Operadores de consulta de fecha y hora no admitidos en el comportamiento DateOnly

Más antiguo de X días

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

Más antiguo de X semanas

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

Más antiguo de X meses

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

Más antiguo de X años

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

Consulte también

Consulta de datos usando SDK para .NET
Utilice FetchXML para construir una consulta
Utilice una combinación externa izquierda en FetchXML para consultar registros "no incluidos"

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).