Visão geral das expressões de dados calculadas

Converte uma string em uma matriz. O delimitador pode ser qualquer string.

A expressão é formatada da seguinte maneira:

ARRAY(string1, "delimiter")

Procura um valor específico em uma lista ou matriz. Se o valor for encontrado, a função retorna Verdadeiro, caso contrário, retorna Falso.

A expressão é formatada da seguinte maneira:

ARRAYCONTAINS(array, value)

Retorna o número de elementos na matriz e é formatado da seguinte maneira:

ARRAYLENGTH(array)

Retorna o elemento no número especificado na matriz. Se o índice estiver fora dos limites, ele retornará vazio.

A expressão é formatada da seguinte maneira:

ARRAYELEMENT(array, number)

É usado com outras expressões para escolher um valor de uma lista, com base em um número de índice.

Um número de índice é um campo ou função que retorna um valor numérico (geralmente em um intervalo conhecido).

A expressão é formatada da seguinte maneira:

CASE(indexNumber, value1, value2, ...)

Por exemplo, a expressão a seguir retorna o nome do dia da semana, onde 1 = domingo, 2 = segunda-feira e assim por diante, em uma coluna calculada:

CASE(DAYOFWEEK({entryDate}),"Sunday","Monday","Tuesday","Wednesday","Thursday","Friday","Saturday")

Funciona melhor com outras expressões que retornam um número, como DAYOFWEEK, DAYOFMONTH e MONTH.

Concatena a string e é formatada da seguinte maneira:

CONCAT(string1,"separator", string2)

A seguir estão alguns exemplos de separadores que você pode incluir:

• um espaço: " "
• um traço: "-"
• uma barra: "/"
• uma vírgula: ","
• uma palavra: "ou", "e"

Retorna verdadeiro se a string findText for encontrada dentro da string withinText e estiver formatada da seguinte maneira:

CONTAINS(findText, withinText)

Escapa quaisquer caracteres especiais na string para que possam ser incluídos em um argumento de URL.

A expressão é formatada da seguinte maneira:

ENCODEURL(string)

Retorna o texto formatado. Apenas as opções de parâmetros listadas aqui são permitidas com FORMAT.

As opções de cor são $$POSITIVE, $$INFORMATIVE, $$NEGATIVE, $$NOTICE e as outras opções de formatação são $$BOLD, $$ITALIC, $$UNDERLINE. É permitida apenas uma opção de cor, juntamente com até três outras opções de formatação. Se nenhuma opção de cor for especificada, a cor padrão do sistema será aplicada.

A expressão é formatada da seguinte maneira:

FORMAT($$POSITIVE, $$BOLD, $$ITALIC)

Observação: esta expressão não é compatível com o Workfront Planning.

Avalia uma condição especificada e retorna o valor da trueExpression se ela for verdadeira, ou o valor da falseExpression se ela for falsa.

A expressão é formatada da seguinte maneira:

IF(condition, trueExpression, falseExpression)

Por exemplo, você pode comparar dois campos de data diferentes seguidos por um resultado Verdadeiro/Falso como uma string de dados:

IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","On Track")

Na linguagem cotidiana, essa afirmação significa: “SE a data de conclusão prevista do meu objeto for ‘maior que’ a data de conclusão planejada do mesmo objeto, exiba as palavras ‘Fora do prazo’ neste campo; caso contrário, exiba as palavras ‘Dentro do prazo’”.

Se você não quiser rotular as expressões verdadeiras ou falsas, deve inserir um rótulo em branco em sua declaração, como:

IF({projectedCompletionDate}>{plannedCompletionDate},"","On Track")

Ou

IF({projectedCompletionDate}>{plannedCompletionDate},"Off Track","")

Para obter mais informações sobre como criar instruções “IF”, consulte Visão geral das instruções “IF”.

Permite procurar um valor específico em uma string de valores possíveis. Se o valor que você está procurando for igual a um dos valores fornecidos, a expressão retornará a trueExpression; caso contrário, retornará a falseExpression.

A expressão é formatada da seguinte maneira:

IFIN(value, value1, value2,..., trueExpression, falseExpression)

Por exemplo, você pode encontrar um proprietário de projeto específico e marcar esses projetos com uma etiqueta específica em uma exibição de projeto:

IFIN({owner}.{name},"Jennifer Campbell","Rick Kuvec","Marketing Team","Other Teams")

Na linguagem cotidiana, essa afirmação significa: “Se o proprietário do projeto for Jennifer Campbell ou Rick Kuvec, marque este projeto com ‘Equipe de Marketing’; caso contrário, marque-o com ‘Outras equipes’.”

Se você não quiser rotular as expressões verdadeiras ou falsas, deve inserir um rótulo em branco em sua declaração, como:

IFIN({owner}.{name},"Jennifer Campbell","Rick Kuvec","","Other Teams")

Ou

IFIN({owner}.{name},"Jennifer Campbell","Rick Kuvec","Marketing Team","")

Retorna verdadeiro se o valor for igual a um dos valores fornecidos; caso contrário, a expressão retorna falso.

A expressão é formatada da seguinte maneira:

IN(value, value1[, value2...])

Retorna verdadeiro se o valor for nulo ou em branco; caso contrário, a expressão retorna falso.

A expressão é formatada da seguinte maneira:

ISBLANK(value)

Retorna um número especificado de caracteres do lado esquerdo de uma string e é formatado da seguinte maneira:

LEFT(string, length)

Retorna o comprimento de uma string e é formatado da seguinte maneira:

LEN(string)

Retorna a string em minúsculas e formatada da seguinte maneira:

LOWER(string)

Converte a string de entrada para PascalCase, colocando em maiúscula a primeira letra de cada palavra e removendo todos os espaços.

A expressão é formatada da seguinte maneira:

PASCAL(string)

Por exemplo, “olá mundo” se torna “OláMundo”

Remove os sinais diacríticos de todos os caracteres acentuados na string de entrada.

A expressão é formatada da seguinte maneira:

REMOVEACCENTS(string)

Por exemplo, “Olá mündó com àcentós” torna-se “Ola mundo com acentos”.

Substitui todas as ocorrências de string2 por string3 em string1.

A expressão é formatada da seguinte maneira:

REPLACE(string1, string2, string3)

Substitui as correspondências do padrão fornecido pela string de substituição.

A expressão é formatada da seguinte maneira:

REPLACEPATTERN (string, pattern, replacement string)

Por exemplo, REPLACEPATTERN("foo123bar", "\d+", "_") gera a string “foo_bar”.

Retorna um número especificado de caracteres do lado direito de uma string e é formatado da seguinte maneira:

RIGHT(string, length)

Retorna o índice da primeira ocorrência de findText na string withinText, começando na posição inicial especificada, ou –1 se o texto não for encontrado.

A expressão é formatada da seguinte maneira:

SEARCH(findText, withinText, start)

Ordena os elementos da matriz em ordem crescente e os converte para o tipo do primeiro elemento.

A expressão é formatada da seguinte maneira:

SORTASCARRAY(array)

Por exemplo, ["–12,6", –13,0] torna-se ["–12,6", "–13"].

Observação: esta expressão não é compatível com o Workfront Planning.

Ordena os elementos da matriz em ordem decrescente e os converte para o tipo do primeiro elemento.

A expressão é formatada da seguinte maneira:

SORTDESCARRAY(array)

Por exemplo, ["–12,6", –13,0] torna-se ["–13", "–12.6"].

Observação: esta expressão não é compatível com o Workfront Planning.

Converte um número em uma string e é formatado da seguinte maneira:

STRING(number)

Classifica uma lista de strings em ordem crescente e é formatada da seguinte maneira:

SORTASCSTRING(string1, string2, ...)

Classifica uma lista de strings em ordem decrescente e é formatada da seguinte maneira:

SORTDESCSTRING(string1, string2, ...)

Retorna caracteres de uma string com base no índice inicial e final especificado e é formatado da seguinte maneira:

SUBSTR({string}, number of start position, number of end position)

Avalia a expressão em contraste com uma lista de valores e retorna o resultado equivalente ao primeiro valor correspondente.

A expressão é formatada da seguinte forma:

SWITCH(expression, value1, result1, [value2, result2], ...)

Esta expressão não é suportada no Workfront Planning.

Remove os espaços em branco do início e do final de uma string e é formatado da seguinte maneira:

TRIM(string)

Retorna uma string em maiúsculas e é formatada da seguinte maneira:

UPPER(string)