Tabellenkalkulation Konnektor
Der Tabellenkalkulation Konnektor ermöglicht die Erstellung, Befüllung und Ausgabe von Tabellen auf Basis von Vorlagen.
Das Verfahren ähnelt einem Seriendruck, bei dem Daten in eine vorbereitete Vorlage eingefügt werden.
Das Ergebnis kann als Tabellenkalkulationsdatei oder als PDF-Dokument ausgegeben und weiterverarbeitet werden.
Neben einzelnen Feldern können auch geschachtelte Listen, HTML-Inhalte und Bilder verarbeitet werden.
Die Funktion wird über spezielle Sync-Typen gesteuert, die Konfiguration und Ablauf unterstützen.
Darüber hinaus kann die Verarbeitung auch direkt über die Syncler API gestartet werden.
Schemaobjekt
Der Konnektor erstellt ein einziges Schemaobjekt SpreadsheetFile, das sowohl für die Konfiguration als auch für das Ergebnis verwendet wird.
Dadurch kann pro Datensatz eine individuelle Konfiguration erfolgen.
Das Schema enthält generische Nutzfelder, die während der Ausführung zugewiesen und in nachfolgenden Syncs weiterverarbeitet werden können.
Die eigentlichen Daten werden dynamisch über die Syncs bereitgestellt.
Lesen von Schema-basierten Daten
- Der Konnektor liest ausschließlich Datensätze aus dem Datensatz-Speicher.
- Nach einer erfolgreichen Verarbeitung werden Ergebnisse im Datensatz-Speicher zwischengespeichert.
- Nachfolgende Syncs können diese Datensätze lesen und weiterverarbeiten.
- Sobald alle Nachfolger abgeschlossen sind, werden die Datensätze automatisch gelöscht.
Schreiben von Daten
Das Schreiben startet die eigentliche Verarbeitung der Vorlage.
Die Vorlage wird geladen, mit den bereitgestellten Daten befüllt und anschließend gemäß Konfiguration gespeichert oder direkt zurückgegeben.
Einstellungen
Folgende Einstellungen stehen für den Tabellenkalkulation Konnektor zur Verfügung:
| Einstellung | Beschreibung |
|---|---|
| FTP Quellverzeichnis | Verzeichnis für Vorlagen, die per FTP eingelesen werden sollen. |
| FTP Zielverzeichnis | Verzeichnis, in dem Ergebnisse gespeichert werden sollen. |
| FTP Verzeichnis für Schriftarten | Optionales Verzeichnis für Schriftarten beim PDF-Druck. Wenn die in der Vorlage verwendete Schriftart nicht vorhanden ist, kann sie hier bereitgestellt werden. |
| Schriftarten löschen | Löscht temporär gespeicherte Schriftarten nach erfolgreicher Verarbeitung. |
| FTP Server | Serveradresse des FTPs. |
| FTP Port | Kommunikationsport des FTP-Servers. |
| FTP Benutzername | Benutzername für den FTP-Zugriff. |
| FTP Passwort | Passwort für den FTP-Zugriff. |
| SFTP verwenden | Aktiviert die sichere Dateiübertragung über SFTP. |
| FTPS verwenden | Aktiviert die sichere Dateiübertragung über FTPS (wenn SFTP deaktiviert ist). |
| Erweitertes Protokoll | Aktiviert detaillierte Protokollierung für Fehleranalyse und Nachvollziehbarkeit. |
Besonderheiten
Unterstützte Eingabeformate
- XLS, XLSX, CSV, HTML, ODS
Vorlagen können über folgende Quellen geladen werden:
- Lokaler Pfad (nur On-Premises)
- Base64-Daten
- Vorlagendatenbank
- URL
- FTP-Server
Unterstützte Ausgabeformate
- XLS, XLSX, CSV, HTML, Image, ODS, XPS, PDF
Ergebnisse können:
- lokal gespeichert (nur On-Premises),
- auf einem FTP abgelegt,
- als Base64-Daten direkt zurückgegeben oder
- im Datensatz-Speicher abgelegt werden.
Hinweis: Nicht alle Funktionen sind mit jedem Ein- oder Ausgabeformat kombinierbar.
Seriendruck-Felder
Felder werden in der Vorlage mit der #..#-Notation definiert.
Diese werden beim Ausführen des Konnektors in allen Tabellenblättern ersetzt.
Beispiel:
#Kundenname#
#Rechnungsnummer#
#Datum#
HTML-Inhalte
Wenn ein Feldnamen-Präfix Html: verwendet wird, interpretiert der Konnektor den Feldinhalt als HTML.
Formatierungen (z. B. Fett, Kursiv, Farben, Tabellen) werden automatisch übernommen.
Bilder
Bilder werden über das Präfix Picture: eingebunden.
Der Feldinhalt gibt an, woher das Bild stammt.
Die Skalierung erfolgt entsprechend der Zellgröße in der Vorlage.
Bilder können über verschiedene Methoden eingebunden werden:
| Methode | Beschreibung |
|---|---|
| PATH | Pfad zu einer Datei |
| BASE64 | Base64-kodierte Bilddaten |
| URL | Webadresse einer Grafikdatei |
| DATABASE | Referenz auf eine Datei in der Vorlagendatenbank |
Die Definition kann in JSON angegeben werden. Wird kein gültiges JSON erkannt, interpretiert der Konnektor den Wert als einfache URL.
Beispiel:
{
"FileMethod": "URL",
"File": "https://example.com/logo.png"
}
Unterstützte Formate: JPG, BMP, GIF, PNG, TIFF, WMF
Geschachtelte Listen
Die Verarbeitung geschachtelter Listen erfolgt über spezielle Platzhalter in der Vorlage:
#RangeStart:Position#
#RangeEnd:Position#
- Alle Zeilen zwischen diesen Platzhaltern werden kopiert und für jeden Listeneintrag ausgefüllt.
- Formatierungen der Vorlage bleiben vollständig erhalten.
- Die Platzhalter selbst werden nach der Verarbeitung entfernt.
Wenn eine Transformation neue Felder erzeugt, werden diese automatisch in das Listenelement übernommen.
PDF-Druck
Beim PDF-Druck wird das Seitenlayout der Excel-Vorlage übernommen.
Der Druck umfasst alle Tabellenblätter der Vorlage.
Optional können eigene Schriftarten eingebunden werden, falls die Standards nicht ausreichen.