Zoek-operators

Spendle ondersteunt zoekoperators waarmee je specifieke transacties kunt vinden in de transactielijst.

Let op: Dit document beschrijft de zoekoperators voor het transactie-zoekscherm. Voor actieregels (automatische categorisatie) gelden andere operators — zie Actieregel-operators onderaan dit document.

Basis-zoekfunctionaliteit

Gedeeltelijke match (standaard)

Zonder operator wordt gezocht op gedeeltelijke matches (case-insensitive).

Syntax: zoekterm

Voorbeelden:

• decl → vindt “decl”, “decl122024jansen”, “declaratie”, “mydeclaration”
• albert → vindt “Albert Heijn”, “albertstraat”, “Albertina”

Gebruik: Ideaal voor snelle, brede zoekopdrachten waar je niet zeker weet van de exacte spelling.

---

Geavanceerde zoekoperators

1. Hele Woord Match (~)

Zoek naar een heel woord, niet als onderdeel van een groter woord.

Syntax: ~zoekterm

Voorbeelden:

• ~decl → vindt “decl” maar NIET “decl122024jansen” of “declaratie”
• ~ah → vindt “AH” maar NIET “Albert Heijn” of “ahoy”
• ~12.50 → vindt exact “12.50” maar NIET ”€ 12.50” of “112.50”

Gebruik: Wanneer je een specifiek woord of code zoekt zonder false positives.

---

2. Exacte Match (=)

Het hele veld moet exact overeenkomen met de zoekterm.

Syntax: =zoekterm

Voorbeelden:

• =decl → vindt alleen transacties waar het memo-veld exact “decl” is
• =Albert Heijn → vindt alleen exact “Albert Heijn”, niet “Albert Heijn Amsterdam”
• =50 → vindt alleen transacties waar een veld exact “50” bevat (niet =50 voor bedragen!)

Gebruik: Voor zeer precieze zoekopdrachten waar je exact weet wat je zoekt.

Let op: Voor bedragfilters gebruik je =50 (met cijfer), voor tekstzoekopdrachten =term (met tekst).

---

3. Begint Met (^)

Vind transacties waar een veld begint met de zoekterm.

Syntax: ^zoekterm

Voorbeelden:

• ^albert → vindt “Albert Heijn”, “Albertstraat” maar NIET “De Albert”
• ^NL → vindt “NL12BANK0123”, “NL-Amsterdam” maar NIET “SNL Bank”
• ^2024 → vindt “2024-01-15”, “20241501” maar NIET “dec2024”

Gebruik: Handig voor het zoeken van transacties die beginnen met een specifiek voorvoegsel, zoals bankcodes, jaartallen of merknamen.

---

4. Eindigt Op ($)

Vind transacties waar een veld eindigt met de zoekterm.

Syntax: zoekterm$

Voorbeelden:

• jansen$ → vindt “decl122024jansen”, “J.Jansen” maar NIET “jansen123”
• BV$ → vindt “Acme BV”, “Transport BV” maar NIET “BV Nederland”
• 2024$ → vindt “dec2024”, “factuur-2024” maar NIET “2024-01-15”

Gebruik: Nuttig voor het vinden van transacties met specifieke achtervoegsels zoals bedrijfsvormen (BV, VOF) of jaartallen aan het einde.

---

5. Exclusie / NOT (-)

Sluit transacties uit die aan de zoekterm voldoen.

Syntax: -zoekterm

Voorbeelden:

• -albert → toont ALLES behalve transacties met “albert”
• -~decl → toont alles behalve transacties met het hele woord “decl”
• -^AH → toont alles behalve transacties die beginnen met “AH”

Gebruik: Filter ongewenste resultaten uit je zoekresultaten.

Combinatie: De - operator kan gecombineerd worden met andere operators:

• -~woord → exclusie van heel woord
• -=exacte → exclusie van exacte match
• -^begin → exclusie van begint-met

---

Meerdere zoektermen combineren

AND Logica (spatie)

Meerdere woorden gescheiden door spaties werken als AND - alle woorden moeten voorkomen.

Voorbeelden:

• albert heijn → vindt transacties die ZOWEL “albert” ALS “heijn” bevatten
• decl 2024 → vindt transacties die ZOWEL “decl” ALS “2024” bevatten
• ~ah amsterdam → vindt transacties met het hele woord “ah” EN “amsterdam”

---

OR Logica (komma)

Meerdere zoektermen gescheiden door komma’s werken als OR - minstens één moet voorkomen.

Voorbeelden:

• albert,jumbo → vindt transacties met “albert” OF “jumbo”
• ~ah,~plus → vindt transacties met het hele woord “ah” OF “plus”
• ^NL,^BE → vindt transacties die beginnen met “NL” OF “BE”

---

Bedragfilters

Naast tekstoperators kun je ook filteren op bedragen:

Syntax:

• >50 → groter dan 50
• >=50 → groter dan of gelijk aan 50
• <100 → kleiner dan 100
• <=100 → kleiner dan of gelijk aan 100
• =50 → exact 50 (let op: voor bedragen, niet voor tekst!)

Combinatie met tekst:

• albert >50 → transacties met “albert” EN bedrag > 50
• ~ah >=20 <=100 → hele woord “ah” EN bedrag tussen 20 en 100

---

Welke velden worden doorzocht?

De zoekfunctie zoekt in de volgende velden:

• Memo (notitie)
• Beschrijving
• Tegenrekening
• Relatie
• Categorie
• Rekening
• Groep
• Annotatie
• Transactie ID
• Tag
• Bedrag

---

Praktische voorbeelden

Scenario 1: Zoek specifieke supermarkt

Probleem: Je zoekt “AH” maar krijgt ook resultaten met “ahoy”, “sahara”, etc.

Oplossing: ~ah

Dit vindt alleen het hele woord “AH”.

---

Scenario 2: Filter lopende kosten

Probleem: Je wilt alle grote uitgaven zien, behalve vaste lasten.

Oplossing: >100 -huur -energie -water

Dit toont uitgaven boven 100 euro, maar sluit huur, energie en water uit.

---

Scenario 3: Zoek IBAN transacties

Probleem: Je zoekt Nederlandse IBANs.

Oplossing: ^NL

Dit vindt alle transacties met velden die beginnen met “NL”.

---

Scenario 4: Zoek oude declaraties

Probleem: Je wilt declaraties uit 2024 vinden.

Oplossing: decl 2024 of ^decl 2024$

De eerste vindt alle transacties met beide woorden, de tweede is specifieker.

---

Scenario 5: Meerdere winkels uitsluiten

Probleem: Je wilt alle transacties zien behalve supermarkten.

Oplossing: -albert -jumbo -aldi -lidl

Of met hele woorden: -~ah -~plus -~coop

---

Tips & Tricks

1. Begin breed, verfijn daarna: Start met een simpele zoekterm en voeg operators toe om te verfijnen.

2. Combineer slim: Gebruik ^ voor begin en $ voor einde in één zoekterm: ^decl2024$

3. Exclusie is krachtig: Gebruik - om snel irrelevante resultaten te filteren.

4. Test je operators: Probeer eerst zonder operator, dan met operator om het verschil te zien.

5. Case-insensitive: Alle zoekopdrachten zijn hoofdletterongevoelig, dus AH, ah en Ah geven hetzelfde resultaat.

6. Operators werken overal: De operators werken in alle velden, niet alleen in memo.

---

Cheatsheet - Transactie Zoeken

Operator	Functie	Voorbeeld	Vindt
(geen)	Gedeeltelijke match	decl	”decl”, “declaratie”, “decl123”
~	Heel woord	~decl	”decl” (niet “declaratie”)
=	Exact	=decl	Alleen exact “decl”
^	Begint met	^albert	”Albert Heijn”, “Albertstraat”
$	Eindigt op	jansen$	”J.Jansen”, “decl-jansen”
-	NOT / Exclusie	-albert	Alles behalve “albert”
(spatie)	AND	decl 2024	Bevat “decl” EN “2024”
,	OR	ah,plus	Bevat “ah” OF “plus”

---

Actieregel-operators

Actieregels (automatische categorisatie) gebruiken andere matching logica dan het transactie zoekscherm. Hieronder staan de operators voor actieregels:

Hoe actieregels velden combineren

In een actieregel heb je meerdere velden die je kunt invullen:

Velden in een actieregel:

• Memo - Notitieveld van transactie
• Beschrijving (Omschrijving) - Beschrijvingsveld van transactie
• Bedrag Min - Minimumbedrag (aparte veldoptie, geen >50 syntax)
• Bedrag Max - Maximumbedrag (aparte veldoptie, geen <100-syntax)
• Rekening - Welke rekening
• Type - IN (inkomsten) of OUT (uitgaven)

Hoe ze combineren:

1. Memo en Beschrijving = OR logica

   • Alleen Memo → moet matchen met memo veld
   • Alleen Beschrijving → moet matchen met beschrijving veld
   • Beide ingevuld → één van beide moet matchen (OR)

2. Andere velden = AND logica

   • Bedrag Min/Max, Rekening, Type
   • Deze moeten allemaal kloppen samen met memo/beschrijving

Praktische voorbeelden:

Memo	Beschrijving	Bedrag Min	Bedrag Max	Match als…
decl*	(leeg)	(leeg)	(leeg)	Memo begint met “decl”
(leeg)	ALBERT HEIJN	(leeg)	(leeg)	Beschrijving bevat “ALBERT HEIJN”
decl*	ALBERT HEIJN	(leeg)	(leeg)	Memo begint met “decl” OF beschrijving bevat “ALBERT HEIJN”
decl*	(leeg)	50	(leeg)	Memo begint met “decl” EN bedrag ≥ 50
decl*	ALBERT HEIJN	50	200	(Memo begint met “decl” OF beschrijving bevat “ALBERT HEIJN”) EN bedrag tussen 50-200
decl*	(leeg)	50	(leeg) + Type: OUT	Memo begint met “decl” EN bedrag ≥ 50 EN uitgave

Belangrijke notitie: In actieregels gebruik je aparte velden voor bedragfilters (Min/Max), niet de >50 of <100-syntax. Die syntax werkt alleen in het transactie zoekscherm!

Basismatching

Automatisch slim matchen:

• Patronen >4 karakters: substring match (vindt overal in de tekst)
• Patronen ≤4 karakters: hele woord match (voorkomt false positives zoals “BP” in “subpage”)

Voorbeelden:

• decl (4 chars) → vindt “decl” maar NIET “decl072024” (hele woord)
• albert (6 chars) → vindt “albert”, “albertheijn”, “Albertstraat” (substring)

Wildcard-operator (*)

Gebruik * als wildcard voor flexibele matching.

Syntax:

• patroon* → begint met “patroon”
• *patroon → eindigt op “patroon”
• *patroon* → bevat “patroon” (forceert substring match)
• patroon*2024 → begint met “patroon” en eindigt op “2024”

Voorbeelden:

• decl* → vindt “decl”, “decl072024Jansen”, “decl122024”, “declaratie”
• *2024 → vindt “decl2024”, “factuur2024”, “dec-2024”
• *AH* → vindt “AH”, “Albert Heijn”, “AHOY” (substring)
• dec*2024 → vindt “dec-2024”, “december2024”, “decl072024”

Gebruik: Perfect voor het matchen van codes met variabele achtervoegsels zoals “decl072024”, “decl122024”, etc.

Exacte woordmatch (=)

Forceer hele woord match, ongeacht lengte.

Syntax: =patroon

Voorbeelden:

• =ah → vindt “AH” maar NIET “Albert Heijn” of “ahoy”
• =2024 → vindt “2024” maar NIET “dec2024” of “20241215”

Exclusie (-)

Sluit matches uit (veto).

Syntax: -patroon

Voorbeelden:

• -privé → matcht NIET als “privé” voorkomt
• -test → sluit test transacties uit

Gebruik: Voorkom dat een regel wordt toegepast op bepaalde transacties.

Verplicht (+)

Match moet voorkomen (AND voorwaarde).

Syntax: +patroon

Voorbeelden:

• albert,jumbo +supermarkt → matcht “albert” OF “jumbo”, maar ALLEEN als ook “supermarkt” voorkomt

Gebruik: Voeg een extra voorwaarde toe aan een regel.

Combinaties in Actieregels

Je kunt meerdere patronen combineren met komma’s (OR logica):

Voorbeelden:

• decl*,declaratie → matcht alles dat begint met “decl” OF “declaratie” bevat
• =ah,=plus,=coop → matcht exacte woorden “ah”, “plus” of “coop”
• albert*,-test → begint met “albert” maar NIET als “test” voorkomt
• *2024,*2023 → eindigt op “2024” of “2023”

---

Cheatsheet - Actieregels

Operator	Functie	Voorbeeld	Vindt
(geen, >4 chars)	Substring match	albert	”albert”, “albertheijn”
(geen, ≤4 chars)	Hele woord	decl	”decl” (niet “decl2024”)
*	Wildcard	decl*	”decl”, “decl072024”, “declaratie”
=	Exacte woord	=ah	”ah” (niet “ahoy”)
-	Exclusie / NOT	-privé	Alles behalve met “privé”
+	Verplicht / AND	+2024	Moet ook “2024” bevatten
,	OR	ah,plus	”ah” OF “plus”

---

Verschil tussen transactie zoeken en actieregels

Functie	Transactie Zoeken	Actieregels
Doel	Snel transacties vinden	Automatisch categoriseren
Hele woord	~decl	decl (≤4 chars) of =decl
Substring	decl (default)	albert (>4 chars) of *decl*
Wildcard	-	decl*
Begint met	^decl	decl*
Eindigt op	decl$	*decl
AND	spatie	+patroon
OR	komma	komma
NOT	-decl	-decl

Belangrijkste verschil: Actieregels gebruiken automatische smart matching (korte patronen = hele woorden) en wildcards, terwijl transactie zoeken expliciete operators gebruikt.

---

Technische details

• Case-insensitive: Alle zoekopdrachten en regels zijn hoofdletterongevoelig
• Meerdere velden: Operators werken op alle doorzoekbare velden
• Backward compatible: Bestaande zoekopdrachten en regels blijven werken
• Combineerbaar: Operators kunnen gecombineerd worden voor complexe queries
• Performant: Efficiënte implementatie met geoptimaliseerde regex voor hele woorden en wildcards