Exportformat und Schemata

Exportformat 1.0 · Stand: 15.09.2026 · gilt für Datenexport und Anbieterwechsel nach Art. 26 und 30 Data Act, siehe Anbieterwechsel und Datenexport

Worum es geht

Ein hejstack-Exportpaket ist ein ZIP-Archiv mit offenen, maschinenlesbaren Formaten: JSON für strukturierte Daten, CSV für Listen, Markdown für Wikis und die Originaldateien für Dokumente und Anhänge. Diese Seite beschreibt den Aufbau verbindlich und verlinkt die JSON-Schemata (JSON Schema, Draft 2020-12), gegen die sich jede Datei des Pakets prüfen lässt.

Aufbau des Pakets

hejstack-export-<organisation>-<JJJJ-MM-TT>.zip
  ├─ manifest.json                       Inhaltsverzeichnis + Prüfsummen
  ├─ dokumente.json                      Metadaten aller Dokumente
  ├─ dokumente/<wissensgruppe>/<datei>   Originaldateien (auch Postfach-Wissen)
  ├─ wikis/<wiki>.zip                    je Wiki ein Open-Knowledge-Format-Archiv (OKF v0.1)
  ├─ chats.json                          Unterhaltungen aller Nutzer
  ├─ chats/<konversation-id>/<datei>     Chat-Anhänge (+ <datei>.transcript.txt bei Audio)
  ├─ aufgaben.json                       Aufgaben + Laufergebnisse
  ├─ nutzer.json / nutzer.csv            Nutzer, Teams, Rollen
  ├─ freigaben.json                      Wissensgruppen und Freigaben
  ├─ konfiguration.json                  Einstellungen und Quellen (ohne Zugangsdaten)
  └─ audit.csv                           Audit-Protokoll

Wird ein Paket wegen seiner Größe in mehrere Teilarchive aufgeteilt, trägt jedes Teilarchiv ein eigenes manifest.json mit laufender Nummer (archive.part / archive.parts) und den in ihm enthaltenen Dateien.

Dateien und Schemata

Jede JSON-Datei nennt in format_version die Version dieser Spezifikation. Die Schemata sind unter der jeweils angegebenen Adresse dauerhaft abrufbar; ihre $id ist die kanonische Adresse https://hejstack.com/export-specs/<name>.schema.json.

Datei	Inhalt	Schema
`manifest.json`	Inhaltsverzeichnis des Pakets: Stichtag, Organisation, Kategorien, Prüfsummen je Datei	`manifest.schema.json`
`dokumente.json`	Metadaten aller Dokumente und des Postfach-Wissens; Originaldateien unter dokumente/	`dokumente.schema.json`
`chats.json`	Unterhaltungen aller Nutzer mit Ordnern, Nachrichten, Quellenverweisen, Anhängen und Feedback	`chats.schema.json`
`aufgaben.json`	Definitionen der E-Mail-Aufgaben und gespeicherte Laufergebnisse	`aufgaben.schema.json`
`nutzer.json`	Nutzer, Teams, Rollen und offene Einladungen (zusätzlich als nutzer.csv)	`nutzer.schema.json`
`freigaben.json`	Wissensgruppen, Team-Zuordnungen, Postfach-Freigaben, Marktplatz-Bezüge	`freigaben.schema.json`
`konfiguration.json`	Organisationseinstellungen, Assistenten, angebundene Quellen und Postfächer (ohne Zugangsdaten)	`konfiguration.schema.json`

Wikis liegen nicht als JSON, sondern im Open Knowledge Format (OKF) Version 0.1 vor (Markdown mit YAML-Frontmatter). Aufbau, Felder und ein Beispiel: Wiki-Exportformat (Open Knowledge Format v0.1).

CSV-Dateien

Kodierung UTF-8 ohne Byte-Order-Mark, Trennzeichen Semikolon, erste Zeile ist die Kopfzeile, Werte mit Semikolon, Anführungszeichen oder Zeilenumbruch stehen in doppelten Anführungszeichen (RFC 4180). Zeitstempel im Format ISO 8601 mit Zeitzone, Wahrheitswerte als true / false.

nutzer.csv

Spalte	Inhalt
`id`	Nutzer-ID (UUID), identisch mit nutzer.json
`email`	E-Mail-Adresse
`display_name`	Anzeigename (leer, wenn nicht gesetzt)
`role`	user (Nutzer), knowledge_manager (Wissensmanager), tenant_admin (Administrator)
`is_active`	true / false
`teams`	Teamnamen, mehrere durch \| getrennt
`created_at`	Anlagedatum

audit.csv

Spalte	Inhalt
`timestamp`	Zeitstempel des Ereignisses
`user_id`	Auslösender Nutzer (UUID, leer bei Systemereignissen)
`event`	Ereignis, z. B. document.uploaded, team.member_added, user.updated
`resource_type`	Betroffener Objekttyp, z. B. document, team, user
`resource_id`	Kennung des betroffenen Objekts
`ip_address`	IP-Adresse des Aufrufs (leer, wenn nicht erfasst)
`details`	Weitere Angaben als JSON-Objekt

Konventionen

Kennungen sind UUIDs. Verweise zwischen Dateien nutzen dieselben IDs: user_id zeigt auf nutzer.json, knowledge_group_id auf freigaben.json, document_id auf dokumente.json.
Zeitstempel sind ISO 8601 mit Zeitzonenangabe (in der Regel UTC, z. B. 2026-09-15T08:30:00+00:00).
Inhalte (Nachrichten, Wiki-Seiten, Laufergebnisse) sind im Paket entschlüsselt. Dateien liegen im Ursprungsformat; ihre SHA-256-Prüfsumme steht in manifest.json.
Nicht enthalten sind Vektor-Embeddings und Suchindizes, Zugangsdaten und Token, Inhalte angebundener Dateiablagen (nur deren Zuordnung) sowie E-Mails, die für Aufgabenläufe nur gelesen und nicht als Postfach-Wissen abgelegt wurden.
Unbekannte Felder dürfen in späteren Versionen hinzukommen; Konsumenten sollen sie ignorieren. Alle Schemata erlauben zusätzliche Eigenschaften.

Versionierung

Die Version hat die Form Haupt.Neben. Ergänzungen (neue Felder, neue Dateien) erhöhen die Nebenversion, bestehende Konsumenten bleiben lauffähig. Umbenennungen, entfernte Felder oder geänderte Bedeutungen erhöhen die Hauptversion; die Schemata früherer Hauptversionen bleiben abrufbar. Jedes Exportpaket nennt seine Version in manifest.json.

Datum	Version	Änderung
15.09.2026	1.0	Erstveröffentlichung

Kontakt

Fragen zum Format: support@hejstack.com