Documentação Campaign Interface do Campaign Web

Editar expressões expression

Last update: Fri Apr 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

A edição de uma expressão envolve a inserção manual de condições para formar uma regra. Esse modo permite usar funções avançadas, que permitem manipular os valores usados para realizar consultas específicas, como manipular datas, sequências de caracteres, campos numéricos e classificação.

IMPORTANT

A seção abaixo fornece informações sobre como trabalhar com o editor de expressão para criar regras. Lembre-se de que a sintaxe usada para criar regras é diferente da usada para adicionar personalização.

Trabalhar com o editor de expressão edit

O editor de expressão está disponível pelo botão Editar expressão do modelador de consulta, disponível para os campos Atributo e Valor ao configurar uma condição personalizada.

Acesso pelo campo Atributo

Acesso do campo Value

Editor de expressão para o campo Atributo

{modal="regular"}

{modal="regular"}

O editor de expressão fornece:

Um campo de entrada (1) onde a expressão é definida.
Uma lista de campos (2) disponíveis que podem ser usados na expressão e correspondem à dimensão de direcionamento da consulta.
Funções auxiliares (3), classificadas por categoria.

Edite a expressão inserindo uma expressão diretamente no campo de entrada. Para adicionar um campo ou uma função auxiliar, coloque o cursor na expressão em que deseja adicioná-lo e clique no botão +.

Interface do editor de expressão {modal="regular"}

Quando a expressão estiver pronta, clique no botão Confirmar. A expressão é exibida no campo selecionado. Para editá-lo, abra o editor de expressão e faça as alterações desejadas.

O exemplo abaixo mostra uma expressão configurada para o campo Value. Para editá-lo, abra o editor de expressão usando o botão Editar expressão.

Exemplo de expressão de edição para o campo Value {modal="regular"}

Funções de ajuda

A ferramenta de edição de query permite usar funções avançadas para fazer filtragens complexas dependendo dos resultados desejados e dos tipos de dados manipulados. Os recursos abaixo estão disponíveis.

Agregado

Funções agregadas executam cálculos em um conjunto de valores.

Nome

Descrição

Sintaxe

Avg

Retorna a média de uma coluna do tipo número

Avg(<value>)

Contagem

Conta os valores não nulos de uma coluna

Count(<value>)

CountAll

Conta os valores retornados (todos os campos)

CountAll()

Countdistinct

Conta os valores não nulos distintos de uma coluna

Countdistinct(<value>)

Max

Retorna o valor máximo de uma coluna, cadeira de caracteres ou coluna de tipo de data

Max(<value>)

Min

Retorna o valor mínimo de uma coluna, cadeira de caracteres ou coluna de tipo de data

Min(<value>)

StdDev

Retorna o desvio padrão de uma coluna do tipo número, cadeira de caracteres ou dados

StdDev(<value>)

StringAgg

Retorna a concatenação dos valores de uma coluna do tipo string, separados pelo caractere do segundo argumento

StringAgg(<Value>, <String>)

Sum

Retorna a soma dos valores de uma coluna do tipo número, cadeira de caracteres ou dados

Sum(<value>)

Data

Funções de data manipulam valores de data ou hora.

Nome

Descrição

Sintaxe

AddDays

Adiciona um número de dias a uma data

AddDays(<date>, <number>)

AddHours

Adiciona um número de horas a uma data

AddHours(<date>, <number>)

AddMinutes

Adiciona um número de minutos a uma data

AddMinutes(<date>, <number>)

AddMonths

Adiciona um número de meses a uma data

AddMonths(<date>, <number>)

AddSeconds

Adiciona um número de segundos a uma data

AddSeconds(<date>, <number>)

AddYears

Adiciona um número de anos a uma data

AddYears(<date>, <number>)

ConvertNTZ

Converte o carimbo de data e hora NTZ (carimbo de data e hora sem fuso horário) em TZ (carimbo de data e hora com fuso horário) usando a sessão definida TZ

ConvertNTZ(<date+time>)

DateCmp

Compara duas datas

DateCmp(<data>, <data>)

DateOnly

Retorna somente a data (com a hora 00:00)

DateOnly(<date>)

Dia

Retorna o número que representa o dia da data

Day(<date>)

DayOfYear

Retorna o número do dia no ano da data

DayOfYear(<date>)

DaysAgo

Retorna a data correspondente à data atual menos n dias

DaysAgo(<number>)

DaysAgoInt

Retorna a data (inteiro aaaammdd) correspondente à data atual menos n dias

DaysAgoInt(<number>)

DaysDiff

Retorna o número de dias entre duas datas

DaysDiff(<end date>, <start date>)

DaysOld

Retorna a idade em dias de uma data.

DaysOld(<date>)

GetDate

Retorna a data atual do sistema do servidor.

GetDate()

Hora

Retorna a hora da data.

Hour(<date>)

HoursDiff

Retorna o número de horas entre duas datas

HoursDiff(<end date>, <start date>)

Minuto

Retorna os minutos da data

Minute(<date>)

MinutesDiff

Retorna o número de minutos entre duas datas

MinutesDiff(<end date>, <start date>)

Mês

Retorna o número que representa o mês da data

Month(<date>)

MonthsAgo

Retorna a data correspondente à data atual menos n meses

MonthsAgo(<number>)

MonthsDiff

Retorna o número de meses entre duas datas

MonthsDiff(<end date>, <start date>)

MonthsOld

Retorna a idade em meses de uma data

MonthsOld(<date>)

Oldest

Retorna a data mais antiga em um intervalo

Oldest(<data, data>)

Second

Retorna os segundos da data

Second(<date>)

SecondsDiff

Retorna o número de segundos entre duas datas

SecondsDiff(<end date>, <start date>)

SubDays

Subtrai um número de dias a partir de uma data

SubDays(<date>, <number>)

SubHours

Subtrai um número de horas a partir de uma data

SubHours(<date>, <number>)

SubMinutes

Subtrai um número de minutos de uma data

SubMinutes(<date>, <number>)

SubMonths

Subtrai um número de meses a partir de uma data

SubMonths(<date>, <number>)

SubSeconds

Subtrai um número de segundos a partir de uma data

SubSeconds(<date>, <number>)

SubYears

Subtrai um número de anos a partir de uma data

SubYears(<date>, <number>)

ToDate

Converte uma data + hora em uma data

ToDate(<date + time>)

ToDateTime

Converte uma cadeia de caracteres em uma data + hora

ToDateTime(<string>)

ToTimestamp

Converte uma cadeia de caracteres em um carimbo de data e hora

ToTimestamp(<string>)

ToTimeZone

Converte uma data + hora em um fuso horário

ToTimeZone(<data>, <fuso horário>)

TruncDate

Arredonda uma data e hora para o segundo mais próximo

TruncDate(@lastModified, <number of seconds>)

TruncDateTZ

Arredonda uma data e hora para uma determinada precisão expressa em segundos

TruncDateTZ(<date>, <number of seconds>, <time zone>)

TruncQuarter

Arredonda uma data para o trimestre

TruncQuarter(<date>)

TruncTime

Arredonda a parte de horário para cima até o próximo segundo

TruncTime(<date>, <number of seconds>)

TruncWeek

Arredonda uma data para a semana

TruncWeek(<date>)

TruncYear

Arredonda uma data + hora para 1º de janeiro do ano

TruncYear(<date>)

WeekDay

Retorna um número que representa o dia da semana da data (0 = segunda-feira, 6 = domingo)

WeekDay(<date>)

Ano

Retorna o número que representa o ano da data

Year(<date>)

YearAndMonth

Retorna o número que representa o ano e o mês da data.

YearAndMonth(<date>)

YearsAgo

Retorna o número de anos entre uma determinada data e a data atual

YearsAgo(<date>)

YearsDiff

Retorna o número de anos entre duas datas

YearsDiff(<end date>, <start date>)

YearsOld

Retorna a idade em anos de uma data

YearsOld(<date>)

NOTE

Observe que a função DateOnly considera o fuso horário do servidor e não do operador.

Geomarketing

As funções de geomarketing são usadas para manipular valores geográficos.

Nome

Descrição

Sintaxe

Distance

Retorna a distância entre dois pontos definidos por sua longitude e latitude, expresso em graus.

Distance(<Longitude A>, <Latitude A>, <Longitude B>, <Latitude B>)

Numérico

As funções numéricas são usadas para converter texto em números.

Nome

Descrição

Sintaxe

Abs

Retorna o valor absoluto de um número

Abs(<número>)

Ceil

Retorna o número inteiro mais baixo maior ou igual a um número

Ceil(<número>)

Floor

Retorna o maior inteiro maior ou igual a um número

Floor(<number>)

Greatest

Retorna o maior número de dois números

Greatest(<número 1>, <número 2>)

Least

Retorna o menor de dois números

Least(<número 1>, <número 2>)

Mod

Retorna o restante da divisão inteira de n1 por n2

Mod(<number 1>, <number 2>)

Percent

Retorna a proporção de dois números expressos como uma porcentagem

Percent(<número 1>, <número 2>)

Random

Retorna o valor aleatório

Random()

Round

Arredonda um número para decimais n

Round(<número>, <número de decimais>)

Sign

Retorna o sinal do número

Sign(<número>)

ToDouble

Converte um inteiro em um flutuante

ToDouble(<número>)

ToInt64

Converte um flutuante em um inteiro de 64 bits

ToInt64(<número>)

ToInteger

Converte um flutuante em um inteiro

ToInteger(<número>)

Trunc

Corta o n1 para o decimal n2

Trunc(<n1>, <n2>)

Outros

Esta tabela contém as funções restantes disponíveis.

Nome

Descrição

Sintaxe

CriptografiaAEM

Cadeia de caracteres criptografada fornecida no argumento

AESEncrypt(<valor>)

Case

Retorna o valor 1 se a condição for verdadeira. Caso contrário, retornará o valor 2.

Case(When(<condition>, <value 1>), Else(<value 2>))

ClearBit

Exclui o Sinalizador no valor

ClearBit(<identificador>, <sinalizador>)

Coalesce

Retorna o valor 2 se o valor 1 for zero ou nulo, caso contrário retorna o valor 1

Coalesce(<valor 1>, <valor 2>)

Decode

Retorna o valor 3 se o valor 1 for igual ao valor 2. Caso contrário, retorna o valor 4.

Decode(<value 1>, <value 2>, <value 3>, <value 4>)

Else

Retorna o valor 1 (só pode ser usado como parâmetro da função case)

Else(<value 1>, <value 2>)

GetEmailDomain

Extrai o domínio de um endereço de email

GetEmailDomain(<valor>)

GetMirrorURL

Recupera o URL do servidor da mirror page

GetMirrorURL(<valor>)

Iif

Retorna o valor 1 se a expressão for verdadeira. Caso contrário, retorna o valor 2

Iif(<condition>, <value 1>, <value 2>)

IsBitSet

Indica se o Sinalizador está no valor

IsBitSet(<identificador>, <sinalizador>)

IsEmptyString

Retorna o valor 2 se a string 1 estiver vazia, caso contrário, retorna o valor 3.

IsEmptyString(<value 1>, <value 2>, <value 3>)

NovoUUID

Retorna uma ID exclusiva

NewUUID()

NoNull

Retorna a string vazia se o argumento for NULL.

NoNull(<valor>)

RowId

Retorna o número da linha.

RowId

SetBit

Força o Sinalizador no valor.

SetBit(<identificador>, <sinalizador>)

ToBoolean

Converte um número em um booleano

ToBoolean(<número>)

When

Retorna o valor 1 se a expressão for verdadeira. Se não, ele retorna o valor 2 (só pode ser usado como parâmetro da função case)

When(<condition>, <value 1>)

String

As funções de string são usadas para manipular um conjunto de strings.

Nome

Descrição

Sintaxe

AllNonNull2

Indica se todos os parâmetros são não nulos e não estão vazios

AllNonNull2(<string>, <string>)

AllNonNull3

Indica se todos os parâmetros são não nulos e não estão vazios

AllNonNull3(<string>, <string>, <string>)

Ascii

Retorna o valor ASCII do primeiro caractere na string.

Ascii(<string>)

Char

Retorna o caractere correspondente ao código ASCII 'n'

Char(<number>)

Charindex

Retorna a posição da string 2 na string 1.

Charindex(<string>, <string>)

dataLength

Retorna o tamanho em bytes da cadeia de caracteres

dataLength(<string>)

GetLine

Retorna a linha enésima (de 1 a n) da string

GetLine(<string>)

IfEquals

Retorna o terceiro parâmetro se os dois primeiros parâmetros forem iguais. Caso contrário, retorna o último parâmetro

IfEquals(<string>, <string>, <string>, <string>)

IsMemoNull

Indica se o memorando passado como parâmetro é nulo

IsMemoNull(<memo>)

JuxtWords

Concatena a string transmitidas como parâmetros. Adiciona espaços entre a string, se necessário.

JuxtWords(<string>, <string>)

JuxtWords3

Concatena a string transmitidas como parâmetros. Adiciona espaços entre a string, se necessário

JuxtWords3(<string>, <string>, <string>)

Left

Retorna os primeiros n caracteres da string

Left(<string>, <number>)

Length

Retorna o comprimento da string

Length(<string>)

Linha

Extrair linha n da cadeia de caracteres

Line(<string>,<number>)

Lower

Retorna a string em minúsculas

Lower(<string>)

LPad

Retorna a string concluída à esquerda

LPad (<Cadeia de caracteres>, <Número>, <Caractere>)

Ltrim

Remove espaços à esquerda da string

Ltrim(<string>)

Md5Digest

Retorna uma representação hexadecimal da chave MD5 de uma string

Md5Digest(<string>)

MemoContains

Especifica se o memorando contém a string aprovada como um parâmetro

MemoContains(<memorando>, <string>)

ValorDoNó

Extrai o valor de um campo XML de seu XPath e dos dados do campo

NodeValue (<String>, <String>)

Replace

Substitui todas as ocorrências de um valor de cadeia de caracteres especificado por outro valor de cadeia de caracteres.

Replace(<String>,<String>,<String>)

Right

Retorna os últimos n caracteres da string

Right(<string>)

RPad

Retorna a string concluída à direita

RPad(<string>, <número>, <caractere>)

Rtrim

Remove espaços à direita da string

Rtrim(<string>)

Sha256Digest

Representação hexadecimal da chave SHA256 de uma cadeia de caracteres.

Sha256Digest (<Cadeia de caracteres>)

Sha512Digest

Representação hexadecimal da chave SHA512 de uma cadeia de caracteres.

Sha512Digest (<Cadeia de caracteres>)

Smart

Retorna a string com a primeira letra de cada palavra em maiúsculas

Smart(<string>)

Substring

Extrai a substring iniciando no caractere n1 da cadeira de caracteres e de comprimento n2

Substring(<string>, <offset>, <length>)

ToString

Converte o número em uma string

ToString(<number>, <number>)

Upper

Retorna a string em maiúsculas

Upper(<string>)

VirtualLink

Retorna a chave externa de um link passado como um parâmetro se os outros dois parâmetros forem iguais

VirtualLink(<número>, <número>, <número>)

VirtualLinkStr

Retorna a chave externa (texto) de um link passado como um parâmetro se os outros dois parâmetros forem iguais

VirtualLinkStr(<string>, <número>, <número>)

Janela

Nome

Descrição

Sintaxe

_Sobre__

Execute a chamada de função SQL inserida como o primeiro parâmetro, em Partição ou Ordenar pelos campos inseridos como o segundo parâmetro

_Over_ (<Value>, <Value>)

Desc

Aplica uma classificação decrescente

Desc(<valor 1>)

OrderBy

Classifica o resultado dentro da partição

OrderBy(<valor 1>)

PartitionBy

Partições do resultado de um query em uma tabela

PartitionBy(<valor 1>)

RowNum

Gera um número de linha com base na partição da tabela e em uma sequência de classificação.

RowNum(PartitionBy(<value 1>), OrderBy(<value 1>))

recommendation-more-help

c39c2d00-ba9a-424b-adf9-66af58a0c34b