Operadores de consulta de data fiscal e de data/hora "mais antigo do que" no FetchXML

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Uma consulta FetchXML no Microsoft Dynamics 365 (online e local) pode usar valores de data fiscal especiais e cláusulas mais antigo que para valores de data e hora em consultas. Por exemplo, uma consulta FetchXML pode localizar todas as ordens preenchidas no último mês fiscal ou em casos urgentes com alta gravidade com mais de 15 minutos.

Neste tópico

Usando operadores condicionais de data fiscal FetchXML

Usando cláusulas “mais antigas“ para valores de data e hora

Usando operadores condicionais de data fiscal FetchXML

O exemplo a seguir mostra uma expressão FetchXML que localiza todos os pedidos atendidos no último período fiscal, de acordo com as configurações de ano fiscal da organização. Por exemplo, se a organização usar meses fiscais, a consulta retornará os pedidos atendidos no último mês fiscal. Se a organização usar trimestres fiscais, a consulta retornará os pedidos atendidos no último trimestre fiscal. Se a organização usar semestres fiscais, os pedidos atendidos no último semestre fiscal serão retornados.

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

O exemplo a seguir mostra uma expressão FetchXML que encontra todas as contas criadas no ano fiscal 2013.

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

O exemplo a seguir mostra uma expressão FetchXML que encontra todas as oportunidades com uma data de fechamento estimada nos próximos três anos fiscais, com base nas configurações de ano fiscal da organização. O valor de x é especificado no atributo de valores da marca de condição.

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

O exemplo a seguir mostra uma expressão FetchXML que localiza todos os pedidos atendidos no período três de qualquer ano fiscal de acordo com as configurações de ano fiscal da organização. O valor do período fiscal é especificado no atributo de valores da marca de condição. Se a organização usar meses fiscais, a consulta retornará resultados do mês três. Se a organização usar trimestres fiscais, a consulta retornará resultados do trimestre três. Se a organização usar semestres fiscais, nenhum resultado será retornado; somente há dois semestres e o valor fornecido está fora do intervalo.

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

O exemplo a seguir mostra uma expressão FetchXML que localiza todos os pedidos atendidos no período três do ano fiscal 2013 de acordo com as configurações de ano fiscal da organização. Se a organização usar meses fiscais, a consulta retornará resultados do mês três. Se a organização usar trimestres fiscais, a consulta retornará resultados do trimestre três. Se a organização usar semestres fiscais, nenhum resultado será retornado; somente há dois semestres e o valor fornecido está fora do intervalo.

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

O exemplo a seguir mostra uma expressão FetchXML que soma o valor total de pedidos atendidos e agrupa o resultado por semestre fiscal e ano fiscal.

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

Usando cláusulas “mais antigas“ para valores de data e hora

O exemplo a seguir mostra um FetchXML que localiza incidentes mais antigos que 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>

Use a sintaxe a seguir para especificar diversas cláusulas mais antigo que em uma expressão FetchXML.

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

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

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

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

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

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

Confira Também

Recuperar dados com consultas utilizando assemblies SDK
Criar consultas com FetchXML
Usar uma junção externa à esquerda no FetchXML para consultar registros “não incluídos”

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais