Suchoperatoren

In Spendle werden Suchoperatoren unterstützt, mit denen du bestimmte Transaktionen in der Transaktionsliste finden kannst.

Hinweis: Dieses Dokument beschreibt die Suchoperatoren für das Transaktions-Suchfeld. Für Aktionsregeln (automatische Kategorisierung) gelten andere Operatoren — siehe Aktionsregel-Operatoren am Ende dieses Dokuments.

Basis-Suchfunktion

Teilübereinstimmung (Standard)

Ohne Operator wird nach Teilübereinstimmungen gesucht (Groß-/Kleinschreibung wird ignoriert).

Syntax: suchbegriff

Beispiele:

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

Verwendung: Ideal für schnelle, breite Suchabfragen, wenn die genaue Schreibweise nicht bekannt ist.

---

Erweiterte Suchoperatoren

1. Ganzwort-Übereinstimmung (~)

Suche nach einem ganzen Wort, nicht als Teil eines größeren Wortes.

Syntax: ~suchbegriff

Beispiele:

• ~decl → findet “decl”, aber NICHT “decl122024jansen” oder “declaratie”
• ~ah → findet “AH”, aber NICHT “Albert Heijn” oder “ahoy”
• ~12.50 → findet exakt “12.50”, aber NICHT ”€ 12.50” oder “112.50”

Verwendung: Wenn du nach einem bestimmten Wort oder Code ohne falsch-positive Treffer suchst.

---

2. Exakte Übereinstimmung (=)

Das gesamte Feld muss exakt mit dem Suchbegriff übereinstimmen.

Syntax: =suchbegriff

Beispiele:

• =decl → findet nur Transaktionen, bei denen das Memo-Feld exakt “decl” ist
• =Albert Heijn → findet nur exakt “Albert Heijn”, nicht “Albert Heijn Amsterdam”
• =50 → findet nur Transaktionen, bei denen ein Feld exakt “50” enthält (nicht =50 für Beträge!)

Verwendung: Für sehr präzise Suchabfragen, wenn der gesuchte Wert genau bekannt ist.

Hinweis: Für Betragsfilter verwendest du =50 (mit Zahl), für Textsuchabfragen =Begriff (mit Text).

---

3. Beginnt mit (^)

Finde Transaktionen, bei denen ein Feld mit dem Suchbegriff beginnt.

Syntax: ^suchbegriff

Beispiele:

• ^albert → findet “Albert Heijn”, “Albertstraat”, aber NICHT “De Albert”
• ^NL → findet “NL12BANK0123”, “NL-Amsterdam”, aber NICHT “SNL Bank”
• ^2024 → findet “2024-01-15”, “20241501”, aber NICHT “dec2024”

Verwendung: Nützlich, um Transaktionen mit einem bestimmten Präfix zu finden, wie Bankcodes, Jahreszahlen oder Markennamen.

---

4. Endet auf ($)

Finde Transaktionen, bei denen ein Feld mit dem Suchbegriff endet.

Syntax: suchbegriff$

Beispiele:

• jansen$ → findet “decl122024jansen”, “J.Jansen”, aber NICHT “jansen123”
• BV$ → findet “Acme BV”, “Transport BV”, aber NICHT “BV Nederland”
• 2024$ → findet “dec2024”, “factuur-2024”, aber NICHT “2024-01-15”

Verwendung: Nützlich, um Transaktionen mit bestimmten Suffixen zu finden, wie Rechtsformen (GmbH, AG) oder Jahreszahlen am Ende.

---

5. Ausschluss / NOT (-)

Schließt Transaktionen aus, die dem Suchbegriff entsprechen.

Syntax: -suchbegriff

Beispiele:

• -albert → zeigt ALLES außer Transaktionen mit “albert”
• -~decl → zeigt alles außer Transaktionen mit dem ganzen Wort “decl”
• -^AH → zeigt alles außer Transaktionen, die mit “AH” beginnen

Verwendung: Unerwünschte Ergebnisse aus den Suchergebnissen herausfiltern.

Kombination: Der - Operator kann mit anderen Operatoren kombiniert werden:

• -~wort → Ausschluss von ganzem Wort
• -=exakt → Ausschluss von exakter Übereinstimmung
• -^anfang → Ausschluss von beginnt-mit

---

Mehrere Suchbegriffe kombinieren

AND-Logik (Leerzeichen)

Mehrere durch Leerzeichen getrennte Wörter wirken als AND — alle Wörter müssen vorkommen.

Beispiele:

• albert heijn → findet Transaktionen, die SOWOHL “albert” ALS AUCH “heijn” enthalten
• decl 2024 → findet Transaktionen, die SOWOHL “decl” ALS AUCH “2024” enthalten
• ~ah amsterdam → findet Transaktionen mit dem ganzen Wort “ah” UND “amsterdam”

---

OR-Logik (Komma)

Mehrere durch Kommas getrennte Suchbegriffe wirken als OR — mindestens einer muss vorkommen.

Beispiele:

• albert,jumbo → findet Transaktionen mit “albert” ODER “jumbo”
• ~ah,~plus → findet Transaktionen mit dem ganzen Wort “ah” ODER “plus”
• ^NL,^BE → findet Transaktionen, die mit “NL” ODER “BE” beginnen

---

Betragsfilter

Neben Textoperatoren kannst du auch nach Beträgen filtern:

Syntax:

• >50 → größer als 50
• >=50 → größer als oder gleich 50
• <100 → kleiner als 100
• <=100 → kleiner als oder gleich 100
• =50 → exakt 50 (Hinweis: für Beträge, nicht für Text!)

Kombination mit Text:

• albert >50 → Transaktionen mit “albert” UND Betrag > 50
• ~ah >=20 <=100 → ganzes Wort “ah” UND Betrag zwischen 20 und 100

---

Welche Felder werden durchsucht?

Die Suchfunktion durchsucht folgende Felder:

• Memo (Notiz)
• Beschreibung
• Gegenkonto
• Relation
• Kategorie
• Konto
• Gruppe
• Annotation
• Transaktions-ID
• Tag
• Betrag

---

Praktische Beispiele

Szenario 1: Bestimmten Supermarkt suchen

Problem: Du suchst “AH”, bekommst aber auch Treffer mit “ahoy”, “sahara” usw.

Lösung: ~ah

Das findet nur das ganze Wort “AH”.

---

Szenario 2: Laufende Kosten filtern

Problem: Du möchtest alle großen Ausgaben sehen, außer Fixkosten.

Lösung: >100 -miete -energie -wasser

Das zeigt Ausgaben über 100 Euro, schließt aber Miete, Energie und Wasser aus.

---

Szenario 3: IBAN-Transaktionen suchen

Problem: Du suchst deutsche IBANs.

Lösung: ^DE

Das findet alle Transaktionen mit Feldern, die mit “DE” beginnen.

---

Szenario 4: Alte Spesenabrechnungen suchen

Problem: Du möchtest Spesenabrechnungen aus 2024 finden.

Lösung: decl 2024 oder ^decl 2024$

Die erste Variante findet alle Transaktionen mit beiden Wörtern, die zweite ist präziser.

---

Szenario 5: Mehrere Geschäfte ausschließen

Problem: Du möchtest alle Transaktionen sehen, außer Supermärkte.

Lösung: -albert -jumbo -aldi -lidl

Oder mit ganzen Wörtern: -~ah -~plus -~coop

---

Tipps & Tricks

1. Breit beginnen, dann verfeinern: Starte mit einem einfachen Suchbegriff und füge Operatoren zur Verfeinerung hinzu.

2. Clever kombinieren: Verwende ^ für Anfang und $ für Ende in einem Suchbegriff: ^decl2024$

3. Ausschluss ist mächtig: Verwende -, um schnell irrelevante Ergebnisse herauszufiltern.

4. Operatoren testen: Probiere erst ohne Operator, dann mit Operator, um den Unterschied zu sehen.

5. Groß-/Kleinschreibung ignoriert: Alle Suchabfragen sind nicht case-sensitiv, also liefern AH, ah und Ah dasselbe Ergebnis.

6. Operatoren wirken überall: Die Operatoren wirken auf alle Felder, nicht nur auf das Memo.

---

Cheatsheet — Transaktionssuche

Operator	Funktion	Beispiel	Findet
(kein)	Teilübereinstimmung	decl	”decl”, “declaratie”, “decl123”
~	Ganzes Wort	~decl	”decl” (nicht “declaratie”)
=	Exakt	=decl	Nur exakt “decl”
^	Beginnt mit	^albert	”Albert Heijn”, “Albertstraat”
$	Endet auf	jansen$	”J.Jansen”, “decl-jansen”
-	NOT / Ausschluss	-albert	Alles außer “albert”
(Leerzeichen)	AND	decl 2024	Enthält “decl” UND “2024”
,	OR	ah,plus	Enthält “ah” ODER “plus”

---

Aktionsregel-Operatoren

Aktionsregeln (automatische Kategorisierung) verwenden eine andere Matching-Logik als das Transaktions-Suchfeld. Im Folgenden stehen die Operatoren für Aktionsregeln:

Wie Aktionsregeln Felder kombinieren

In einer Aktionsregel gibt es mehrere Felder, die ausgefüllt werden können:

Felder in einer Aktionsregel:

• Memo — Notizfeld der Transaktion
• Beschreibung — Beschreibungsfeld der Transaktion
• Betrag Min — Mindestbetrag (separates Feld, keine >50-Syntax)
• Betrag Max — Höchstbetrag (separates Feld, keine <100-Syntax)
• Konto — Welches Konto
• Type — IN (Einnahmen) oder OUT (Ausgaben)

Wie sie kombiniert werden:

1. Memo und Beschreibung = OR-Logik

   • Nur Memo → muss mit Memo-Feld übereinstimmen
   • Nur Beschreibung → muss mit Beschreibungsfeld übereinstimmen
   • Beide ausgefüllt → eines von beiden muss übereinstimmen (OR)

2. Andere Felder = AND-Logik

   • Betrag Min/Max, Konto, Type
   • Diese müssen alle zusammen mit Memo/Beschreibung zutreffen

Praktische Beispiele:

Memo	Beschreibung	Betrag Min	Betrag Max	Trifft zu, wenn…
decl*	(leer)	(leer)	(leer)	Memo beginnt mit “decl”
(leer)	ALBERT HEIJN	(leer)	(leer)	Beschreibung enthält “ALBERT HEIJN”
decl*	ALBERT HEIJN	(leer)	(leer)	Memo beginnt mit “decl” ODER Beschreibung enthält “ALBERT HEIJN”
decl*	(leer)	50	(leer)	Memo beginnt mit “decl” UND Betrag ≥ 50
decl*	ALBERT HEIJN	50	200	(Memo beginnt mit “decl” ODER Beschreibung enthält “ALBERT HEIJN”) UND Betrag zwischen 50–200
decl*	(leer)	50	(leer) + Type: OUT	Memo beginnt mit “decl” UND Betrag ≥ 50 UND Ausgabe

Wichtiger Hinweis: In Aktionsregeln verwendest du separate Felder für Betragsfilter (Min/Max), nicht die >50- oder <100-Syntax. Diese Syntax funktioniert nur im Transaktions-Suchfeld!

Basis-Matching

Automatisches Smart-Matching:

• Muster >4 Zeichen: Teilstring-Match (findet überall im Text)
• Muster ≤4 Zeichen: Ganzwort-Match (verhindert falsch-positive wie “BP” in “subpage”)

Beispiele:

• decl (4 Zeichen) → findet “decl”, aber NICHT “decl072024” (ganzes Wort)
• albert (6 Zeichen) → findet “albert”, “albertheijn”, “Albertstraat” (Teilstring)

Wildcard-Operator (*)

Verwende * als Platzhalter für flexibles Matching.

Syntax:

• muster* → beginnt mit “muster”
• *muster → endet auf “muster”
• *muster* → enthält “muster” (erzwingt Teilstring-Match)
• muster*2024 → beginnt mit “muster” und endet auf “2024”

Beispiele:

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

Verwendung: Ideal für das Matching von Codes mit variablen Suffixen wie “decl072024”, “decl122024” usw.

Exakte Wortübereinstimmung (=)

Erzwinge Ganzwort-Match, unabhängig von der Länge.

Syntax: =muster

Beispiele:

• =ah → findet “AH”, aber NICHT “Albert Heijn” oder “ahoy”
• =2024 → findet “2024”, aber NICHT “dec2024” oder “20241215”

Ausschluss (-)

Schließt Treffer aus (Veto).

Syntax: -muster

Beispiele:

• -privat → trifft NICHT zu, wenn “privat” vorkommt
• -test → schließt Testtransaktionen aus

Verwendung: Verhindere, dass eine Regel auf bestimmte Transaktionen angewendet wird.

Pflichtbedingung (+)

Übereinstimmung muss vorkommen (AND-Bedingung).

Syntax: +muster

Beispiele:

• albert,jumbo +supermarkt → trifft auf “albert” ODER “jumbo” zu, aber NUR wenn auch “supermarkt” vorkommt

Verwendung: Füge einer Regel eine zusätzliche Bedingung hinzu.

Kombinationen in Aktionsregeln

Mehrere Muster können mit Kommas kombiniert werden (OR-Logik):

Beispiele:

• decl*,declaratie → trifft alles, das mit “decl” beginnt, ODER “declaratie” enthält
• =ah,=plus,=coop → trifft exakte Wörter “ah”, “plus” oder “coop”
• albert*,-test → beginnt mit “albert”, aber NICHT wenn “test” vorkommt
• *2024,*2023 → endet auf “2024” oder “2023”

---

Cheatsheet — Aktionsregeln

Operator	Funktion	Beispiel	Findet
(kein, >4 Zeichen)	Teilstring-Match	albert	”albert”, “albertheijn”
(kein, ≤4 Zeichen)	Ganzes Wort	decl	”decl” (nicht “decl2024”)
*	Platzhalter	decl*	”decl”, “decl072024”, “declaratie”
=	Exaktes Wort	=ah	”ah” (nicht “ahoy”)
-	Ausschluss / NOT	-privat	Alles außer mit “privat”
+	Pflichtbedingung / AND	+2024	Muss auch “2024” enthalten
,	OR	ah,plus	”ah” ODER “plus”

---

Unterschied zwischen Transaktionssuche und Aktionsregeln

Funktion	Transaktionssuche	Aktionsregeln
Zweck	Transaktionen schnell finden	Automatisch kategorisieren
Ganzes Wort	~decl	decl (≤4 Zeichen) oder =decl
Teilstring	decl (Standard)	albert (>4 Zeichen) oder *decl*
Platzhalter	-	decl*
Beginnt mit	^decl	decl*
Endet auf	decl$	*decl
AND	Leerzeichen	+muster
OR	Komma	Komma
NOT	-decl	-decl

Wichtigster Unterschied: Aktionsregeln verwenden automatisches Smart-Matching (kurze Muster = ganze Wörter) und Platzhalter, während die Transaktionssuche explizite Operatoren verwendet.

---

Technische Details

• Groß-/Kleinschreibung ignoriert: Alle Suchabfragen und Regeln sind nicht case-sensitiv
• Mehrere Felder: Operatoren wirken auf alle durchsuchbaren Felder
• Rückwärtskompatibel: Bestehende Suchabfragen und Regeln funktionieren weiterhin
• Kombinierbar: Operatoren können für komplexe Abfragen kombiniert werden
• Performant: Effiziente Implementierung mit optimiertem Regex für ganze Wörter und Platzhalter