Lokator: DB-Link-Locators

Der Lokator DB-Link-Lokator (Search for DB linked datadata) findet auf Basis weiterervon Lokatoren-Ergebnisse,konfigurierbaren EinträgeFiltermerkmalen inden Datenbanken.

Wert

Ein klassisches Beispielder für diedas Verwendungentsprechende diesesFeld Lokatorsvorgesehen istist. 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 DB-Link-Locators

Im folgenden gehen wir auf die beispielhafte Konfiguration eines Lokators ein, der zur Ermittlung von Kreditorennummern eingesetzt wird.

Der Lokator für die Suche nach Kreditorennummern mittels der Datenbank-Suche ist Bestandteil des ausgelieferten "Invoice Templates" und ist ein klassisches Beispiel für die Verwendung dieses Lokators bei Eingangsrechnungs-Erkennung.

Die Konfiguration wird analog zu allen anderen Lokatoren durchgeführt. Der Lokator Typ für diesenden Db-Link-Lokator ist "Search for DB linked data.data" und muss über das Auswahlfeld innerhalb der Lokatoren-Konfiguration im Tab "Allgemein" ausgewählt werden.

Wie man nun erkennt sind neben des Typen-Merkmals auch die weiteren allgemeinen Merkmale, entsprechend unseres Beispiels, eingepflegt 

Um nun die Datenbanksuche und die Filtermerkmale zu konfigurieren müssen wir den Tab "Datenbanksuche" öffnen und die Stammdaten-Tabelle sowie die Ausgabespalte definieren.

Unter dem Reiter Datenbanksuche wirdFür die Datenbank-SucheUmsetzung konfiguriert:des konkreten Beispiels werden wir hier als Stammdaten-Tabelle die "Liste aller Lieferanten"

Diesewählen Konfigurationund wirddie amAusgabespalte Beispielmit der"Nummer" Kreditor-Suchedefinieren. erläutert.Auf die  Konfigurationsmerkmale Filterspalte, Filterfeld und Filterlokator (ab Squeeze 2.5.0) gehen wir im Abschnitt Lokator-Filter weiter ein.

Im Unteren Abschnitt des Tabs "Datenbanksuche" können nun die ersten Filtermerkmale(Quell-Lokatoren), im Tabellenabschnitt, konfiguriert werden:

• 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.

• das LocatorFeld Feld"Quellen-Lokator" ist ein Auswahlfeld mit allen Lokatoren die konfiguriert sind
• das Feld "DB ColumnSpalte" gibt an in welcher Datenbankspalte das Lokatorergbnis in der Tabelle gesucht werden soll
• für das Feld Stop"Stop" kann entweder ja oder ja/nein ausgewähltgewählt werden.werden und bestimmt ob die weitere Suche nach einem eindeutigen Treffer fortgeführt werden soll, wenn ein Wert für das Filtermerkmal "Quellen-Lokator" gefunden wurde.

Eine weitere Verwendungsmöglichkeit diesesals Lokators ist die Plausibilisierung entsprechender Lokator-Ergebnisse gegen Datenbankeinträge.Datenbank-Plausibilisierung 

So könnte man zum Beispiel mittels:unter Verwendung anderer Lokatortypen wie: 

• regulärerRegex AusdrückeLokatoren
• KeyWordsKeyWord Lokatoren
• Value next to KeyWord-SucheKeyWord Lokatoren

folgende beispielhafteeindeutigen MerkmaleWerte auf dem Dokument ermitteln:

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

und dieseals dann gegen geeignete Datenbankinformationen plausibilisieren.

Dazu wird das Lokator - ErgebnisQuell-Lokatoren in derdem entsprechendenTabellenabschnitt Datenbanktabelledes gesuchtDB-Link undLokators 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.hinzufügen.

Beispiel für Datenbank-Plausibilisierung 

---

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

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

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

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(ab Squeeze 2.5.0 war dieses Feature ausschließlich nur über eine manuelle Anpassung in der Datenbank zu konfigurieren.

0)

AbDer DB-Link-Lokator bietet ab der Version 2.5.0 findetdrei sichneue unterFiltermerkmale um die Datenbankeinträge die zu Prüfen sind vorab einzugrenzen. Unter dem Tab "Datenbanksuche" können nun die drei neue Merkmale zur Filterung definiert werden. 

1. Filterspalte
   • die Datenbank Spalte die als Basis des Vergleichs herangezogen wird
2. Filterfeld
   • das Dokumentenklassen-Feld das verwendet werden soll, um auf die Filterpalte zu vergleichen
3. Filter-Lokator
   • ein bereitsbestehender Lokator der Administrationsoberflächeebenfalls fürverwendet Lokatorenwerden mitsoll, demum Typ "Search for db linked data"auf die Möglichkeit diese ParameterFilterspalte zu konfigurieren. 
     vergleichen

Folgendes Beispiel beschreibt die Formel für eine erfolgreiche Datensatz Identifizierung:

Filtermerkmal-Ergebnis	Filtermerkmal
A	Filterspalte
B	Filterfeld
C	Filter-Lokator

Formel:
Wahr wenn: A = B = C

DieAlle Mandantenspezifische-KreditorfilterungErgebnisse die dieser Formel entsprechen können nun durch die weiteren Quell-Lokatoren Filter validiert werden. Ein konkretes Beispiel wie man mit diesem Filter umgehen kann nurfinden gewährleistetSie werden für Lokatoren des Typs "Search for db linked data"hier.