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

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Uma consulta FetchXML no Atualização do Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015 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.

Observação

Para todas as consultas de data fiscal, a consulta FetchXML usa as configurações de ano fiscal da organização.

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.

Cláusula

Sintaxe

Mais antigo que X minutos

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

Observação

Esta cláusula não tem suporte para atributos de data e hora com o comportamento DateOnly.Para obter mais informações:Operadores de consulta de data e hora sem suporte para o comportamento DateOnly

Mais antigo que X horas

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

Observação

Esta cláusula não tem suporte para atributos de data e hora com o comportamento DateOnly.Para obter mais informações:Operadores de consulta de data e hora sem suporte para o comportamento DateOnly

Mais antigo que X dias

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

Mais antigo que X semanas

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

Mais antigo que X meses

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

Mais antigo que X anos

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

Observação

Exceto pela cláusula Mais antigo que X meses, todas as outras cláusulas mais antigo que só estarão disponíveis se você estiver usando o Microsoft Dynamics CRM Online e se tiver atualizado sua instância do Dynamics 365 para o CRM Online 2015 Atualização 1.

Confira Também

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

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais