Tag-formules

Met tag-formules kunt u rekenen, datums opmaken, tekst samenstellen en waarden samenvatten binnen een tag. Ze gebruiken dezelfde {{ }}-syntaxis als een gewone tag, maar beginnen met = om ze als formule te markeren.

Als uw bron bijvoorbeeld een veld Line Item Price heeft en u de prijs inclusief 10% belasting wilt weergeven, vermenigvuldigt u het veld met 1.1:

{{= Line Item Price * 1.1}}

Tag formula evaluated inside a Portant document template

Rekenkundige bewerkingen

U kunt de volgende rekenkundige operatoren gebruiken in tag-formules:

Symbool	Bewerking
`+`	Optelling
`*`	Vermenigvuldiging
`-`	Aftrekking
`/`	Deling

U kunt meerdere operatoren combineren en haakjes ( ) gebruiken om complexere expressies samen te stellen.

Ingebouwde formules

Net als Google Sheets en Excel beschikt Portant over een set ingebouwde formules die u binnen een tag kunt aanroepen. Zo beperkt ROUND een numerieke waarde tot een bepaald aantal decimalen:

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

De volgende ingebouwde formules zijn beschikbaar:

Formule	Beschrijving
`ROUND(Tag, [Places])`	Rondt de numerieke waarde van `Tag` af op `Places` decimalen. Laat het tweede argument weg om af te ronden op een geheel getal.
`DEFAULT(Tag, Default Value)`	Gebruik een standaardwaarde wanneer de tag leeg is.
`ADD(Tag 1, Tag 2, [...])`	Telt twee of meer numerieke tags bij elkaar op. Hetzelfde als `+` gebruiken.
`MULTIPLY(Tag 1, Tag 2, [...])`	Vermenigvuldigt twee of meer numerieke tags met elkaar. Hetzelfde als `*` gebruiken.
`TRUNCATE(Tag, Length)`	Verkort de tekstwaarde van `Tag` tot de opgegeven `Length`.
`LOWER(Tag)`	Converteert de waarde van `Tag` naar tekst in kleine letters.
`UPPER(Tag)`	Converteert de waarde van `Tag` naar tekst in HOOFDLETTERS.
`NAMEONLY(Tag)`	Geeft alleen de naam terug uit een waarde zoals `'Jane Smith' <jane@acme.com>`.
`EMAILONLY(Tag)`	Geeft alleen het e-mailadres terug uit een waarde zoals `'Jane Smith' <jane@acme.com>`. Als de waarde geen adres tussen `< >` bevat, wordt de waarde ongewijzigd teruggegeven.

[ ] betekent dat de parameter optioneel is.

U kunt letterlijke waarden opgeven in plaats van tags (en tags in plaats van waarden) op elke positie in een formule.

Numeriek

Geaggregeerde formules

Sommige ingebouwde formules zijn ontworpen voor gebruik in datagroepering-workflows en aggregeren alle gegroepeerde waarden voor een tag. De meest gebruikte is SUM, die alle waarden voor een bepaalde tag bij elkaar optelt. Dit is de eenvoudigste manier om een totaal te berekenen in een sjabloon.

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

De numerieke geaggregeerde formules zijn:

Formule	Beschrijving
`SUM(Tag)`	Telt alle waarden voor `Tag` bij elkaar op.
`PRODUCT(Tag)`	Vermenigvuldigt alle waarden voor `Tag` met elkaar.
`AVG(Tag)`	Berekent het gemiddelde van alle waarden voor `Tag`.
`MAX(Tag)`	Geeft de grootste waarde voor `Tag` terug.
`MIN(Tag)`	Geeft de kleinste waarde voor `Tag` terug.

U kunt geaggregeerde formules overal in het document gebruiken, ook binnen complexere expressies. Om bijvoorbeeld te berekenen welk percentage een enkele regelpost is van het totaal:

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

Voor de regelposten in de bovenstaande tabel levert dit het volgende op:

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

Modifier voor decimalen

Voeg | gevolgd door een getal toe aan het einde van een expressie om het resultaat af te ronden op dat aantal decimalen, op dezelfde manier als ROUND doet. Om een willekeurige expressie bijvoorbeeld af te ronden op 3 decimalen:

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

Datum- en tijdopmaak

Maak elke datum of tijdstempel op met de formule FORMATDATE. Hiermee heeft u volledige controle over hoe datums worden weergegeven in uw gegenereerde documenten.

Basisgebruik

Gebruik de formule binnen een tag:

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

De eerste parameter is uw datumveld. De tweede parameter is het uitvoerformaat.

Opmaaktokens

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

Voorbeeldformaten

Formaat	Voorbeelduitvoer
`"DD/MM/YYYY"`	07/02/2025
`"MMM D, YYYY"`	Feb 7, 2025
`"MMMM DD"`	February 07
`"YY-MM-DD"`	25-02-07

Datum- en tijdrekenen

U kunt tijd optellen bij of aftrekken van een datumveld met behulp van deze helpers:

{{= Date + DAYS(30)}} geeft een waarde terug die 30 dagen na de waarde van Date ligt.

De ondersteunde eenheden (waarbij N de hoeveelheid is om op te tellen of af te trekken) zijn:

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

Formulewoordenlijst

Som

Geeft de som terug van een reeks veldwaarden, inclusief alle veldwaarden binnen een datagroeperingstag.

Syntaxis

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

tag1: De eerste tag om bij elkaar op te tellen.
tag2, ... (optioneel): Aanvullende tags om bij tag1 op te tellen.

Tags binnen de haakjes hebben geen {{ en }} om zich heen nodig.

Gemiddelde

AVG geeft het numerieke gemiddelde terug van een groep tags, inclusief alle veldwaarden binnen een datagroeperingstag.

Syntaxis

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

tag1: De eerste tag of datagroeperingstag om in het gemiddelde op te nemen.
tag2, ... (optioneel): Aanvullende tags om op te nemen.

Maximum

Geeft de grootste waarde terug uit een groep tags, inclusief alle veldwaarden binnen een datagroeperingstag.

Syntaxis

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

tag1: De eerste tag of datagroeperingstag om te beschouwen.
tag2, ... (optioneel): Aanvullende tags om te beschouwen.

Minimum

Geeft de kleinste waarde terug uit een groep tags, inclusief alle veldwaarden binnen een datagroeperingstag.

Syntaxis

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

tag1: De eerste tag of datagroeperingstag om te beschouwen.
tag2, ... (optioneel): Aanvullende tags om te beschouwen.

Afronden

Rondt de numerieke waarde van een veld af op een bepaald aantal decimalen.

Syntaxis

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

tag: De waarde om af te ronden.
places (optioneel, standaard 0): Het aantal decimalen om op af te ronden.

Voorbeeldgebruik

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

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

Vermenigvuldigen

Geeft het product terug van twee velden of numerieke waarden. Hetzelfde als de operator *.

Syntaxis

{{=MULTIPLY(tag1, tag2)}}

tag1: Een veld met een numerieke waarde of een letterlijk getal (bijv. 6).
tag2: Een veld met een numerieke waarde of een letterlijk getal (bijv. 7).

Optellen

Geeft de som terug van twee velden of numerieke waarden. Hetzelfde als de operator +.

Syntaxis

{{=ADD(tag1, tag2)}}

tag1: Een veld met een numerieke waarde of een letterlijk getal (bijv. 19).
tag2: Een veld met een numerieke waarde of een letterlijk getal (bijv. 23).

Tekst

Samenvoegen

Voegt tekenreeksen samen.

Voorbeeldgebruik

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

{{=CONCATENATE(Line Item Name)}} -> "Item AItem BItem C" (geen spaties)

CONCATENATE(A2:B7)

Syntaxis

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

string1: Een willekeurig veld of datagroeperingsveld uit de bron, of een letterlijke tekenreeks tussen aanhalingstekens.
string2 ...: Een willekeurig aantal andere velden, datagroeperingsvelden of letterlijke tekenreeksen.

Tekst samenvoegen

Combineert tekst uit meerdere velden, of uit een datagroeperingsveld met meerdere waarden, met een scheidingsteken tussen elk item.

Voorbeeldgebruik

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

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

Syntaxis

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

delimiter: Een tekenreeks (die leeg kan zijn) of een ander veld. Als deze leeg is, worden de waarden eenvoudigweg samengevoegd.
tag_name_1: Een willekeurig veld of datagroeperingsveld uit de bron, of een letterlijke tekenreeks tussen aanhalingstekens.
tag_name_2, ...: Een willekeurig aantal andere velden, datagroeperingsvelden of letterlijke tekenreeksen.

U kunt ook {{=TEXTJOINNONEMPTY(...)}} gebruiken om lege waarden in het resultaat over te slaan.

Afkappen

Verkort de waarde van een veld of letterlijke tekenreeks tot een bepaalde lengte.

Syntaxis

{{=TRUNCATE(tag, length)}}

tag: De tekst om af te kappen.
length: Het aantal tekens om te bewaren.

Als length groter is dan het aantal tekens in de waarde, wordt de waarde ongewijzigd teruggegeven.

Voorbeeld

{{Message}} -> "Hello World"

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

Filteren en optellen (SUMIF)

Telt waarden op die aan een voorwaarde voldoen.

Syntaxis

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

Zie voor meer informatie over voorwaarden binnen tags tag if statements (tag if-instructies).

Alleen naam en alleen e-mail

Splits een waarde met naam en e-mail, zoals {{Workflow Runner}} of een HubSpot-eigenaarveld met de indeling "Name + Email", in de onderdelen.

Voorbeeld

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

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

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

Zie Een HubSpot-eigenaar als naam en als e-mail gebruiken voor hoe u dit met HubSpot instelt.