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. [](https://docs.squeeze.one/uploads/images/gallery/2020-03/image-1584095013318.png) **Unter dem Reiter Datenbanksuche wird die Datenbank-Suche konfiguriert:** Diese Konfiguration wird am Beispiel der Kreditor-Suche erläutert. [](https://docs.squeeze.one/uploads/images/gallery/2020-03/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) | 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.** [](https://docs.squeeze.one/uploads/images/gallery/2020-03/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:** [](https://docs.squeeze.one/uploads/images/gallery/2020-03/image-1584115622290.png) **Lokator für die Plausibilisierung der erkannten Bestellnummer gegen eine Datenbank:** [](https://docs.squeeze.one/uploads/images/gallery/2020-03/image-1584115295926.png)