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-IDs, 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.

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-1584095013318.png

Unter dem Reiter Datenbanksuche wird die Datenbank-Suche konfiguriert:

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

image-1584095390109.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-IDs) EUTaxId Nein
IBAN (Lokator für die Ermittlung von IBANs) IBAN Nein
Email (Lokator für die Ermittlung von Emails) Email Nein
URL (Lokator für die Ermittlung von URLs) 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 IBANs werden in der Datenbankspalte IBAN gesucht, wenn eine oder mehrere passende IBANs gefunden werden, werden die Kreditor-IDs dieser Zeilen zurückgegeben.

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

image-1584114112306.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-1584115622290.png

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

image-1584115295926.png