# Dokumentenklassen

Konfigurations-Anleitungen im Kontext von Dokumentenklassen.

# Dokumentenklassen

#### Einführung

Dokumentenklassen beschreiben jeweils einen spezifischen Dokumententyp.

Innerhalb einer Dokumentenklasse können für den jeweiligen Dokumententyp, spezifische Konfigurationen angelegt werden:

**1. Felder und Tabellen**

- Lieferantennummer
- Lieferanten-Name
- Bestellnummer
- ID im ERP
- ...

**2. Feldgruppen (auf getrennten Reitern befindliche Felder)**

- Kopfdaten
- Metadaten
- ...

**3. Verlinkung zu Lokatoren (Wie werden Werte für ein Feld gefunden?)**

- reguläre Ausdrücke
- Datenbank-Link,
- Key-Value
- ...

**4. Export-Schnittstellen (Wie werden validierte Dokumente in das Folgesystem gebracht?)**

- Documents Soap
- XML-Datei
- Webservice
- ...

**5. Eigenschaften (allgemeine Konfigurationen für eine Dokumentenklasse)**

Alle möglichen Eigenschaften sind unter der Dokumentationseite der [Stapelklassen-Eigenschaften](https://docs.squeeze.one/books/squeeze-2-admin-handbuch/page/stapelklassen-eigenschaften) aufgelistet.

<p class="callout info">Die Eigenschaften an einer Dokumentenklasse überschreiben die Eigenschaften an einer Stapelklasse.</p>

#### Dokumentenklasse anlegen

Dokumentenklassen können mit einem Klick auf den Reiter Dokumentenklassen konfiguriert werden

[![image-1648136421456.de - Outlook.png](https://docs.squeeze.one/uploads/images/gallery/2022-03/scaled-1680-/image-1648136421456-de-outlook.png)](https://docs.squeeze.one/uploads/images/gallery/2022-03/image-1648136421456-de-outlook.png)

Die Invoice Dokumentenklasse wird mit dem Invoice Template ausgeliefert.

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

Mit dem + Symbol können neuen Dokumentenklassen angelegt werden. Hier wird der technische Name und die Beschreibung der Dokumentenklasse gefüllt.

Mit einem Klick auf den Eintrag in der Liste öffnet sich der Konfigurationsdialog für die Dokumentenklasse.

[![Bildschirmfoto 2024-10-17 um 08.35.56.png](https://docs.squeeze.one/uploads/images/gallery/2024-10/scaled-1680-/bildschirmfoto-2024-10-17-um-08-35-56.png)](https://docs.squeeze.one/uploads/images/gallery/2024-10/bildschirmfoto-2024-10-17-um-08-35-56.png)

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