[Também se aplica ao v8]{class="badge positive" title="Também se aplica ao Campaign v8"}

Definir condições de filtro defining-filter-conditions

Escolher o operador choosing-the-operator

Nas condições de filtragem, é necessário vincular dois valores usando um operador.

Abaixo está uma lista dos operadores disponíveis:

Operador
Finalidade
Exemplo
Equal to
Retorna um resultado idêntico aos dados inseridos na segunda coluna de valor.
Last name (@lastName) equal to 'Jones', retornará apenas destinatários cujo sobrenome seja Jones.
Greater than
Retorna um valor maior que o valor digitado.
Age (@age) greater than 50, retornará todos os valores maiores que '50', ou seja, '51', '52' etc.
Less than
Retorna um valor menor que o valor digitado.
Creation date (@created) before 'DaysAgo(100)', retornará todos os destinatários criados menos de 100 dias atrás.
Greater than or equal to
Retorna todos os valores iguais ou maiores que o valor digitado.
Age (@age) greater than or equal to '30’, retornará todos os destinatários maiores de 30 anos ou mais.
Less than or equal to
Retorna todos os valores iguais ou inferiores ao valor inserido.
Age (@age) less than or equal to '60', retornará todos os destinatários com 60 anos ou menos.
Not equal to
Retorna todos os valores não idênticos ao valor inserido.
Language (@language) to equal to 'English'.
Starts with
Retorna os resultados iniciando com o valor inserido.
Account # (@account) starts with '32010'.
Does not start with
Retorna os resultados que não começam com o valor inserido
Account # (@account) does not start with '20'.
Contains
Retorna os resultados contendo pelo menos o valor inserido.
Email domain (@domain) contains 'mail' retornará todos os nomes de domínio que contêm 'mail’. Assim, o domínio "gmail.com" também será retornado.
Does not contain
Retorna resultados não contendo o valor digitado.
Email domain (@domain) does not contain 'vo'. Nesse caso, nomes de domínio que contêm 'vo' não serão retornados. O nome de domínio 'voila.fr' não aparecerá nos resultados.
Like
Like é muito semelhante ao operador Contains. Ele permite inserir um caractere curinga % no valor.
Last name (@lastName) like 'Jon%s'. Aqui, o caractere curinga é usado como "joker" para localizar o nome "Jones", o operador esqueceu a letra ausente entre o 'n' e o 's'.
Not like
É semelhante a Like. Permite que você não recupere o valor inserido. Aqui o valor inserido também deve conter o caractere curinga %.
Last name (@lastName) not like 'Smi%h'. Aqui, os destinatários que têm 'Smi%h' como sobrenome não serão retornados.
Is empty
Nesse caso, o resultado que estamos procurando corresponde a um valor vazio na segunda coluna de valor.
Mobile (@mobilePhone) is empty retorna todos os destinatários que não têm número de celular.
Is not empty
Funciona de forma inversa ao operador Is empty. Não é necessário inserir dados na segunda coluna de valor.
Email (@email) is not empty.
Is included in
Retorna resultados incluídos nos valores indicados. Esses valores devem ser separados por vírgula.
Birth date (@birthDate) is included in '12/10/1979,12/10/1984' retornará os destinatários nascidos entre essas datas.
Is not included in
Funciona como o operador Is included in. Aqui, queremos excluir destinatários com base nos valores inseridos.
Birth date (@birthDate) is not included in '12/10/1979,12/10/1984'. Ao contrário do exemplo anterior, os destinatários nascidos nessas datas não serão retornados.

Usar AND, OR, EXCEPT using-and--or--except

Para queries usando várias condições de filtragem, você precisa definir links entre as condições. Há três links possíveis:

  • And possibilita combinar duas condições de filtragem,
  • Or possibilita oferecer uma alternativa,
  • Except permite definir uma exceção.

Clique em And (oferecido por padrão) e escolha na lista suspensa.

  • And: adiciona uma condição e permite a filtragem excessiva.

  • Or: adiciona uma condição e permite a filtragem excessiva.

    O exemplo a seguir permite localizar destinatários cujo domínio de email contenha "orange.co.uk" ou cujo código postal começa com "NW".

  • Except: se você tiver dois filtros e o primeiro não retornar um valor, esse tipo de vínculo criará uma exceção.

    No exemplo a seguir, queremos retornar destinatários cujo domínio de email contenha "orange.co.uk", exceto se o sobrenome do destinatário for "Smith".

Este exemplo mostra um filtro que permite exibir: destinatários que falam espanhol, ou que são mulheres com números de celular, ou ainda destinatários sem um número de conta e cujo nome da empresa começa com a letra "N".

Priorizar condições prioritizing-conditions

Esta seção explica como priorizar condições com ajuda das setas azuis na barra de ferramentas.

  • A seta apontando para a direita permite adicionar um nível de parênteses ao filtro.

  • A seta apontando para a esquerda permite excluir um nível de parêntese selecionado do filtro.

  • As setas verticais permitem mover uma condição, alterando assim sua sequência de execução.

Este exemplo mostra como usar a seta para excluir um nível de parênteses. Comece a partir da seguinte condição de filtragem: City equal to London OR gender equal to male and mobile not indicated OR account # starts with “95” and company name starts with “A”.

Coloque o cursor na condição de filtragem Gender (@gender) equal to Male e clique na seta Remove a parenthesis level.

A condição Gender (@gender) equal to Male foi retirada dos parênteses. Ela foi movida para o mesmo nível da condição "Cidade igual a Londres". Essas condições são vinculadas entre si (And).

Selecionar dados para extrair selecting-data-to-extract

Os campos disponíveis variam de uma tabela para outra. Todos os campos são armazenados em um nó principal conhecido como Main element. No exemplo a seguir, os campos disponíveis estão na tabela de destinatários. Os campos são sempre exibidos em ordem alfabética.

O detalhe do campo selecionado é visível na parte inferior da janela. Por exemplo, o campo Email domain é um Calculated SQL field e sua extensão é (@domain).

NOTE
Use a ferramenta Search para localizar um campo disponível.

Clique duas vezes em um campo disponível para adicioná-lo às colunas de saída. No final da query, cada campo selecionado cria uma coluna na janela Data preview.

Campos avançados não são exibidos por padrão. Clique em Display advanced fields no canto inferior direito dos campos disponíveis para exibir tudo. Clique novamente para retornar ao modo de exibição anterior.

Por exemplo, na tabela de destinatários, os campos avançados são Boolean 1, Boolean 2, Boolean 3, Foreign key of “Folder” link etc.

O exemplo a seguir mostra os campos avançados da tabela de destinatários.

As várias categorias de campos:

Ícone
Descrição
Exemplos
Campo simples
Email, sexo, etc.
Chave primária. Este campo SQL é uma maneira de identificar um registro em uma tabela.
Os destinatários do identificador são chaves primárias e os identificadores são exclusivos por definição.
Chave externa. Usado como um link para outra tabela.
Chave externa do destinatário, chave externa de serviço etc.
Campo calculado. Esse tipo de campo é calculado mediante solicitação usando os valores no banco de dados.
Idade, domínio de email etc.
Campo contendo textos longos.
Comentário, endereço completo etc.
Campo SQL indexado.
Nome completo, código ISO etc.

Vincular a uma tabela e elemento de coleção:

Ícone
Descrição
Exemplo
Vincular a uma tabela em particular. Eles coincidem com as associações de tipo 1-1. Uma ocorrência da tabela de origem pode coincidir com apenas uma ocorrência da tabela de target. Por exemplo, somente um destinatário pode ser vinculado a um país.
Pasta, Estado, País etc.
Elemento de coleção em uma tabela específica. Eles correspondem com associações de tipo 1-N. Uma ocorrência da tabela de origem pode coincidir com várias ocorrências da tabela de destino, mas uma ocorrência da tabela de destino pode coincidir com apenas uma ocorrência da tabela de origem. Por exemplo, um destinatário pode assinar cartas de assinatura 'n'.
Assinaturas, listas, logs de exclusão etc.
NOTE
  • Use o botão Add (acima da barra de ícones lateral) para adicionar uma coluna de saída na qual editaremos a expressão. Para obter mais informações sobre como editar uma expressão, consulte esta seção.
  • Exclua uma coluna de saída clicando no 'x' vermelho (Excluir).
  • Altere a ordem das colunas de saída usando as setas.
  • O Distribution of values é uma maneira de exibir a distribuição dos valores do campo selecionado (por exemplo, as distribuições vinculadas às cidades de destinatários, idiomas do destinatário, etc.).

Criar campos calculados creating-calculated-fields

Se necessário, adicione uma coluna durante a formatação de dados. Um campo calculado adiciona uma coluna à seção de visualização de dados. Clique em Add a calculated field.

Existem quatro tipos de campos calculados:

  • Fixed string: permite adicionar uma string.

  • String with JavaScript tags: o valor do campo calculado combina uma string e diretivas JavaScript.

  • JavaScript expression: o valor do campo calculado é o resultado de uma avaliação de função JavaScript. O valor retornado pode ser digitado (número, data etc.).

  • Enumerations: esse tipo de campo permite usar/modificar o conteúdo de uma das colunas de saída em uma nova coluna.

    É possível usar o valor de origem de uma coluna e fornecer um valor de destino. Esse valor de destino será exibido na nova coluna de saída.

    Há um exemplo de adição do tipo de campo calculado Enumerations nesta seção.

    O tipo de campo calculado Enumerations pode incluir quatro condições:

    • Keep the source value restaura o valor de origem no destino sem alterá-lo.
    • Use the following value possibilita inserir um valor de destino padrão para valores de origem não definidos.
    • Generate a warning and continue avisa o usuário que o valor de origem não pode ser alterado.
    • Generate an error and reject the line impede que a linha seja calculada e importada.

Clique em Detail of calculated field para exibir os detalhes do campo inserido.

Para remover esse campo calculado, clique na cruz Remove the calculated field.

Criar expressões building-expressions

A ferramenta de edição de expressão permite calcular agregações, gerar funções ou editar uma fórmula usando uma expressão.

O exemplo a seguir mostra como executar uma contagem em uma chave primária.

Siga as etapas abaixo:

  1. Clique em Add na janela Data to extract. Na janela Formula type, selecione um tipo de fórmula para inserir a expressão.

    Há vários tipos de fórmulas disponíveis: Field only, Aggregate, Expression.

    Selecione Process on an aggregate function e Count. Clique em Next.

  2. A chave primária é calculada.

Veja a seguir uma exibição detalhada das opções disponíveis na janela Formula types:

  1. Field only permite retornar à janela Field to select.

  2. Aggregate (Process on an aggregate function). Veja alguns exemplos de uso agregado:

    • Count permite executar uma contagem de chaves primárias.

    • Sum permite somar todas as compras feitas por um cliente no período de um ano.

    • Maximum value permite encontrar os clientes que compraram mais produtos "n".

    • O Minimum value permite classificar os clientes e encontrar aqueles que se subscreveram para uma oferta mais recentemente.

    • Average. Essa função permite calcular a idade média dos destinatários.

      A caixa Distinct permite recuperar valores exclusivos e diferentes de zero em uma coluna. Por exemplo, é possível recuperar todos os logs de rastreamento de um destinatário; eles são alterados para o valor 1, desde que sejam todos referentes ao mesmo destinatário.

  3. Expression abre a janela Edit the expression. Isso permite detectar números de telefone com muitos numerais, provavelmente devido a erros de entrada.

    Para obter uma lista de todas as funções disponíveis, consulte Lista de funções.

Lista de funções list-of-functions

Se uma fórmula do tipo Expression for escolhida, você será direcionado à janela "edit the expression". É possível associar várias categorias de funções aos campos disponíveis: Aggregates, String, Date, Numerical, Currency, Geomarketing, Windowing function e Others.

O editor de expressão tem esta aparência:

Ele permite selecionar campos nas tabelas do banco de dados e adicionar funções avançadas a eles. Os recursos abaixo estão disponíveis.

Agregados

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, string ou coluna de tipo de data
Max(<value>)
Min
Retorna o valor mínimo de uma coluna do tipo número, string ou dados
Min(<value>)
StdDev
Retorna o desvio padrão de uma coluna do tipo número, string ou dados
StdDev(<value>)
Sum
Retorna a soma dos valores de uma coluna do tipo número, string ou dados
Sum(<value>)

String

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>)
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>)
LPad
Retorna a string concluída à esquerda
LPad(<string>, <number>, <character>)
Left
Retorna os primeiros n caracteres da string
Left(<string>, <number>)
Length
Retorna o comprimento da string
Length(<string>)
Lower
Retorna a string em minúsculas
Lower(<string>)
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(<memo>, <string>)
RPad
Retorna a string concluída à direita
RPad(<string>, <number>, <character>)
Right
Retorna os últimos n caracteres da string
Right(<string>)
Rtrim
Remove espaços à direita da string
Rtrim(<string>)
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>, <number>, <number>)
dataLength
Retorna o tamanho da string
dataLength(<string>)

Data

Nome
Descrição
Sintaxe
AddDays
Adiciona um número de dias a uma data
AddDays(<data>, <número>)
AddHours
Adiciona um número de horas a uma data
AddHours(<data>, <número>)
AddMinutes
Adiciona um número de minutos a uma data
AddMinutes(<data>, <número>)
AddMonths
Adiciona um número de meses a uma data
AddMonths(<data>, <número>)
AddSeconds
Adiciona um número de segundos a uma data
AddSeconds(<data>, <número>)
AddYears
Adiciona um número de anos a uma data
AddYears(<data>, <número>)
DateOnly
Retorna somente a data (com a hora 00:00)*
DateOnly(<date>)
Day
Retorna o número que representa o dia da data
Day(<data>)
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
Número de dias entre duas datas
DaysDiff(<data final>, <data inicial>)
DaysOld
Retorna a idade em dias de uma data.
DaysOld(<data>)
GetDate
Retorna a data atual do sistema do servidor.
GetDate()
Hour
Retorna a hora da data.
Hour(<data>)
HoursDiff
Retorna o número de horas entre duas datas
HoursDiff(<end date>, <start date>)
Minute
Retorna os minutos da data
Minute(<data>)
MinutesDiff
Retorna o número de minutos entre duas datas
MinutesDiff(<data final>, <data inicial>)
Month
Retorna o número que representa o mês da data
Month(<data>)
MonthsAgo
Retorna a data correspondente à data atual menos n meses
MonthsAgo(<número>)
MonthsDiff
Retorna o número de meses entre duas datas
MonthsDiff(<data final>, <data inicial>)
MonthsOld
Retorna a idade em meses de uma data
MonthsOld(<data>)
Second
Retorna os segundos da data
Second(<date>)
SecondsDiff
Retorna o número de segundos entre duas datas
SecondsDiff(<data final>, <data inicial>)
SubDays
Subtrai um número de dias a partir de uma data
SubDays(<data>, <número>)
SubHours
Subtrai um número de horas a partir de uma data
SubHours(<data>, <número>)
SubMinutes
Subtrai um número de minutos de uma data
SubMinutes(<data>, <número>)
SubMonths
Subtrai um número de meses a partir de uma data
SubMonths(<data>, <número>)
SubSeconds
Subtrai um número de segundos a partir de uma data
SubSeconds(<data>, <número>)
SubYears
Subtrai um número de anos a partir de uma data
SubYears(<data>, <número>)
ToDate
Converte uma data + hora em uma data
ToDate(<data + hora>)
ToDateTime
Converte uma string em uma data + hora
ToDateTime(<string>)
TruncDate
Arredonda uma data e hora para o segundo mais próximo
TruncDate(@lastModified, <número de segundos>)
TruncDateTZ
Arredonda uma data e hora para uma determinada precisão expressa em segundos
TruncDateTZ(<data>, <número de segundos>, <fuso horário>)
TruncQuarter
Arredonda uma data para o trimestre
TruncQuarter(<data>)
TruncTime
Arredonda a parte de horário para cima até o próximo segundo
TruncTim(e<date>, <number of seconds>)
TruncWeek
Arredonda uma data para a semana
TruncWeek(<data>)
TruncYear
Arredonda uma data + hora para 1º de janeiro do ano
TruncYear(<date>)
TruncWeek
Retorna o número que representa o dia na semana da data
WeekDay(<data>)
Year
Retorna o número que representa o ano da data
Year(<data>)
YearAnd Month
Retorna o número que representa o ano e o mês da data.
YearAndMonth(<data>)
YearsDiff
Retorna o número de anos entre as duas datas
YearsDiff(<data final>, <data inicial>)
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.

Numerical

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>)
  1. Currency
Nome
Descrição
Sintaxe
ConvertCurrency
Converte uma quantia na moeda de origem em uma quantia na moeda de destino
ConvertCurrency(<amount>, <source currency>, <target currency>, <conversion date>)
FormatCurrency
Formata a quantidade exibida com base nas configurações de moeda
FormatCurrency(<amount>, <currency>)

Geomarketing

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>)

Outros

Nome
Descrição
Sintaxe
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>)
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>)

Funções janela

Nome
Descrição
Sintaxe
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
601d79c3-e613-4db3-889a-ae959cd9e3e1