Valores do operador de condição FetchXML

Use valores do operador de condição FetchXML no operator atributo de um elemento de condição para especificar como avaliar uma condição ao filtrar linhas. Esta referência lista cada operador, os tipos de dados que suporta e exemplos. Para saber como usar esses valores, consulte Filtrar linhas usando FetchXml.

Operator Description Tipos de dados
acima Retorna todos os registros na linha de ancestralidade hierárquica do registro referenciado. Hierárquico
começa-com A cadeia de caracteres ocorre no início de outra cadeia de caracteres. String
entre O valor está entre dois valores. Número
Data/hora
contém-valores O valor de escolha é um dos valores especificados. Opção
termina-com A cadeia de caracteres termina com outra cadeia de caracteres. String
eq Os valores são comparados para a igualdade. Opção
Data/hora
Hierárquico
Número
Owner
String
Identificador Único
EQ-BusinessID O valor é igual ao ID comercial especificado. Identificador Único
eq-or-acima Retorna o registro referenciado e todos os registros acima dele na hierarquia. Hierárquico
eq-or-em Retorna o registro referenciado e todos os registros filho abaixo dele na hierarquia. Hierárquico
eq-userid O valor é igual ao ID de usuário especificado. Identificador Único
eq-userlanguage O valor é igual ao idioma para o usuário. Número
eq-useroruserhierarchy Quando modelos de segurança hierárquica são usados, é igual ao usuário atual ou sua hierarquia de relatórios. Hierárquico
eq-useroruserhierarchyandteams Quando modelos de segurança hierárquica são usados, Equals usuário atual e suas equipes ou sua hierarquia de relatórios e suas equipes. Hierárquico
eq-useroruserteams O registro é de propriedade de um usuário ou equipes das quais o usuário é membro. Owner
eq-userteams O registro é de propriedade de um usuário ou equipes das quais o usuário é membro. Owner
GE O valor é maior ou igual ao valor comparado. Número
Data/hora
String
GT O valor é maior do que o valor comparado. Número
Data/hora
String
em O valor existe em uma lista de valores. Opção
Número
Owner
String
Identificador Único
no período fiscal O valor está dentro do período fiscal especificado. Data/hora
no período fiscal e no ano O valor está dentro do período fiscal e do ano especificados. Data/hora
no exercício fiscal O valor está dentro do ano especificado. Data/hora
in-or-pós-período fiscal e ano O valor está dentro ou após o período fiscal e o ano especificados. Data/hora
in-or-antes-período-fiscal-e-ano O valor está dentro ou antes do período fiscal e do ano especificados. Data/hora
Último período fiscal O valor está dentro do período fiscal anterior. Data/hora
último ano fiscal O valor está dentro do exercício anterior. Data/hora
Último mês O valor está dentro do mês anterior, incluindo o primeiro dia do último mês e o último dia do último mês. Data/hora
Últimos sete dias O valor está dentro dos últimos sete dias, incluindo hoje. Data/hora
Última semana O valor é dentro da semana anterior, incluindo domingo a sábado. Data/hora
Últimos-X-Dias O valor está dentro do número de dias especificado anteriormente. Data/hora
últimos-x-períodos-fiscais O valor está dentro do número especificado anterior de períodos fiscais. Data/hora
últimos-x-exercícios-fiscais O valor está dentro do número especificado anterior de períodos fiscais. Data/hora
Últimas horas x horas O valor está dentro do número de horas especificado anteriormente. Data/hora
Últimos x meses O valor está dentro do número de meses especificado anteriormente. Data/hora
Últimas Semanas X O valor está dentro do número de semanas especificado anteriormente. Data/hora
Últimos X-Anos O valor está dentro do número de anos especificado anteriormente. Data/hora
último ano O valor está dentro do ano anterior. Data/hora
le O valor é menor ou igual ao valor comparado. Número
Data/hora
String
goste A cadeia de caracteres corresponde ao padrão especificado. String
lt O valor é inferior ao valor comparado. Número
Data/hora
String
NE Os dois valores não são iguais. Opção
Data/hora
Hierárquico
Número
Owner
String
Identificador Único
NE-BUSINESSID O valor não é igual ao ID comercial especificado. Identificador Único
ne-userid O valor não é igual ao ID de usuário especificado. Identificador Único
NEQ Deprecated. Use ne em vez disso. Permanece apenas para compatibilidade com versões anteriores. N/A
próximo período fiscal O valor está dentro do próximo período fiscal. Data/hora
próximo exercício fiscal O valor está dentro do próximo ano fiscal. Data/hora
próximo mês O valor está dentro do próximo mês. Data/hora
Próximo-Sete Dias O valor é dentro dos próximos sete dias. Data/hora
próxima semana O valor é dentro da próxima semana. Data/hora
Próximo-X-Dias O valor está dentro do próximo número especificado de dias. Data/hora
próximo-x-períodos-fiscais O valor está dentro do próximo número especificado de períodos fiscais. Data/hora
próximo-x-exercícios-fiscais O valor está dentro do próximo número especificado de exercícios fiscais. Data/hora
Próximas-X-Horas O valor está dentro do próximo número especificado de horas. Data/hora
próximos-x-meses O valor está dentro do próximo número especificado de meses. Data/hora
Próximas-X-Semanas O valor está dentro do próximo número especificado de semanas. Data/hora
Próximos-X-Anos O valor está dentro do próximo número especificado de anos. Data/hora
próximo ano O valor está dentro dos próximos X anos. Data/hora
não-começar-com A cadeia de caracteres não começa com outra cadeia de caracteres. String
não-entre O valor não está entre dois valores. Número
Data/hora
não-contém-valores O valor de escolha não é um dos valores especificados. Opção
não-fim-com A cadeia de caracteres não termina com outra cadeia de caracteres. String
não-em O valor dado não corresponde a um valor em uma subconsulta ou lista. Número
não-parecido A cadeia de caracteres não corresponde ao padrão especificado. String
não-nulo O valor não é nulo. Opção
Data/hora
Hierárquico
Número
Owner
String
Identificador Único
não-inferior Retorna todos os registros não abaixo do registro referenciado na hierarquia. Hierárquico
null O valor é null. Opção
Data/hora
Hierárquico
Número
Owner
String
Identificador Único
mais velhos-x-dias O valor é mais antigo do que o número especificado de dias. Data/hora
mais velho-x-horas O valor é mais antigo do que o número especificado de horas. Data/hora
mais velhos-x-minutos O valor é mais antigo do que o número especificado de minutos. Data/hora
mais velhos-x-meses O valor é mais antigo do que o número especificado de meses. Data/hora
mais velho-x-semanas O valor é mais antigo do que o número especificado de semanas. Data/hora
mais velhos-x-anos O valor é mais antigo do que o número especificado de anos. Data/hora
sobre O valor está em uma data especificada. Data/hora
on-or-depois O valor está em ou após uma data especificada. Data/hora
on-or-antes O valor está em ou antes de uma data especificada. Data/hora
este-período fiscal O valor está dentro do período fiscal atual. Data/hora
este-exercício-exercício O valor está dentro do exercício atual. Data/hora
este mês O valor está dentro do mês atual. Data/hora
esta semana O valor está dentro da semana atual. Data/hora
este ano O valor está dentro do ano corrente. Data/hora
Hoje O valor é igual à data de hoje. Data/hora
amanhã O valor é igual à data de amanhã. Data/hora
em Retorna todos os registros filho abaixo do registro referenciado na hierarquia. Hierárquico
Ontem O valor é igual à data de ontem. Data/hora

Voltar ao topo

Operadores por tipo de dado

Esta secção agrupa os operadores pelo tipo de dados com que trabalham.

Dados de escolha

Utilize os seguintes operadores em condições que utilizem valores de escolha.

Operator Description
contém-valores O valor de escolha é um dos valores especificados.
eq Os valores são comparados para a igualdade.
em O valor existe em uma lista de valores.
NE Os dois valores não são iguais.
não-contém-valores O valor de escolha não é um dos valores especificados.
não-nulo O valor não é nulo.
null O valor é null.

Dados de data/hora

Utilize os seguintes operadores em condições com valores de data e hora.

Observação

Quando configuras uma coluna com DateOnly comportamento, não podes usar os operadores que se aplicam às horas e minutos. Saiba mais sobre o comportamento das colunas de data e hora.

O comportamento de alguns operadores depende das configurações do ano fiscal para o ambiente. Saiba mais sobre as configurações do ano fiscal

Operator Description
entre O valor está entre dois valores.
eq Os valores são comparados para a igualdade.
GT O valor é maior do que o valor comparado.
GE O valor é maior ou igual ao valor comparado.
no período fiscal e no ano O valor está dentro do período fiscal e do ano especificados.
no período fiscal O valor está dentro do período fiscal especificado.
no exercício fiscal O valor está dentro do ano especificado.
in-or-pós-período fiscal e ano O valor está dentro ou após o período fiscal e o ano especificados.
in-or-antes-período-fiscal-e-ano O valor está dentro ou antes do período fiscal e do ano especificados.
Último período fiscal O valor está dentro do período fiscal anterior.
último ano fiscal O valor está dentro do exercício anterior.
Último mês O valor está dentro do mês anterior, incluindo o primeiro dia do último mês e o último dia do último mês.
Últimos sete dias O valor está dentro dos últimos sete dias, incluindo hoje.
Última semana O valor é dentro da semana anterior, incluindo domingo a sábado.
Últimos-X-Dias O valor está dentro do número de dias especificado anteriormente.
últimos-x-períodos-fiscais O valor está dentro do número especificado anterior de períodos fiscais.
últimos-x-exercícios-fiscais O valor está dentro do número especificado anterior de períodos fiscais.
Últimas horas x horas O valor está dentro do número de horas especificado anteriormente.
Últimos x meses O valor está dentro do número de meses especificado anteriormente.
Últimas Semanas X O valor está dentro do número de semanas especificado anteriormente.
Últimos X-Anos O valor está dentro do número de anos especificado anteriormente.
último ano O valor está dentro do ano anterior.
le O valor é menor ou igual ao valor comparado.
lt O valor é inferior ao valor comparado.
próximo período fiscal O valor está dentro do próximo período fiscal.
próximo exercício fiscal O valor está dentro do próximo ano fiscal.
próximo mês O valor está dentro do próximo mês.
Próximo-Sete Dias O valor é dentro dos próximos sete dias.
próxima semana O valor é dentro da próxima semana.
Próximo-X-Dias O valor está dentro do próximo número especificado de dias.
próximo-x-períodos-fiscais O valor está dentro do próximo número especificado de períodos fiscais.
próximo-x-exercícios-fiscais O valor está dentro do próximo número especificado de exercícios fiscais.
Próximas-X-Horas O valor está dentro do próximo número especificado de horas.
próximos-x-meses O valor está dentro do próximo número especificado de meses.
Próximas-X-Semanas O valor está dentro do próximo número especificado de semanas.
Próximos-X-Anos O valor está dentro do próximo número especificado de anos.
próximo ano O valor está dentro dos próximos X anos.
não-entre O valor não está entre dois valores.
não-nulo O valor não é nulo.
null O valor é null.
mais velhos-x-dias O valor é mais antigo do que o número especificado de dias.
mais velho-x-horas O valor é mais antigo do que o número especificado de horas.
mais velhos-x-minutos O valor é mais antigo do que o número especificado de minutos.
mais velhos-x-meses O valor é mais antigo do que o número especificado de meses.
mais velho-x-semanas O valor é mais antigo do que o número especificado de semanas.
mais velhos-x-anos O valor é mais antigo do que o número especificado de anos.
on-or-depois O valor está em ou após uma data especificada.
on-or-antes O valor está em ou antes de uma data especificada.
sobre O valor está em uma data especificada.
este-período fiscal O valor está dentro do período fiscal atual.
este-exercício-exercício O valor está dentro do exercício atual.
este mês O valor está dentro do mês atual.
esta semana O valor está dentro da semana atual.
este ano O valor está dentro do ano corrente.
Hoje O valor é igual à data de hoje.
amanhã O valor é igual à data de amanhã.
Ontem O valor é igual à data de ontem.

Dados hierárquicos

Utilize os seguintes operadores em condições com dados hierárquicos. Saiba mais sobre como consultar dados hierárquicos.

Operator Description
acima Retorna todos os registros na linha de ancestralidade hierárquica do registro referenciado.
eq-or-acima Retorna o registro referenciado e todos os registros acima dele na hierarquia.
eq-or-em Retorna o registro referenciado e todos os registros filho abaixo dele na hierarquia.
eq-useroruserhierarchy Quando modelos de segurança hierárquica são usados, é igual ao usuário atual ou sua hierarquia de relatórios.
eq-useroruserhierarchyandteams Quando modelos de segurança hierárquica são usados, Equals usuário atual e suas equipes ou sua hierarquia de relatórios e suas equipes.
não-inferior Retorna todos os registros não abaixo do registro referenciado na hierarquia.
em Retorna todos os registros filho abaixo do registro referenciado na hierarquia.

Dados numéricos

Utilize os seguintes operadores em condições com valores numéricos.

Operator Description
entre O valor está entre dois valores.
eq-userlanguage O valor é igual ao idioma para o usuário.
eq Os valores são comparados para a igualdade.
GE O valor é maior ou igual ao valor comparado.
GT O valor é maior do que o valor comparado.
em O valor existe em uma lista de valores.
le O valor é menor ou igual ao valor comparado.
lt O valor é inferior ao valor comparado.
NE Os dois valores não são iguais.
não-entre O valor não está entre dois valores.
não-em O valor dado não corresponde a um valor em uma subconsulta ou lista.
não-nulo O valor não é nulo.
null O valor é null.

Dados do proprietário

Utilize os seguintes operadores em condições de acordo com os valores do proprietário.

Operator Description
eq-useroruserteams O registro é de propriedade de um usuário ou equipes das quais o usuário é membro.
eq-userteams O registro é de propriedade de um usuário ou equipes das quais o usuário é membro.
eq Os valores são comparados para a igualdade.
em O valor existe em uma lista de valores.
NE Os dois valores não são iguais.

Dados de cadeia de caracteres

Use os seguintes operadores em condições com valores de cadeia.

Todas as condições de filtro para valores de cadeia de caracteres não diferenciam maiúsculas de minúsculas.

Use caracteres coringa com os seguintes operadores: tal,não-gostar, começa-com, não-começo-com, termina-com, e não-fim-com. Saiba mais sobre como usar caracteres curinga em condições para valores de cadeia de caracteres.

Operator Description
começa-com A cadeia de caracteres ocorre no início de outra cadeia de caracteres.
termina-com A cadeia de caracteres termina com outra cadeia de caracteres.
eq Os valores são comparados para a igualdade.
GE O valor é maior ou igual ao valor comparado.
GT O valor é maior do que o valor comparado.
em O valor existe em uma lista de valores.
le O valor é menor ou igual ao valor comparado.
goste A cadeia de caracteres corresponde ao padrão especificado.
lt O valor é inferior ao valor comparado.
NE Os dois valores não são iguais.
não-começar-com A cadeia de caracteres não começa com outra cadeia de caracteres.
não-fim-com A cadeia de caracteres não termina com outra cadeia de caracteres.
não-parecido A cadeia de caracteres não corresponde ao padrão especificado.
não-nulo O valor não é nulo.
null O valor é null.

Dados de identificador único

Utilize os seguintes operadores em condições com valores de identificador único (GUID).

Operator Description
EQ-BusinessID O valor é igual ao ID comercial especificado.
eq-userid O valor é igual ao ID de usuário especificado.
eq Os valores são comparados para a igualdade.
em O valor existe em uma lista de valores.
NE-BUSINESSID O valor não é igual ao ID comercial especificado.
ne-userid O valor não é igual ao ID de usuário especificado.
NE Os dois valores não são iguais.
não-nulo O valor não é nulo.
null O valor é null.

Voltar ao topo

Detalhes do operador

Esta secção inclui detalhes sobre cada um dos operadores de condição FetchXML.

acima

Retorna todos os registros na linha de ancestralidade hierárquica do registro referenciado.

Saiba mais sobre como consultar dados hierárquicos

Tipo de dados: Hierárquico

começa-com

A cadeia de caracteres ocorre no início de outra cadeia de caracteres.

Você pode usar caracteres curinga com este operador. Saiba mais sobre como usar caracteres curinga em condições para valores de cadeia de caracteres.

Tipo de dados: String

entre

O valor está entre dois valores.

Este operador requer dois valores.

<condition attribute="numberofemployees" operator="between">
  <value>6</value>
  <value>20</value>
</condition>

Tipos de dados:

contém-valores

O valor de escolha é um dos valores especificados.

Tipo de dados: Escolha

termina-com

A cadeia de caracteres termina com outra cadeia de caracteres.

Você pode usar caracteres curinga com este operador. Saiba mais sobre como usar caracteres curinga em condições para valores de cadeia de caracteres.

Tipo de dados: String

eq

Os valores são comparados para a igualdade.

Tipos de dados:

EQ-BusinessID

O valor é igual ao ID comercial especificado.

Tipo de dado: Identificador Único

eq-or-acima

Retorna o registro referenciado e todos os registros acima dele na hierarquia.

Saiba mais sobre como consultar dados hierárquicos

Tipo de dados: Hierárquico

eq-or-em

Retorna o registro referenciado e todos os registros filho abaixo dele na hierarquia.

Saiba mais sobre como consultar dados hierárquicos

Tipo de dados: Hierárquico

eq-userid

O valor é igual ao ID de usuário especificado.

Este operador não requer um valor.

<condition attribute='ownerid' operator='eq-userid' />

Tipo de dado: Identificador Único

eq-userlanguage

O valor é igual ao idioma para o usuário.

Quando uma coluna utiliza o tipo Power Apps Language, armazena um valor inteiro que representa o Microsoft Locale ID Value para a língua. O valor é comparado ao UserSettings.UILanguageId que representa o idioma preferido do usuário chamador. Essas colunas têm AttributeMetadata.AttributeTypeName.Value igual a IntegerType e um valor Format de IntegerFormat.Language.

Tipo de dados: Número

eq-useroruserhierarchy

Quando modelos de segurança hierárquica são usados, é igual ao usuário atual ou sua hierarquia de relatórios.

Saiba mais sobre como consultar dados hierárquicos

Tipo de dados: Hierárquico

eq-useroruserhierarchyandteams

Quando modelos de segurança hierárquica são usados, Equals usuário atual e suas equipes ou sua hierarquia de relatórios e suas equipes.

Saiba mais sobre como consultar dados hierárquicos

Tipo de dados: Hierárquico

eq-useroruserteams

O registro é de propriedade de um usuário ou equipes das quais o usuário é membro.

Tipo de dados: Proprietário

eq-userteams

O registro é de propriedade de um usuário ou equipes das quais o usuário é membro.

Tipo de dados: Proprietário

ge

O valor é maior ou igual ao valor comparado.

Tipos de dados:

gt

O valor é maior do que o valor comparado.

Tipos de dados:

in

O valor existe em uma lista de valores.

Tipos de dados:

no período fiscal

O valor está dentro do período fiscal especificado.

Saiba mais sobre as configurações do ano fiscal

O exemplo a seguir mostra uma consulta FetchXML que localiza todos os pedidos atendidos no terceiro período de qualquer ano fiscal, de acordo com as configurações do ano fiscal da organização. Especifique o valor do período fiscal na coluna de valor do elemento condição. Se a organização usar meses fiscais, a consulta retornará os resultados do terceiro mês. Se a organização usar trimestres fiscais, a consulta retornará os resultados do terceiro trimestre. Se a organização usar semestres fiscais, a consulta não devolve resultados porque só existem dois semestres e o valor que forneceu 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>

Tipo de dados: Data-hora

no período fiscal e no ano

O valor está dentro do período fiscal e do ano especificados.

Saiba mais sobre as configurações do ano fiscal

O exemplo a seguir mostra uma expressão FetchXML que localiza todos os pedidos atendidos no período três do ano fiscal de 2023, de acordo com as configurações do ano fiscal da organização. Se a organização usar meses fiscais, a consulta retornará os resultados do terceiro mês. Se a organização usar trimestres fiscais, a consulta retornará os resultados do terceiro trimestre. Se a organização usar semestres fiscais, a consulta não devolve resultados porque só existem dois semestres e o valor que forneceu 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>2023</value>
         </condition>
      </filter>
   </entity>
</fetch>

Tipo de dados: Data-hora

no exercício fiscal

O valor está dentro do ano especificado.

Saiba mais sobre as configurações do ano fiscal

O exemplo a seguir mostra uma expressão FetchXML que localiza todas as contas criadas no ano fiscal de 2023.

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

Tipo de dados: Data-hora

in-or-pós-período fiscal e ano

O valor está dentro ou após o período fiscal e o ano especificados.

Saiba mais sobre as configurações do ano fiscal

Tipo de dados: Data-hora

in-or-antes-período-fiscal-e-ano

O valor está dentro ou antes do período fiscal e do ano especificados.

Saiba mais sobre as configurações do ano fiscal

Tipo de dados: Data-hora

Último período fiscal

O valor está dentro do período fiscal anterior.

Saiba mais sobre as configurações do ano fiscal

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 do ano fiscal da organização. Por exemplo, se a organização usa meses fiscais, a consulta retorna ordens atendidas no último mês fiscal. Se a organização usar trimestres fiscais, a consulta retornará pedidos atendidos no último trimestre fiscal. Se a organização utilizar semestres fiscais, a consulta devolve as ordens cumpridas no último semestre fiscal.

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

Tipo de dados: Data-hora

último ano fiscal

O valor está dentro do exercício anterior.

Saiba mais sobre as configurações do ano fiscal

Tipo de dados: Data-hora

Último mês

O valor está dentro do mês anterior, incluindo o primeiro dia do último mês e o último dia do último mês.

Tipo de dados: Data-hora

Últimos sete dias

O valor está dentro dos últimos sete dias, incluindo hoje.

Tipo de dados: Data-hora

Última semana

O valor é dentro da semana anterior, incluindo domingo a sábado.

Tipo de dados: Data-hora

Últimos-X-Dias

O valor está dentro do número de dias especificado anteriormente.

Tipo de dados: Data-hora

últimos-x-períodos-fiscais

O valor está dentro do número especificado anterior de períodos fiscais.

Saiba mais sobre as configurações do ano fiscal

Tipo de dados: Data-hora

últimos-x-exercícios-fiscais

O valor está dentro do número especificado anterior de períodos fiscais.

Saiba mais sobre as configurações do ano fiscal

Tipo de dados: Data-hora

Últimas horas x horas

O valor está dentro do número de horas especificado anteriormente.

Não é possível aplicar esse operador em uma coluna configurada para usar o DateOnly comportamento. Saiba mais sobre o comportamento das colunas de data e hora

Tipo de dados: Data-hora

Últimos x meses

O valor está dentro do número de meses especificado anteriormente.

Tipo de dados: Data-hora

Últimas Semanas X

O valor está dentro do número de semanas especificado anteriormente.

Tipo de dados: Data-hora

Últimos X-Anos

O valor está dentro do número de anos especificado anteriormente.

Tipo de dados: Data-hora

último ano

O valor está dentro do ano anterior.

Tipo de dados: Data-hora

le

O valor é menor ou igual ao valor comparado.

Tipos de dados:

gostar

A cadeia de caracteres corresponde ao padrão especificado.

Você pode usar caracteres curinga com este operador. Saiba mais sobre como usar caracteres curinga em condições para valores de cadeia de caracteres.

Tipo de dados: String

lt

O valor é inferior ao valor comparado.

Tipos de dados:

ne

Os dois valores não são iguais.

Tipos de dados:

NE-BUSINESSID

O valor não é igual ao ID comercial especificado.

Tipo de dado: Identificador Único

ne-userid

O valor não é igual ao ID de usuário especificado.

Tipo de dado: Identificador Único

NEQ

Deprecated. Use ne em vez disso. Permanece apenas para compatibilidade com versões anteriores.

próximo período fiscal

O valor está dentro do próximo período fiscal.

Saiba mais sobre as configurações do ano fiscal

Tipo de dados: Data-hora

próximo exercício fiscal

O valor está dentro do próximo ano fiscal.

Saiba mais sobre as configurações do ano fiscal

Tipo de dados: Data-hora

próximo mês

O valor está dentro do próximo mês.

Tipo de dados: Data-hora

Próximo-Sete Dias

O valor é dentro dos próximos sete dias.

Tipo de dados: Data-hora

próxima semana

O valor é dentro da próxima semana.

Tipo de dados: Data-hora

Próximo-X-Dias

O valor está dentro do próximo número especificado de dias.

Tipo de dados: Data-hora

próximo-x-períodos-fiscais

O valor está dentro do próximo número especificado de períodos fiscais.

Saiba mais sobre as configurações do ano fiscal

Tipo de dados: Data-hora

próximo-x-exercícios-fiscais

O valor está dentro do próximo número especificado de exercícios fiscais.

Saiba mais sobre as configurações do ano fiscal

O exemplo a seguir mostra uma expressão FetchXML que localiza todas as oportunidades com uma data de fechamento estimada nos próximos três anos fiscais, com base nas configurações do ano fiscal da organização. Especifica o valor de x na coluna de valor do elemento 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>

Tipo de dados: Data-hora

Próximas-X-Horas

O valor está dentro do próximo número especificado de horas.

Não é possível aplicar esse operador em uma coluna configurada para usar o DateOnly comportamento. Saiba mais sobre o comportamento das colunas de data e hora

Tipo de dados: Data-hora

próximos-x-meses

O valor está dentro do próximo número especificado de meses.

Tipo de dados: Data-hora

Próximas-X-Semanas

O valor está dentro do próximo número especificado de semanas.

Tipo de dados: Data-hora

Próximos-X-Anos

O valor está dentro do próximo número especificado de anos.

Tipo de dados: Data-hora

próximo ano

O valor está dentro dos próximos X anos.

Tipo de dados: Data-hora

não-começar-com

A cadeia de caracteres não começa com outra cadeia de caracteres.

Você pode usar caracteres curinga com este operador. Saiba mais sobre como usar caracteres curinga em condições para valores de cadeia de caracteres.

Tipo de dados: String

não-entre

O valor não está entre dois valores.

Tipos de dados:

não-contém-valores

O valor de escolha não é um dos valores especificados.

Tipo de dados: Escolha

não-fim-com

A cadeia de caracteres não termina com outra cadeia de caracteres.

Você pode usar caracteres curinga com este operador. Saiba mais sobre como usar caracteres curinga em condições para valores de cadeia de caracteres.

Tipo de dados: String

não-em

O valor dado não corresponde a um valor em uma subconsulta ou lista.

Tipo de dados: Número

não-parecido

A cadeia de caracteres não corresponde ao padrão especificado.

Você pode usar caracteres curinga com este operador. Saiba mais sobre como usar caracteres curinga em condições para valores de cadeia de caracteres.

Tipo de dados: String

não-nulo

O valor não é nulo.

Tipos de dados:

não-inferior

Retorna todos os registros não abaixo do registro referenciado na hierarquia.

Saiba mais sobre como consultar dados hierárquicos

Tipo de dados: Hierárquico

null

O valor é null.

Tipos de dados:

mais velhos-x-dias

O valor é mais antigo do que o número especificado de dias.

Tipo de dados: Data-hora

mais velho-x-horas

O valor é mais antigo do que o número especificado de horas.

Não é possível aplicar esse operador em uma coluna configurada para usar o DateOnly comportamento. Saiba mais sobre o comportamento das colunas de data e hora

Tipo de dados: Data-hora

mais velhos-x-minutos

O valor é mais antigo do que o número especificado de minutos.

Não é possível aplicar esse operador em uma coluna configurada para usar o DateOnly comportamento. Saiba mais sobre o comportamento das colunas de data e hora

O exemplo a seguir mostra uma consulta FetchXML que retorna incidentes com mais 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>

Tipo de dados: Data-hora

mais velhos-x-meses

O valor é mais antigo do que o número especificado de meses.

Tipo de dados: Data-hora

mais velho-x-semanas

O valor é mais antigo do que o número especificado de semanas.

Tipo de dados: Data-hora

mais velhos-x-anos

O valor é mais antigo do que o número especificado de anos.

Tipo de dados: Data-hora

on

O valor está em uma data especificada.

Tipo de dados: Data-hora

on-or-depois

O valor está em ou após uma data especificada.

Tipo de dados: Data-hora

on-or-antes

O valor está em ou antes de uma data especificada.

Tipo de dados: Data-hora

este-período fiscal

O valor está dentro do período fiscal atual.

Saiba mais sobre as configurações do ano fiscal

Tipo de dados: Data-hora

este-exercício-exercício

O valor está dentro do exercício atual.

Saiba mais sobre as configurações do ano fiscal

Tipo de dados: Data-hora

este mês

O valor está dentro do mês atual.

Tipo de dados: Data-hora

esta semana

O valor está dentro da semana atual.

Tipo de dados: Data-hora

este ano

O valor está dentro do ano corrente.

Tipo de dados: Data-hora

Hoje

O valor é igual à data de hoje.

Tipo de dados: Data-hora

amanhã

O valor é igual à data de amanhã.

Tipo de dados: Data-hora

em

Retorna todos os registros filho abaixo do registro referenciado na hierarquia.

Saiba mais sobre como consultar dados hierárquicos

Tipo de dados: Hierárquico

Ontem

O valor é igual à data de ontem.

Tipo de dados: Data-hora