Daten-Import & -Export

Überblick

dForge hat eingebauten Import und Export auf Plattform-Ebene, verfügbar aus jeder Grid-Ansicht und jedem Bericht. Beide respektieren dieselbe Sicherheit wie direkte Abfragen — Anwender können nur importieren oder exportieren, was sie ohnehin sehen können.

Einige Details unten beschreiben geplantes Verhalten; das Import-/Export-Feature wird mit der Plattform weiterentwickelt.

Daten importieren

Import ist über die Toolbar jeder Grid-Ansicht verfügbar. Er legt Datensätze in der vom Grid angezeigten Entität an oder aktualisiert sie und respektiert den Ordner-Kontext — Defaults aus dem aktuellen Ordner werden automatisch auf neue Zeilen angewendet.

Workflow

1. Öffnen Sie eine Grid-Ansicht für die Entität, die Sie befüllen möchten
2. Klicken Sie in der Toolbar auf Importieren
3. Wählen Sie eine Excel- (.xlsx) oder CSV-Datei
4. Mappen Sie die Spalten der Datei auf Entitätsfelder
5. Sehen Sie sich die Daten und Validierungsergebnisse als Vorschau an
6. Bestätigen Sie den Import

Unterstützte Formate

Format	Hinweise
Excel (.xlsx)	Standardmäßig erstes Tabellenblatt; Kopfzeile als Spaltennamen verwendet
CSV (.csv)	Komma- oder semikolongetrennt; Kopfzeile als Spaltennamen verwendet

Spalten-Mapping

dForge mappt Datei-Spalten automatisch auf Entitätsfelder anhand der Namensähnlichkeit. Sie können:

• Mappings manuell neu zuweisen
• Spalten überspringen, die nicht importiert werden sollen
• Referenzfelder per Code oder Anzeigename auflösen (Lookup)
• Pflichtfeld-Mappings überschreiben

Import-Modi

Modus	Verhalten
Nur einfügen	Neue Datensätze anlegen; Zeilen, die einem bestehenden Datensatz entsprechen, überspringen
Nur aktualisieren	Bestehende Datensätze per Schlüssel aktualisieren; neue Zeilen überspringen
Upsert	Neue Zeilen einfügen und bestehende per Schlüssel aktualisieren

Für Update und Upsert wählen Sie, welches Feld bzw. welche Felder bestehende Datensätze identifizieren.

Validierung und Vorschau

Bevor irgendeine Zeile geschrieben wird, zeigt der Importer eine Vorschau mit Validierungsergebnissen:

• Pflichtfeld-Prüfungen
• Datentyp-Validierung
• Referenz-Lookup-Validierung (z. B. ein Ländercode, der nicht existiert)
• Eindeutigkeits-Constraint-Prüfungen
• Eigene Check-Constraints, die auf der Entität definiert sind

Sie können wählen, Zeilen mit Fehlern zu überspringen und nur die gültigen zu importieren — oder die Quelldatei korrigieren und es erneut versuchen. Importe laufen innerhalb einer Transaktion, sodass eine fehlgeschlagene Charge die Datenbank unverändert lässt.

Vorlagen

Häufig verwendete Mappings können als Import-Vorlagen gespeichert werden, sodass Sie nicht jedes Mal neu mappen müssen. Vorlagen können persönlich oder geteilt sein.

Daten exportieren

Export ist aus Grid-Ansichten und aus Berichten verfügbar. Der Export passiert nachdem die Daten geladen sind — er ist nicht Teil des Berichts-Parameter-Dialogs.

Aus Grid-Ansichten

1. Öffnen Sie eine Grid-Ansicht
2. Wenden Sie beliebige Filter und Sortierreihenfolgen an
3. Klicken Sie in der Toolbar auf Exportieren
4. Wählen Sie ein Format (Excel, CSV oder PDF)
5. Die Datei wird in Ihren Browser heruntergeladen

Die exportierte Datei enthält:

• Nur die sichtbaren Spalten der aktuellen Ansicht
• Den aktuellen Filter (Ordner + Ansicht + Anwenderfilter)
• Die aktuelle Sortierreihenfolge
• Alle passenden Datensätze — nicht nur die aktuelle Seite

Aus Berichten

1. Führen Sie den Bericht mit Ihren gewählten Parametern aus
2. Klicken Sie auf Exportieren
3. Wählen Sie ein Format und (optional) eine Vorlage
4. Die Datei wird heruntergeladen

Ein Berichts-Export enthält alle Datensätze. PDFs rendern Diagramme als Bilder; Excel-Exporte bewahren Datentypen und legen jeden Datensatz auf ein eigenes Tabellenblatt.

Unterstützte Formate

Format	Am besten für	Hinweise
Excel (.xlsx)	Analyse, Pivot-Tabellen	Bewahrt Datentypen; mehrere Tabellenblätter für Berichte mit mehreren Datensätzen
CSV (.csv)	Datenaustausch, Aufnahme durch andere Tools	Einzelner Datensatz, reiner Text
PDF (.pdf)	Drucken, Archivieren, formelle Berichte	Formatiertes Layout, enthält Diagramme

Vorlagen

PDF- und Excel-Exporte können Vorlagen verwenden, die Layout, Branding und Formatierung definieren:

• PDF-Vorlagen — Header/Footer, Logo, Seitenausrichtung, Spaltenbreiten, Diagramm-Platzierung
• Excel-Vorlagen — Kopfzeilen, Zahlenformate, Multi-Sheet-Layouts, bedingte Formatierung

Vorlagen können mit einem Modul ausgeliefert werden (sodass dieselbe Rechnung immer gleich gedruckt wird), von Mandanten-Admins definiert oder — irgendwann — pro Anwender gespeichert werden.

Sicherheit

Sowohl Import als auch Export respektieren den vollständigen Sicherheits-Stack:

• Der Anwender muss die für die Operation erforderlichen Entitätsrechte haben (S für Export, I/U für Import)
• Filter für Sicherheit auf Zeilenebene werden auf Exporte angewendet — Anwender können niemals Zeilen exportieren, die sie nicht sehen können
• Sicherheit auf Spaltenebene wird durchgesetzt — versteckte Spalten sind nicht in exportierten Dateien enthalten
• Importe durchlaufen dieselbe Validierung und Check-Constraints wie jeder andere Schreibvorgang

Es gibt keinen „Raw-Export“-Modus, der Sicherheit umgeht. Exporte sind genau das, was der Anwender ohnehin in der Oberfläche sehen könnte — nur in eine Datei verpackt.