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.
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 |
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 |
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 |
|
Mais antigo que X semanas |
|
Mais antigo que X meses |
|
Mais antigo que X anos |
|
Observação
Exceto para a 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 CRM Online 2015 Atualização 1 ou o Microsoft Dynamics 365 (local).
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