Eigene Expressions in docform definieren

Expressions sind definierte RegEx, um bestimmte Muster zu erkennen.

Sie können sie in der MetaDb hinterlegen und dann automatisiert verwenden, wenn Sie eine Expression im docform-Training benötigen.
Das System verwendet immer die am besten passende Expression auf den ausgewählten Text.
Das Modul agorum core docform positions nutzt Expressions häufig bei der Positionserkennung, da es dort meistens um die Erkennung von Mustern geht.
Das meistverwendete Muster ist 2 Dezimalzahlen nebeneinander.

Mitgelieferte Expressions

Achtung: Datenverlust durch Änderung der mitgelieferten Expressions. Bei Updates werden Ihre Änderungen an den mitgelieferten Expressions überschrieben. Ändern Sie die mitgelieferten Expressions daher nicht ab, sondern definieren Sie eigene Expressions.

So finden Sie die mitgelieferten Expressions:

Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.

Öffnen Sie den Pfad:

MAIN_MODUL_MANAGEMENT/docform/control/Expressions

Mitgelieferte Expression	Text	Value
Integer	Ganzzahl	`(?<=(^\|\s))\d+(?=(\s\|$))`
Datum (dd.MM.yyyy)	Datum - dd.MM.yyyy	`\d\d[,\.]\d\d[,\.]\d\d\d\d`
2 Dezimalzahlen (2 Nachkommastellen)	2 Dezimalzahlen (2 Nachkommastellen)	`-?[,\.\d]\d[,\.]\d{2}\s-?[,\.\d]\d[,\.]\d{2}(?!\d)`
Dezimalzahl (1 Nachkommastelle)	Dezimalzahl (1 Nachkommastelle)	`-?[,\.\d]*\d[,\.]\d(?!\d)`
Dezimalzahl (2 Nachkommastellen	Dezimalzahl (2 Nachkommastellen)	`-?[,\.\d]*\d[,\.]\d{2}(?!\d)`
Dezimalzahl (3 Nachkommastellen)	Dezimalzahl (3 Nachkommastellen)	`-?[,\.\d]*\d[,\.]\d{3}(?!\d)`
Dezimalzahl	Ganzzahl	`-?[,\.\d]*\d[,\.]\d+(?!\d)`

Eine eigene Expression definieren

Legen Sie eigene Expressionen an, um Ihre Benutzer zu unterstützen.

Öffnen Sie links in der Seitenleiste Administration und dann MetaDB.

Öffnen Sie den Pfad:

MAIN_MODUL_MANAGEMENT/docform/control/Expressions

Kopieren Sie eine bestehende Expression, etwa 10 Integer, und fügen Sie diese in dieselbe Ebene ein.
Nennen Sie das kopierte Property-Bundle entsprechend Ihrer Expression um.
Überarbeiten Sie die darin liegenden Property-Entrys:

Text
Definiert den displayName (Anzeigenamen) für die Benutzer in der docform-Bedienoberfläche.

Value
Definiert die Regular Expression (RegExp).
Laden Sie docform mit der Taste F5 neu.

Tipp: Überführen Sie den MetaDB-Eintrag in die export.yml-Datei, wenn Sie ihr eigenes Konfigurationsprojekt bearbeiten.

Die Reihenfolge bestimmen

Das System arbeitet die Property-Bundles von oben nach unten ab.
Mit entsprechender Nummerierung beeinflussen Sie die Reihenfolge.
Eine gute Sortierung sorgt für eine bessere automatische Auswahl.
Führen Sie komplexere Expressions oben auf, damit das System diese als Erstes abgleichen kann.

Fortlaufende Nummerierung

Wenn Sie Probleme mit Expressions haben

Eigene Expressions erscheinen nicht

Beschreibung des Problems

Eigene Expressions fehlen im docform-Training, obwohl sie in der MetaDB vorhanden sind.

Ursache

Eigene (Test-) Expressions wurden erstellt, aber einer der beiden Property-Entrys Text oder Value wurde nicht angepasst.

Lösung

Stellen Sie sicher, dass Ihre Property-Entrys Test und Value einzigartig sind.