Workflows

Daten importieren und exportieren

Nutze gemeinsame Importe und Exporte auf unterstützten Listenansichten sowie spezialisierte Kontakt-, Banktransaktions- und Buchhaltungsworkflows.

Daten importieren und exportieren

Einblick verwendet über die meisten unterstützten Listenansichten hinweg einen gemeinsamen Import-/Export-Ablauf. Export und Import greifen auf dieselbe Feldregistrierung zurück. Dadurch basieren Feldauswahl, übersetzte Bezeichnungen, Auto-Mapping und Validierung auf derselben Definition der jeweiligen Entität.

Kontakte verwenden über dieselbe Aktion Importieren einen spezialisierten Verzeichnisimport, weil Adressbücher Matching, Organisationsverknüpfungen und vCard-Unterstützung brauchen. Banktransaktionen nutzen einen separaten OFX-/CSV-Import, weil Bankdateien Kontoabgleich, Abstimmung und Deduplizierung statt der gemeinsamen Feldregistrierung brauchen. Buchhaltungsexporte nutzen einen eigenen Finanz-Workflow, weil Übergabepakete aus Journalbuchungen, Steuercode-Mappings, Partnernummern und Quelldokumenten entstehen statt aus Listenfeldern.

Wo du den Ablauf findest

Auf unterstützten Listenansichten verwendest du die Header-Aktionen Export und Importieren.
Import ist aktuell verfügbar in Abwesenheiten, Gebäude, Kontakte, Equipment, Events, Festivals, Materialien, Organisationen, Berichte, Aufgaben, Werkzeuge, Fahrzeuge und Arbeitszeiten.
Export ist darüber hinaus auf weiteren Listenansichten verfügbar, die die gemeinsamen Data Views nutzen, etwa Projekte, Anfragen, Angebote, Rechnungen, Eingangsrechnungen und Aufträge.
Die Kontakt-Importaktion öffnet den Verzeichnisimport statt des generischen Spaltenzuordnungs-Sheets.
Banktransaktionen bietet Datei importieren für OFX- und CSV-Bankexporte. Dieser Ablauf zeigt vor dem Schreiben neue, aktualisierte, doppelte und übersprungene Transaktionen und kann ein manuelles Bankkonto anlegen, wenn die eigene IBAN neu ist.
Accounting Exports ist ein spezialisierter Finanzexport. Der Ablauf zeigt eine Periode in der Vorschau, prüft Journalbuchungen, erzeugt einen unveränderlichen Snapshot und hält ZIP- sowie Manifest-Downloads für die Übergabe bereit.

Export-Ablauf

Öffne Export auf einer unterstützten Listenansicht.
Wähle das Exportformat: CSV, XLSX oder JSON.
Wähle den Exportmodus:
- Lesbar: übersetzte Überschriften, formatierte Datumswerte und Anzeigenamen
- Daten: rohe Feldschlüssel, rohe Enum-Werte, rohe gespeicherte Datumswerte und Relations-IDs zur Wiederverwendung im Import
Passe Filter, Felder, Feldreihenfolge, verknüpfte Daten und Sortierung an.
Starte den Export und lade die erzeugte Datei herunter.

Das Export-Sheet startet immer mit den aktuellen Tabellenfiltern. So kannst du entweder die ganze Liste oder nur die gerade sichtbare Teilmenge exportieren. Facettenfilter und Datumsbereiche lassen sich vor dem Export anpassen; Datumsbereiche verwenden inklusive Von-/Bis-Tage. In gemeinsamen Data Views mit Archivstatus sind archivierte Zeilen standardmäßig ausgeblendet. Aktiviere vor dem Export den Archiv-Schalter in der Tabellen-Toolbar, wenn die Datei archivierte Datensätze enthalten soll.

Buchhaltungsexport-Ablauf

Accounting Exports ist vom gemeinsamen Listenexport getrennt.

Provider, Kontenrahmen, Steuercode-Mappings, Dokumentbeilagen und Partnernummern konfigurierst du unter Workspace-Einstellungen -> Accounting.
Unter Accounting Exports wählst du einen Monat und prüfst Zeilenanzahl, Warnungen, blockierende Probleme und Beispielbuchungen, bevor du ein Paket erzeugst.
Journalbuchungen können aus bezahlten Ausgangsrechnungen, bezahlten Eingangsrechnungen, aktiven Finanzbuchungen, kategorisierten Banktransaktionen sowie synchronisierten Stripe-Balance-Transaktionen oder Payouts stammen.
Blockierende Probleme müssen vor der BMD-Paketgenerierung gelöst werden. Die Problemaktionen öffnen nach Möglichkeit Steuermappings, Partnernummern oder den Quelldatensatz.
Erzeugte Exporte behalten Laufnummer, Zeitraum, Warnungsanzahl, ZIP-Download, Manifest-Download und eine Mark sent-Aktion.
Provider-Einstellungen können für mehrere Provider vorbereitet werden, die ZIP-Paketgenerierung ist derzeit aber nur für BMD verdrahtet.

Formate und Modi

CSV ist immer ein flacher Single-Table-Export. Datenmodus ist für CSV nicht verfügbar.
XLSX unterstützt sowohl lesbare als auch Daten-Exporte.
JSON unterstützt sowohl lesbare als auch Daten-Exporte.
Im Modus Lesbar wirkt sich die optionale Übersetzung der Überschriften auf CSV und XLSX aus.
Im Modus Daten sind übersetzte Überschriften aus und CSV ist deaktiviert.
Lesbares JSON ohne verknüpfte Daten wird als einfaches Array exportiert. Wenn verknüpfte Daten eingeschlossen sind, wird der JSON-Export zu einem { data, relatedData }-Objekt.
JSON im Datenmodus ergänzt zusätzlich einen _einblick-Block, damit der Import die Datei als Einblick-Export erkennen kann.

Exporte mit verknüpften Daten

Verknüpfte Daten stehen aktuell für diese Parent-Tabellen bereit:

invoices → invoicePositions
quotes → quotePositions
workOrders → workOrderPositions
organizations → organizationsContacts, organizationsBankDetails
festivals → festivalDays

So wird die Ausgabe aufgebaut:

In XLSX landen die Hauptdatensätze im ersten Blatt und jede verknüpfte Tabelle in einem zusätzlichen Blatt.
In JSON werden verknüpfte Zeilen in einem separaten relatedData-Objekt abgelegt, das nach Tabellennamen gruppiert ist.
Im Modus Lesbar sind verknüpfte Daten optional.
Im Modus Daten werden verknüpfte Daten automatisch eingeschlossen, wenn die Parent-Tabelle sie unterstützt.

Import-Ablauf

Dies ist der generische Ablauf für die meisten importfähigen Seiten.

Öffne Importieren auf einer unterstützten Listenansicht.
Lade eine CSV-, XLSX-, XLS- oder JSON-Datei hoch.
Wenn die Datei mehrere Blätter hat, wähle das Blatt aus, das du importieren willst.
Prüfe die Spaltenzuordnung.
Führe einen Testlauf aus, um zu sehen, wie viele Datensätze erstellt würden und welche Zeilen fehlschlagen.
Starte den Import und beobachte den Fortschritt im selben Sheet.

Laufende Importe verarbeiten Zeilen in Batches und zeigen erstellte sowie fehlgeschlagene Zeilen. Import abbrechen stoppt die verbleibenden Batches, bereits erstellte Zeilen bleiben aber bestehen.

Aktuelle Limits im Client-Parser:

maximale Dateigröße: 10 MB
maximale Zeilen pro Datei: 50.000

Kontakt-Verzeichnisimporte

Die Kontakt-Importaktion ist für Adressbücher optimiert, nicht für generische Tabellen-Reimporte.

Unterstützte Quellen sind der System-Kontaktpicker des Browsers, wenn verfügbar, sowie .vcf / .vcard, CSV, XLSX, XLS und JSON.
Einblick normalisiert gängige Kontakt-Header, vCard-Felder und Browser-Kontaktfelder zu Kontakt- und Organisationsdaten.
Zeilen werden zuerst als bereit, zu prüfen oder übersprungen vorbereitet. Bereite Zeilen können Kontakte oder Organisationen erstellen, nur leere Felder bei exakten Treffern aktualisieren und Kontakt-Organisations-Verknüpfungen anlegen.
Widersprüchliche oder uneindeutige Zeilen werden im aktuellen Import nicht geschrieben. Importjobs melden erstellte, aktualisierte, verknüpfte, übersprungene und fehlgeschlagene Zeilen sowie Warnungen getrennt.

Spaltenzuordnung und Testläufe

Einblick versucht zuerst exakte Treffer über rohe Feldschlüssel, übersetzte Feldlabels und gängige Synonyme.
Wenn das nicht ausreicht, folgt unscharfes Matching, das gesondert markiert wird, damit du es prüfen kannst.
Jede Spalte kann manuell umgeordnet oder ignoriert werden.
Die Vorschau zeigt die ersten geparsten Zeilen, bevor etwas geschrieben wird.
Der Testlauf meldet, wie viele Zeilen erstellt würden, und liefert zeilenbezogene Fehler, die du als CSV herunterladen kannst.

Bestes Format für Re-Importe

Nutze den Modus Daten, wenn du Datensätze zwischen Workspaces bewegen, Rohdaten archivieren oder später wieder importieren willst.
Wähle XLSX oder JSON für verlustfreie Exporte. CSV eignet sich für flache Dateien zur manuellen Prüfung oder für Tabellenkalkulationen.
JSON-Exporte im Datenmodus enthalten _einblick-Metadaten. Beim erneuten Import können rohe Feldschlüssel deshalb direkt gemappt werden, statt sich auf übersetzte Labels zu stützen.
Wenn du verknüpfte Daten in mehrere Blätter exportierst, importierst du diese Blätter jeweils separat in der passenden Feature-Ansicht.

Aktueller Umfang

Generische Importe erstellen aktuell neue Datensätze. Bestehende Datensätze werden nicht direkt aktualisiert. Kontakt-Verzeichnisimporte sind die Ausnahme: Sie können leere Felder bei exakten Treffern füllen.
Banktransaktionsimporte sind eine weitere Ausnahme: Sie deduplizieren gegen bestehende Transaktionen und können eine passende Transaktion aktualisieren, statt eine neue Zeile zu erstellen.
Generische Importe laufen aktuell gegen genau eine Zieltabelle. Mehrere Blätter helfen bei der Auswahl, stellen aber keine Parent-Kind-Strukturen in einem Schritt wieder her. Kontakt-Verzeichnisimporte können Kontakte, Organisationen und Organisationsverknüpfungen aus einem vorbereiteten Adressbuchimport erstellen.
Systemfelder, berechnete Felder und nicht importierbare Feldtypen wie reine Datei-/Bild-Eingaben sind in der Zuordnung ausgeschlossen.