Fórmulas de etiqueta

Las fórmulas de etiqueta permiten realizar cálculos matemáticos, formatear fechas, construir texto y agregar valores dentro de una etiqueta. Usan la misma sintaxis {{ }} que una etiqueta normal, pero comienzan con = para indicar que son una fórmula.

Por ejemplo, si su fuente tiene un campo Line Item Price y desea mostrar el precio con un 10% de impuesto añadido, multiplique el campo por 1.1:

{{= Line Item Price * 1.1}}

Fórmula de etiqueta evaluada dentro de una plantilla de documento de Portant

Aritmética

Puede usar los siguientes operadores aritméticos en las fórmulas de etiqueta:

Símbolo	Operación
`+`	Suma
`*`	Multiplicación
`-`	Resta
`/`	División

Puede combinar varios operadores y usar paréntesis ( ) para construir expresiones más complejas.

Fórmulas integradas

Al igual que Google Sheets y Excel, Portant dispone de un conjunto de fórmulas integradas que puede invocar dentro de una etiqueta. Por ejemplo, ROUND limita un valor numérico a un número determinado de decimales:

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

Las siguientes fórmulas integradas están disponibles:

Fórmula	Descripción
`ROUND(Tag, [Places])`	Redondea el valor numérico de `Tag` a `Places` decimales. Omita el segundo argumento para redondear al número entero más próximo.
`DEFAULT(Tag, Default Value)`	Usa un valor de reserva cuando la etiqueta está en blanco.
`ADD(Tag 1, Tag 2, [...])`	Suma dos o más etiquetas numéricas. Equivalente a usar `+`.
`MULTIPLY(Tag 1, Tag 2, [...])`	Multiplica dos o más etiquetas numéricas. Equivalente a usar `*`.
`TRUNCATE(Tag, Length)`	Acorta el valor de texto de `Tag` a la longitud `Length` especificada.
`LOWER(Tag)`	Convierte el valor de `Tag` a texto en minúsculas.
`UPPER(Tag)`	Convierte el valor de `Tag` a texto en MAYÚSCULAS.

[ ] indica que el parámetro es opcional.

Puede pasar valores literales en lugar de etiquetas (y etiquetas en lugar de valores) en cualquier parte de una fórmula.

Numérico

Fórmulas de agregación

Algunas fórmulas integradas están diseñadas para funcionar con flujos de trabajo de agrupación de datos y agregan todos los valores agrupados de una etiqueta. La más habitual es SUM, que suma todos los valores de una etiqueta determinada. Es la forma más sencilla de calcular un total dentro de una plantilla.

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

Las fórmulas de agregación numéricas son:

Fórmula	Descripción
`SUM(Tag)`	Suma todos los valores de `Tag`.
`PRODUCT(Tag)`	Multiplica todos los valores de `Tag`.
`AVG(Tag)`	Calcula el promedio de todos los valores de `Tag`.
`MAX(Tag)`	Devuelve el valor más alto de `Tag`.
`MIN(Tag)`	Devuelve el valor más bajo de `Tag`.

Puede usar fórmulas de agregación en cualquier parte del documento, incluidas expresiones más complejas. Por ejemplo, para calcular qué porcentaje representa un único elemento de línea sobre el total:

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

Para los elementos de línea de la tabla anterior, esto produce:

+-------------------+------------------------------------------------+
|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 decimales

Añada | seguido de un número al final de una expresión para redondear el resultado a esa cantidad de decimales, de la misma manera que lo hace ROUND. Por ejemplo, para redondear una expresión arbitraria a 3 decimales:

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

Formato de fecha y hora

Formatee cualquier fecha o marca de tiempo usando la fórmula FORMATDATE. Esto le otorga control total sobre cómo aparecen las fechas en sus documentos generados.

Uso básico

Use la fórmula dentro de una etiqueta:

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

El primer parámetro es su campo de fecha. El segundo parámetro es el formato de salida.

Tokens de formato

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

Formatos de ejemplo

Formato	Ejemplo de salida
`"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 fecha y hora

Puede sumar o restar tiempo de un campo de fecha utilizando estos helpers:

{{= Date + DAYS(30)}} devuelve un valor 30 días después del valor de Date.

Las unidades admitidas (donde N es la cantidad a sumar o restar) son:

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

Glosario de fórmulas

Sum (Suma)

Devuelve la suma de una serie de valores de campo, incluidos todos los valores de campo dentro de una etiqueta de agrupación de datos.

Sintaxis

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

tag1: La primera etiqueta que se va a sumar.
tag2, ... (opcional): Etiquetas adicionales que se suman a tag1.

Las etiquetas dentro de los corchetes no necesitan {{ ni }} a su alrededor.

Average (Promedio)

AVG devuelve el promedio numérico de un grupo de etiquetas, incluidos todos los valores de campo dentro de una etiqueta de grupo de datos.

Sintaxis

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

tag1: La primera etiqueta o etiqueta de grupo de datos que se incluye en el promedio.
tag2, ... (opcional): Etiquetas adicionales que se incluyen.

Maximum (Máximo)

Devuelve el valor más grande de un grupo de etiquetas, incluidos todos los valores de campo dentro de una etiqueta de grupo de datos.

Sintaxis

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

tag1: La primera etiqueta o etiqueta de grupo de datos que se considera.
tag2, ... (opcional): Etiquetas adicionales que se consideran.

Minimum (Mínimo)

Devuelve el valor más pequeño de un grupo de etiquetas, incluidos todos los valores de campo dentro de una etiqueta de grupo de datos.

Sintaxis

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

tag1: La primera etiqueta o etiqueta de grupo de datos que se considera.
tag2, ... (opcional): Etiquetas adicionales que se consideran.

Round (Redondeo)

Redondea el valor numérico de un campo a un número determinado de decimales.

Sintaxis

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

tag: El valor que se va a redondear.
places (opcional, 0 por defecto): El número de decimales al que se redondea.

Ejemplo de uso

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

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

Multiply (Multiplicación)

Devuelve el producto de dos campos o valores numéricos. Equivale al operador *.

Sintaxis

{{=MULTIPLY(tag1, tag2)}}

tag1: Un campo con un valor numérico o un número literal (por ejemplo, 6).
tag2: Un campo con un valor numérico o un número literal (por ejemplo, 7).

Add (Suma)

Devuelve la suma de dos campos o valores numéricos. Equivale al operador +.

Sintaxis

{{=ADD(tag1, tag2)}}

tag1: Un campo con un valor numérico o un número literal (por ejemplo, 19).
tag2: Un campo con un valor numérico o un número literal (por ejemplo, 23).

Texto

Concatenate (Concatenar)

Une cadenas de texto.

Ejemplo de uso

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

{{=CONCATENATE(Line Item Name)}} -> "Item AItem BItem C" (sin espacios)

CONCATENATE(A2:B7)

Sintaxis

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

string1: Cualquier campo o campo de agrupación de datos del origen, o una cadena literal entre comillas.
string2 ...: Cualquier número de otros campos, campos de agrupación de datos o cadenas literales.

Text join (Unión de texto)

Combina texto de varios campos, o de un campo de agrupación de datos con múltiples valores, con un delimitador entre cada elemento.

Ejemplo de uso

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

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

Sintaxis

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

delimiter: Una cadena (que puede estar vacía) u otro campo. Si está vacía, los valores simplemente se concatenan.
tag_name_1: Cualquier campo o campo de agrupación de datos del origen, o una cadena literal entre comillas.
tag_name_2, ...: Cualquier número de otros campos, campos de agrupación de datos o cadenas literales.

También puede utilizar {{=TEXTJOINNONEMPTY(...)}} para omitir los valores vacíos en el resultado.

Truncate (Truncar)

Acorta el valor de un campo o una cadena literal a una longitud determinada.

Sintaxis

{{=TRUNCATE(tag, length)}}

tag: El texto que se va a truncar.
length: El número de caracteres que se conservan.

Si length es mayor que el número de caracteres del valor, el valor se devuelve sin cambios.

Ejemplo

{{Message}} -> "Hello World"

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

Filter and sum, SUMIF (Filtrar y sumar)

Suma valores que cumplen una condición.

Sintaxis

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

Para obtener más información sobre las condiciones dentro de las etiquetas, consulte tag if statements.