# Dokumenten- und Tabellenfelder

#### Allgemeines

**Dokumentenfelder werden in Squeeze für unterschiedliche Funktionen benötigt:**

- Informationen aus der Extraktion aufnehmen
- Für die Dokumentensuche indiziert werden
- Informationen aus der Extraktion im Validierungsclient darstellen
- Validierte Extraktionsergebnisse in den Exportschnittstellen bereitstellen

**Felder und Tabellen sind als Teil einer Dokumentenklasse zu konfigurieren:**

[![image-1667925377844.png](https://docs.squeeze.one/uploads/images/gallery/2022-11/scaled-1680-/image-1667925377844.png)](https://docs.squeeze.one/uploads/images/gallery/2022-11/image-1667925377844.png)

##### Allgemeine Konfiguration

<table border="1" id="bkmrk-name-technischer-fel"><thead><tr><td>Feld-Konfiguration</td><td>Bedeutung</td></tr></thead><tbody><tr><td>Name</td><td>technischer Feldname</td></tr><tr><td>Beschreibung</td><td>Name des Feldes, welcher auf Kopfebene angezeigt wird</td></tr><tr><td>Lokator</td><td>Auswahlfeld für bereits konfigurierte Lokatoren, die dem Feld zugewiesen werden können</td></tr><tr><td>Subfield</td><td>relevant für die Endbeträge bei Eingangsrechnungen (NetAmount, TaxAmount, TotalAmount, TaxRate)</td></tr><tr><td>Gruppe</td><td>Auswahlfeld mit den Gruppen dieser Dokumentenklasse (Feldgruppen -&gt; Groups)</td></tr><tr><td>Name im Zielsystem</td><td>Technischer Name für die Exportschnittstelle für dieses Feld. Wird nicht durch alle Export-Schnittstellen berücksichtigt.</td></tr></tbody></table>

##### Feldtypen

In Squeeze werden verschiedene Arten von Feldern verarbeitet. Diese Feldtypen haben Einfluss auf die Anzeige in der UI und ggf. die Extraktion sowie das Handling bei Export-Schnittstellen.

<table border="1" id="bkmrk-text-date-amount-tab" style="width: 801px; height: 144px;"><thead><tr style="height: 29px;"><td style="width: 71px; height: 29px;">Feld-Typ</td><td style="width: 730px; height: 29px;">Bedeutung</td></tr></thead><tbody><tr style="height: 29px;"><td style="width: 71px; height: 29px;">Text</td><td style="width: 730px; height: 29px;">Textfeld das z.B. für Belegnummern, Vorgangsarten oder Mandanten verwendet werden kann.</td></tr><tr style="height: 29px;"><td style="width: 71px; height: 28px;">Date</td><td style="width: 730px; height: 28px;">Datumsfeld das z.B. für das Belegdatum oder das Leistungsdatum verwendet wird.</td></tr><tr style="height: 29px;"><td style="width: 71px; height: 29px;">Amount</td><td style="width: 730px; height: 29px;">Betragsfeld (numerisch, 2 Nachkommastellen. Wird z.B. für Netto, Steuer und Brutto verwendet.</td></tr><tr style="height: 29px;"><td style="width: 71px; height: 29px;">Table</td><td style="width: 730px; height: 29px;">Tabellenfeld (Wurde nur in der v1 UI so dargestellt. In der neuen UI werden Tabellen seperat behandelt und daher ist dieser Typ nicht auswählbar.)

</td></tr></tbody></table>

<p class="callout info">Datum- und Betragsfelder bringen in der Praxis komplexe Formatierungs- &amp; Lokalisierungs-Anforderungen mit sich.</p>

#####  

#### Feldtypen bedingte Funktionalitäten

Die Feld-Typen bedingten Funktionalitäten greifen, wie der Name schon sagt, nur wenn der zugehörige Feld-Typ ausgewählt wurde. Dabei werden in der Konfigurations-Oberfläche, je nach Feld-Typ, die bestimmten zugehörigen Eingabe-Elemente angezeigt oder ausgeblendet.   
  
Folgende Funktionalitäten werden Feld-Typen bedingt bereitgestellt:

<table border="1" id="bkmrk-feld-typ%C2%A0-version-be" style="width: 803px; height: 58px;"><thead><tr style="height: 29px;"><td style="width: 71px; height: 29px;">Feld-Typ </td><td style="width: 70px; height: 29px;">Version</td><td style="width: 662px; height: 29px;">Bedeutung</td></tr></thead><tbody><tr style="height: 29px;"><td style="width: 71px; height: 29px;">Text</td><td style="width: 70px; height: 29px;">&gt;=2.6.x</td><td style="width: 662px; height: 29px;">Feld-Längenbegrenzung mit Abschneide-Funktion:  
- nicht abschneiden
- Anfang abschneiden
- Ende abschneiden

</td></tr><tr><td style="width: 71px;">Betrag</td><td style="width: 70px;">&gt;=2.6.x</td><td style="width: 662px;">[Betragsformatierung für Anzeige-Werte innerhalb der Dokument-Validierungsoberfläche:](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/features-verwalten "Features verwalten")

- Tausendseperator
- Dezimalseperator
- Nachkommastellen

</td></tr></tbody></table>

#### <span style="text-decoration: underline;">**Feld-Längenbegrenzung:**</span>

Die Feld-Längenbegrenzung lässt sich für Tabellen-Felder als auch für die Dokumenten-Felder konfigurieren. Dabei erweitert sich die Eingabe-Oberfläche, wenn der Daten-Typ "Text" ausgewählt wird.

[![image-1705313861736.png](https://docs.squeeze.one/uploads/images/gallery/2024-01/scaled-1680-/image-1705313861736.png)](https://docs.squeeze.one/uploads/images/gallery/2024-01/image-1705313861736.png)

Wählt man den Date-Typen "Text" kann man:

- die Feldlänge bearbeiten   
    
    1. Standardwert = 0 (keine Feld-Längenbegrenzung)
- den Inhalt abschneiden lassen auf die gewünschte Feldlänge 
    1. Nicht abschneiden 
        - Feldlänge wird nicht abgeschnitten, jedoch wird das Feld in der Validierung als fehlerhaft mit einem entsprechendem Hinweis bzgl. der Feldlänge versehen.
    2. Feldanfang abschneiden 
        - Feldlänge wird vom Anfang auf die gewünschte Feldlänge abgeschnitten.
    3. Feldende abschneiden 
        - Feldlänge wird vom Ende auf die gewünschte Feldlänge abgeschnitten

[![image-1705314957653.png](https://docs.squeeze.one/uploads/images/gallery/2024-01/scaled-1680-/image-1705314957653.png)](https://docs.squeeze.one/uploads/images/gallery/2024-01/image-1705314957653.png)

#### <span style="text-decoration: underline;">**Betragsformatierung:**</span>

Die Betragsformatierung gilt für Kopffelder und Tabellenfelder und kann innerhalb der Feld-Konfiguration konfiguriert werden. Sobald der Feld-Typ auf Betrag steht wird ein neuer Tab "Darstellung" eingeblendet. In diesem Tab lassen sich dann alle Konfigurationen konfigurieren:

[![image-1708004976680.png](https://docs.squeeze.one/uploads/images/gallery/2024-02/scaled-1680-/image-1708004976680.png)](https://docs.squeeze.one/uploads/images/gallery/2024-02/image-1708004976680.png)

<p class="callout info">Wenn kein Format angegeben wurde, dann wird immer wie bisher auch das Deutsche-Format(Standard) Tausendertrennzeichen(".") und Dezimalstellentrennzeichen(",") mit zwei Nachkommastellen verwendet.</p>

<p class="callout warning">Die Formatierungsoptionen Tausendertrennzeichen und Dezimaltrennzeichen sind ausschließlich Optionen für die Anzeige. Die Daten werden von der Anwendung trotzdem immer im Standard-Format (Deutsch) gespeichert  
  
Nachkommastellen werden jedoch übernommen. Dies bedeutet, dass nach dem Validieren die Dezimalstellen erhalten bleiben aber die Trennzeichen wieder, wie im Standardformat erhalten bleiben. </p>

##### Validierungsspezifische Eigenschaften

Diese Einstellungen steuern, wie sich ein Feld in der Validierung verhält.

<table border="1" id="bkmrk-pflichtfeld-leere-fe" style="height: 179px;"><thead><tr style="height: 46px;"><td style="height: 46px; width: 118.483px;">Feld-Eigenschaft</td><td style="height: 46px; width: 690.75px;">Bedeutung</td></tr></thead><tbody><tr style="height: 46px;"><td style="height: 46px; width: 118.483px;">Pflichtfeld</td><td style="height: 46px; width: 690.75px;">leere Felder werden im Webclient rot dargestellt, die Validierung ist nicht möglich solange das Feld nicht gefüllt ist</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 118.483px;">Nur Lesen</td><td style="height: 29px; width: 690.75px;">Im Webclient kann das Feld nicht bearbeitet werden, Lokatoren können das Feld im Hintergrund füllen</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 118.483px;">Versteckt</td><td style="height: 29px; width: 690.75px;">das Feld wird im Webclient nicht dargestellt</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 118.483px;">Bestätigen</td><td style="height: 29px; width: 690.75px;">das Feld wird im Webclient blau dargestellt und muss vor der Validierung mit Enter bestätigt werden</td></tr></tbody></table>

#### **Tabellenfelder (kurz "Tabellen")** 

Für Tabellenfelder, in der UI nur als "Tabellen" bezeichnet, gelten die selben Kriterien, die auch für Dokumentenfelder gelten. Mit einer Ausnahme:

[![image-1654268333787.png](https://docs.squeeze.one/uploads/images/gallery/2022-06/scaled-1680-/image-1654268333787.png)](https://docs.squeeze.one/uploads/images/gallery/2022-06/image-1654268333787.png)

Für die Tabellenfelder ist es wichtig, dass sowohl ein Überschrift- als auch ein Wert-Lokator definiert werden. Mit Hilfe des Überschrift-Lokators wird die Spalte definiert in der per Wert-Lokator, wie im oberen Beispiel, der zu suchende Wert pro Zeile ausgelesen wird.

#### Eingabehilfen

##### Konfiguration

Eingabehilfen auf Feldern oder Tabellenspalten untersützen Validierer beim Auswählen von vordefinierten Werten auf Basis von Stammdatentabellen.

[![image-1667925495049.png](https://docs.squeeze.one/uploads/images/gallery/2022-11/scaled-1680-/image-1667925495049.png)](https://docs.squeeze.one/uploads/images/gallery/2022-11/image-1667925495049.png)

<table border="1" id="bkmrk-feld-konfiguration-b" style="height: 329px;"><thead><tr style="height: 29px;"><td style="height: 29px; width: 329px;">Feld-Konfiguration</td><td style="height: 29px; width: 479px;">Bedeutung</td></tr></thead><tbody><tr style="height: 29px;"><td style="height: 29px; width: 329px;">Aktiv?</td><td style="height: 29px; width: 479px;">Hier kann ausgewählt werden, ob die Eingabehilfe aktiviert oder deaktiviert werden soll</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 329px;">Freitext erlauben?</td><td style="height: 29px; width: 479px;">Wenn Freitext erlauben aktiviert ist, dann können auch Werte in dem Feld eingetragen werden, die nicht in der Datenbank stehen.</td></tr><tr style="height: 46px;"><td style="height: 46px; width: 329px;">Suche ab Zeichen</td><td style="height: 46px; width: 479px;">Hier kann eingetragen werden, ab welcher Anzahl an Zeichen gesucht werden soll.</td></tr><tr style="height: 46px;"><td style="height: 46px; width: 329px;">Tabelle</td><td style="height: 46px; width: 479px;">Hier kann ausgewählt werden, welche Stammdatentabelle als Grundlage für eine Suche dienen soll.</td></tr><tr style="height: 46px;"><td style="height: 46px; width: 329px;">Ergebnisspalte</td><td style="height: 46px; width: 479px;">Hier kann angegeben werden, aus welcher Spalte der Stammdatentabelle das Ergebnis ausgegeben werden soll. </td></tr><tr style="height: 29px;"><td style="height: 29px; width: 329px;">Suche in Spalte(n)</td><td style="height: 29px; width: 479px;">Hier wird angegeben in welchen Datenbankspalten der eingegebene Wert gesucht werden soll.</td></tr><tr style="height: 29px;"><td style="height: 29px; width: 329px;">Informationsspalten</td><td style="height: 29px; width: 479px;">Sollten ein oder mehrere Treffer gefunden werden, wird hier angegeben welche Spalteninformationen zur Anzeige der Treffer verwendet werden sollen.</td></tr><tr><td style="width: 329px;">Eingabewert ignorieren</td><td style="width: 479px;">Falls aktiv, wird bei der Eingabehilfe der aktuelle Feldwert ignoriert. Das führt dazu, dass mehr Ergebnisse angezeigt werden.</td></tr><tr><td style="width: 329px;">Max. Anzahl Suchergebnisse</td><td style="width: 479px;">Steuert, wie viele Ergebnisse gesucht und angezeigt werden sollen.</td></tr><tr style="height: 46px;"><td style="height: 46px; width: 329px;">Zusätzliche Filter, um die Ergebnisse der Eingabehilfe einzuschränken</td><td style="height: 46px; width: 479px;">s. unten</td></tr></tbody></table>

**Die Ergebnisse der Eingabehilfe können mit weiteren zur Verfügung stehenden Kopffeldern gefiltert werden. Filter anlegen.:**

<table border="1" id="bkmrk-tabellenspalte-hier-" style="border-collapse: collapse; width: 100%; height: 116px;"><tbody><tr style="height: 29px;"><td style="width: 17.1606%; height: 29px;">Tabellenspalte</td><td style="width: 82.8394%; height: 29px;">Hier wird die Tabellenspalte angegeben, mit der der Feldwert verglichen werden soll.</td></tr><tr style="height: 29px;"><td style="width: 17.1606%; height: 29px;">Operant</td><td style="width: 82.8394%; height: 29px;">Hier wird der Operator angegeben mit dessen Hilfe der Datenbankwert und Feldwert verglichen werden sollen.</td></tr><tr style="height: 29px;"><td style="width: 17.1606%; height: 29px;">Feld</td><td style="width: 82.8394%; height: 29px;">Hier wird das Fed ausgewählt in dem der Wert steht, der mit dem Datenbankwert verglichen werden soll.</td></tr></tbody></table>

##### Verhalten

<p class="callout info">Die Eingabehilfe wird beeinflusst durch den aktuellen Feldwerte. Auch die Extraktions-Alternativen werden bei der Eingabehilfe berücksichtigt.</p>

<p class="callout warning">Die Dokumentation der Eingabehilfe ist noch nicht vollständig, da ihre Funktion aktiv erweitert wird. Wir bitten diese Dokumentation zukünftig erneut aufzusuchen und um Feedback.</p>

1. Wenn das Feld ein **vor erkannten Wert** durch die Extraktion erhalten **(gilt auch für Alternativen)** hat und das Feld aber durch den Nutzer geleert wurde um eine listen artige Selektion der Stammdaten-Werte zu erzeugen 
    - dann wird die Eingabehilfe dennoch durch den **vor erkannten Wert gefiltert** (<span style="text-decoration: underline;">auch wenn das Feld geleert wurde)</span>, das bedeutet das man nie ein anderes Ergebnis erhält bis man den ersten Buchstaben in das Feld eintippt.