Partilhar via

Sintaxe de expressões de gatilho no SharePoint

  • Artigo

Saiba mais sobre expressões de gatilho que você pode usar para criar condições de gatilho para configurar a chamada do serviço Web no SharePoint.

Elementos usados na sintaxe das expressões de gatilho

Os elementos que podem ser usados em uma expressão de gatilho são:

  • Operadores

  • Acesso de valor de propriedade de gerenciados

  • Literais

  • Funções

  • Constantes

Observação

[!OBSERVAçãO] A cadeia de caracteres " Null" é reservada para o valor Null.

Operadores na sintaxe de expressão gatilho

A tabela 1 descreve os operadores de suporte de linguagem de expressão de gatilho, com a ordem de precedência sendo do maior para o menor. Operadores na mesma categoria têm precedência igual. Vários operadores tem duas versões de sua sintaxe.

Tabela 1. Operadores com suporte para sintaxe de expressão de gatilho

Categoria Expressão Descrição
Unário
 -
!, NÃO
 Negação aritmética
Negação lógica
Multiplicassão
 *
/
%, mod
 Multiplicação
Divisão
Restante
Aditivo
 +
-
&
 Adição
Subtração
Concatenação de cadeia de caracteres
Relacional
 =, = =
!=, <>
<
>
<=
>=
 Igualdade
Desigualdade
Menor que
Maior que
Menor ou igual
Maior que ou igual
AND lógico
 &&, AND
 AND lógico
OR lógico
 OU
 OR lógico

Gerenciados acesso à propriedade em expressões de gatilho

Propriedades gerenciadas nos itens rastreados sejam referenciadas por seus nomes; o nome não estiver entre aspas ("") e diferencia maiúsculas de minúsculas.

Literais em expressões de gatilho

Os seguintes tipos de dados podem ser expresso como literais: String, Int32, Doublee Boolean.

Funções em expressões de gatilho

Uma ampla coleção de funções que vão desde funções matemáticas, como Floor até funções para uso com tipos de dados específicos, como Lists. Você pode usar essas funções individualmente ou você pode aninhá-los.

  • bool? ListContains<T>(IList<T> list, T obj)

  • int? Count<TElement>(IList<TElement> list)

  • TElement Item<TElement>(IList<TElement> list, int? index)

  • bool IsInsideRange(DateTime? date, long? fromTicks, long? toTicks)

  • DateTime Now()

  • DateTime? ToDate(string date, string format)

  • int? Day(DateTime? date)

  • int? DayOfWeek(DateTime? date)

  • int? DayOfYear(DateTime? date)

  • int? GetDatePart(DateTime? date, DatePartConstant datePartConstant)

  • int? Hour(DateTime? date)

  • int? Minute(DateTime? date)

  • int? Month(DateTime? date)

  • int? Quarter(DateTime? date)

  • int? Second(DateTime? date)

  • int? Year(DateTime? date)

  • long? GetDateDiff(DateTime? occursFirst, DateTime? occursLast, DatePartConstant datePartConstant)

  • string Extension(string arg)

  • string FileName(string arg)

  • string FileName(string arg, bool? excludeExtension)

  • bool IsNull(object value)

  • bool? IsDate(string input, string format)

  • object IfThenElse(bool? condition, object thenBranch, object elseBranch)

  • decimal? Ceiling(decimal? number)

  • decimal? Floor(decimal? number)

  • double? Ceiling(double? number)

  • double? Floor(double? number)

  • double? Sqrt(double? number)

  • bool? Contains(string arg, string contained)

  • bool? EndsWith(string arg, string suffix)

  • bool? IsMatch(string input, string pattern)

  • bool? IsMatch(string input, string pattern, int? start, RegexOptionConstant options)

  • bool? IsMatch(string input, string pattern, RegexOptionConstant options)

  • bool? IsNullOrEmpty(string input)

  • bool? StartsWith(string arg, string prefix)

  • int? IndexOf(string arg, string toFind)

  • int? IndexOfRegex(string input, string regex)

  • int? LastIndexOf(string arg, string toFind)

  • int? Length(string arg)

  • string Match(string input, string pattern)

  • string Match(string input, string pattern, int? start, int? length, RegexOptionConstant options)

  • string Match(string input, string pattern, int? start, RegexOptionConstant options)

  • string Match(string input, string pattern, RegexOptionConstant options)

  • string Substring(string arg, int? start)

  • string Substring(string arg, int? start, int? length)

  • string ToLower(string arg)

  • string Trim(string value)

Constantes em expressões de gatilho

Há dois conjuntos de constantes que podem ser usadas com funções específicas: DatePartConstant e RegexOptionConstant. A tabela 2 lista os dois exemplos de constantes e onde você pode usá-los.

Tabela 2. Constantes de expressão de gatilho e uso no SharePoint

Grupo de constantes Exemplos Uso
DatePartConstant
Day, Month, Year, Hour, Minute, Second.
Com a função GetDatePart
RegexOptionConstant
IgnoreCase
Com as funções IsMatch, Match, ReplaceRegexe IndexOfRegex.

Confira também