Dokumente mit einer Dateivorlagen-Integration lesen
Zeigen Sie Transportial, wo Werte in einem Dokumentlayout stehen, etwa in einem Bestellformular, damit Dateien in diesem Layout automatisch gelesen werden.
Aktualisiert am 4. Oktober 2026
Viele Kunden senden Aufträge als PDF-, Word- oder Excel-Dateien, die immer gleich aussehen. Eine Dateivorlagen-Integration beschreibt dieses Layout einmal: welcher Wert wo steht und welches Transportial-Feld er füllt. Dateien im selben Layout können dann automatisch gelesen werden, zum Beispiel wenn Sie einen Auftrag aus einer Datei erstellen.
Bevor Sie beginnen
- Halten Sie eine Beispieldatei im gewünschten Layout bereit. Unterstützt werden unter anderem PDF, Word, Excel, CSV, XML und Bilder.
Die Vorlage erstellen
- Öffnen Sie das Seitenmenü (☰, oben rechts), wählen Sie Integrationen und klicken Sie auf + Integration erstellen.
- Geben Sie einen Name ein, zum Beispiel Kunde und Dokumentname.
- Wählen Sie unter Wählen Sie den Integrationstyp aus die Option Integration von Dateivorlagen. Das Fenster wird breiter.
- Wählen Sie unter Entität auswählen, was die Datei erstellt, meist einen Transportauftrag.
- Legen Sie Ihre Beispieldatei im Upload-Bereich ab oder klicken Sie darauf, um die Datei auszuwählen.
- Klicken Sie für jeden Wert, den Sie lesen möchten, auf + Feld hinzufügen.
- Richten Sie jedes Feld ein (siehe unten).
- Klicken Sie auf Zu testen und prüfen Sie das Ergebnis.
- Stellen Sie Aus/Ein auf Ein und klicken Sie auf Speichern.
Ein Feld einrichten
- Selektortyp auswählen: wie der Wert gefunden wird.
- HTML: Der Wert wird in der Textstruktur des Dokuments gefunden.
- Matrix: Der Wert steht an einer Position im Seitenraster.
- Position der Textvariablen: Der Wert wird relativ zu einer Beschriftung gefunden, zum Beispiel der Text rechts von „Lieferdatum“. Geben Sie mit Oben, Rechts, Unten und der Option für links an, wo.
- Selektor: wonach gesucht wird.
- JSON-Zuordnung: das Transportial-Feld, in das der Wert kommt.
- Feldtyp auswählen, Format und Regex: Daten und Zahlen korrekt lesen und einen Teil eines Texts herausgreifen.
Die Tabs Matrix und HTML neben den Feldern zeigen, wie Transportial Ihre Beispieldatei sieht, und heben hervor, was Ihre Selektoren finden. Nutzen Sie sie zur Feinabstimmung der Positionen. Schalten Sie den JSON-Modus ein, um alle Felder als Text zu bearbeiten.
Markieren Sie das Feld, das den Auftrag identifiziert (zum Beispiel die Auftragsnummer des Kunden), mit Identifikation, damit eine korrigierte Datei den Auftrag aktualisiert, statt einen zweiten anzulegen.
Die Vorlage verwenden
Wenn Sie einen Auftrag aus einer Datei erstellen, füllt Transportial den Auftrag anhand Ihrer Vorlage aus. Siehe Einen Transportauftrag aus einer Datei importieren.