Zum Inhalt springen
craftdexDocs

Aufbau der ZIP-Datei

Ordner und Dateien im Komplett-Export und wie die CSV-Dateien formatiert sind.

CraftDex-Datenexport-2026-11-20.zip
├── craftdex-export.json      alle Tabellen + Dateiverzeichnis (maschinenlesbar)
├── LIESMICH.txt              Übersicht, Anzahl Zeilen je Tabelle
├── stammdaten.xlsx           Stammdaten im Format der Importvorlage (nur bei aktivem Zugang)
├── daten/
│   ├── users.csv
│   ├── sites.csv
│   ├── time_entries.csv
│   └── …                     eine Datei je Tabelle
└── dateien/
    ├── site-photos/…         Baustellenfotos
    ├── site-documents/…      Dokumente zu Baustellen
    ├── site-plans/…          Pläne
    ├── invoice-pdfs/…        Rechnungen als PDF und XRechnung
    └── …                     eine Ablage je Ordner

CSV-Dateien

EigenschaftWert
ZeichensatzUTF-8 mit BOM (Excel erkennt Umlaute)
TrennzeichenSemikolon ;
ZeilenendeCRLF
Kopfzeiletechnische Spaltennamen, wie in Tabellen und Spalten
Anführungszeichennur wenn ein Wert ;, " oder einen Zeilenumbruch enthält, " wird verdoppelt
Leere Werteleeres Feld
Listen und Objekteals JSON-Text in der Zelle

Eine Tabelle ohne Einträge ergibt eine leere Datei. Die Spalten einer CSV-Datei ergeben sich aus den exportierten Zeilen. Wer die Struktur verlässlich braucht, liest craftdex-export.json.

Ordner dateien

Unter dateien/<ablage>/ liegen die Dateien mit demselben Pfad wie in CraftDex, ohne die Kennung des Betriebs am Anfang. Welche Datei zu welchem Eintrag gehört, steht in der jeweiligen Tabelle, zum Beispiel site_photos.storage_path, und im Dateiverzeichnis von craftdex-export.json. Fotos und PDFs sind in der ZIP-Datei nicht noch einmal komprimiert.

Zeitangaben und Kennungen

  • Zeitpunkte im Format ISO 8601 in UTC, zum Beispiel 2026-11-20T14:05:00.123+00:00
  • Datumsangaben als JJJJ-MM-TT, Uhrzeiten als HH:MM:SS
  • Kennungen: Die Spalte id jeder Tabelle ist eine UUID. Verweise zwischen Tabellen laufen über diese Kennungen, zum Beispiel site_id in site_photos auf id in sites. Nicht jede Spalte auf _id ist ein Verweis: vat_id (USt-IdNr.), leitweg_id, personal_id und qr_code_id sind Text.
  • Beträge in Euro als Dezimalzahl mit Punkt

Auf dieser Seite