Aangepaste exports: de Expression Builder gebruiken
Inhoudsopgave
- Wat is de Expression Builder?
- Waarom gebruiken?
- Terminologie
- Opmerkingen en huidige beperkingen
- Stapsgewijs: de Expression Builder configureren en gebruiken
- Filteropties voor kostentypes
- 1. Toeslagen: nu volledig ondersteund
- 2. Omzet uit extra’s (nieuwe categorie)
- 3. Consistente filtering in interface en export
- 4. Documentatie opnemen
- Tips
- Geavanceerd: expressiemodus
- Problemen oplossen
Dit artikel legt uit wat de Expression Builder is, waarom die nuttig is voor aangepaste exports en welke termen vaak voorkomen. Daarna volgt een stapsgewijze uitleg met een voorbeeld. De functies en termen komen overeen met de huidige implementatie van de Expression Builder en het onderliggende querymodel.
Wat is de Expression Builder?
Met de Expression Builder kunnen gegevens voor aangepaste exports zonder code worden vormgegeven. Hiermee kan de gebruiker:
- Lijsten filteren tot alleen de gewenste items
- Waarden samenvoegen, zoals som, aantal, minimum of maximum
- Datums, datums/tijden en getallen opmaken voor het doelsysteem
- Resultaten bekijken in een preview tijdens het configureren

Waarom gebruiken?
- Flexibiliteit: CSV- of spreadsheetbestanden op maat aanmaken voor partners, BI-tools of financiële systemen.
- Consistentie: Exportmappings opslaan en hergebruiken in verschillende teams.
- Precisie: Rechtstreeks bij het exporteren filteren en samenvoegen, zodat de spreadsheets verderop in de keten eenvoudig blijven.
Terminologie
| Term | Definitie |
|---|---|
| Pad | Een verwijzing naar de gegevens die moeten worden opgehaald. Bijvoorbeeld: trip > charges verwijst naar de lijst met kosten van een trip. |
| Filter | Een voorwaarde die een lijst beperkt tot alleen de overeenkomende items. Voorbeeld: charge_type = “Transport”. |
| Operator | De vergelijking die in een filter wordt gebruikt, zoals EQ, NEQ, GT, GTE, LT, LTE, IN, NONE_IN. |
| Aggregatie | Een manier om een lijst tot één waarde te herleiden. Mogelijke opties zijn SUM, COUNT, DISTINCT, MIN, MAX, EXISTS, NOT_EXISTS. |
| Opmaak | Instellingen voor de weergave van datums, datums/tijden en getallen, met een optionele conversie naar tekst voor betrouwbare CSV-bestanden. |
| Expressiemodus\ | |
| (geavanceerd) | Een editor voor ruwe expressies, beschikbaar voor admins, voor complexe transformaties. |
| Preview | Een live weergave die het resultaat van de configuratie toont vóór het exporteren. |
Opmerkingen en huidige beperkingen
- Enumwaarden worden nog niet vertaald.
- Filteren binnen bepaalde geneste lijsten kan een alternatieve oplossing vereisen als er geen getypeerd pad beschikbaar is.
- Eenheidsconversies en “meerdere velden in één kolom combineren” worden apart opgevolgd.
Stapsgewijs: de Expression Builder configureren en gebruiken
Hieronder staat een veelvoorkomend scenario: het totaal van de transportkosten van een trip en een opgemaakte ophaaldatum en -tijd exporteren, opgebouwd als twee exportkolommen.
Voor het begin:
- Een aangepaste exportmapping openen of een nieuwe aanmaken.
- Bepalen vanuit welke entiteit wordt geëxporteerd, bijvoorbeeld orders.
Kolom A: totale transportkosten
-
Een nieuwe kolom toevoegen
- Naam: Totale transportkost
-
Een pad kiezen
- Pad: orders > charges
- Dit verwijst naar de lijst met alle kosten van de trip.
-
Een filter toevoegen
- Filterpad: charge_type
- Operator: EQ
- Waarde: Transport
- Resultaat: alleen kosten van het type Transport worden meegenomen.
-
Een aggregatie instellen
- Aggregatie: SUM
- Opgeteld veld: amount
- Resultaat: telt het bedrag van de gefilterde kosten op.
-
Opmaak
- Getalnotatie: #,###.00
- Naar tekst converteren: aan, zodat CSV-cellen nooit leeg zijn en indien nodig als tekst worden behandeld.
-
Preview
- Met de preview controleren of het resulterende getal aan de verwachtingen voldoet.
Wat dit doet
- Vertrekt van de lijst met kosten
- Filtert op charge_type = Transport
- Telt het bedrag op
- Geeft een opgemaakte tekst terug die geschikt is voor CSV-import in boekhoudpakketten.

Kolom B: ophaaldatum en -tijd (Amerikaanse notatie)
-
Een nieuwe kolom toevoegen
- Naam: Ophaaldatum/-tijd (VS)
-
Een pad kiezen
- Pad: trip > pickup_datetime
-
Opmaak
- Datum-/tijdnotatie: yyyy-MM-dd HH:mm:ss
- Voorbeeld: 2025-12-31 16:45:00
- Naar tekst converteren: aan, zodat de CSV-uitvoer consistent blijft.
-
Preview
- Controleren of datum en tijd in de gevraagde notatie verschijnen.
Wat dit doet
- Leest de ophaaldatum en -tijd van de trip en geeft die in een duidelijke, consistente notatie terug voor tools verderop in de keten.
Exporteren
- De mapping opslaan en de export uitvoeren. Het CSV-bestand bevat beide kolommen volgens de geconfigureerde transformatieregels.

Filteropties voor kostentypes
Filters kunnen nu worden toegepast op expressies die naar kosten verwijzen. Zo is er volledige controle over welke kosten in de berekening worden opgenomen.
1. Toeslagen: nu volledig ondersteund
Vroeger toonde de datafeed alleen _index_toeslagen (brandstoftoeslagen), waardoor de logica in de interface en in de export niet overeenkwam.
De Expression Builder ondersteunt nu twee configuratieopties:
-
Toeslagen (alle types)
Omvat alle toeslagtypes die in de interface worden gebruikt:- Algemene toeslagen
- Indextoeslagen (FSC)
- Alle toekomstige toeslagtypes
-
Andere toeslagen (zonder FSC)
Bedoeld voor gevallen zoals Mulgrews, waar FSC niet bij de toeslagen mag worden meegeteld.
Zo kunnen teams kiezen voor de werking die past bij hun rapportagemodel.
2. Omzet uit extra’s (nieuwe categorie)
Extra’s kan nu als aparte categorie worden geselecteerd.
Extra’s omvatten:
- Alle kosten waarbij
addon_type≠ surcharge - Alle ad-hockosten
Zo is het eenvoudig om “alle omzet behalve transport/brandstof” te berekenen of om te rapporteren over diverse kostenitems.
3. Consistente filtering in interface en export
De Expression Builder gebruikt nu dezelfde logica voor het filteren van kosten als de prijsberekening in de Qargo-interface, waaronder:
- Goedgekeurde DONT_INVOICE-kosten uitfilteren
- Correcte verwerking van transportkosten
- Volledige afstemming op de bestaande werking van de frontend
Zo komt wat gebruikers in de interface zien overeen met wat in exports en geautomatiseerde berekeningen terechtkomt, zonder verrassingen.
4. Documentatie opnemen
Gebruikers kunnen nu documentatiegegevens opnemen in rapportages met de aggregatieoptie “Exists” van de Expression Builder. De gegevens omvatten:
-
Naam, beschrijving, datum- en tijdstempels
-
Met de aggregatie ‘exists’ wordt de kolom toegevoegd met de waarden ‘true/false’
- True = documentatie aan de order gekoppeld
- False = geen documentatie aan de order gekoppeld
Tips
- Beginnen met een pad en één filter, en pas aggregatie en opmaak toevoegen zodra de preview klopt.
- COUNT of EXISTS gebruiken voor een ja/nee-waarde of een eenvoudig aantal overeenkomsten.
- DISTINCT gebruiken om dubbele waarden te verwijderen bij het exporteren van lijsten naar één cel.
Geavanceerd: expressiemodus
Workspace-admins kunnen overschakelen naar een modus voor ruwe expressies om complexe logica rechtstreeks te schrijven. Dit is nuttig voor uitzonderlijke gevallen waarin de formuliergebaseerde builder te beperkt is. Opgeslagen expressies best documenteren, zodat ze onderhoudbaar blijven.
Problemen oplossen
- Lege cellen: Naar tekst converteren inschakelen, zodat spreadsheetprogramma’s lege waarden niet verkeerd interpreteren.
- Onverwachte totalen: de filteroperator en de spelling van de waarde controleren. Nagaan of het pad naar de bedoelde lijst verwijst.
- Datumopmaak: de notatie voor datum/tijd controleren en nagaan of het bronveld een datum of een datum-tijd bevat.
