Portant Docs
Página inicial Instalar no HubSpot Comece grátis

Fórmulas de tag

As fórmulas de tag permitem realizar cálculos matemáticos, formatar datas, construir textos e agregar valores dentro de uma tag. Elas utilizam a mesma sintaxe {{ }} de uma tag normal, mas começam com = para indicar que se trata de uma fórmula.

Por exemplo, se sua fonte de dados possui um campo Line Item Price e você deseja exibir o preço com 10% de imposto adicionado, multiplique o campo por 1.1:

{{= Line Item Price * 1.1}}

Tag formula evaluated inside a Portant document template

Aritmética

Você pode usar os seguintes operadores aritméticos em fórmulas de tag:

Symbol Operation
+ Addition
* Multiplication
- Subtraction
/ Division

É possível combinar múltiplos operadores e usar parênteses ( ) para construir expressões mais complexas.

Fórmulas integradas

Assim como o Google Sheets e o Excel, o Portant possui um conjunto de fórmulas integradas que podem ser chamadas dentro de uma tag. Por exemplo, ROUND limita um valor numérico a um determinado número de casas decimais:

{{Line Item Price}} -> 24.1234
{{=ROUND(Line Item Price, 2)}} -> 24.12
{{=ROUND(Line Item Price)}} -> 24

As seguintes fórmulas integradas estão disponíveis:

Formula Description
ROUND(Tag, [Places]) Rounds the numeric value of Tag to Places decimal places. Omit the second argument to round to a whole number.
DEFAULT(Tag, Default Value) Use a fallback value when the tag is blank.
ADD(Tag 1, Tag 2, [...]) Adds two or more numeric tags together. Same as using +.
MULTIPLY(Tag 1, Tag 2, [...]) Multiplies two or more numeric tags together. Same as using *.
TRUNCATE(Tag, Length) Shortens the text value of Tag to the specified Length.
LOWER(Tag) Converts the value of Tag to lowercase text.
UPPER(Tag) Converts the value of Tag to UPPERCASE text.
NAMEONLY(Tag) Retorna apenas o nome de um valor como 'Jane Smith' <jane@acme.com>.
EMAILONLY(Tag) Retorna apenas o endereço de e-mail de um valor como 'Jane Smith' <jane@acme.com>. Se o valor não tiver um endereço entre < >, ele é retornado sem alteração.

[ ] indica que o parâmetro é opcional.

É possível passar valores literais no lugar de tags (e tags no lugar de valores) em qualquer ponto de uma fórmula.

Numérico

Fórmulas de agregação

Algumas fórmulas integradas são projetadas para funcionar com fluxos de trabalho de agrupamento de dados e agregam todos os valores agrupados de uma tag. A mais comum é SUM, que soma todos os valores de uma determinada tag. É a maneira mais simples de calcular um total dentro de um template.

Within a Data Grouping Table:
+-----------------------------+
|1. {{Line Item Price}} -> 10 |
+-----------------------------+
|2. {{Line Item Price}} -> 20 |
+-----------------------------+
|3. {{Line Item Price}} -> 30 |
+-----------------------------+

{{=SUM(Line Item Price)}} -> 60

As fórmulas de agregação numéricas são:

Formula Description
SUM(Tag) Adds together all values for Tag.
PRODUCT(Tag) Multiplies together all values for Tag.
AVG(Tag) Calculates the average of all values for Tag.
MAX(Tag) Returns the largest value for Tag.
MIN(Tag) Returns the smallest value for Tag.

É possível usar fórmulas de agregação em qualquer parte do documento, inclusive dentro de expressões mais complexas. Por exemplo, para calcular qual percentual um único item de linha representa em relação ao total:

{{= (Price / SUM(Price)) * 100 | 2}}%

Para os itens de linha na tabela acima, isso produz:

+-------------------+------------------------------------------------+
|1. {{Price}} -> 10 | {{= (Price / SUM(Price)) * 100 | 2}}% -> 0.16% |
+-------------------+------------------------------------------------+
|2. {{Price}} -> 20 | {{= (Price / SUM(Price)) * 100 | 2}}% -> 0.33% |
+-------------------+------------------------------------------------+
|3. {{Price}} -> 30 | {{= (Price / SUM(Price)) * 100 | 2}}% -> 0.50% |
+-------------------+------------------------------------------------+

Modificador de casas decimais

Adicione | seguido de um número ao final de uma expressão para arredondar o resultado para aquela quantidade de casas decimais, da mesma forma que ROUND faz. Por exemplo, para arredondar uma expressão arbitrária para 3 casas decimais:

{{1.1234 + 1.0 | 3}} -> 2.123

Formatação de data e hora

Formate qualquer data ou timestamp usando a fórmula FORMATDATE. Isso oferece controle total sobre como as datas aparecem nos documentos gerados.

Uso básico

Utilize a fórmula dentro de uma tag:

{{=FORMATDATE(Timestamp, "DD/MM/YYYY")}}

O primeiro parâmetro é o campo de data. O segundo parâmetro é o formato de saída.

Tokens de formatação

Token Output examples
D 1, 19
DD 01, 19
M 1, 12
MM 01, 12
MMM Jan, Dec
MMMM January, December
YY 25
YYYY 2025

Exemplos de formatos

Format Output example
"DD/MM/YYYY" 07/02/2025
"MMM D, YYYY" Feb 7, 2025
"MMMM DD" February 07
"YY-MM-DD" 25-02-07

Aritmética de data e hora

Você pode adicionar ou subtrair tempo de um campo de data usando estes auxiliares:

{{= Date + DAYS(30)}} retorna um valor 30 dias após o valor de Date.

As unidades suportadas (onde N é a quantidade a adicionar ou subtrair) são:

  • MINUTES(N)
  • HOURS(N)
  • DAYS(N)
  • WEEKS(N)

Glossário de fórmulas

Sum (Soma)

Retorna a soma de uma série de valores de campo, incluindo todos os valores de campo dentro de uma tag de agrupamento de dados.

Sintaxe

{{=SUM(tag1, tag2, ...)}}

  • tag1: A primeira tag a ser somada.
  • tag2, ... (opcional): Tags adicionais a serem somadas a tag1.

As tags dentro dos colchetes não precisam de {{ e }} ao redor delas.

Average (Média)

AVG retorna a média numérica de um grupo de tags, incluindo todos os valores de campo dentro de uma tag de grupo de dados.

Sintaxe

{{=AVG(tag1, tag2, ...)}}

  • tag1: A primeira tag ou tag de grupo de dados a incluir na média.
  • tag2, ... (opcional): Tags adicionais a incluir.

Maximum (Máximo)

Retorna o maior valor de um grupo de tags, incluindo todos os valores de campo dentro de uma tag de grupo de dados.

Sintaxe

{{=MAX(tag1, tag2, ...)}}

  • tag1: A primeira tag ou tag de grupo de dados a considerar.
  • tag2, ... (opcional): Tags adicionais a considerar.

Minimum (Mínimo)

Retorna o menor valor de um grupo de tags, incluindo todos os valores de campo dentro de uma tag de grupo de dados.

Sintaxe

{{=MIN(tag1, tag2, ...)}}

  • tag1: A primeira tag ou tag de grupo de dados a considerar.
  • tag2, ... (opcional): Tags adicionais a considerar.

Round (Arredondamento)

Arredonda o valor numérico de um campo para um determinado número de casas decimais.

Sintaxe

{{=ROUND(tag, [places])}}

  • tag: O valor a arredondar.
  • places (opcional, 0 por padrão): O número de casas decimais para arredondar.

Exemplo de uso

{{=ROUND(1.234, 2)}} -> 1.23

{{=ROUND(1.234)}} -> 1

Multiply (Multiplicação)

Retorna o produto de dois campos ou valores numéricos. Equivalente ao operador *.

Sintaxe

{{=MULTIPLY(tag1, tag2)}}

  • tag1: Um campo com valor numérico ou um número literal (por exemplo, 6).
  • tag2: Um campo com valor numérico ou um número literal (por exemplo, 7).

Add (Adição)

Retorna a soma de dois campos ou valores numéricos. Equivalente ao operador +.

Sintaxe

{{=ADD(tag1, tag2)}}

  • tag1: Um campo com valor numérico ou um número literal (por exemplo, 19).
  • tag2: Um campo com valor numérico ou um número literal (por exemplo, 23).

Texto

Concatenate (Concatenação)

Une strings.

Exemplo de uso

{{=CONCATENATE('Hello', ' ', 'World')}} -> "Hello World"

{{=CONCATENATE(Line Item Name)}} -> "Item AItem BItem C" (sem espaços)

CONCATENATE(A2:B7)

Sintaxe

CONCATENATE(tag_name_1, [tag_name_2, ...])

  • string1: Qualquer campo ou campo de agrupamento de dados da fonte, ou uma string literal entre aspas.
  • string2 ...: Qualquer número de outros campos, campos de agrupamento de dados ou strings literais.

Text join (União de texto)

Combina texto de múltiplos campos, ou de um campo de agrupamento de dados com múltiplos valores, com um delimitador entre cada item.

Exemplo de uso

{{=TEXTJOIN(" | ", "Hello", "World")}} -> "Hello | World"

{{=TEXTJOIN(", ", Line Item Name)}} -> "Item A, Item B, Item C"

Sintaxe

{{=TEXTJOIN(delimiter, tag_name_1, [tag_name_2, ...])}}

  • delimiter: Uma string (que pode estar vazia) ou outro campo. Se estiver vazia, os valores são simplesmente concatenados.
  • tag_name_1: Qualquer campo ou campo de agrupamento de dados da fonte, ou uma string literal entre aspas.
  • tag_name_2, ...: Qualquer número de outros campos, campos de agrupamento de dados ou strings literais.

Você também pode usar {{=TEXTJOINNONEMPTY(...)}} para ignorar valores vazios no resultado.

Truncate (Truncamento)

Encurta o valor de um campo ou string literal até um comprimento especificado.

Sintaxe

{{=TRUNCATE(tag, length)}}

  • tag: O texto a truncar.
  • length: O número de caracteres a manter.

Se length for maior que o número de caracteres no valor, o valor é retornado sem alterações.

Exemplo

{{Message}} -> "Hello World"

{{=TRUNCATE(Message, 5)}} -> "Hello"

Filter and sum (Filtrar e somar, SUMIF)

Some valores que correspondem a uma condição.

Sintaxe

{{=SUMIF(Condition Tag = "Something", Numeric Data Grouped Field)}}

Para mais informações sobre condições dentro de tags, consulte tag if statements (instruções condicionais de tag).

Apenas nome e apenas e-mail

Divida um valor de nome e e-mail, como {{Workflow Runner}} ou um campo de proprietário do HubSpot com o formato "Name + Email", em suas partes.

Exemplo

{{Deal Owner}} -> 'Jane Smith' <jane@acme.com>

{{=NAMEONLY(Deal Owner)}} -> Jane Smith

{{=EMAILONLY(Deal Owner)}} -> jane@acme.com

Para configurar isso com o HubSpot, consulte Usar um proprietário do HubSpot como nome e como e-mail.