Skip to main content

Lokator: Search for DB linked data

Der Lokator Search for DB linked data findet auf Basis weiterer Lokatoren-Ergebnisse, Einträge in Datenbanken.

Ein klassisches Beispiel für die Verwendung dieses Lokators ist die Kreditorsuche bei Eingangsrechnungen.

Mittels entsprechender Lokatoren für die Suche nach IBAN-Nummern, Umsatzsteuer-ID´s, Steuernummern, Telefon - und Fax-Nummern, Email-Adressen oder Internet-Adressen wird in einer entsprechenden Datenbank nach passenden Einträgen gesucht und zu diesen Einträgen die Kreditor-Nummer zurückgegeben.

Der Lokator für die Suche nach Kreditoren mittels Datenbanksuche ist Bestandteil des ausgelieferten Invoice Templates.

  1. Konfiguration des DB Link Locators

  2. Beispiel für Datenbank-Plausibilisierung 
  3. Lokatorenfilterung
Konfiguration des DB Link Locators

Die Konfiguration wird analog zu allen anderen Lokatoren durchgeführt. Der Lokator Typ für diesen Lokator ist Search for DB linked data.

image-1648644001550.png

Unter dem Reiter Datenbanksuche wird die Datenbank-Suche konfiguriert:

Diese Konfiguration wird am Beispiel der Kreditor-Suche erläutert.

image-1648644038345.png

  • Im oberen Teil der Konfiguration wird die Stammdaten-Tabelle für Kreditoren im Feld Tabelle ausgewählt.
  • Im Feld Spalte kann die Datenbank-Spalte dieser Tabelle für das Ergebnis der Datenbank-Suche ausgewählt werden.
  • In diesem Beispiel soll als Lokator-Ergebnis die Kreditor-Nummer zurückgegeben werden.

Im unteren Tabellen-Bereich der Konfiguration werden die Source-Lokatoren für die Kreditor-Suche konfiguriert.

Source Lokator (Quell-Lokator) DB-Spalte der ausgewählten DB Stop-Kennzeichen
UstId (Lokator für die Ermittlung von Umsatzsteuer-ID´s) EUTaxId Nein
IBAN (Lokator für die Ermittlung von IBAN´s) IBAN Nein
Email (Lokator für die Ermittlung von Emails) Email Nein
URL (Lokator für die Ermittlung von URL´s) Webpage Nein
Phone (Lokator für die Ermittlung von Telefonnummern) Phone Nein
Phone (Lokator für die Ermittlung von Telefaxnummern) Fax Nein

Die Such-Ergebnisse der Source-Lokatoren werden in der DB-Spalte der entsprechenden Datenbank gesucht und der Wert der Ergebnis-Spalte zurückgegeben.

Die Reihenfolge wie die Ergebnisse der Source-Lokatoren in der Datenbank gesucht werden, kann in der Liste via Drag & Drop geändert werden. Der oberste Eintrag wird zuerst gesucht, der unterste Eintrag zuletzt.

Für das Stop-Kennzeichen kann entweder ja oder nein ausgewählt werden. Ja bedeutet, wenn nur ein Ergebnis in der Datenbank gefunden wird, wird der Wert der konfigurierten Ergebnis-Spalte zurückgegeben und die Suche beendet. Nein bedeutet, unabhängig ob es Treffer in der Datenbank gibt, es wird immer mit dem nächsten Lokator in der Liste weiter gesucht. 

Für die IBAN bedeutet diese Konfiguration, alle via IBAN-Lokator gefundenen IBAN´s werden in der Datenbankspalte IBAN gesucht, wenn eine oder mehrere passende IBAN´s gefunden werden, werden die Kreditor-ID´s dieser Zeilen zurückgegeben.

Mit dem Symbol "Neuer Eintrag" können weitere Lokatoren die bereits konfiguriert sind, ausgewählt und hinzugefügt werden.

image-1648644148630.png

  • das Locator Feld ist ein Auswahlfeld mit allen Lokatoren die konfiguriert sind
  • das Feld DB Column gibt an in welcher Datenbankspalte das Lokatorergbnis in der Tabelle gesucht werden soll
  • für das Feld Stop kann entweder ja oder nein ausgewählt werden.
Eine weitere Verwendungsmöglichkeit dieses Lokators ist die Plausibilisierung entsprechender Lokator-Ergebnisse gegen Datenbankeinträge.

So könnte man zum Beispiel mittels:

  • regulärer Ausdrücke
  • KeyWords
  • Value next to KeyWord-Suche

folgende beispielhafte Merkmale auf dem Dokument ermitteln:

  • Bestell-Nummern,
  • Lieferschein-Nummern,
  • Auftrags-Nummern,
  • Mandanten-Namen

und diese dann gegen geeignete Datenbankinformationen plausibilisieren.

Dazu wird das Lokator - Ergebnis in der entsprechenden Datenbanktabelle gesucht und diese Datenbankspalte auch als Ergebnis-Spalte konfiguriert. Mittels dieser Konfiguration werden als Ergebnis nur Einträge die auch in der Datenbank gefunden werden zurückgegeben.

Beispiel für Datenbank-Plausibilisierung 

In dem abgebildeten Beispiel, wird die mittels eines regulären Ausdrucks ermittelte Bestellnummer, gegen eine Datenbank mit entsprechenden Bestellnummern plausibilisiert.

Lokator für Erkennung der Bestellnummer (10-stellig numerisch) mittels regulärem Ausdruck:

image-1648644299907.png

Lokator für die Plausibilisierung der erkannten Bestellnummer gegen eine Datenbank:

image-1648644407609.png

Lokatorenfilterung

auf dieser Seite zeigen wir Ihnen Beispiele für die Verwendung von Lokatorfiltern. Die Lokatorfilter basieren auf Werten eines Lokators und dessen Einsatz bei Filterbedingungen auf ausgelesenen Dokumentenklassenfeldern.

Bis zur Version Squeeze 2.5.0 war dieses Feature ausschließlich nur über eine manuelle Anpassung in der Datenbank zu konfigurieren.

Ab der Version 2.5.0 findet sich unter der Administrationsoberfläche für Lokatoren mit dem Typ "Search for db linked data" die Möglichkeit diese Parameter zu konfigurieren. 

image-1687952512439.png

image-1687952620213.png

Die Mandantenspezifische-Kreditorfilterung kann nur gewährleistet werden für Lokatoren des Typs "Search for db linked data"