MDM Lite – Benutzerhandbuch

Version: Oktober 2026

Was sich in den einzelnen Releases geändert hat, finden Sie in den Release Notes.


Inhaltsverzeichnis

  1. Einstieg & Login
  2. Hauptoberfläche verstehen
  3. Umgebungen (Test & Produktion)
  4. Datasets verwalten
  5. Schema definieren
  6. Daten bearbeiten
  7. Hierarchien abbilden: Tabelle mit Beziehungen oder Baum?
  8. Zeitliche Gültigkeit
  9. Import (CSV / Excel)
  10. Versionierung & Historie
  11. Beziehungen zwischen Datasets
  12. Export
  13. Bereitstellung auf der Datenplattform (Microsoft Fabric) · → Detailliertes Integrationshandbuch
  14. KI-Zugriff (MCP)
  15. Sensitivitätsklassifizierung & Microsoft Purview
  16. API-Keys verwalten
  17. E-Mail-Versand konfigurieren
  18. Nutzerverwaltung
  19. Rollenmodell & Berechtigungen
  20. Plattform-Datenbibliothek
  21. Häufige Fragen (FAQ)

1. Einstieg & Login

Login

Das MDM Lite verwendet Microsoft Entra ID (Azure AD) zur Anmeldung. Es ist kein separates Passwort notwendig — Sie melden sich mit Ihrem bestehenden Microsoft-Unternehmenskonto an.

  1. Die Anwendungs-URL im Browser öffnen
  2. Auf „Mit Microsoft anmelden" klicken
  3. Unternehmensdaten eingeben (falls nicht bereits angemeldet)
  4. Nach erfolgreicher Authentifizierung werden Sie automatisch in Ihren Mandanten weitergeleitet

Mehrere Mandanten (Tenant-Auswahl)

Haben Sie Zugriff auf mehrere Mandanten (oder sind Sie AppAdmin), erscheint nach dem Login eine Mandantenauswahl. Der aktive Mandant wird oben in der Kopfzeile angezeigt; über das Wechsel-Symbol (⇄) lässt sich jederzeit ein anderer Mandant wählen. Beim Wechsel werden die Daten neu geladen — ein Browser-Reload ist nicht nötig.

Das angemeldete Konto sehen Sie rechts oben im Profilmenü.

Erstmaliger Zugriff

Beim ersten Login in einen freigeschalteten Mandanten erhalten Sie automatisch die Rolle Admin, sofern Sie der erste Nutzer sind. Alle weiteren Nutzer müssen von einem Admin eingeladen werden (siehe Nutzerverwaltung).

Falls Sie nach dem Login eine Fehlermeldung sehen, wurde Ihr Mandant noch nicht freigeschaltet — wenden Sie sich an Ihren MDM-Lite-Administrator.


2. Hauptoberfläche verstehen

Die Oberfläche ist in zwei Bereiche aufgeteilt:

┌──────────────────────┬─────────────────────────────────────────┐
│  Dataset Explorer    │  Detail-Bereich                         │
│  (linke Spalte)      │                                         │
│                      │  Tabs: Daten | Spalten | Beziehungen     │
│  [Suche / Filter]    │       Verlauf | Verwaltung | ...        │
│                      │                                         │
│  Ordner-Struktur     │  Inhalt des gewählten Datasets          │
│  ├─ Ordner A         │                                         │
│  └─ Ordner B         │                                         │
│  — Nicht zugeordnet  │                                         │
└──────────────────────┴─────────────────────────────────────────┘

Dataset Explorer (links): Zeigt alle Datasets des Mandanten in einer frei definierbaren Ordnerstruktur. Hier navigieren Sie, erstellen neue Datasets und Ordner.

Dataset-Übersicht (Kacheln/Liste): Wählen Sie einen Ordner, erscheinen dessen Datasets in drei nach Status getrennten Lanes: Veröffentlicht, Entwurf und Archiv. Die Archiv-Lane ist eingeklappt und wird erst auf Klick geladen. Über den Umschalter oben rechts wechseln Sie zwischen Kachel- und Listenansicht (die Wahl wird gespeichert). Datasets mit der Pflegeart „Automatisch geliefert" tragen einen Hinweis auf ihre Pflegeart, und nur wenn sie ihren erwarteten Lieferrhythmus überschreiten, zusätzlich „Lieferung überfällig". Manuell gepflegte Datasets zeigen keinen Hinweis, auch wenn sie lange unverändert sind.

Detail-Bereich (rechts): Zeigt den Inhalt des aktuell ausgewählten Datasets über mehrere Tabs:

TabInhalt
Daten (bei Datasets vom Typ Baum: Baum)Dateninhalte in Grid- bzw. Baumansicht, editierbar — arbeitet immer auf dem aktuellen Bearbeitungsstand (Head), siehe Bearbeitungsstand & Auslieferungsstatus
SpaltenSpaltendefinitionen, Typen, Regeln
BeziehungenVerknüpfungen zu anderen Datasets
VerlaufVersionen, Version-Diff, Restore, Audit-Log und Publish-Historie
VerwaltungVerantwortliche Person (ändern: Dataset-Admin), Pflegeart (nur Mandanten-Admin) und Aufbewahrungsrichtlinie (Versions-Retention) für dieses Dataset
IntegrationDWH-/Fabric-Anbindung, Umgebungskopie
PurviewSensitivitätsklassifizierung & Data-Map-Registrierung (falls aktiviert)

Aktionsleiste (Explorer): Am Rand des Explorers liegen feste Symbol-Buttons für: 🌐 Bibliothek (Plattform-Datenbibliothek öffnen), Neuer Ordner, Neues Dataset, Aus Datei erstellen, Bulk-Import und Fabric-Bulk-Sync.

Systemordner „Plattformdaten": Ganz oben im Explorer erscheint immer ein geschützter Ordner 🌐 Plattformdaten (Globus-Icon). Dorthin werden Datensätze aus der Plattform-Datenbibliothek importiert. Dieser Ordner kann nicht umbenannt, verschoben oder gelöscht werden.

Kopfzeile: Rechts oben finden Sie den Sprachumschalter (DE / EN), eine Versionsanzeige (Build-Umgebung + Version) sowie das Profil-/Kontomenü — dort finden Sie auch den Umgebungs-Wechsler.


3. Umgebungen (Test & Produktion)

Ein Mandant kann mehrere Umgebungen enthalten — separate, isolierte Datenräume für z. B. Produktion und Test. Jedes Dataset lebt in genau einer Umgebung; Sie arbeiten immer im Kontext der aktuell gewählten Umgebung, und alle Explorer-Ansichten, die Suche und der Changes-Feed zeigen nur deren Inhalt.

Die Live-Umgebung

Bei der Anlage eines Mandanten existiert automatisch genau eine Umgebung: „Produktion". Sie ist die Live-Umgebung (dauerhaftes „Live"-Badge in der Oberfläche) und damit die Datenquelle für alle externen Abnehmer — DWH-Sync, Changes-Feed, MCP sowie jeden API-Aufruf ohne explizite Umgebungsangabe. Die Live-Umgebung kann weder deaktiviert noch gelöscht werden; ihr Anzeigename ist aber änderbar.

Umgebung wechseln

Im Profil-/Kontomenü (oben rechts) erscheint der Abschnitt „Umgebung" mit allen aktiven Umgebungen (Farbpunkt + Name; die Live-Umgebung trägt zusätzlich das „Live"-Badge, die aktuell gewählte einen Haken). Ein Klick wechselt die Umgebung — Dataset-Explorer, Suche und alle Listen laden sich mit dem Inhalt der neuen Umgebung neu. Ihre Wahl wird pro Mandant im Browser gemerkt.

Hinweis: Arbeiten Sie nicht in der Live-Umgebung, zeigt ein durchgehender farbiger Streifen am oberen Bildschirmrand den Namen der aktiven Umgebung — so ist jederzeit erkennbar, dass Sie sich außerhalb von Produktion befinden. In der Live-Umgebung erscheint kein Banner (Normalzustand, kein Alarm).

Umgebungen verwalten (Admin)

Aufrufen: Einstellungen → Umgebungen (Route /settings/environments). Erforderliche Rolle: Admin.

Integrationen und Umgebungen

Mehrere Einstellungen gelten je Umgebung. Oben auf diesen Seiten zeigt eine Kontextzeile, für welche Umgebung Sie gerade arbeiten (Umgebungsname, Farbpunkt, bei Live das „Live"-Badge) und den Satz „Diese Einstellungen gelten nur für die Umgebung „Test". Umgebung wechseln im Benutzermenü." Mandantenweite Seiten (Allgemein, Nutzer & Rollen, Umgebungen, E-Mail) tragen stattdessen den Hinweis „Gilt für alle Umgebungen."

EinstellungGilt je UmgebungStandard in Nicht-Live-Umgebungen
Microsoft Fabric (Bereitstellung auf der Datenplattform)Ja, eigenes Ziel je UmgebungKeine Bereitstellung, bis Sie ein Ziel einrichten
Microsoft Purview (Katalog-Registrierung)Ja, eigene Verbindung, eigene Collection und eigenes Webhook-Secret je UmgebungKeine Registrierung, bis Sie Purview für die Umgebung einrichten
Notebooks (Erzeugung)JaAus
MCP-Server (KI-Zugriff)Ja, Endpunkt /mcp/{Umgebungs-Slug}Aus
API-KeysJa, Feld Umgebung beim AnlegenDer Key gilt für alle Umgebungen, bis Sie ihn beschränken

Eine Umgebung liefert nie in das Ziel einer anderen Umgebung und fällt nie auf die Einstellung von Live zurück. Eine neue Umgebung startet ohne Integrationen. Wie Sie die Bereitstellung auf der Datenplattform einrichten, steht unter Bereitstellung je Umgebung einrichten in Kapitel 13.

Deaktivierte Umgebung: Die Bereitstellung läuft weiter, auch der Rückzug von Spalten. Deaktivieren heißt „nur lesbar für Nutzer", nicht „Plattform einfrieren". Einstellungen ändern und manuell synchronisieren können Sie in dieser Zeit nicht (409 environment_inactive). Wollen Sie die Bereitstellung einer deaktivierten Umgebung stoppen, reaktivieren Sie die Umgebung kurz, deaktivieren die Integration und deaktivieren die Umgebung wieder.

Umgebung löschen: MDM Lite löscht mit der Umgebung auch ihre Integrationen samt Zugangsdaten. Der Lösch-Dialog nennt die Zahl der mitgelöschten Integrationen. Tabellen auf der Datenplattform bleiben bestehen und müssen dort manuell entfernt werden.

Dataset zwischen Umgebungen kopieren

Über den Tab „Integration" eines Datasets → „In Umgebung kopieren…" übertragen Sie Schema und Daten der gewählten Version in eine andere Umgebung desselben Mandanten (z. B. Test → Produktion). Erforderlich: mindestens die Rolle Editor.

  1. Zielumgebung wählen
  2. Modus wählen:
ModusVerhalten
Neu anlegen (Standard)Legt ein neues Dataset in der Zielumgebung an (Status Entwurf)
Bestehendes aktualisierenSchreibt Schema und Daten als neue Version in ein vorhandenes Ziel-Dataset (gleicher Typ vorausgesetzt) — dessen eigene Historie bleibt erhalten
  1. Optional Quellversion (Standard: die zuletzt gültige Version — nicht zwangsläufig die neueste) und Zielordner wählen
  2. Mit „Kopieren" bestätigen

Wichtig: Die Versionshistorie und das Änderungsprotokoll werden nicht mitkopiert — das Ziel-Dataset startet bei einer neuen Version. Woher ein Stand kopiert wurde, bleibt über das Audit-Log beider Datasets nachvollziehbar; es gibt kein Vorschau-/Diff wie beim Veröffentlichen, nur diesen Hinweis.

Liefer-Gate: Die kopierte Version durchläuft dieselbe Prüfung wie jede andere Änderung. Ohne ausgewählte Quellversion wird automatisch die zuletzt gültige Version des Quell-Datasets kopiert — ein gerade in Bearbeitung befindlicher, noch ungültiger Stand wird nie unbemerkt in eine andere Umgebung übertragen. Gibt es keine gültige Quellversion, meldet das Tool einen Fehler, und es wird nichts kopiert. Wählen Sie bewusst eine bestimmte (ggf. ungültige) Quellversion aus, wird diese zwar kopiert, aber ebenso als ungültig markiert und nicht ausgeliefert — bis eine gültige neuere Version vorliegt, bleibt in der Zielumgebung der vorherige gültige Stand aktiv.

Sensitivitätsstufen: Kopieren dürfen Sie nur, was Sie selbst sehen dürfen. Enthält das Quell-Dataset eine Spalte oberhalb Ihrer Stufe — im aktuellen Schema oder in der gewählten Quellversion —, lehnt MDM Lite die Kopie ab (403 classification_ceiling_exceeded), und es wird nichts angelegt. Hintergrund: Dataset-Rollen werden nicht mitkopiert; im Ziel gelten zunächst die Mandanten-Rollen. Bitten Sie in diesem Fall einen Admin des Datasets um die Kopie. Werte von Spalten, die im Schema nicht mehr existieren, werden nie mitkopiert.

Technischer Name: Das neue Dataset in der Zielumgebung übernimmt den technischen Namen des Quell-Datasets unverändert — dieselbe Tabelle heißt in Test und Produktion also gleich. Ist der Name in der Zielumgebung bereits vergeben (z. B. weil dort schon einmal in dieselbe Umgebung kopiert wurde), hängt MDM Lite automatisch einen Zahlensuffix an (_2, _3, …), statt das Kopieren abzulehnen.

Nach erfolgreichem Kopieren führt „In <Umgebung> öffnen" direkt zum neuen bzw. aktualisierten Dataset in der Zielumgebung.

Beziehungen beim Kopieren

Hat die Tabelle Spalten vom Typ „Verknüpfung" (Beziehungen zu anderen Tabellen), zeigt der Dialog einen Abschnitt „Beziehungen". Dort sehen Sie vor dem Kopieren, worauf jede Beziehung in der Zielumgebung zeigen wird. Die Prüfung läuft automatisch, sobald Zielumgebung, Modus, Name und Version feststehen, und schreibt nichts.

Für Entwickler/CI: Das Kopieren steht auch über die API zur Verfügung (POST /api/datasets/{id}/copy-to-environment, mit Idempotency-Key für sichere Wiederholung) — z. B. für automatisierte Promotion Test → Prod. API-Aufrufe ohne X-Environment-Header treffen immer die Live-Umgebung (Abwärtskompatibilität bestehender DWH-Integrationen). Ein API-Key, der auf die Quell-Umgebung beschränkt ist, darf ein Dataset in der Zielumgebung nicht neu anlegen (403); er darf nur ein Ziel-Dataset aktualisieren, das zuvor aus genau diesem Quell-Dataset kopiert wurde. Legen Sie das Ziel-Dataset deshalb einmalig selbst über „In Umgebung kopieren…" (Modus „Neu anlegen") an; danach kann die Pipeline es mit „Bestehendes aktualisieren" (mode=update) befüllen. Details: API-Spezifikation ↗ (GitHub, ggf. Zugriff erforderlich), Abschnitt „Umgebungen".


4. Datasets verwalten

Erster Start (Onboarding)

Ist Ihr Mandant noch leer (kein Dataset vorhanden), startet automatisch ein kurzer Onboarding-Assistent: Sie vergeben einen Namen und wählen entweder eine Vorlage oder laden eine Datei hoch — und haben so in wenigen Sekunden Ihr erstes Dataset. Der Assistent lässt sich überspringen und erscheint nicht erneut, sobald mindestens ein Dataset existiert.

Neues Dataset anlegen

  1. Im Dataset Explorer auf + klicken
  2. „Neues Dataset" wählen
  3. Optional „Mit Vorlage starten": eine der fertigen Vorlagen wählen (Filialhierarchie, Kostenstellen, Produktkategorien, ISO-Ländercodes, Mitarbeiter-Gruppen). Die Vorlage legt Typ und passende Spalten (inkl. Eindeutiger Bezeichner) automatisch an — Sie müssen nur noch Daten einpflegen.
  4. Name, Beschreibung und Typ auswählen (Typ entfällt bei Vorlagen):
    • Tabelle — eine Zeile je Eintrag; für Lookup-Tabellen, Mappings und auch für Hierarchien mit festen Ebenen (über Beziehungen verbunden, siehe Abschnitt 7). Empfohlen und vorausgewählt.
    • Baum — für eine Eltern-Kind-Hierarchie innerhalb eines einzigen Datasets (Organigramm, Kontenplan). Nur nötig, wenn Einträge derselben Art beliebig tief verschachtelt sind und alle Ebenen dieselben Spalten haben.
    • ⚠ Diese Wahl ist dauerhaft — der Typ eines Datasets kann nach der Erstellung nicht mehr geändert werden. Im Zweifel Tabelle wählen.
  5. Technischer Name prüfen oder anpassen: MDM Lite schlägt ihn aus dem Namen vor und aktualisiert den Vorschlag live, solange Sie das Feld nicht selbst bearbeitet haben. Das ist der Tabellenname auf der Datenplattform — siehe Technischer Tabellenname für die Regeln.
  6. Mit „Erstellen" bestätigen

Das Dataset wird im Status Entwurf angelegt. Daten können sofort eingepflegt werden.

Dataset-Status & Lebenszyklus

Jedes Dataset durchläuft einen klaren Lebenszyklus, der oben in der Detailansicht als umschaltbares Statussteuerelement angezeigt wird:

StatusBedeutung
EntwurfIn Bearbeitung, nicht für DWH-Export oder Changes-Feed sichtbar
VeröffentlichtFreigegeben, per API, Export und DWH-Sync abrufbar
ArchiviertNicht mehr aktiv, bleibt historisch und per API erhalten

Der Statuswechsel erfolgt über das Statussteuerelement auf der Detailseite oder das Aktionsmenü (⋮) im Explorer. Übergänge sind reversibel (z. B. Veröffentlicht → Entwurf zum Zurückziehen).

Verantwortliche Person (Owner) eines Datasets

Jedes Dataset hat genau eine verantwortliche Person: die Ansprechperson für Inhalt und Pflege. Sie muss nicht die Person sein, die das Dataset angelegt hat. Oft legt jemand aus IT oder BI das Dataset an, verantwortlich ist aber eine Person aus dem Fachbereich.

Pflegeart eines Datasets

Die Pflegeart legt fest, auf welchem Weg Daten in ein Dataset kommen dürfen. Sie ist eine Regel, die MDM Lite durchsetzt, und kein bloßes Etikett.

PflegeartBedeutung
Manuell gepflegt (Standard)Anwender pflegen die Daten in MDM Lite: im Editor oder per Datei-Upload in der Weboberfläche.
Automatisch geliefertEin externes System schreibt die Daten per API-Key (Import-API oder Zeilen-Endpunkte).

Alle bestehenden und neuen Datasets sind zunächst Manuell gepflegt. Die Pflegeart sehen Sie in der Kopfzeile eines Datasets, bei automatisch gelieferten Datasets auch in der Übersicht.

Pflegeart ändern (nur Mandanten-Admin): Dataset öffnen → Tab „Verwaltung" → Abschnitt „Pflegeart". Dataset-Admins, Editoren, Viewer und API-Keys können sie nicht ändern. Jede Änderung steht im Änderungsprotokoll des Datasets.

Was die Pflegeart bewirkt:

Beim Kopieren in eine andere Umgebung mit dem Modus „Neu anlegen" übernimmt die Kopie die Pflegeart (und den Lieferrhythmus). Beim Aktualisieren eines bestehenden Ziel-Datasets bleibt dessen eigene Pflegeart unverändert.

Hinweis: Die Pflegeart „Automatisch abgeholt" (MDM Lite holt Daten selbst aus einer Quelle) ist vorgesehen, aber noch nicht verfügbar.

Veröffentlichen & Zurückziehen (Publish-Workflow)

Erst durch Veröffentlichen wird ein Dataset für das DWH und automatisierte Abnehmer sichtbar. Das schützt Entwürfe vor verfrühtem Zugriff.

Veröffentlichen:

  1. Auf der Detailseite „Veröffentlichen" wählen
  2. Das Tool zeigt eine Pre-Publish-Validierung (blockierende Fehler + Warnungen) und eine Änderungsübersicht (Zeilen hinzugefügt / geändert / entfernt seit der letzten Veröffentlichung)
  3. Einen Kommentar eingeben (Pflicht — dokumentiert, warum veröffentlicht wurde)
  4. Warnungen ggf. bestätigen und mit „Veröffentlichen" abschließen

Zurückziehen (Unpublish): Über „Zurückziehen" wird ein veröffentlichtes Dataset wieder in den Entwurf-Status versetzt. Eine Wirkungswarnung weist darauf hin, dass DWH-Abnehmer das Dataset danach nicht mehr sehen.

Nicht veröffentlichte Änderungen: Bearbeiten Sie ein bereits veröffentlichtes Dataset, erscheint ein Indikator „Änderungen ausstehend" (auf der Kachel und im Detail-Header). Die Änderungen werden erst mit einer erneuten Veröffentlichung für das DWH wirksam. Im Dataset-Explorer zeigt ein Banner alle Datasets mit unveröffentlichten Änderungen — mit „Alle anzeigen" filtern Sie gezielt darauf.

Publish-Historie: Der Tab „Verlauf" enthält eine Zeitleiste aller Veröffentlichungen mit Datum, Nutzer und Kommentar.

Hinweis: Es handelt sich um einen Publish-Gate (Validierung + Kommentar durch eine berechtigte Person), nicht um ein Vier-Augen-Prinzip mit separater Genehmigung durch eine zweite Person.

Ordner erstellen und verwalten

Dataset suchen

Das Suchfeld über dem Explorer-Baum filtert in Echtzeit nach Dataset-Name oder Ordner-Name. Die Checkbox „Unterordner einschließen" steuert, ob bei Klick auf einen Ordner auch Datasets aus Unterordnern angezeigt werden.

Archivierte Datasets endgültig löschen (Purge)

Archivierte Datasets bleiben standardmäßig dauerhaft erhalten (siehe Dataset-Status & Lebenszyklus). Für den Fall, dass ein Dataset versehentlich angelegt wurde oder endgültig entfernt werden soll, gibt es eine separate, unumkehrbare Endgültig-löschen-Funktion.

Aufrufen: Einstellungen → Daten → Archivierte Datasets (Route /settings/data/archived). Erforderliche Rolle: Admin.

Die Seite listet alle archivierten Datasets des Mandanten mit Typ, Archivierungsdatum, letzter Version und Zeilenzahl.

  1. In der Zeile des gewünschten Datasets „Endgültig löschen" klicken
  2. Im Bestätigungsdialog wird aufgelistet, was verloren geht: Dataset, alle Versionen, Schema und Daten
  3. Enthält das Dataset bereits Daten (mindestens eine Zeile oder mehr als eine Version), muss zur Bestätigung der exakte Dataset-Name eingetippt werden, bevor der rot hervorgehobene Button „Endgültig löschen" aktiv wird
  4. Bestätigen — das Dataset ist danach unwiderruflich entfernt

Achtung: Diese Aktion kann nicht rückgängig gemacht werden — anders als Archivieren betrifft sie auch die Versionshistorie und das Audit-Log des Datasets. Nutzen Sie sie nur für Datasets, die wirklich nicht mehr benötigt werden.

Sperre bei aktiven Referenzen: Wird das Dataset noch als Fremdschlüssel-Ziel von einer Spalte in einem anderen Dataset verwendet, lehnt das Tool das endgültige Löschen ab (Meldung „Dieses Dataset wird von anderen Datasets referenziert und kann nicht gelöscht werden."). Lösen Sie zuerst die Beziehung auf (siehe Beziehungen-Tab) und wiederholen Sie den Löschvorgang danach.


5. Schema definieren

Das Schema legt fest, welche Spalten ein Dataset hat. Es wird pro Dataset frei definiert — kein starres Systemmodell.

Schema-Tab öffnen

Auf ein Dataset klicken → Tab „Spalten" wählen. Der Tab zeigt die Spalten zunächst nur an. Zum Ändern klicken Sie auf „Spalten bearbeiten" (siehe Änderungen sammeln und speichern); alle Änderungen werden dort gesammelt und erst mit „Speichern" übernommen.

Änderungen sammeln und speichern

Im Tab „Spalten" ändern Sie das Schema im Bearbeitungsmodus. Alle Änderungen werden dort zunächst nur gesammelt (als Entwurf in Ihrem Browser) und erst mit „Speichern" gemeinsam übernommen. Bis dahin ändert sich weder das Dataset noch eine Version, und niemand sonst sieht Ihre Änderungen.

Bearbeitungsmodus starten und beenden

  1. Öffnen Sie das Dataset und wählen Sie den Tab „Spalten".
  2. Klicken Sie auf „Spalten bearbeiten". Bei archivierten Datasets ist die Schaltfläche gesperrt („Archivierte Datasets sind schreibgeschützt").
  3. Die Leiste zeigt jetzt „Bearbeitungsmodus" mit dem Hinweis „Alle Änderungen an Spalten werden erst mit „Speichern" übernommen." sowie die Schaltflächen „FK-Erkennung", „Spalte hinzufügen", „Verwerfen" und „Speichern (+n ~n −n)".
  4. Beenden Sie den Modus mit „Speichern" oder „Verwerfen". Eine Schaltfläche „Fertig" gibt es nicht.

Was Sie sammeln können — jede Aktion des Tabs:

Die Dialoge schließen Sie mit „Spalte hinzufügen" (neue Spalte), „Übernehmen" (Bearbeiten, Typwechsel) bzw. „Zum Löschen vormerken" (Löschen) ab. Das speichert noch nichts, es legt die Änderung nur im Entwurf ab. Mehrere Änderungen an derselben Spalte fasst MDM Lite zu einer zusammen.

Rollen: Struktur-Änderungen (Spalte hinzufügen, löschen, Typ ändern, Name, Pflichtfeld, Eindeutig, Primärschlüssel, erlaubte Werte, Validierungsregel, Beziehung, Berechnung) sowie Bezeichnung, Breite und Reihenfolge erfordern die Rolle Dataset-Admin. Für Editoren sind diese Aktionen deaktiviert (Tooltip „Nur für Dataset-Admins"). Editoren ändern im Bearbeitungsmodus Sichtbarkeit, Klassifizierung (innerhalb ihrer Obergrenze) und Glossar-Begriff.

Markierungen in der Spaltenliste

MarkierungBedeutung
„Neu"Spalte, die noch nicht gespeichert ist
„Geändert"Bestehende Spalte mit mindestens einer vorgemerkten Änderung
„Wird gelöscht"Zum Löschen vorgemerkte Spalte

Mit „Änderungen an dieser Spalte zurücknehmen" machen Sie in einer Zeile alle vorgemerkten Änderungen an dieser einen Spalte rückgängig. Eine zum Löschen vorgemerkte Spalte holen Sie mit „Spalte wiederherstellen" zurück.

Der Zähler am Button „Speichern (+n ~n −n)" zeigt, wie viele Spalten neu (+), geändert (~) und zum Löschen vorgemerkt (−) sind. Solange nichts vorgemerkt ist, ist der Button deaktiviert.

Verwerfen

„Verwerfen" verlässt den Bearbeitungsmodus und verwirft alle noch nicht gespeicherten Änderungen im Tab „Spalten". Liegen Änderungen vor, fragt MDM Lite nach: „Änderungen verwerfen? Alle nicht gespeicherten Änderungen gehen verloren." Ohne Änderungen verlassen Sie den Modus sofort. Verworfene Änderungen lassen sich nicht wiederherstellen; es entsteht keine Version.

Speichern und Zusammenfassung

  1. Klicken Sie auf „Speichern (+n ~n −n)".
  2. Enthält der Entwurf nur Anzeige-Einstellungen (Bezeichnung, Breite, Sichtbarkeit, Klassifizierung, Glossar-Begriff, Reihenfolge), speichert MDM Lite sofort, ohne Dialog.
  3. Sonst prüft MDM Lite den gesamten Entwurf, ohne etwas zu schreiben, und öffnet den Dialog „Änderungen speichern" („Auswirkungen werden geprüft…"). Er zeigt:
    • Die Versionswirkung: „Es entsteht Version v{n}.", „Der Entwurf wird aktualisiert." (bei einem Dataset im Status Entwurf) oder „Keine neue Version — nur Anzeige-Einstellungen."
    • Eine Zeile je Änderung, zum Beispiel „Neue Spalte …", „Spalte … in … umbenennen", „Spalte …: Typwechsel zu …", „Spalte … löschen", „Reihenfolge der Spalten ändern".
    • Die Auswirkung auf die Daten: wie viele Zeilen in die neue Version übernommen werden, in wie vielen Zeilen ein Standardwert eingetragen oder ein Wert berechnet wird, wie viele Werte umgewandelt werden und wie viele nicht zum neuen Typ passen.
    • Hinweise zu Folgen: „Breaking Change" bei Umbenennen, Typwechsel und Löschen, „Datenverlust" mit der Zahl der betroffenen Zeilen (davon bereits beendete Zeilen) und der Hinweis auf defekte Beziehungen, wenn eine gelöschte Spalte Ziel einer Beziehung ist. Benennen Sie eine Spalte um, die Ziel von Beziehungen anderer Datasets ist, steht dort: „Die Fremdschlüssel-Spalten in n anderen Datasets werden automatisch auf den neuen Namen umgestellt." MDM Lite nennt die Zahl der anderen Datasets, nicht deren Namen.
  4. Klicken Sie im Dialog auf „Änderungen speichern". MDM Lite meldet „Änderungen gespeichert (Version v{n})." (bzw. „Änderungen gespeichert.") und verlässt den Bearbeitungsmodus.

Speichern ist alles oder nichts: Lässt sich auch nur eine Änderung nicht übernehmen, wird nichts gespeichert, und Ihr Entwurf bleibt erhalten.

Verweisen nach dem Speichern Zeilen anderer Datasets über eine importierte Beziehung noch auf entfernte Werte, zeigt MDM Lite nach dem Speichern den Hinweis „Einige Einträge anderer Datasets verweisen über eine importierte Beziehung noch auf entfernte Werte." mit den betroffenen Zeilen und Schlüsseln. Zeilen in Datasets, auf die Sie keinen Zugriff haben, erscheinen nur als Zahl. Diesen Hinweis sehen Sie erst nach dem Speichern, nicht schon in der Zusammenfassung.

Wann entsteht eine neue Version?

Ihre ÄnderungNeue Version?
Mindestens eine strukturelle Änderung (Spalte hinzufügen, löschen, Typ ändern, Name, Pflichtfeld, Eindeutig, Primärschlüssel, erlaubte Werte, Validierungsregel, Beziehung, Berechnung)Ja, genau eine Version für den gesamten Speichervorgang, egal wie viele Änderungen der Entwurf enthält. Alle Zeilen werden dabei einmal gemeinsam angepasst.
Nur Anzeige-Einstellungen (Bezeichnung, Breite, Sichtbarkeit, Klassifizierung, Glossar-Begriff, Reihenfolge)Nein. Das Dataset behält seine Versionsnummer.

Bei einem Dataset im Status Entwurf aktualisiert MDM Lite die vorhandene Arbeitsversion, statt eine neue anzulegen. Ältere Versionen behalten immer ihren damaligen Spaltenstand (siehe Schema-Stand historischer Versionen). Im Änderungsprotokoll steht ein Sammeleintrag schema_changes_saved mit der Zahl der Änderungen (ohne Spaltennamen) sowie je Spalte ein Einzeleintrag.

Fehler beim Speichern

Meldung / SituationBedeutung und Abhilfe
„n Änderungen können nicht gespeichert werden. Bitte korrigieren Sie die markierten Spalten."MDM Lite lehnt eine oder mehrere Änderungen ab. Die Gründe stehen unter dem Banner und an der jeweiligen Spalte, zum Beispiel „Ein Pflichtfeld braucht einen Standardwert, der in alle vorhandenen Zeilen eingetragen wird." oder „Als Primärschlüssel nicht möglich: n Schlüsselwerte kommen mehrfach …". Korrigieren Sie die markierten Spalten und speichern Sie erneut. Der Entwurf bleibt erhalten.
„Diese Spalte hat widersprüchliche Änderungen. Nehmen Sie die Änderungen an der Spalte zurück und erfassen Sie sie neu."Setzen Sie die Spalte mit „Änderungen an dieser Spalte zurücknehmen" zurück und erfassen Sie die Änderung neu.
„Umbenennen und Typwechsel bitte in zwei getrennten Schritten speichern."Speichern Sie zuerst das eine, dann das andere. Gleiches gilt für Typwechsel und Primärschlüssel.
„Dieser Name gehört noch zu einer anderen Spalte. Speichern Sie zuerst deren Umbenennung oder Löschung und vergeben Sie den Namen danach."Ein Name lässt sich nicht im selben Speichervorgang tauschen oder weitergeben. Speichern Sie in zwei Schritten.
„Für einige Änderungen fehlen Ihnen die Rechte. Es wurde nichts gespeichert."Mindestens eine Änderung braucht die Rolle Dataset-Admin (oder eine höhere Klassifizierungsberechtigung). Bitten Sie einen Admin oder nehmen Sie die Änderung zurück.
„Gerade läuft eine andere Änderung an diesem Dataset. Bitte speichern Sie erneut. Ihre Änderungen bleiben erhalten."Eine andere Schreibaktion läuft. Warten Sie kurz und klicken Sie erneut auf Speichern.

Jemand anderes hat das Schema inzwischen geändert

Ändert eine andere Person die Spalten des Datasets, während Sie im Bearbeitungsmodus arbeiten, lehnt MDM Lite Ihr Speichern ab, damit deren Änderung nicht still überschrieben wird. Es erscheint der Dialog „Das Schema wurde inzwischen geändert." („Jemand anderes hat die Spalten dieses Datasets geändert, seit Sie sie geladen haben. Es wurde nichts gespeichert."). Sie haben zwei Möglichkeiten:

Nur Änderungen an den Spalten lösen diesen Dialog aus; Änderungen an den Daten (Zeilen bearbeiten, Import) nicht.

Ungespeicherte Änderungen: Schutz beim Verlassen

Liegen im Tab „Spalten" oder im Tab „Daten" ungespeicherte Änderungen vor, fragt MDM Lite nach, bevor sie verloren gehen: „Es gibt ungespeicherte Änderungen. Trotzdem verlassen?" Die Rückfrage erscheint beim

Mit Abbrechen bleiben Sie im Tab, mit OK verlassen Sie ihn und verwerfen die Änderungen.

Grenze: Die Zurück-Schaltfläche des Browsers fängt MDM Lite nicht ab. Wer damit die Seite verlässt, verliert ungespeicherte Änderungen ohne Rückfrage. Speichern oder verwerfen Sie deshalb bewusst, bevor Sie die Browser-Navigation nutzen.

Für API- und MCP-Nutzer: Der Bearbeitungsmodus bündelt die Änderungen in einem Aufruf PATCH /api/datasets/{id}/schema (Details: API-Spezifikation ↗ (GitHub, ggf. Zugriff erforderlich), Abschnitt 5.8). Die bisherigen Einzel-Endpunkte (POST/PUT/DELETE …/schema/columns…, PATCH …/schema/order, …/type, …/classification usw.) bleiben dauerhaft verfügbar, bestehende Skripte und Integrationen funktionieren unverändert. Sie wirken allerdings sofort, ohne Entwurf und Zusammenfassung.

Neue Spalte anlegen

  1. Klicken Sie im Bearbeitungsmodus auf „Spalte hinzufügen"
  2. Felder ausfüllen und den Dialog mit „Spalte hinzufügen" bestätigen. Die Spalte erscheint als „Neu" und wird erst mit „Speichern" angelegt:
FeldBeschreibung
NameTechnischer Spaltenname (keine Leerzeichen, z. B. filial_nr)
BezeichnungAnzeigename in der UI (z. B. „Filial-Nr.")
TypDatentyp (siehe unten)
PflichtfeldZeilen ohne diesen Wert werden abgelehnt
PrimärschlüsselBusiness Key zur eindeutigen Identifikation der Zeile

Unterstützte Datentypen

TypBeschreibungBeispiel
StringFreier Text"Frankfurt", "EUR"
IntegerGanzzahl42, 1001
BooleanJa/Nein-Werttrue, false
DateDatum (ISO 8601)2025-01-01
EnumAuswahlliste mit festen Werten"Nord", "Süd", "West"
ForeignKeyVerweis auf ein anderes DatasetFiliale verweist auf Region

Primärschlüssel (Business Key)

Genau eine Spalte muss als Primärschlüssel markiert werden. Dieser Business Key identifiziert eine Zeile eindeutig und wird beim Import für Abgleich und Deduplizierung verwendet.

Hinweis: Der Primärschlüssel ist unveränderlich, sobald Daten im Dataset vorhanden sind. Wählen Sie ihn sorgfältig.

Zusammengesetzter Schlüssel: Ist eine Zeile erst durch mehrere Spalten eindeutig (z. B. Land, Segment und Jahr), legen Sie eine berechnete Spalte an und markieren Sie diese als Primärschlüssel.

Enum-Werte definieren

Bei Typ Enum erscheint ein zusätzliches Feld „Erlaubte Werte". Tragen Sie jeden Wert ein und bestätigen mit Enter. Import-Zeilen mit einem nicht gelisteten Wert werden abgelehnt.

Nachträgliche Spalten und bestehende Daten

Neue Spalten können auch zu einem Dataset hinzugefügt werden, das bereits Zeilen enthält — die vorhandenen Zeilen gehen dabei nicht verloren: Sie werden automatisch in die neue Version übernommen, die neue Spalte ist dort zunächst leer.

Ausnahme: Legen Sie eine neue Spalte als Pflichtfeld ohne Standardwert an, obwohl das Dataset bereits Zeilen hat, weist das Tool die Änderung ab und bittet um einen Standardwert — dieser wird dann für alle bestehenden Zeilen automatisch eingesetzt. Alternativ die Spalte als optional anlegen.

Spalte umbenennen

Klicken Sie im Bearbeitungsmodus des Tabs „Spalten" in der Zeile der Spalte auf das Bearbeiten-Symbol, ändern Sie den Spaltennamen und bestätigen Sie mit „Übernehmen". Die Umbenennung gilt erst nach „Speichern"; die Zusammenfassung nennt sie als „Breaking Change". Alle Werte bleiben erhalten und stehen danach unter dem neuen Namen, auch beim Primärschlüssel: Die Zeilen behalten ihren Business Key, und die Version bleibt gültig. Ältere Versionen behalten den bisherigen Spaltennamen.

Zwei Einschränkungen:

Hinweis für bereits betroffene Datasets: Wurde eine Spalte mit einer älteren Version von MDM Lite umbenannt und erscheint seitdem leer, benennen Sie sie auf ihren ursprünglichen Namen zurück. Die Werte sind dann wieder sichtbar. Anschließend können Sie die Spalte erneut umbenennen; die Werte wandern jetzt mit.

Spalte löschen

Klicken Sie im Bearbeitungsmodus des Tabs „Spalten" an der Spalte auf das Lösch-Symbol und bestätigen Sie mit „Zum Löschen vormerken". Die Spalte erscheint als „Wird gelöscht" und wird erst mit „Speichern" tatsächlich entfernt; bis dahin holen Sie sie mit „Spalte wiederherstellen" zurück. Spalten lassen sich auch löschen, wenn das Dataset bereits Zeilen enthält. Die folgenden Hinweise erscheinen im Löschdialog und in der Zusammenfassung beim Speichern.

Enthält die Spalte Werte, nennt der Dialog die Anzahl der betroffenen Zeilen, zum Beispiel: „Die Spalte enthält in 12 Zeilen Werte. In der neuen Version gehen diese Werte verloren." Gelöscht wird erst, wenn Sie den Verlust mit dem Kontrollkästchen ausdrücklich bestätigen. Die neue Version enthält die Spalte und ihre Werte dann nicht mehr.

Zu den betroffenen Zeilen zählen auch beendete Zeilen: Eine im Tab „Daten" gelöschte Zeile wird nicht entfernt, sondern mit einem Gültig-bis-Datum historisiert. Sie gehört weiter zur aktuellen Version, wird in der Tabellenansicht aber nicht mehr angezeigt. Der Dialog weist deshalb gesondert aus, wie viele der betroffenen Zeilen bereits beendet sind. So erklärt sich, warum eine scheinbar leere Tabelle trotzdem Werte enthält.

Ist die Spalte das Ziel einer Beziehung aus einem anderen Dataset, weist der Dialog darauf hin: Nach dem Löschen ist diese Beziehung defekt und muss im Tab „Beziehungen" angepasst werden.

Zusätzlich zeigt der Bestätigungsdialog einen Breaking-Change-Hinweis, denn eine Spaltenentfernung wirkt weitreichender als eine Spalten-Hinzufügung:

Breaking Change Das Entfernen einer Spalte ist eine strukturelle Änderung: Neue Versionen, Exporte und API-Antworten enthalten die Spalte {Spaltenname} ab sofort nicht mehr. API-Konsumenten und DWH-Abfragen, die diese Spalte erwarten, können fehlschlagen.

Historische Versionen behalten die Spalte und ihre Werte (Schema-Snapshot) und bleiben unverändert abrufbar.

Die Klassifizierung, die die Spalte beim Löschen hat, gilt in diesen älteren Versionen weiter (siehe Schema-Stand historischer Versionen). Eine Spalte zu löschen ist deshalb kein Weg, eine Hochstufung zu umgehen.

Der Hinweis blockiert das Löschen nicht — er macht die Tragweite sichtbar, bevor Sie bestätigen. Was „historische Versionen behalten die Spalte" konkret bedeutet, erklärt Schema-Stand historischer Versionen.

Berechnete Spalten

Eine berechnete Spalte setzt MDM Lite selbst aus den Werten anderer Spalten derselben Zeile zusammen. Sie tragen dort nichts ein: Der Wert entsteht beim Speichern, beim Massenändern und beim Import automatisch und wird bei jeder Änderung einer Quellspalte neu berechnet.

Wann nutzen Sie das? Vor allem für einen zusammengesetzten fachlichen Schlüssel. MDM Lite kennt als Primärschlüssel genau eine Spalte. Ist eine Zeile erst durch die Kombination mehrerer Spalten eindeutig, bilden Sie aus diesen Spalten eine berechnete Spalte und markieren sie als Primärschlüssel. Beispiel: Ein Dataset „Preisfaktoren" ist je Land, Segment und Jahr eindeutig. Die berechnete Spalte PK_PREIS ergibt dann zum Beispiel DE|Privat|2026. Auch der Import im Modus „Ergänzen & Aktualisieren" gleicht über diesen Schlüssel ab (siehe Import mit berechneten Spalten). Eine berechnete Spalte eignet sich außerdem als reine Anzeigespalte, etwa „Nachname, Vorname".

Voraussetzungen: Berechnete Spalten gibt es nur in Tabellen, nicht in Bäumen. Anlegen, Ändern und Zurückwandeln erfordern die Rolle Dataset-Admin. Im Assistenten „Dataset aus Datei erstellen" lässt sich keine berechnete Spalte anlegen: Legen Sie das Dataset an und ergänzen Sie die Spalte anschließend im Tab „Spalten".

Nicht zu verwechseln: Die Automatische Nummer (Auto-Increment) vergibt fortlaufende Nummern und ist keine berechnete Spalte im Sinne dieses Kapitels.

Berechnete Spalte anlegen

  1. Öffnen Sie das Dataset und wählen Sie den Tab „Spalten". Klicken Sie auf „Spalten bearbeiten" und dann auf „Spalte hinzufügen". Wie alle Änderungen im Tab wird auch die berechnete Spalte erst mit „Speichern" angelegt (siehe Änderungen sammeln und speichern).
  2. Wählen Sie bei „Werte" die Option „Berechnet aus anderen Spalten" (Standard ist „Eingabe").
  3. Tragen Sie Spaltenname und Anzeigebezeichnung ein. Der Typ steht fest auf Text: „Berechnete Spalten sind immer Text."
  4. Wählen Sie unter „Quellspalten" mindestens 2 und höchstens 10 Spalten. Die Reihenfolge bestimmt die Verkettung. Mit den Pfeilen verschieben Sie eine Quellspalte, mit „Quellspalte hinzufügen" ergänzen Sie eine weitere.
  5. Legen Sie optional je Quellspalte die Stellen fest (siehe unten).
  6. Wählen Sie das Trennzeichen.
  7. Markieren Sie bei Bedarf „Primärschlüssel" und „Eindeutig". „Pflichtfeld" setzt MDM Lite selbst: Es gilt automatisch, sobald die Spalte Primärschlüssel ist.
  8. Prüfen Sie die Vorschau und speichern Sie.

Sie erkennen die erfolgreiche Anlage an der Meldung „Spalte „…" angelegt. Die Werte von N vorhandenen Zeilen wurden berechnet." und am Chip „Berechnet" neben dem Typ der Spalte. Die Berechnung erzeugt eine neue Version des Datasets; bestehende Zeilen bleiben erhalten.

Eine vorhandene Text-Spalte machen Sie über „Spalte bearbeiten" → „Berechnen aus anderen Spalten" zur berechneten Spalte. Achtung: Die vorhandenen Werte werden überschrieben. Spalten anderer Typen lassen sich nicht umwandeln.

So fügt MDM Lite die Werte zusammen

RegelVerhalten
TrennzeichenEines der Zeichen | (Standard), -, _, /, ., :, ;, # oder „ohne Trennzeichen". Andere Zeichen sind nicht erlaubt.
StellenOptional je Quellspalte, 1 bis 50. Kürzere Werte werden links mit 0 aufgefüllt, längere bleiben unverändert. Beispiel mit 2 Stellen: 1 wird zu 01. Leer lassen heißt keine Auffüllung.
Ohne TrennzeichenDann sollte jede Quellspalte außer der letzten eine feste Stellenzahl haben, sonst ist der Wert mehrdeutig (30 und 52018 ergäben dasselbe wie 305 und 2018). Bei einem Primärschlüssel ist das Pflicht.
Leere QuelleIst auch nur ein Quellwert leer, ist der berechnete Wert leer. Es gibt keine Teilverkettung.
ErgebnisImmer Text, auch wenn alle Quellen Zahlen sind.
Mögliche QuellspaltenSpalten desselben Datasets vom Typ Text, Ganze Zahl, Ja/Nein, Datum, Auswahlliste oder Verknüpfung. Nicht möglich: eine Automatische Nummer, die Spalte selbst und andere berechnete Spalten (keine Ketten).

Beispiel mit den Quellspalten BUCHUNGSKREIS = 305, JAHR = 2018, MONAT = 1:

EinstellungErgebnis
Trennzeichen |, keine Stellen305|2018|1
Trennzeichen -, MONAT mit 2 Stellen305-2018-01
ohne Trennzeichen, Stellen 4 / 4 / 20305201801

Die Vorschau im Dialog zeigt Beispielwerte und die Zahl leerer Werte. Sie rechnet auf dem Server und speichert nichts. Bei einem Primärschlüssel meldet sie zusätzlich doppelte Schlüsselwerte und Verstöße gegen die Schlüsselregeln.

Als Primärschlüssel verwenden

Ist die berechnete Spalte der Primärschlüssel, gelten zusätzlich diese Regeln, damit der Schlüssel eindeutig bleibt:

Achtung beim Ändern der Berechnung: Ändern Sie Quellspalten, Reihenfolge, Trennzeichen oder Stellen eines Primärschlüssels, ändern sich alle Schlüsselwerte. Verweisende Datasets und die Bereitstellung im Modus „Aktualisieren & ergänzen (Upsert)" sehen dann neue Schlüssel. Der Dialog warnt davor. Wird ein Schlüssel noch von einem anderen Dataset referenziert, schützt MDM Lite diese Verweise wie beim Löschen (siehe Verwendete Einträge können nicht gelöscht werden).

Berechnete Spalten im Tab „Daten"

Import mit berechneten Spalten

Berechnete Spalten werden nicht aus der Datei gelesen.

Klassifizierung

Eine berechnete Spalte ist mindestens so hoch klassifiziert wie die höchste ihrer Quellspalten. MDM Lite setzt die Stufe beim Anlegen entsprechend. Eine niedrigere Stufe lehnt MDM Lite ab („Eine berechnete Spalte darf nicht niedriger klassifiziert sein als ihre Quellspalten (mindestens: …)"). Stufen Sie eine Quellspalte herauf, zieht die berechnete Spalte automatisch mit; im Änderungsprotokoll steht dafür ein eigener Eintrag. Eine Herabstufung der Quelle ändert die berechnete Spalte nicht. So gelangen vertrauliche Werte nicht über eine niedriger klassifizierte Verkettung in die Bereitstellung. Hintergrund: Welche Spalten auf die Datenplattform gehen.

Quellspalten umbenennen, ändern oder löschen

In normale Spalte umwandeln

Möchten Sie die Werte behalten, aber nicht mehr automatisch berechnen lassen: „Spalte bearbeiten" → „In normale Spalte umwandeln". Nach der Bestätigung („Die Werte der Spalte „…" bleiben erhalten und werden nicht mehr automatisch aktualisiert.") ist die Spalte eine normale Text-Spalte und frei editierbar. Auch das erfordert die Rolle Dataset-Admin. Berechnung ändern und Umwandeln lassen sich nicht in einem Schritt speichern.

Versionierung und Bereitstellung

Berechnete Werte werden gespeichert und überall wie eine normale Text-Spalte ausgeliefert: in der REST-API, im Export, in der Bereitstellungstabelle auf der Datenplattform und über MCP. Wird eine Berechnung geändert, entsteht wie bei jeder Schemaänderung eine neue Version; ältere Versionen behalten ihre Werte. Beim Wiederherstellen einer älteren Version berechnet MDM Lite die Werte nach der aktuellen Berechnung neu. Beim Kopieren in eine andere Umgebung wird die Berechnung mitkopiert.

Stimmen gespeicherte Werte einmal nicht mehr mit der Berechnung überein, stellt MDM Lite diese Version nicht bereit (Prüfregel COMPUTED_VALUE_MISMATCH, Meldung „Die berechnete Spalte „…" enthält N Werte, die nicht der Berechnung entsprechen."). Das ist nur nach außergewöhnlichen Ereignissen zu erwarten, etwa nach einem Rückbau der Software. Die Abhilfe steht im nächsten Abschnitt.

Werte weichen von der Berechnung ab (Neuberechnen)

Für Dataset-Admins. Meldet die Versionsprüfung, dass Werte einer berechneten Spalte nicht der Berechnung entsprechen, gleichen Sie sie mit dem Neuberechnen-Endpunkt ab:

POST /api/datasets/{datasetId}/schema/columns/{columnId}/recompute
  1. Ermitteln Sie die Spalten-ID über GET /api/datasets/{datasetId}/schema/columns (die Spalte trägt das Feld computation).
  2. Rufen Sie recompute mit einem Anmelde-Token oder API-Key mit Dataset-Admin-Rechten auf.
  3. Antwort { "changed": n, "newVersion": v }: n abweichende Zeilen wurden in der neuen Version v korrigiert. Bei { "changed": 0, "newVersion": null } gab es nichts zu korrigieren, und es entsteht keine Version.

Gehen Sie ebenso vor, nachdem Ihr Betrieb auf einen Softwarestand vor Einführung der berechneten Spalten zurückgebaut hatte und dazwischen Daten geändert wurden. Auf einer normalen Spalte antwortet der Endpunkt mit 422 und not_computed. Eine Schaltfläche dafür gibt es in der Weboberfläche nicht.

Fehlermeldungen beim Einrichten

Meldung (Auszug)Ursache und Lösung
„Berechnete Spalten gibt es nur in Tabellen, nicht in Bäumen."Das Dataset ist ein Baum. Nutzen Sie ein Tabellen-Dataset.
„Die Quellspalten sind ungültig: Es sind 2 bis 10 verschiedene Spalten nötig …"Wählen Sie 2 bis 10 verschiedene Spalten.
„Berechnete Spalten lassen sich nicht verketten …"Eine berechnete Spalte kann nicht Quelle einer anderen sein. Verwenden Sie deren ursprüngliche Quellspalten.
„Eine Automatische Nummer kann keine Quelle sein …"Wählen Sie eine andere Spalte als Quelle.
„Ohne Trennzeichen braucht jede Quellspalte außer der letzten eine feste Stellenzahl …"Tragen Sie Stellen ein oder wählen Sie ein Trennzeichen.
„Es gibt bereits einen Primärschlüssel."Pro Dataset ist nur ein Primärschlüssel erlaubt.
„Vorhandene Werte verletzen die Schlüsselregeln …"Ein Quellwert enthält das Trennzeichen oder ist zu lang. Bereinigen Sie die Daten oder ändern Sie die Einstellung.
„Die Berechnung ändern oder umwandeln können nur Dataset-Admins."Ihnen fehlt die Rolle Dataset-Admin.
„Die gespeicherte Berechnung dieses Datasets kann nicht gelesen werden …"Es wurde nichts geändert. Wenden Sie sich an den Support.

6. Daten bearbeiten

Tabellenansicht

Der Tab „Daten" zeigt alle Zeilen des aktuellen Bearbeitungsstands (Head) in einem Grid. Spalten entsprechen dem definierten Schema. Was „Head" bedeutet und wie er sich vom ausgelieferten Stand unterscheidet, erklärt Bearbeitungsstand (Head) & Auslieferungsstatus.

Das Grid lädt immer nur die angezeigte Seite (25, 100 oder 500 Zeilen). Suche, Spaltenfilter und die Filter „Betroffene Zeilen anzeigen" (Typabweichungen) bzw. „Nur fehlerhafte Zeilen" werden auf dem Server über alle Zeilen ausgewertet; die Zeilenzahl unten nennt die Treffer über alle Seiten. Auch sehr große Datasets öffnen deshalb ohne Wartezeit. Suche und Filter wirken auf die gespeicherten Werte — noch nicht gespeicherte Änderungen bleiben sichtbar, verändern aber die Trefferliste erst nach dem Speichern.

Bearbeitungsmodus aktivieren

Zellen sind nicht direkt editierbar. Klicken Sie zuerst oben im Grid auf „Bearbeiten", um den Bearbeitungsmodus zu öffnen. Erst dann erscheinen die Auswahl-Checkboxen, die Aktionsspalte (Duplizieren/Löschen) je Zeile und die Zeile „+ Zeile" am Tabellenende — im Lesemodus bleibt die Ansicht bewusst aufgeräumt und zeigt keine deaktivierten Bedienelemente.

Ein Banner „Bearbeitungsmodus aktiv" bleibt sichtbar, solange Sie im Grid arbeiten, und zeigt einen Hinweis: „Ihre Änderungen werden noch nicht gespeichert."

Zelle bearbeiten

  1. Im Bearbeitungsmodus auf eine Zelle klicken → Zelle wird editierbar
  2. Wert ändern, mit Enter oder Klick in eine andere Zelle bestätigen

Die Änderung ist damit nur lokal vorgemerkt (Entwurf) — noch nicht gespeichert. Der Button „Bearbeiten" wird zu „Speichern (+hinzugefügt ~geändert -gelöscht)" und zeigt laufend, wie viele Zeilen aktuell als hinzugefügt, geändert bzw. zum Löschen markiert vorliegen.

Primärschlüssel ist bei bestehenden Zeilen schreibgeschützt: Der Wert der Primärschlüssel-Spalte lässt sich bei bereits vorhandenen Zeilen nicht mehr ändern (Tooltipp: „Der Primärschlüssel identifiziert diese Zeile und kann nicht geändert werden."). Benötigen Sie einen anderen Schlüssel, legen Sie eine neue Zeile mit dem gewünschten Wert an und löschen die alte. Bei neu angelegten Zeilen (siehe unten) ist die Primärschlüssel-Spalte weiterhin frei editierbar.

Neue Zeile hinzufügen

Im Bearbeitungsmodus über den Button „+ Zeile" am Ende der Tabelle. Neue Zeilen existieren nur im Bearbeitungsmodus und werden beim Speichern dauerhaft angelegt.

Zeile löschen

Im Bearbeitungsmodus: Zeilenmarkierung (Checkbox links) aktivieren → „Löschen" in der Aktionsleiste. Ein Bestätigungsdialog weist darauf hin: „Diese Zeile wird zum Löschen markiert und beim Speichern dauerhaft entfernt." — die Zeile verschwindet also erst endgültig, wenn Sie anschließend speichern.

Bis dahin bleibt eine zum Löschen markierte Zeile an ihrer Stelle durchgestrichen sichtbar. Über das Symbol „Zeile wiederherstellen" in der Aktionsspalte nehmen Sie die Markierung wieder zurück.

Hinweis: Gelöschte Zeilen sind im Audit-Log weiterhin sichtbar und können in früheren Versionen eingesehen werden.

Änderungen speichern oder verwerfen

Massenänderungen

Mehrere Zeilen im Bearbeitungsmodus über die Checkboxen markieren → Aktionsleiste zeigt Optionen für:

Die Checkbox im Tabellenkopf markiert alle Zeilen der angezeigten Seite. Die Markierung bleibt beim Blättern und Filtern erhalten — so können Sie Zeilen über mehrere Seiten hinweg sammeln. Liegen markierte Zeilen außerhalb der angezeigten Seite, nennt die Aktionsleiste ihre Anzahl („davon N nicht auf dieser Seite"). Die Massenaktionen wirken immer auf alle markierten Zeilen.

Alle gefilterten Zeilen auswählen: Passen mehr Zeilen zum Filter, als die Seite zeigt, und haben Sie alle Zeilen der angezeigten Seite markiert, bietet die Aktionsleiste „Alle N gefilterten Zeilen auswählen“ an. Ein Klick markiert alle Treffer über alle Seiten hinweg, die Aktionsleiste bestätigt mit „Alle N gefilterten Zeilen sind ausgewählt.“ So ändern oder löschen Sie zum Beispiel alle Zeilen einer Suche in einem Schritt.


7. Hierarchien abbilden: Tabelle mit Beziehungen oder Baum?

MDM Lite bietet zwei Wege, eine Hierarchie abzubilden — welcher passt, hängt davon ab, ob die Ebenen fest oder variabel sind:

KriteriumTabelle + BeziehungenBaum
Ebenenfest (z. B. Kontinent → Region → Land)variabel, beliebig tief
Spalten je Ebeneje Ebene eigene Spaltenalle Knoten gleiche Spalten
Ebenen einzeln nutzenjede Ebene ist ein eigenes Dataset: eigenes Lookup, eigene Rollen, eigene Versionennur als Ganzes
Funktionsumfangvollständig (u. a. Version wiederherstellen, Beziehungen, FK-Erkennung)eingeschränkt (kein Restore, teilversioniert, MVP-Limit 10.000 Knoten für Baumabfragen, keine Beziehungen)
BeispieleLand → Region → Kontinent, Filiale → Vertriebsgebiet, Produkt → ProduktgruppeOrganigramm, Kontenplan, Kostenstellenstruktur, NACE, ICD-10

Standard ist „Tabelle". „Baum" ist nur dann die richtige Wahl, wenn alle drei Bedingungen zutreffen: (1) Einträge derselben Art sind ineinander verschachtelt, (2) die Tiefe ist variabel oder steht vorab nicht fest, (3) alle Ebenen haben dieselben Spalten. Der Typ ist nach dem Anlegen nicht mehr änderbar — im Zweifel „Tabelle" wählen.

Beispiel: Land → Region → Kontinent (Hierarchie über Beziehungen)

  1. Drei Datasets vom Typ Tabelle anlegen: Kontinent, Region, Land.
  2. Im Dataset Region eine Beziehung zu Kontinent anlegen (Tab „Beziehungen" → „+ Beziehung hinzufügen").
  3. Im Dataset Land eine Beziehung zu Region anlegen.
  4. Importreihenfolge: von oben nach unten — zuerst Kontinent, dann Region, zuletzt Land. Der Grund: FK-Werte werden beim Import gegen das jeweilige Ziel-Dataset geprüft, das Ziel muss also bereits befüllt sein.

Jede Ebene bleibt ein eigenständiges Dataset mit eigenem Lookup, eigenen Rollen und eigener Versionshistorie — siehe Abschnitt 11, Beziehungen zwischen Datasets.

7.1 Baum-Datasets (Eltern-Kind-Hierarchie)

Bei Datasets vom Typ Baum hat jede Zeile einen optionalen Parent (Elternknoten). Damit entstehen Eltern-Kind-Hierarchien beliebiger Tiefe innerhalb eines einzigen Datasets. Das ist etwas anderes als eine „Beziehung" (siehe Abschnitt 11) — der Elternknoten-Verweis verbindet Zeilen desselben Datasets, eine Beziehung verbindet zwei verschiedene Datasets.

Baumansicht vs. Tabellenansicht

Zwischen den Ansichten wechseln über den Schalter oben rechts im Tabellen-Tab.

Knoten anlegen & verschieben

In der Baumansicht legen Sie neue Knoten gezielt unter einem Elternknoten an: Knoten auswählen → „Unterknoten hinzufügen". Ohne Auswahl wird ein Root-Knoten angelegt.

Um einen bestehenden Knoten umzuhängen (anderen Elternknoten zuweisen), wechseln Sie in die Tabellenansicht und ändern den Wert in der Spalte parent. Alternativ lässt sich die Hierarchie per Import (Spalte parent/parent_business_key) neu setzen.

Root-Knoten

Knoten ohne Parent sind Root-Knoten (oberste Ebene). Ein Dataset kann mehrere Root-Knoten haben.


8. Zeitliche Gültigkeit

Jede Zeile kann mit einem Gültigkeitszeitraum versehen werden. Das ermöglicht historisch korrekte Auswertungen.

Felder

FeldBedeutung
Gültig ab (valid_from)Pflichtfeld — ab wann ist diese Zeile gültig
Gültig bis (valid_to)Optional — leer bedeutet „unbegrenzt gültig"

Regeln

As-Of-Abfrage

Über die API kann der Datenstand zu einem beliebigen Stichtag abgerufen werden:

GET /api/datasets/{id}/as-of?date=2024-12-31

Das DWH erhält damit genau die Datensätze, die am angegebenen Datum gültig waren.

Zusammenspiel mit der Versionsaufbewahrung: Ist für den Mandanten oder das Dataset ein Limit für vorgehaltene Versionen konfiguriert (siehe Versionsaufbewahrung (Retention)), liefert As-Of stets den besten noch vorhandenen gültigen Stand. Liegt der angefragte Stichtag vor dem ältesten noch vorhandenen Snapshot, ist das historisch exakte Ergebnis nicht mehr rekonstruierbar. Ohne konfiguriertes Limit (Standard: unbegrenzt) besteht diese Einschränkung nicht.


9. Import (CSV / Excel)

Wann Import statt manueller Eingabe?

Import empfiehlt sich für:

Unterstützte Dateiformate

FormatWeb UIAPI
CSV✅✅
Excel (XLSX)✅✅
Parquet✅✅
JSONL (eine JSON-Zeile pro Datensatz)✅✅
JSON-Body (Datensätze direkt im Request)—✅

Import starten

  1. Dataset öffnen → Button „Importieren" (oben rechts im Detail-Bereich)
  2. Datei auswählen
  3. Import-Modus wählen:
ModusVerhalten
Vollständiger Ersatz (FULL_REPLACE)Alle bisherigen Zeilen werden durch die Importdatei ersetzt
Upsert (UPSERT)Bestehende Zeilen werden aktualisiert, neue hinzugefügt, fehlende bleiben
  1. Fehlerverhalten wählen:
ModusVerhalten
Bei erstem Fehler stoppenDer gesamte Import wird abgelehnt, sobald ein Fehler auftritt
Fehlerhafte Zeilen überspringenKorrekte Zeilen werden übernommen, fehlerhafte protokolliert und übersprungen
  1. „Validieren" klicken — das Tool prüft die Datei, ohne sie zu importieren

Mehrere Excel-Blätter

Enthält eine Excel-Datei mehrere Arbeitsblätter, fragt das Tool, welches Blatt importiert werden soll, bevor Schema und Daten gelesen werden. Enthält nur eines der Blätter tatsächlich Daten (die übrigen sind leer), wählt das Tool dieses Blatt automatisch aus — unabhängig davon, an welcher Position es in der Datei steht — und die Abfrage entfällt.

Validierungsphasen

Das Tool prüft in mehreren Stufen:

  1. Dateiformat — ist die Datei parsebar?
  2. Schema-Konformität — sind alle Pflichtfelder vorhanden?
  3. Zeilenebene — Typkonformität, Pflichtfelder, Enum-Werte
  4. Konsistenz — keine doppelten Business Keys, keine Zeitüberlappungen
  5. Referenzielle Integrität — alle Foreign-Key-Werte existieren im Zieldataset

Fehlerbericht

Bei Validierungsfehlern zeigt das Tool einen strukturierten Fehlerbericht:

Zeile 5:  Spalte 'filial_nr' — Pflichtfeld darf nicht leer sein
Zeile 12: Spalte 'sort_order' — Erwartet Integer, gefunden: "abc"
Zeile 23: Spalte 'region' — Wert 'Mitte' nicht in Auswahlliste

Der Import wird vollständig abgelehnt solange Fehler vorliegen — es gibt keinen Teilimport.

CSV-Format

Import aus der Zwischenablage

Statt eine Datei zu speichern und hochzuladen, können Sie einen Ausschnitt direkt aus Excel, Google Sheets oder LibreOffice in ein bestehendes Dataset übernehmen:

  1. Markieren Sie in der Tabellenkalkulation den Bereich inklusive Kopfzeile und kopieren Sie ihn mit Strg+C (Mac: Cmd+C).
  2. Öffnen Sie in MDM Lite den Import-Dialog des Datasets und drücken Sie Strg+V, oder klicken Sie auf „Aus Zwischenablage einfügen". Verweigert der Browser den Zugriff auf die Zwischenablage, nutzen Sie Strg+V.
  3. Prüfen Sie die Vorschau: Sie zeigt die Kopfzeile, die ersten 20 Zeilen sowie die Anzahl der Zeilen und Spalten. Kopfzeilen, die keiner Spalte des Datasets entsprechen, und fehlende Pflichtspalten sind markiert. Beim Abgleich spielen Groß-/Kleinschreibung sowie unsichtbare Zeichen und überzählige Leerzeichen keine Rolle.
  4. Mit „Verwerfen" löschen Sie die Vorschau und können erneut einfügen. „Importieren" wird erst nach der Vorschau aktiv.

Gültig-ab, Erweiterte Einstellungen, Fehlerbehandlung und Protokollierung funktionieren wie beim Datei-Import. Zahlen und Datumswerte im deutschen Format (1.234,56, 01.10.2026) werden wie beim CSV-Import behandelt. Es gilt dieselbe Größenbegrenzung wie beim Datei-Upload.

Hinweis: Ist die Zwischenablage leer oder enthält nur eine einzelne Zelle ohne Kopfzeile bzw. keine Datenzeile, erscheint eine Fehlermeldung.

KI-gestützte Schema-Erkennung

Beim Onboarding eines neuen Datasets (noch ohne Schema) analysiert das Tool die hochgeladene Datei automatisch und schlägt vor:

Die Vorschläge können vor dem Speichern angepasst werden.

Schnellimport (Vorschau & Bestätigen)

Für den häufigsten Fall ist der Import bewusst kurz gehalten: Nach dem Hochladen sehen Sie eine Vorschau (Zeilen- und Feldanzahl, erkannter Eindeutiger Bezeichner, erste Datenzeilen) und bestätigen direkt. Detaileinstellungen — Spalten umbenennen/ausschließen, Import-Modus, Fehlerverhalten — liegen unter „Erweiterte Einstellungen" und müssen nur im Bedarfsfall geöffnet werden. Wird kein Eindeutiger Bezeichner erkannt, öffnet sich dieser Bereich automatisch und fordert zur Auswahl auf.

Bulk-Import (mehrere Dateien)

Über das Symbol „Bulk-Import" in der Aktionsleiste des Explorers laden Sie mehrere Dateien gleichzeitig hoch — pro Datei entsteht ein eigenes neues Dataset. Jede Datei durchläuft einen kurzen Review-Schritt (Schema, Zielordner), danach werden alle in einem Durchgang importiert.

Duplikat-Erkennung

Beim Anlegen eines Datasets aus einer Datei prüft das Tool, ob bereits ein strukturell ähnliches Dataset existiert (gleiche/ähnliche Spalten). Ist das der Fall, erscheint ein Hinweisbanner mit dem passenden Dataset. Sie können dann direkt in das bestehende Dataset importieren, statt ein Duplikat anzulegen.

Dateigrößen-Limit

KanalMaximale Dateigröße
Web UI (interaktiver Upload)50 MB
API (API-Key)100 MB

Das Limit gilt immer für die gesamte Datei, nicht für einzelne Spalten oder Zeilen. Wird es überschritten, meldet die Anwendung dies bereits beim Auswählen der Datei — mit der Größe Ihrer Datei und dem erlaubten Maximum.


10. Versionierung & Historie

Wie Versionierung funktioniert

Jede gespeicherte Änderung — Zelleditierung, Massenbearbeitung, Import, Schema-Änderung, Restore — erzeugt eine neue Dataset-Version. Versionen sind:

Bearbeitungsstand (Head) & Auslieferungsstatus

Für die tägliche Arbeit sind zwei Begriffe wichtig:

BegriffBedeutung
HeadDie absolut neueste Version eines Datasets — unabhängig davon, ob sie fehlerfrei oder bereits wirksam ist. Die Tabs „Daten"/„Baum" bearbeiten immer den Head.
Ausgelieferte VersionDie neueste gültige und wirksame Version. Das ist der Stand, den externe Konsumenten erhalten: API (GET /current), DWH-Sync, Exporte und der KI-Zugriff (MCP).

Im Regelfall sind Head und ausgelieferte Version identisch. Sie können auseinanderfallen, wenn:

Ein Banner oberhalb des Grids zeigt den jeweiligen Zustand:

Zustand des HeadBanner
Gültig & wirksam„Version #N · ausgeliefert"
Gültig & geplant„geplant ab <Datum> · ausgeliefert wird #M"
Ungültig, ältere gültige Version vorhanden„Version #N ist ungültig (X Fehler) und wird nicht ausgeliefert — Konsumenten sehen weiterhin v#M." + Button „Fehler anzeigen"
Ungültig, keine gültige Version vorhanden„Keine gültige Version — die Auslieferung ist ausgesetzt, bis die Fehler korrigiert sind." + Button „Fehler anzeigen"

Über „Fehler anzeigen" springen Sie zu den betroffenen Zeilen/Spalten, die direkt im Grid markiert werden; der Schalter „Nur fehlerhafte Zeilen" blendet alle übrigen Zeilen aus. Beheben Sie die Fehler und speichern Sie — sobald die neue Version gültig ist, verschwindet das Banner automatisch, und die Auslieferung schaltet auf den korrigierten Stand um. Ein eigener Bestätigungsschritt ist dafür nicht nötig.

Reine Leseansichten ohne Editor (z. B. der Explorer), die auf ein Dataset ohne auslieferbare Version treffen, zeigen den Hinweis „Keine auslieferbare Version vorhanden — im Editor korrigieren."

Baum-Datasets: Auslieferung angehalten. Bei einem Baum ändert MDM Lite Knoten an Ort und Stelle, ältere Versionen eines Baums lassen sich deshalb nicht wiederherstellen. Ist die neueste Version eines Baums fehlerhaft, liefert MDM Lite gar keine Version aus, auch keine ältere. Der Tab „Baum" zeigt dann das Banner „Auslieferung angehalten, bis die Fehler behoben sind" mit dem Button „Fehler anzeigen". Ist die neueste Version erst ab einem zukünftigen Stichtag gültig, lautet es „Auslieferung angehalten bis <Datum>". Solange die Auslieferung angehalten ist:

Sobald Sie die Fehler beheben (bzw. der Stichtag erreicht ist), läuft die Auslieferung automatisch mit der neuesten Version weiter. Bei Tabellen-Datasets bleibt alles wie oben beschrieben: Dort wird weiter die letzte fehlerfreie Version ausgeliefert.

Tipp: Ein Knoten mit einem Gültig-ab-Datum in der Zukunft macht die neue Baumversion zu einer geplanten Version. Die Auslieferung des ganzen Baums ist dann bis zu diesem Datum angehalten.

Schema-Stand historischer Versionen

Jede Version merkt sich, welche Spalten zum Zeitpunkt ihrer Entstehung im Schema existierten. Entfernen Sie später eine Spalte, bleibt sie in allen älteren Versionen unverändert sichtbar:

Die Werte der entfernten Spalte gehen dabei nicht verloren — sie stehen weiterhin in den betroffenen Zeilen. Nicht mehr angezeigt werden sie nur im aktuellen Bearbeitungsstand (Head) und in neu erzeugten Versionen, weil die Spalte dort nicht mehr Teil des Schemas ist.

Die Klassifizierung bleibt beim Löschen erhalten: Beim Löschen einer Spalte merkt sich MDM Lite ihre letzte Klassifizierung. Diese Stufe gilt in allen älteren Versionen weiter, die noch Werte der Spalte enthalten, so als stünde die Spalte noch im Schema. Wurde eine Spalte also erst hochgestuft (etwa auf „Vertraulich") und dann gelöscht, sehen Nutzer und API-Keys unterhalb dieser Stufe ihre Werte auch in älteren Versionen nicht: nicht beim Öffnen im Verlauf, nicht bei As-Of-Abfragen, nicht im Versionsvergleich, nicht im Export, nicht über MCP und nicht in den Bereitstellungstabellen. Das gilt ebenso für eine Spalte, die beim Entfernen einer Beziehung oder beim Kopieren in eine andere Umgebung (Modus „Aktualisieren") wegfällt. Legen Sie später eine Spalte gleichen Namens neu an, hat sie ihre eigene Stufe, die nur für ihre eigenen Versionen gilt. Ein Restore einer älteren Version übernimmt die Werte der gelöschten Spalte nicht in die neue Spalte, wenn die gelöschte Spalte strenger eingestuft war.

Versionen von vor Einführung dieser Funktion kennen ihren damaligen Spaltenstand nicht. Sie zeigen deshalb mit dem ausdrücklichen Hinweis „Schema-Stand dieser Version wurde nicht aufgezeichnet (vor Einführung der Schema-Versionierung) — Anzeige mit dem aktuellen Schema." stattdessen das aktuelle Schema an. Das ist bewusst so gelöst: Statt einen historischen Spaltenstand zu erraten, kennzeichnet das Tool ihn klar als nicht aufgezeichnet — betrachten Sie „aktuelles Schema" in diesem Fall nicht als verlässliche Aussage über den damaligen Stand.

Versionsübersicht

Tab „Verlauf" zeigt:

Version vergleichen (Diff)

  1. In der Versionsübersicht zwei Versionen auswählen
  2. „Vergleichen" klicken
  3. Das Tool zeigt Zeilen, die hinzugekommen, geändert oder entfernt wurden — inkl. Vorher/Nachher-Werten, auf Basis des jeweiligen Spaltenstands beider Versionen

Fehlt für eine der beiden verglichenen Versionen der aufgezeichnete Schema-Stand (Alt-Version, siehe oben), weist ein Hinweis darauf hin, dass für diesen Zeitpunkt ersatzweise das aktuelle Schema herangezogen wird.

Version wiederherstellen (Restore)

Eine ältere Version lässt sich als neuen Bearbeitungsstand reaktivieren, ohne die Historie zu verändern: Restore kopiert die Zeilen der gewählten Version forward-only in eine brandneue Version (Head + 1). Die Quellversion und alle dazwischenliegenden Versionen bleiben dabei unverändert — es handelt sich nicht um ein Zurücksetzen, sondern um eine neue Version mit altem Inhalt.

Wichtig — Restore betrifft ausschließlich die Daten, nicht das Schema: Restore stellt die Zeilen der gewählten Version wieder her. Das aktuelle Schema (welche Spalten es gibt) wird dabei nicht verändert und nicht zurückgesetzt — auch dann nicht, wenn die wiederhergestellte Version ursprünglich zusätzliche oder andere Spalten hatte. Erwarten Sie nach einem Restore, dass eine inzwischen entfernte Spalte automatisch wieder im Schema auftaucht: Das tut sie nicht. Auch ihre Werte werden nicht wiederhergestellt — Restore übernimmt nur Werte von Spalten, die es im aktuellen Schema gibt. Sonst stünden etwa die Werte einer gelöschten vertraulichen Spalte ohne Klassifizierung wieder in den Daten. Die Quellversion selbst behält ihre Werte unverändert; brauchen Sie eine entfernte Spalte samt Werten zurück, setzen Sie als Admin des Datasets den Spaltenstand mit „Daten und Schema wiederherstellen“ zurück, statt nur die Daten wiederherzustellen.

Voraussetzungen:

Vorgehen:

  1. Im Tab „Verlauf" bei der gewünschten Version „Als neue Version wiederherstellen" wählen
  2. Der Dialog nennt Quell- und Zielversionsnummer, verlinkt eine Diff-Vorschau und zeigt unter „Schema-Abweichung zu Version #{Quellversion}" die Unterschiede zwischen dem Schema-Stand der Quellversion und dem aktuellen Schema:
    • Seitdem entfernte Spalten — deren Werte werden nicht wiederhergestellt. Admins des Datasets sehen unter der Abweichung den Hinweis „Auch den Spaltenstand von Version #{Quellversion} wiederherstellen?“ mit dem Button „Daten und Schema wiederherstellen…“ (siehe Schema auf älteren Stand zurücksetzen). Alle anderen sehen „Den Spaltenstand kann ein Admin dieses Datasets zurücksetzen.“
    • Seitdem neu hinzugekommene Spalten — die wiederhergestellten Zeilen haben dafür keine Werte
    • Spalten mit geänderter Struktur (Typ/Pflicht/Unique/Primärschlüssel) seit der Quellversion
    • Ist für die Quellversion kein Schema-Stand aufgezeichnet (Alt-Version, siehe Schema-Stand historischer Versionen), weist der Dialog darauf hin, dass sich eine Abweichung nicht ermitteln lässt
  3. Optional einen Kommentar eintragen (max. 500 Zeichen)
  4. „Auf v{Zielversion} wiederherstellen" klicken

Ergebnis: Version #{Zielversion} entsteht als Kopie der Zeilen von Version #{Quellversion}. Zwei Sonderfälle:

Wiederhergestellte Versionen sind in der Versionsübersicht am Badge „wiederhergestellt aus v{Quellversion}" erkennbar.

Schema auf älteren Stand zurücksetzen

Der normale Restore stellt nur Daten wieder her. Mit „Schema auf Stand v{n} zurücksetzen…“ setzen Sie dagegen den Spaltenstand auf den Stand einer älteren Version zurück: welche Spalten es gibt, ihre Typen, Pflicht- und Eindeutigkeits-Einstellungen, Primärschlüssel, Beziehungen und die Reihenfolge. MDM Lite zeigt vorher genau, was sich ändert, und verlangt für jeden Konflikt eine bewusste Entscheidung.

Wann nutze ich das? Typische Fälle:

Voraussetzungen:

Die zwei Umfänge

UmfangSpaltenZeilen der neuen VersionWann sinnvoll
„Nur Schema – die aktuellen Daten bleiben“wie in Version #ndie aktuellen Daten, angepasst an den SpaltenstandSie wollen den Aufbau zurück, aber nicht die alten Werte
„Schema und Daten von Version #n“wie in Version #ndie Zeilen von Version #nSie wollen den kompletten Stand von damals zurück

Beispiel: Version 5 hatte die Spalten Code, Name und Region. In Version 8 wurde Region gelöscht, danach wurden Zeilen geändert. Der Head ist Version 11.

Wollen Sie eine versehentlich gelöschte Spalte samt Werten zurück, wählen Sie meist „Schema und Daten“, sofern sich die Zeilen seit damals nicht wesentlich geändert haben. Sonst nutzen Sie „Nur Schema“ und tragen die Werte neu ein oder importieren sie.

Vorgehen

  1. Öffnen Sie das Dataset und wechseln Sie in den Tab „Verlauf“.

  2. Wählen Sie im Aktionsmenü der gewünschten Version „Schema auf Stand v{n} zurücksetzen…“. Der Dialog öffnet sich mit dem Umfang „Nur Schema“. Alternativ öffnen Sie bei der Version „Als neue Version wiederherstellen“. Zeigt der Dialog eine Schema-Abweichung, klicken Sie unter „Auch den Spaltenstand von Version #n wiederherstellen?“ auf „Daten und Schema wiederherstellen…“. Der Dialog zum Zurücksetzen öffnet sich dann mit dem Umfang „Schema und Daten“.

  3. Wählen Sie unter „Was soll wiederhergestellt werden?“ den Umfang. Die Erklärung darunter nennt die Nummer der neuen Version.

  4. MDM Lite ermittelt die Änderungen („Änderungen werden ermittelt …“) und zeigt sie gruppiert:

    • „Werden wieder angelegt“: Spalten, die es heute nicht gibt. Je Spalte steht dabei, ob sie leer startet („Wird ohne Werte angelegt …“) oder im Umfang „Schema und Daten“ „Werte aus Version #n: {Anzahl} Zeilen“ mitbringt.
    • „Werden entfernt“: Spalten, die es in Version #n noch nicht gab. Bei Spalten mit Werten steht, wie viele Zeilen betroffen sind und dass ältere Versionen die Werte behalten.
    • „Werden angeglichen“: Spalten, deren Typ, Bezeichnung, Pflicht, Eindeutigkeit, Primärschlüssel, Auswahlwerte, Validierungsregel oder Beziehung abweichen, mit Alt- und Neuwert. Eine geänderte Reihenfolge steht als eigene Zeile.
    • „Klassifizierung“: Spalten, deren Klassifizierung angehoben wird.
    • Hinweise zu Glossar-Zuordnungen (Purview), zur Auslieferung und zu Beziehungen anderer Datasets, die auf eine entfernte Spalte zeigen.

    Ist alles gleich, steht dort „Der Spaltenstand von Version #n entspricht dem aktuellen.“ und es gibt nichts auszuführen.

  5. Lösen Sie jeden Konflikt (siehe unten). Solange einer offen ist, bleibt der Button gesperrt.

  6. Bei Datenverlust (siehe unten) setzen Sie das Häkchen bei „Mir ist klar, dass die Werte entfernter Spalten in der neuen Version fehlen.“

  7. Optional tragen Sie einen Kommentar ein (max. 500 Zeichen). Er erscheint in Verlauf und Änderungsprotokoll.

  8. Klicken Sie auf „Schema zurücksetzen (Version #{neu})“ bzw. „Schema und Daten wiederherstellen (Version #{neu})“.

Ergebnis: Eine neue Version entsteht mit dem Spaltenstand von Version #n. MDM Lite meldet „Version #{neu} wurde mit dem Spaltenstand von Version #n erzeugt.“ (bei „Schema und Daten“: „… mit Spaltenstand und Daten von Version #n erzeugt.“). Im Tab „Verlauf“ trägt die Version das Badge „Schema aus v{n}“ bzw. „Daten und Schema aus v{n}“. Im Änderungsprotokoll steht je Spalte ein Eintrag zur Änderung sowie ein Sammeleintrag „hat das Schema auf einen früheren Stand zurückgesetzt“ (ohne Spaltennamen). Wird die neue Version ungültig, meldet MDM Lite „Version #{neu} wurde erzeugt, ist aber ungültig ({Anzahl} Fehler) – die bisherige gültige Version wird weiterhin ausgeliefert.“

Konflikte und wie Sie sie auflösen

Ein Konflikt blockiert das Zurücksetzen, bis Sie unter „Bitte für jeden Konflikt wählen, wie verfahren werden soll“ eine Auflösung wählen. MDM Lite entscheidet nie still für Sie.

Beziehungen (Fremdschlüssel-Spalten). Eine Spalte, die in Version #n auf ein anderes Dataset verwies, lässt sich nur wieder anlegen, wenn das Ziel heute noch passt. Sonst erscheint ein Konflikt, etwa „Das Ziel der Beziehung gibt es in dieser Umgebung nicht (mehr).“, „Das Ziel der Beziehung ist archiviert …“, „… ist ein Baum. Beziehungen gibt es nur zwischen Tabellen.“, „Die Zielspalte … fehlt im Ziel oder ist dort weder Primärschlüssel noch eindeutig.“ oder „Die Beziehung würde einen Kreis bilden.“ Dafür gibt es:

AuflösungWirkung
„Als Text-Spalte wiederherstellen (Beziehung entkoppeln)“Die Spalte wird als gewöhnliche Text-Spalte angelegt, ohne Beziehung
„Mit einem anderen Dataset verknüpfen“Sie wählen unter „Tabelle für die Beziehung von {Spalte}“ ein anderes Tabellen-Dataset aus. Gibt es in dieser Umgebung ein gleichnamiges Dataset, schlägt MDM Lite es vor („Vorschlag: gleichnamiges Dataset …“). Das Ziel muss dieselben Regeln erfüllen wie bei jeder neuen Beziehung
„Diese Spalte nicht zurücksetzen“Die Spalte bleibt, wie sie heute ist (oder wird nicht angelegt bzw. nicht entfernt). Nur ihre Position folgt dem Zielstand

Daten, die nicht passen (Umfang „Nur Schema“). Passt der Typ der alten Version nicht zu den aktuellen Werten (z. B. Text in einer Zahl-Spalte: „{Anzahl} Werte lassen sich nicht von … in … umwandeln (z. B. …)“) oder wären mit einer Spalte als Primärschlüssel Schlüssel doppelt, wählen Sie „Diese Spalte nicht zurücksetzen“ oder bereinigen zuerst die Daten. Im Umfang „Schema und Daten“ entfallen Typkonflikte in der Regel, weil die Zeilen von Version #n bereits zum damaligen Spaltenstand passen.

Weitere Konflikte betreffen den Bereitstellungsmodus „Aktualisieren & ergänzen (Upsert)“ (er braucht einen Primärschlüssel), fortlaufende Nummern (lassen sich für vorhandene Zeilen nicht nachträglich anlegen), inzwischen reservierte Spaltennamen und berechnete Spalten, deren Berechnungsvorschrift in Version #n nicht gespeichert ist. Auch hier hilft „Diese Spalte nicht zurücksetzen“.

Ergibt die Kombination Ihrer Entscheidungen ein ungültiges Schema (etwa mehrere Primärschlüssel oder eine berechnete Spalte ohne Quellspalte), nennt MDM Lite den Grund. Lösen Sie die Konflikte dann anders auf.

Datenverlust bestätigen

Im Umfang „Nur Schema“ fehlen Spalten, die es in Version #n noch nicht gab, in der neuen Version, und damit ihre Werte. Tragen solche Spalten Werte, verlangt MDM Lite Ihre ausdrückliche Bestätigung (Häkchen „Mir ist klar, …“). Ältere Versionen behalten die Werte und sind weiterhin lesbar, sie gehen nicht verloren. Im Umfang „Schema und Daten“ ersetzt der Stand von Version #n die Zeilen vollständig. Die Vorschau nennt trotzdem je Spalte, wie viele Werte in der neuen Version fehlen.

Klassifizierung sinkt nie

Das Zurücksetzen senkt nie die Klassifizierung einer Spalte (siehe Sensitivitätsklassifizierung). Es gilt immer die strengste Stufe aus der aktuellen Stufe, der Stufe in Version #n und der gemerkten Stufe einer gelöschten Spalte. War eine Spalte damals strenger eingestuft als heute, wird sie wieder angehoben („Klassifizierung von {Spalte} wird angehoben: {alt} → {neu}“). Eine berechnete Spalte ist mindestens so streng wie ihre Quellspalten. Wollen Sie eine Stufe danach senken, tun Sie das bewusst im Tab „Spalten“. Ist eine beteiligte Spalte höher klassifiziert, als Ihre Rolle bearbeiten darf, lehnt MDM Lite den Vorgang ab.

Was zurückgesetzt wird und was bleibt

Wird auf Version #n zurückgesetztBleibt, wie es heute ist
Spalten (anlegen, entfernen), Name in heutiger SchreibweiseAnzeige-Einstellungen im Tab „Daten“ (Sichtbarkeit, Spaltenbreite)
Bezeichnung, Typ, Pflicht, Eindeutig, Primärschlüssel, Auswahlwerte, ValidierungsregelZuordnung der Spalten der Import-Datei
Beziehungen (mit den Auflösungen von oben)Name, technischer Name, Bereitstellungsmodus, Status und Import-Einstellungen des Datasets
Reihenfolge der SpaltenGlossar-Zuordnungen (Purview) bestehender Spalten

Spalten, die es heute und in Version #n gibt, behalten ihre Identität: Glossar-Zuordnungen, eingehende Beziehungen anderer Datasets und Links bleiben erhalten. Eine zurückgeholte Glossar-Zuordnung wird zur Prüfung markiert, weil sich der Begriff inzwischen geändert haben kann. Entfernte Spalten verlieren ihre Zuordnung, wie beim Löschen.

Auswirkung auf die Bereitstellung

Das Zurücksetzen ist eine gewöhnliche Schemaänderung mit neuer Version. Ist das Dataset veröffentlicht und die neue Version gültig, wird sie sofort ausgeliefert: REST-API, Export, die Bereitstellungstabelle auf der Datenplattform und MCP zeigen den geänderten Spaltenstand. Konsumenten sehen dann zum Beispiel eine zurückgeholte Spalte. Die Vorschau weist darauf hin („Das Dataset ist veröffentlicht …“). Wird die neue Version voraussichtlich ungültig, etwa weil Pflichtspalten ohne Werte entstehen, warnt die Vorschau, und ausgeliefert wird weiter die letzte gültige Version.

Wichtig zur Historie

Das Zurücksetzen schreibt die Historie nie um. Es entsteht immer eine neue Version; die Quellversion, alle Versionen dazwischen und das Änderungsprotokoll bleiben unverändert. Das gilt auch für ein Dataset im Status Entwurf. Der Vorgang läuft vollständig oder gar nicht: Bei einem Fehler oder Konflikt entsteht keine Version.

Grenzen des Schema-Zurücksetzens

Titel des Browser-Tabs anpassen (Tenant-Admin)

Sind mehrere MDM-Lite-Tabs offen (verschiedene Mandanten oder Umgebungen wie TEST und PROD), lassen sie sich am Tab-Titel unterscheiden. Ohne Konfiguration lautet der Titel <Mandantenname>@MDM Lite, z. B. Contoso@MDM Lite. Vor der Anmeldung und ohne ausgewählten Mandanten steht nur „MDM Lite". Beim Mandantenwechsel aktualisiert sich der Titel automatisch.

Voraussetzungen: Rolle Admin oder AppAdmin im Mandanten.

Schritte:

  1. Einstellungen → Allgemein (Route /settings/general) öffnen
  2. Im Feld „Titel des Browser-Tabs" ein Muster eintragen, z. B. {tenant} ({env})@MDM Lite — leer lassen für den Standard
  3. Die Vorschau unter dem Feld prüfen, dann „Speichern" klicken
PlatzhalterErsetzt durch
{tenant}Anzeigename des Mandanten (Feld „Anzeigename" auf derselben Seite)
{env}Betriebsumgebung der Installation: DEV, TEST oder PROD (bei lokalen Entwicklungs-Builds local). Nicht zu verwechseln mit den Daten-Umgebungen (Entwicklung/Test/Live) eines Mandanten.

Beispiel: {tenant} ({env})@MDM Lite ergibt auf der TEST-Installation Contoso (TEST)@MDM Lite.

Verifikation: Nach dem Speichern und einem Neuladen der Seite zeigt der Browser-Tab den neuen Titel.

Troubleshooting:

MeldungUrsacheLösung
„Unbekannter Platzhalter. Erlaubt: {tenant}, {env}."Unbekannter Platzhalter oder einzelne geschweifte Klammer (klein geschrieben, genau so)Nur {tenant} und {env} verwenden
„Das Muster darf höchstens 100 Zeichen lang sein."Muster zu langMuster kürzen

Die Änderung wird im Änderungsprotokoll des Mandanten (alter und neuer Wert) festgehalten.

Versionsaufbewahrung (Retention)

Ohne Konfiguration hebt MDM Lite alle Versionen eines Datasets unbegrenzt auf. Bei Datasets mit häufigen Änderungen (z. B. mehrfach täglichem API-Import) wächst die Historie dadurch entsprechend schnell. Admins können deshalb pro Mandant und zusätzlich pro Dataset ein Limit für die Anzahl vorgehaltener Versionen setzen; überzählige ältere Versionen werden automatisch entfernt, sobald eine neue Version entsteht.

Was bleibt garantiert erhalten, auch wenn das Limit überschritten würde:

RegelGrund
Der Headaktuelle Bearbeitungsbasis
Die ausgelieferte VersionStand, den API/DWH/Exporte/MCP aktuell erhalten
Alle geplanten Versionen (zukünftiger Stichtag)werden zum Stichtag automatisch ausgeliefert
Versionen, auf die noch Knoten eines Baum-Datasets verweisenBäume sind teilversioniert — praktisch wird kaum etwas entfernt
Das Audit-Logbleibt vollständig, unabhängig von entfernten Versionen

Das Limit ist damit eine Zielgröße, keine harte Garantie — die Schutzregeln haben immer Vorrang.

Speicherverbrauch

MDM Lite speichert je Version nur die tatsächlich geänderten Zeilen — eine unveränderte Zeile wird beim nächsten Commit, bei einer Massenänderung oder bei einem Import nicht neu geschrieben, sondern von der Vorversion übernommen. Der Speicherbedarf einer Historie wächst deshalb mit der Anzahl geänderter Zeilen (Δ), nicht mit „Anzahl Versionen × Anzahl Zeilen" wie bei einem reinen Voll-Snapshot-Modell. Bei einem Dataset mit täglichem Import und 1 % geänderten Zeilen macht das über ein Jahr einen Unterschied von Größenordnungen (Beispielrechnung: ≈ 50 MB statt ≈ 3,5 GB pro Jahr bei 15.000 Zeilen). Für Sie als Anwender ändert sich dadurch nichts am Verhalten — jede Version bleibt weiterhin vollständig lesbar (Diff, Restore, As-Of, Export), nur der Speicherplatz im Hintergrund wird effizienter genutzt.

Mandanten-weites Limit einrichten (Tenant-Admin)

Voraussetzungen: Rolle Admin oder AppAdmin im Mandanten.

Schritte:

  1. Einstellungen → Allgemein (Route /settings/general) öffnen
  2. Feld „Maximal vorgehaltene Versionen pro Dataset" ausfüllen — leer lassen für unbegrenzt
  3. „Speichern" klicken

Verifikation: Die erfolgreiche Einrichtung erkennen Sie daran, dass beim nächsten Öffnen der Seite der gespeicherte Wert wieder angezeigt wird, und dass der Tab „Verwaltung" eines beliebigen Datasets denselben Wert unter „Mandanten-Limit: {n} Versionen" ausweist.

Troubleshooting:

MeldungUrsacheLösung
„Das Limit muss mindestens 2 sein (oder leer für unbegrenzt)."Wert < 2 eingetragenWert ≥ 2 verwenden oder Feld leeren

Dataset-spezifisches Override einrichten

Ein Dataset kann ein strengeres (niedrigeres) Limit als das Mandanten-Limit erhalten — z. B. für ein besonders schreibintensives Dataset. Das Override kann das Mandanten-Limit nicht überschreiten.

Voraussetzungen: Rolle Admin auf dem Dataset (höhere Hürde als Editor, da Retention Historie unwiderruflich entfernt).

Schritte:

  1. Dataset öffnen → Tab „Verwaltung"
  2. Feld „Override für dieses Dataset" ausfüllen — leer lassen, um das Mandanten-Limit zu übernehmen
  3. „Speichern" klicken

Verifikation: Die Anzeige „Effektives Limit: {n} Versionen" unterhalb des Formulars zeigt den tatsächlich wirksamen Wert — das Minimum aus Mandanten-Limit und Override.

Troubleshooting:

MeldungUrsacheLösung
„Das Limit muss mindestens 2 sein (oder leer für unbegrenzt)."Wert < 2 eingetragenWert ≥ 2 verwenden oder Feld leeren
„Der Override darf das Mandanten-Limit nicht überschreiten."Eingetragener Wert liegt über dem Mandanten-LimitKleineren Wert wählen oder das Mandanten-Limit anheben lassen
Feld ist schreibgeschützt, nur ein Wert wird angezeigtIhre Rolle auf dem Dataset ist niedriger als AdminEinen Dataset-Admin um die Änderung bitten

Auswirkung im laufenden Betrieb

Audit-Log

Das Audit-Log ist das detaillierteste Protokoll: Jede einzelne Zellenänderung ist erfasst mit:

Das Audit-Log kann nicht verändert oder gelöscht werden — es ist die unveränderliche Sicherheitsgrundlage.

Änderungs-Feed (dataset-übergreifend)

Über „Änderungen" in der Kopfzeile öffnen Sie einen dataset-übergreifenden Änderungs-Feed: alle Änderungen über sämtliche Datasets hinweg in einem wählbaren Zeitfenster (Standard: letzte 24 Stunden), neueste zuerst.

Das ist das schnellste Werkzeug zur Ursachensuche, wenn das DWH Auffälligkeiten zeigt — eine Abfrage zeigt alle Änderungen im relevanten Zeitraum (API: GET /api/changes?since=…).

Globale Suche

Über das Suchfeld in der Kopfzeile (oder ⌘K / Strg+K) durchsuchen Sie tenant-weit Datasets, Ordner und Spalten. Treffer sind nach Typ gruppiert; mit den Pfeiltasten navigieren und mit Enter öffnen. Es werden nur Datasets angezeigt, auf die Sie Zugriff haben.


11. Beziehungen zwischen Datasets

Datasets können über Foreign-Key-Spalten miteinander verknüpft werden. Beispiel: Eine „Filiale"-Zeile verweist auf eine „Region" aus dem Regionen-Dataset.

Über Beziehungen bilden Sie auch Hierarchien mit festen Ebenen ab — siehe Abschnitt 7, Hierarchien abbilden für die Entscheidungsregel und das durchgerechnete Beispiel Land → Region → Kontinent. Beziehungen funktionieren derzeit nur zwischen Datasets vom Typ Tabelle — ein Dataset vom Typ Baum kann bisher weder Ziel noch Quelle einer Beziehung sein.

Beziehung anlegen

Variante A – Schema-Tab:

  1. Im Schema-Tab eine neue Spalte vom Typ ForeignKey anlegen
  2. Im Feld „Referenz-Dataset" das Ziel-Dataset (und die Schlüsselspalte) auswählen
  3. Speichern

Variante B – Quick-Connect: Im Tab Beziehungen direkt „Verbinden" wählen und das Ziel-Dataset auswählen. Das Tool legt die FK-Spalte automatisch an und wählt den passenden Eingabemodus (Dropdown bei wenigen, Suchfeld bei vielen Zielzeilen).

In der Tabellenansicht erscheint die FK-Spalte je nach Modus als Dropdown oder Suchfeld — nur gültige Werte aus dem Referenz-Dataset sind auswählbar. „Gültig" heißt: Der Eintrag ist im Referenz-Dataset heute gültig. Gelöschte oder beendete Einträge werden nicht mehr angeboten. Importierte FK-Spalten sind im Grid schreibgeschützt; über das Symbol ↗ lässt sich der Zieldatensatz einsehen.

Verweist eine Zeile auf einen Eintrag, den es im Referenz-Dataset nicht mehr gibt, zeigt das Grid den Wert rot mit ⚠ an (Tooltip „Nicht gefunden – Eintrag existiert im Ziel nicht mehr"). Korrigieren Sie solche Werte, indem Sie einen gültigen Eintrag wählen, oder holen Sie den Eintrag im Referenz-Dataset zurück (z. B. per Restore einer früheren Version).

KI-gestützte FK-Erkennung

Das Tool kann passende Beziehungen automatisch vorschlagen: Im Schema- oder Beziehungen-Tab „Beziehungen erkennen" wählen. Die KI/Heuristik analysiert Spaltennamen und Werte und liefert Kandidaten mit Confidence-Score. Vorschläge können einzeln übernommen werden — dabei wird die FK-Spalte angelegt und (auf Wunsch) befüllt.

Wer darf das? Die Erkennung erfordert mindestens die Rolle Editor auf dem Dataset. Viewer und API-Keys ohne write-Scope erhalten eine Fehlermeldung (403). Ein API-Key, der auf bestimmte Datasets beschränkt ist, berücksichtigt nur diese.

Was wird vorgeschlagen? Nur Spalten, die Sie laut Datenklassifizierung sehen dürfen, und nur Ziel-Datasets, die Sie lesen dürfen und deren Schlüsselspalte für Sie sichtbar ist.

Was geht an den KI-Anbieter? Die Web-Oberfläche nutzt die heuristische Erkennung; der KI-Modus (mode: "ai" oder "hybrid") ist über die API erreichbar. Dabei gehen nur Spaltennamen, Beschriftungen und bis zu zehn Beispielwerte von Spalten bis zur Stufe internal an den KI-Anbieter — auch für Admins. Spalten der Stufen confidential und restricted und Ziel-Datasets mit einer solchen Schlüsselspalte werden nie übermittelt. Jeder KI-Aufruf erscheint im Änderungsprotokoll des Datasets als Eintrag ai_query (ohne die übermittelten Werte).

Ist kein KI-Provider konfiguriert, weist das Tool darauf hin; die heuristische Erkennung funktioniert weiterhin. Über die API liefert mode: "ai" dann 503 mit ai_not_configured, mode: "hybrid" die heuristischen Vorschläge mit dem Hinweis aiError.

Beziehungen-Tab

Der Tab „Beziehungen" zeigt eine visuelle Übersicht (mit Verbindungslinien) aller ein- und ausgehenden Verknüpfungen des Datasets. Jede Beziehung trägt einen Health-Status:

StatusBedeutung
OKZielspalte existiert, Werte auflösbar
BrokenZielspalte/Dataset existiert nicht mehr — Beziehung reparieren
Stale (archiviert)Ziel-Dataset ist archiviert

Zusätzlich zählt jede ausgehende Beziehung die Zeilen, deren Wert im Ziel nicht gefunden wird (z. B. „2 Zeilen verweisen auf nicht gefundene Einträge"). Gezählt werden nur Zeilen, die heute oder künftig gültig sind; abgelaufene Historie zählt nicht.

Eine Beziehung lässt sich hier per Papierkorb-Symbol wieder entfernen — das löscht die zugehörige Fremdschlüssel-Spalte. Der Bestätigungsdialog zeigt eine Vorschau, wie viele Zeilen Werte enthalten, sowie denselben Breaking-Change-Hinweis wie beim Löschen einer Spalte im Schema-Tab: Neue Versionen, Exporte und API-Antworten enthalten die Spalte danach nicht mehr, und API-Konsumenten oder DWH-Abfragen, die sie erwarten, können fehlschlagen. Historische Versionen behalten die Spalte und ihre Werte unverändert (siehe Schema-Stand historischer Versionen). Wollen Sie stattdessen nur die Verknüpfung auflösen und die Werte als normale Textspalte behalten, nutzen Sie „Beziehung entkoppeln" statt „entfernen".

Validierung bei Import & Pflege

Foreign-Key-Werte werden beim Import und beim Speichern im Grid geprüft: Ein Wert, der im Referenz-Dataset nicht existiert, führt zu einem Validierungsfehler bzw. blockiert das Speichern. Geprüft wird gegen die Einträge, die am Stichtag der Änderung gültig sind (bei einer Zeile mit späterem „Gültig ab" an diesem Datum). Ein Eintrag, der zum Stichtag bereits beendet ist, gilt als nicht gefunden. Der Beziehungen-Tab zeigt die Zahl der Zeilen mit nicht gefundenen Werten je Beziehung.

Verwendete Einträge können nicht gelöscht werden

Ein Eintrag, auf den Zeilen eines anderen Datasets noch verweisen, lässt sich nicht entfernen. Das gilt für das Löschen (auch Mehrfachauswahl), das Ändern des Schlüsselwerts, einen Import „Vollständig ersetzen" ohne diesen Eintrag, einen Restore auf eine Version ohne ihn und die Kopie aus einer anderen Umgebung. Das Tool speichert dann nichts und zeigt den Dialog „Einträge werden noch verwendet": welches Dataset, welche Spalte, wie viele Zeilen und welche Einträge betroffen sind, mit Link zum verweisenden Dataset. Datasets, die Sie nicht lesen dürfen, erscheinen nur als Zahl („2 Zeilen in Datasets ohne Ihre Leseberechtigung"). Ihre Änderungen im Grid bleiben erhalten, die betroffenen Zeilen sind markiert.

So gehen Sie vor:

  1. Im verweisenden Dataset die betroffenen Zeilen ändern: einen anderen Eintrag wählen, den Wert leeren (wenn die Spalte kein Pflichtfeld ist) oder die Zeile zum selben Stichtag beenden.
  2. Danach den Eintrag im Referenz-Dataset entfernen.

Nicht blockiert werden:

Der Schutz greift beim Entfernen einzelner Einträge. Das Löschen einer ganzen Schlüsselspalte im Schema-Tab bleibt erlaubt und zeigt nur eine Warnung.


12. Export

Manueller Export

Im Tab „Daten" einer Dataset-Detailseite: Button „Exportieren" → Format wählen:

FormatEinsatzgebiet
JSONAPI-Konsumenten, Entwickler
CSVExcel, BI-Tools, allgemeine Weiterverarbeitung
Excel (.xlsx)Direkte Weitergabe an Fachbereiche, die mit Excel arbeiten
SQLFertiges INSERT-Skript zum Einspielen in eine Zieldatenbank

Der Export enthält immer die aktuelle Version der Daten. Historische Versionen können über die API exportiert werden (?version= bzw. ?date=, alle Formate) — Spaltenkopf bzw. Feldsatz entsprechen dabei dem Schema-Stand der exportierten Version: Ein Export einer Version von vor einer Spaltenentfernung enthält diese Spalte samt Werten weiterhin.

SQL-Export konfigurieren

Der SQL-Export öffnet einen eigenen Dialog mit zwei Optionen:

OptionWerteBedeutung
SQL-DialektANSI / PostgreSQL, T-SQL (SQL Server), Fabric / Azure WarehouseBestimmt Quoting, Datentypen und Syntax der erzeugten INSERT-Anweisungen
CREATE TABLE voranstellenAn/AusStellt dem Skript eine zum Schema passende CREATE TABLE-Anweisung voran

Sowohl die generierte CREATE TABLE-Anweisung als auch der Dateiname des SQL-Exports verwenden standardmäßig den technischen Namen des Datasets als Tabellennamen.


13. Bereitstellung auf der Datenplattform (Microsoft Fabric)

MDM Lite stellt veröffentlichte Datasets auf der Datenplattform (Microsoft Fabric/OneLake) bereit — als Tabelle, die auf allen Bereitstellungswegen identisch aufgebaut ist. Eine vollständige Schritt-für-Schritt-Anleitung — einschließlich Azure-Konfiguration, SAS-Token-Einrichtung, Notebook-Generierung und Planung — finden Sie im dedizierten Integrationshandbuch:

→ Microsoft Fabric & OneLake – Integrationshandbuch

Wichtiger Hinweis für bestehende Tabellen: Der Tabellenvertrag in diesem Kapitel gilt seit dem Release von September 2026 ohne Übergangsfrist. Bereits auf der Datenplattform bestehende Tabellen werden beim nächsten Export bzw. Notebook-Lauf mit dem neuen Schema überschrieben (neue Systemspalten, andere Datentypen, die Spalte rdm_row_id entfällt ersatzlos). Views, Power-BI-Modelle oder Pipelines, die die alten Systemspalten lesen, müssen danach angepasst werden. Details siehe Moduswechsel und Aufbewahrung unten und den Abschnitt „Einmalige Umstellung“ im Integrationshandbuch.

Bereitstellungsweg und Bereitstellungsmodus

Zwei unabhängige Achsen bestimmen, was auf der Datenplattform ankommt:

AchseFrageWer legt sie fest
BereitstellungswegWie kommen die Daten auf die Datenplattform?Admin/IT, einmalig eingerichtet (Integrationshandbuch)
BereitstellungsmodusWas enthält die Tabelle?Dataset-Admin, je Dataset (dieses Kapitel)

Die Bereitstellungswege:

WegBeschreibung
OneLake direktMDM Lite schreibt die Delta-Tabelle direkt ins Fabric-Lakehouse — kein eigener Storage Account nötig
OneLake ShortcutMDM Lite schreibt die Delta-Tabelle in einen eigenen ADLS-Gen2-Container; Fabric bindet sie per Shortcut ein
Fabric-NotebookEin generiertes Notebook ruft die Tabelle über die API ab und schreibt sie selbst — einzeln oder als Sammel-Notebook für mehrere Datasets

Gleich, welchen Weg Sie nutzen: Für dasselbe Dataset im selben Bereitstellungsmodus sind Tabellenname, Spalten, Datentypen, Systemspalten und Zeilen byte-identisch. Ein Wechsel des Wegs (z. B. von OneLake Shortcut zu OneLake direkt) ändert an der Tabelle selbst nichts.

Den Bereitstellungsmodus wählen

Ort: Dataset öffnen → Tab „Integration" → Abschnitt „Bereitstellung auf der Datenplattform" (derselbe Abschnitt wie der technische Tabellenname weiter unten).

Berechtigung: Nur ein Mitglied mit der effektiven Dataset-Rolle Admin kann den Modus ändern — dieselbe Hürde wie beim technischen Namen und bei der Versionsaufbewahrung. Editor und Viewer sehen die Auswahl schreibgeschützt. API-Keys können den Modus nie ändern (sie erreichen nie die Rolle Admin).

Standard: Jedes Dataset — neu angelegt oder bereits bestehend — startet im Modus „Aktueller Stand".

Die verfügbaren Modi:

ModusInhaltGeeignet für
Aktueller Stand (Standard)Genau die heute ausgelieferte Version, nicht mehr und nicht weniger — wie eine normale Tabelle, ohne HistorieLookup- und Mapping-Tabellen, Joins im Berichtswesen, alles, was den Stand von heute braucht
Vollständige HistorieJeder frühere Stand jeder Zeile bleibt als eigene Zeile erhalten (SCD Typ 2)Historisierte DWH-Dimensionen, Revision, reproduzierbare Berichte

„Aktualisieren & ergänzen (Upsert)" ist in der Oberfläche als dritter, geplanter Modus sichtbar, aber noch nicht verfügbar — ein Speicherversuch mit diesem Wert schlägt fehl. Bis dahin deckt die Historie mit einer entsprechend gefilterten Abfrage denselben Anwendungsfall ab (siehe Zwei Zeitachsen).

Entscheidungshilfe:

Die Modi am Beispiel

Kostenstellen-Dataset mit Schlüsselspalte kostenstelle und Spalte name. Verlauf:

VersionÄnderung
34711 „Marketing" angelegt, gültig ab 2026-01-01
5Name korrigiert zu „Marketing & Kommunikation"
74799 „Test" angelegt, gültig ab 2026-07-01
8Löschen mit Stichtag 2026-07-01: 4711 wird beendet (rdm_valid_to 2026-06-30), 4799 entfällt ganz (am selben Tag gültig geworden)

Aktueller Stand nach Version 8 — nur die heute gültige bzw. zuletzt gültige Zeile:

kostenstellenamerdm_valid_fromrdm_valid_tordm_versionrdm_delivered_at
4711Marketing & Kommunikation2026-01-012026-06-3082026-07-01 08:00

„Marketing" (die alte Bezeichnung) und 4799 fehlen — genau wie in einer normalen, nicht historisierten Tabelle.

Vollständige Historie nach Version 8 — jeder Stand, der je ausgeliefert war, als eigene Zeile:

kostenstellenamerdm_valid_fromrdm_valid_tordm_versionrdm_version_tordm_delivered_atrdm_delivered_tordm_is_current
4711Marketing2026-01-01352026-01-02 09:002026-03-10 14:00false
4711Marketing & Kommunikation2026-01-01582026-03-10 14:002026-07-01 08:00false
4711Marketing & Kommunikation2026-01-012026-06-3082026-07-01 08:00true
4799Test2026-07-01782026-06-15 10:002026-07-01 08:00false

Nichts wird überschrieben oder gelöscht: WHERE rdm_is_current ergibt exakt dieselben fachlichen Zeilen wie „Aktueller Stand".

Zwei Zeitachsen: fachliche Gültigkeit und Bereitstellungszeit

Die Bereitstellungstabelle unterscheidet zwei unabhängige Zeitachsen:

ZeitachseFrageSpalten
Fachliche GültigkeitAb wann und bis wann gilt die Zeile in der realen Welt?rdm_valid_from, rdm_valid_to
BereitstellungszeitSeit welcher MDM-Lite-Version und seit wann liefert MDM Lite diesen Stand aus?rdm_version, rdm_delivered_at; in der Historie zusätzlich rdm_version_to, rdm_delivered_to, rdm_is_current

Ein leeres rdm_valid_to heißt „fachlich noch offen", nicht „aktueller Stand" — ein korrigierter Name ist ein überholter Stand, auch wenn seine fachliche Gültigkeit weiterhin offen ist (siehe Zeile 1 im Beispiel oben).

Drei typische Abfragen auf der Historie:

-- Heute fachlich gültige Zeilen (funktioniert in jedem Modus)
SELECT * FROM kostenstellen
WHERE rdm_valid_from <= current_date
  AND (rdm_valid_to IS NULL OR rdm_valid_to >= current_date)

-- Aktueller Stand, aus der Historie abgeleitet
SELECT * FROM kostenstellen_history WHERE rdm_is_current

-- Stand zum Monatsabschluss (30.06., 23:59 UTC)
SELECT * FROM kostenstellen_history
WHERE rdm_delivered_at <= '2026-06-30T23:59:00Z'
  AND (rdm_delivered_to IS NULL OR rdm_delivered_to > '2026-06-30T23:59:00Z')

Was passiert bei …

EreignisAktueller StandVollständige Historie
Wertänderung (Editor, Import)Zeile zeigt neuen Wertalter Stand geschlossen, neuer Stand ab der neuen Version
Löschen im Editor (Enddatierung)Zeile bleibt, rdm_valid_to gesetztneuer Stand mit rdm_valid_to, alter Stand geschlossen
Entfernen am selben Tag gelöscht (Import „Vollständiger Ersatz" ohne die Zeile)Zeile verschwindetStand geschlossen, ohne Nachfolger
Nur Reihenfolge geändertrdm_sort_order aktualisiert, keine neue Versionkein neuer Stand, rdm_sort_order aktualisiert
Neue Spalte, ohne StandardwertSpalte kommt hinzuSpalte kommt hinzu, keine neuen Stände
Spalte über  höchste Klassifizierung für die Bereitstellung hochgestuft oder höchste Klassifizierung gesenktSpalte verschwindet mit dem automatischen Rückzug (etwa 30 Sekunden), abgelöste Dateien werden sofort gelöschtdito, aus allen Ständen (siehe Rückzug)
Zurückziehen, ArchivierenTabelle bleibt unverändertdito; nach erneutem Veröffentlichen vollständig nachgezogen
Dataset endgültig löschen (Purge)Tabelle bleibt auf der Datenplattform stehen — MDM Lite löscht dort nie eine Tabelledito
Retention entfernt ältere Versionenkeine Wirkung (der ausgelieferte Stand ist geschützt)Historie beginnt bei der ältesten noch aufbewahrten Version

Welche Spalten auf die Datenplattform gehen (Klassifizierung)

Wie im Klassifizierungskapitel beschrieben, kann jede Spalte eine Sensitivitätsstufe tragen (public, internal, confidential, restricted). Für die Bereitstellung gilt zusätzlich eine mandantenweite höchste Klassifizierung für die Bereitstellung (in diesem Kapitel kurz „höchste Klassifizierung"): Nur Spalten, deren Stufe diese höchste Klassifizierung nicht überschreitet, verlassen MDM Lite auf irgendeinem Bereitstellungsweg. Es gibt genau eine höchste Klassifizierung für alle Wege — OneLake und Fabric-Notebook zeigen also nie unterschiedliche Spaltenmengen.

Die höchste Klassifizierung ist die einzige Einstellung, die steuert, was MDM Lite in Richtung Datenplattform verlässt. In der Oberfläche der Bereitstellung heißen die Stufen Öffentlich, Intern, Vertraulich und Eingeschränkt (technisch public bis restricted; im Schema-Tab heißt die höchste Stufe „Streng vertraulich" — gemeint ist dieselbe Stufe restricted).

Wichtig — API-Key-Klassifizierungsgrenzen gelten für OneLake nicht: Die Klassifizierungsgrenze eines einzelnen API-Keys oder einer Rolle formt die Tabelle auf dem OneLake-Weg (direkt und Shortcut) nie. Dort zählt ausschließlich die höchste Klassifizierung des Mandanten. Nur auf dem Notebook-Weg, der die Tabelle über die API abruft, wird ein Key mit niedrigerer höchste Klassifizierung abgewiesen (siehe unten).

Die höchste Klassifizierung einrichten und ändern

Voraussetzungen: Rolle Admin oder AppAdmin im Mandanten.

Schritte:

  1. Einstellungen → Allgemein öffnen.
  2. Im Feld „Höchste Klassifizierung für die Bereitstellung" die Stufe wählen — Öffentlich, Intern (Standard), Vertraulich oder Eingeschränkt.
  3. „Speichern" klicken.
  4. Ändert sich die Stufe, öffnet MDM Lite vor dem Speichern einen Bestätigungsdialog (siehe nächster Abschnitt). Lesen Sie ihn und bestätigen Sie mit „Klassifizierung anheben" bzw. „Klassifizierung senken" — oder brechen Sie mit „Abbrechen" ab. Ohne Bestätigung wird nichts gespeichert.

Verifikation: Der gespeicherte Wert wird beim nächsten Öffnen der Seite wieder angezeigt. Unter Einstellungen → Microsoft Fabric steht die höchste Klassifizierung schreibgeschützt als „Höchste Klassifizierung für die Bereitstellung: …" (mit dem Zusatz „Spalten bis einschließlich … werden übertragen; höher eingestufte bleiben in MDM Lite") und dem Hinweis „Ändern unter Einstellungen → Allgemein". Neben der Einstellung (Allgemein, Fabric, Bereitstellungs-Assistenten) erklärt das Info-Symbol i die Rangfolge der Stufen: Öffentlich < Intern < Vertraulich < Eingeschränkt. Es lässt sich per Tastatur öffnen und mit Esc schließen. Editoren und Viewer können die höchste Klassifizierung nicht ändern; wo die Oberfläche sie anzeigt, verweist sie für sie auf die Mandanten-Admins.

Der Bestätigungsdialog beim Ändern

Jede Änderung der höchsten Klassifizierung wird bestätigt, weil sie bestimmt, welche Daten MDM Lite verlassen. Der Text hängt von der Richtung ab:

ÄnderungTitelWas der Dialog sagt
Anheben (z. B. Intern → Vertraulich)„Höchste Klassifizierung für die Bereitstellung auf „[Stufe]" anheben?"Ab der nächsten Bereitstellung verlassen zusätzlich Spalten dieser Stufe MDM Lite, auf allen Bereitstellungswegen. Die Zugriffskontrolle auf der Datenplattform liegt bei Ihnen. Bei aktivem Auto-Export geschieht das innerhalb von etwa 30 Sekunden.
Anheben auf „Vertraulich"ditoZusätzlich: Lese-Keys können Bereitstellungstabellen nicht mehr abrufen — ein Fabric-Notebook mit Lese-Key funktioniert dann nicht mehr.
Anheben auf „Eingeschränkt"ditoZusätzlich: Kein API-Key kann Bereitstellungstabellen mehr abrufen — der Notebook-Weg ist dann nicht mehr nutzbar.
Senken (z. B. Vertraulich → Intern)„Höchste Klassifizierung für die Bereitstellung auf „[Stufe]" senken?"Spalten über der neuen Grenze werden bei der nächsten Bereitstellung von der Datenplattform entfernt. Views und Berichte, die diese Spalten lesen, brechen. Zusätzlich: Bestehende Bereitstellungen, deren Schlüsselspalte höher eingestuft ist als die neue höchste Klassifizierung, schlagen ab der nächsten Bereitstellung fehl (403 delivery_ceiling_exceeds_key), bis ein Admin Modus oder höchsten Klassifizierung ändert.

Automatischer Rückzug: Beim Senken entfernt MDM Lite zurückgezogene Spalten auf dem OneLake-Weg von selbst, in der Regel innerhalb von etwa 30 Sekunden und auch ohne aktivierten Auto-Export; die abgelösten Dateien mit den Werten werden dabei sofort gelöscht (siehe Was beim Senken oder Hochstufen mit bereits bereitgestellten Daten passiert).

Ein bewusster „Vollexport": höchste Klassifizierung auf „Eingeschränkt"

Sollen alle Spalten eines Datasets auf die Datenplattform gehen — auch vertrauliche und eingeschränkte —, gibt es dafür keinen Sonderweg: Sie setzen die höchste Klassifizierung bewusst auf Eingeschränkt. Das ist eine Entscheidung des Mandanten, die für alle Datasets und alle Bereitstellungswege gilt.

  1. Einstellungen → Allgemein → „Höchste Klassifizierung für die Bereitstellung" → Eingeschränkt wählen, „Speichern" klicken.
  2. Im Dialog „Höchste Klassifizierung für die Bereitstellung auf „Eingeschränkt" anheben?" die Hinweise lesen und „Klassifizierung anheben" klicken.
  3. Erwartetes Ergebnis: Ab der nächsten Bereitstellung enthält jede Tabelle alle Spalten. Die Hinweisboxen zeigen dann „Diese Bereitstellung enthält alle Spalten dieses Datasets, auch vertrauliche und eingeschränkte. Die Zugriffskontrolle auf der Datenplattform liegt bei Ihnen."

Was das bedeutet:

Die Hinweise in der Oberfläche

Damit Sie nicht raten müssen, was ein Bereitstellungsweg enthält, zeigt MDM Lite an fünf Stellen, welche Spalten auf die Datenplattform gehen. Dazu gehört die höchste Klassifizierung im Dataset („Höchste Klassifizierung in diesem Dataset: …"). MDM Lite leitet sie aus den Spalten des aktuellen Schemas ab und speichert sie nicht.

OrtWas Sie sehen
OneLake-Shortcut-Assistent, Schritt 1Box „Welche Spalten auf die Datenplattform gehen" mit Stufen-Badge, Aussage zur höchsten Klassifizierung, dem Hinweis „Klassifizierungsgrenzen einzelner API-Keys gelten für diesen Weg nicht" und dem Link „Einstellungen → Allgemein öffnen" (nur für Admins; andere sehen „Nur Mandanten-Admins können  höchste Klassifizierung für die Bereitstellung ändern (Einstellungen → Allgemein).")
Tab „Integration" des Datasets, Abschnitt „Bereitstellung auf der Datenplattform"Dieselbe Aussage in einer Zeile, z. B. „Stellt Spalten bis „Intern" bereit; 2 Spalte(n) zurückgehalten."
Einstellungen → Microsoft FabricDie höchste Klassifizierung schreibgeschützt, mit Verweis auf Einstellungen → Allgemein
„Mit DWH verbinden" und Fabric-Sammel-NotebookBei einer höchsten Klassifizierung über „Intern" der Hinweis „Bei  höchsten Klassifizierung für die Bereitstellung über „Intern" kann ein Notebook mit Lese-Key die Tabelle nicht abrufen. Nutzen Sie OneLake direkt oder OneLake Shortcut." — sichtbar, bevor Sie einen Key anlegen
Einstellungen → AllgemeinDer Bestätigungsdialog beim Ändern (siehe oben)

Der Text hängt von der höchsten Klassifizierung ab. „Diese Bereitstellung enthält alle Spalten …" erscheint nur, wenn es stimmt: bei höchster Klassifizierung Eingeschränkt oder wenn keine Spalte zurückgehalten wird und das Dataset vertrauliche Spalten hat. Sonst lautet der Text „Diese Bereitstellung enthält Spalten bis zur Stufe „[Stufe]". [n] Spalte(n) dieses Datasets liegen darüber und werden nicht bereitgestellt." (bzw. „… Keine Spalte dieses Datasets liegt darüber."). Die Namen zurückgehaltener Spalten nennt MDM Lite nie, nur ihre Anzahl.

Auch auf der Datenplattform sichtbar: Jede Bereitstellungstabelle trägt die Tabelleneigenschaft mdmlite.deliveryCeiling mit der höchsten Klassifizierung, mit der sie geschrieben wurde (public, internal, confidential oder restricted). So sehen auch Konsumenten und Governance-Werkzeuge in Fabric, bis zu welcher Stufe die Tabelle Daten enthält. Prüfen können Sie das mit SHOW TBLPROPERTIES <Tabelle> bzw. DESCRIBE DETAIL <Tabelle>. Nach einer Änderung der höchsten Klassifizierung zeigt die Eigenschaft den neuen Wert, sobald die Tabelle neu bereitgestellt wurde. Tabellen, die vor Einführung der Eigenschaft geschrieben wurden, erhalten sie bei ihrer nächsten Bereitstellung.

Auswirkungen auf die Tabelle

Was beim Senken oder Hochstufen mit bereits bereitgestellten Daten passiert

Wird eine Spalte hochgestuft oder die höchste Klassifizierung gesenkt, liegt die Spalte zunächst noch in der Tabelle auf der Datenplattform. MDM Lite nennt diesen Zustand Rückzug ausstehend (pending) und schreibt die Tabelle auf dem OneLake-Weg von selbst ohne die Spalte neu.

So läuft der Rückzug ab:

Den Status ansehen: Bei ausstehendem Rückzug zeigt die Oberfläche (Assistent, Tab „Integration") die Warnung „Die Tabelle auf der Datenplattform enthält noch Spalten, die inzwischen über  höchsten Klassifizierung für die Bereitstellung liegen. MDM Lite entfernt sie bei der nächsten Bereitstellung." Im Assistenten ersetzt sie den Hinweis „Die Daten wurden nach dem Export geändert". Dieselbe Information liefert die API im Block delivery_classification des OneLake-Status (Details im Integrationshandbuch):

FeldBedeutung
delivery_ceilingDie höchste Klassifizierung des Mandanten
dataset_levelHöchste Klassifizierung im aktuellen Schema des Datasets
withheld_column_countAnzahl der Spalten, die wegen der höchsten Klassifizierung nicht bereitgestellt werden
retractionnone — nichts zurückzuziehen. pending — die Tabelle enthält noch Spalten über der höchsten Klassifizierung, die nächste Bereitstellung entfernt sie. blocked — MDM Lite kann derzeit nichts schreiben; der Grund steht in retraction_blocked_reason.

Was tun bei pending?

  1. Warten Sie ab: Der automatische Rückzug läuft in der Regel etwa 30 Sekunden nach der Änderung. Wer nicht warten will, löst die Bereitstellung selbst aus: Jetzt bereitstellen bzw. Exportieren → Export to OneLake; bei Notebooks der nächste Lauf.
  2. Erwartetes Ergebnis: Die Warnung verschwindet, die Tabelle enthält die Spalten nicht mehr, und die abgelösten Datendateien sind gelöscht.
  3. Prüfen Sie bei Bedarf die übrigen Stellen der Checkliste zu Rückständen (_delta_log, Papierkorb, Kopien).

Was tun bei blocked? MDM Lite schreibt dann nichts. Die Warnung nennt den Grund: „… kann sie derzeit nicht entfernen: [Grund]. Beheben Sie den Grund oder bereinigen Sie die Tabelle auf der Datenplattform."

Grund in der WarnungUrsacheWas Sie tun
das Dataset ist nicht veröffentlichtDas Dataset ist zurückgezogen oder archiviertVeröffentlichen Sie das Dataset erneut; danach entfernt die nächste Bereitstellung die Spalten. Soll es unveröffentlicht bleiben, bereinigen Sie die Tabelle manuell (siehe Checkliste).
es gibt keine auslieferbare VersionEs gibt keine gültige, bereits wirksame Version (z. B. nur geplante Versionen mit zukünftigem Stichtag)Sorgen Sie für eine wirksame Version bzw. warten Sie den Stichtag ab. Alternativ bereinigen Sie die Tabelle manuell.
die Bereitstellung des Baums ist zurückgehaltenEin Baum-Dataset wird derzeit nicht ausgeliefert (siehe Baum-Datasets in der Bereitstellung)Beheben Sie die Ursache am Dataset, oder bereinigen Sie die Tabelle manuell.
die Schlüsselspalte liegt über  höchsten Klassifizierung für die BereitstellungOhne bereitstellbaren Schlüssel schreibt MDM Lite bei Baum-Datasets (künftig auch bei Upsert) nichtsStufen Sie die Schlüsselspalte herunter, sofern fachlich vertretbar. Oder heben Sie die höchste Klassifizierung an — das gibt aber alle Spalten bis zu dieser Stufe frei. Oder bereinigen Sie die Tabelle manuell.
die Fabric-Integration ist deaktiviertDie Integration ist ausgeschaltet oder die Berechtigung entzogenAktivieren Sie sie unter Einstellungen → Microsoft Fabric, bzw. lassen Sie die Funktion für den Mandanten freischalten.
die Tabelle wurde außerhalb von MDM Lite verändertEin fremder Commit (z. B. OPTIMIZE, VACUUM) liegt auf der TabelleEntfernen Sie den fremden Job und bereinigen Sie die Tabelle bei Bedarf manuell. Den Grund kennt MDM Lite, sobald ein Bereitstellungsversuch daran gescheitert ist (delta_table_modified_externally); danach versucht der Rückzugslauf es nicht erneut. Lösen Sie nach dem Beheben Exportieren → Export to OneLake aus.

Die manuelle Bereinigung beschreibt die folgende Checkliste. Blockierte Fälle bereinigt MDM Lite nicht automatisch.

Checkliste für Admins: Rückstände außerhalb von MDM Lite

Auch nach einer Bereitstellung ohne die Spalte können Werte oder Namen an Stellen bleiben, die MDM Lite nicht erreicht. Gehen Sie diese Liste durch, wenn eine Spalte wirklich verschwinden muss, etwa weil sie versehentlich zu niedrig eingestuft war:

StelleWas dort bleiben kannWas Sie tun
Abgelöste Datendateien der Tabelle (part-….snappy.parquet)Nach einem Rückzug durch MDM Lite: nichts, die Dateien werden sofort gelöscht. Nur bei einem blockierten Rückzug oder einer Bereinigung ohne MDM Lite: die Werte, bis zu 168 Stunden (7 Tage)Ist der Rückzug blockiert, lösen Sie nach dem Beheben eine Bereitstellung aus; die Dateien löscht dann MDM Lite. Wollen Sie ohne MDM Lite bereinigen, löschen Sie im Ordner der Tabelle alle Datendateien außer der einen, die im neuesten Commit unter _delta_log als add steht — im Azure-Portal (Storage Account, Shortcut-Weg) bzw. im OneLake-Datei-Explorer (direkter Weg). Führen Sie kein VACUUM aus: Ein fremder Commit lässt die nächste Bereitstellung abbrechen. Die Zeitreise auf ältere Stände ist danach nicht mehr möglich.
_delta_logDie Namen zurückgezogener Spalten in früheren Commits (nie die Werte)Bleibt bestehen; MDM Lite räumt das Log derzeit nicht auf. Ist bereits der Spaltenname vertraulich, lassen Sie den Tabellenordner von Ihrem Plattform-Team löschen und lösen Sie danach eine Bereitstellung aus.
Papierkorb (Soft Delete)Gelöschte Dateien, je nach KonfigurationOneLake: hält gelöschte Dateien laut Microsoft automatisch 7 Tage vor. ADLS Gen2 / Blob Storage (Shortcut-Weg): nur, wenn Soft Delete aktiviert ist; der Storage-Admin stellt die Frist ein (1 bis 365 Tage). Klären Sie die Frist mit Ihrem Plattform-Team und lassen Sie die Dateien bei Bedarf dort endgültig löschen oder die Frist verkürzen. Stand der Microsoft-Angaben: September 2026.
Kopien auf der PlattformAbgeleitete Tabellen, semantische Modelle (Power BI), Caches des SQL-Endpunkts, Downloads und Exporte durch NutzerLiegen in der Verantwortung des Mandanten; MDM Lite kann sie weder finden noch löschen. Aktualisieren Sie Modelle und Berichte, die die Spalte lasen, und lassen Sie Kopien gezielt entfernen.

Faustregel: Die Klassifizierung schützt davor, dass Daten MDM Lite verlassen. Was bereits auf der Datenplattform angekommen ist, kann MDM Lite nicht in jedem Fall zurückholen. Stufen Sie Spalten deshalb vor der ersten Bereitstellung richtig ein.

Änderungsprotokoll

Jede Bereitstellung auf dem OneLake-Weg erzeugt den Eintrag onelake_exported im Änderungsprotokoll des Datasets. Er enthält zusätzlich delivery_ceiling (die höchste Klassifizierung zum Zeitpunkt der Bereitstellung), withheld_column_count (Anzahl zurückgehaltener Spalten) retraction (true, wenn vor dieser Bereitstellung ein Rückzug ausstand) und deleted_file_count (Anzahl der dabei gelöschten Datendateien). Der automatische Rückzug trägt den Auslöser retraction und den Akteur system:retraction. Die Namen zurückgehaltener Spalten stehen bewusst nie im Protokoll. Das Ändern der höchsten Klassifizierung selbst wird mit Benutzer, Zeitpunkt sowie altem und neuem Wert als delivery_ceiling_changed festgehalten.

Moduswechsel und Aufbewahrung

Beim Ändern des Modus zeigt MDM Lite einen Bestätigungsdialog mit:

Nach dem Bestätigen gibt es keinen separaten Migrationsschritt: Die nächste reguläre Bereitstellung (OneLake in der Regel innerhalb von 30 Sekunden bei aktivem automatischem Export, sonst „Jetzt bereitstellen"; Notebook beim nächsten Lauf) schreibt die Tabelle unter demselben Namen im neuen Modus neu.

Aufbewahrung koppelt an den Modus: „Vollständige Historie" verlangt eine unbegrenzte Versionsaufbewahrung für das Dataset — weder ein Mandanten- noch ein Dataset-Limit darf gesetzt sein (siehe Versionsaufbewahrung). Ist ein Limit aktiv, schlägt das Umschalten auf „Vollständige Historie" mit einer entsprechenden Fehlermeldung fehl; umgekehrt lässt sich ein Aufbewahrungslimit nicht setzen, solange das Dataset im Modus „Vollständige Historie" steht. Die Historie auf der Datenplattform reicht dadurch nie weiter zurück als die in MDM Lite aufbewahrten Versionen — wer lange Historie auf der Datenplattform will, setzt in MDM Lite kein Limit.

Prüfbar über eine Tabelleneigenschaft: Im Modus „Vollständige Historie" trägt die Tabelle zusätzlich die Eigenschaft mdmlite.historyTruncated (true/false, in Fabric per SHOW TBLPROPERTIES bzw. DESCRIBE DETAIL sichtbar). Sie ist immer gesetzt, nicht nur bei tatsächlich abgeschnittener Historie — false bestätigt, dass die Historie lückenlos bis zur ersten je ausgelieferten Version zurückreicht, true zeigt an, dass ältere Versionen durch die Aufbewahrungsregel bereits entfernt wurden. Weil „Vollständige Historie" ohnehin nur bei unbegrenzter Aufbewahrung erlaubt ist, bleibt true in der Praxis auf Datasets beschränkt, die schon vor dem Umschalten auf diesen Modus eine begrenzte Aufbewahrung hatten.

Jede Moduswechsel-Aktion wird mit Benutzer, Zeitpunkt sowie altem und neuem Wert im Änderungsprotokoll des Datasets festgehalten.

Baum-Datasets in der Bereitstellung

Baum-Datasets (Eltern-Kind-Hierarchie) unterstützen aktuell ausschließlich den Modus „Aktueller Stand" — die Radio-Auswahl im Abschnitt „Bereitstellung auf der Datenplattform" zeigt für sie keine weiteren Optionen an, und ein Speicherversuch mit einem anderen Modus scheitert. Grund: Baum-Datasets sind teilversioniert (Knoten werden an Ort und Stelle geändert), frühere Stände lassen sich deshalb nicht exakt nachstellen. Die Tabelle enthält zusätzlich die Systemspalte rdm_parent_key mit dem Schlüssel des Elternknotens (leer = Wurzelknoten). Ist die neueste Version eines Baums fehlerhaft oder erst geplant, ist seine Auslieferung angehalten, siehe Bearbeitungsstand (Head) & Auslieferungsstatus.

Die Bereitstellungswege im Überblick

Jeder Weg transportiert exakt den in diesem Kapitel beschriebenen Tabellenvertrag — Tabellenname, Spalten, Systemspalten, Typen und Zeilen unterscheiden sich nicht danach, welchen Weg Sie wählen. Die vollständige Einrichtung — Azure-Konfiguration, SAS-Token, Service Principal, Notebook-Generierung, Planung, Fehlerbehebung — steht im Integrationshandbuch:

→ Microsoft Fabric & OneLake – Integrationshandbuch, insbesondere das dortige Kapitel „Der Tabellenvertrag".

Bereitstellung je Umgebung einrichten

Jede Umgebung hat ihr eigenes Ziel auf der Datenplattform. So schreibt „Test" in ein Test-Lakehouse, während „Produktion" das Produktiv-Lakehouse beliefert. Die Einrichtung des Ziels (Storage Account oder OneLake direkt) beschreibt das Integrationshandbuch Schritt für Schritt.

Voraussetzung: Rolle Admin.

  1. Wechseln Sie im Benutzermenü in die Umgebung, die Sie einrichten möchten, zum Beispiel „Test".
  2. Öffnen Sie Einstellungen → Integrationen → Microsoft Fabric. Die Kontextzeile oben nennt die Umgebung.
  3. Hat die Umgebung noch kein Ziel, zeigt die Seite „Für die Umgebung „Test" ist keine Bereitstellung eingerichtet." Klicken Sie auf „Bereitstellung für „Test" einrichten".
  4. Tragen Sie das Ziel ein und speichern Sie. In einer Umgebung, die nicht Live ist, erscheint beim ersten Aktivieren der Dialog „Bereitstellung in einer Nicht-Live-Umgebung aktivieren?": „Daten der Umgebung „Test" werden nach … geschrieben. MDM Lite gibt damit Daten dieser Umgebung an ein externes System." Bestätigen Sie mit „Aktivieren und Daten übertragen" oder brechen Sie ab. Die Bestätigung steht im Änderungsprotokoll (non_live_egress_confirmed).

Sie erkennen die erfolgreiche Einrichtung daran, dass die Übersicht „Bereitstellung je Umgebung" die Umgebung mit Art, Ziel und dem Status „Aktiv" zeigt und die Schaltfläche „Jetzt synchronisieren (Umgebung „Test")" verfügbar ist.

Übersicht „Bereitstellung je Umgebung": Die Tabelle zeigt je Umgebung die Spalten Umgebung, Art, Ziel, Automatik und Zeitplan und Status.

SpalteMögliche Werte
Art„Storage Account & Shortcut", „OneLake direkt", „Nicht eingerichtet"
Automatik und Zeitplan„Bei Veröffentlichung und Änderung" oder „Manuell", dazu ein eingestellter Zeitplan
Status„Aktiv", „Deaktiviert", „Secret nicht lesbar"

Mit „Zu dieser Umgebung wechseln" springen Sie in die Umgebung der Zeile. Die aktuelle Zeile trägt „Aktuelle Umgebung". Haben Sie ungespeicherte Eingaben, fragt MDM Lite vor dem Wechsel nach.

Verhalten im Betrieb:

SituationWas passiert
Umgebung ohne ZielEs wird nichts übertragen, auch nicht in das Ziel von Live. Ein manueller Export antwortet mit 503 und fabric_target_not_configured.
Veröffentlichen, Änderung, Zeitplan, „Jetzt synchronisieren"Jedes Dataset geht ausschließlich in das Ziel seiner Umgebung. „Jetzt synchronisieren" betrifft nur die aktuelle Umgebung.
Ziel ändern (Workspace, Lakehouse, Konto, Container oder Pfad-Präfix)Nach dem Speichern erscheint „Bereits bereitgestellte Tabellen bleiben im bisherigen Ziel. MDM Lite schreibt ab jetzt in das neue Ziel." Die Datasets gehen bei der nächsten Bereitstellung oder mit „Jetzt synchronisieren" ins neue Ziel. Die alten Tabellen löschen Sie dort selbst.
Integration löschen oder deaktivierenAlle Bereitstellungen dieser Umgebung stoppen. Ein ausstehender Rückzug von Spalten bleibt dann liegen.
Konfiguration aus der Zeit vor den UmgebungenSie liefert nirgendwohin, bis Sie sie zuordnen. Sie erscheint nur in Live. Mit Speichern dort ordnen Sie sie Live zu. In der API trägt sie environment_unassigned: true.

Zielschutz: Zwei Umgebungen dürfen nicht in dieselben Tabellenordner schreiben. Beim Speichern prüft MDM Lite das und meldet sonst: „Dieses Ziel wird bereits von der Umgebung „Produktion" verwendet. Wählen Sie ein anderes Lakehouse oder einen anderen, nicht verschachtelten Pfad-Präfix." Gehört ein Tabellenordner schon einem anderen Dataset, bricht die Bereitstellung ab, bevor etwas geschrieben wird: „Der Tabellenordner gehört einem anderen Dataset. MDM Lite schreibt nicht darüber. Prüfen Sie Ziel und Pfad-Präfix." Ursachen und Lösungen: Zielschutz und Fehlermeldungen.

Mandantenweite Grenzen: Die höchste Klassifizierung für die Bereitstellung (Einstellungen → Allgemein) und die Bereitstellungs-Obergrenze gelten für den ganzen Mandanten, also für jedes Ziel jeder Umgebung gleich. Der Bestätigungsdialog nennt, wie viele Ziele in wie vielen Umgebungen betroffen sind, zum Beispiel „Die Änderung wirkt auf 3 Bereitstellungsziele in 3 Umgebungen."

Notebooks, KI-Zugriff und API-Keys: Sie sind je Umgebung getrennt konfiguriert (siehe Integrationen und Umgebungen). Notebook-Erzeugung und MCP-Zugriff sind in Nicht-Live-Umgebungen standardmäßig aus. Nutzen Sie einen Nicht-Live-MCP-Zugriff bisher per X-Environment-Header, schalten Sie ihn in der jeweiligen Umgebung unter Einstellungen → Integrationen → MCP-Server (KI-Zugriff) mit „KI-Zugriff (MCP) für diese Umgebung erlauben" einmalig ein. Ohne Freigabe antwortet MDM Lite mit 404.

Technischer Tabellenname

Jedes Dataset hat neben seinem frei änderbaren Anzeigenamen einen technischen Namen — den Tabellen- bzw. Ordnernamen, unter dem es auf der Datenplattform bereitgestellt wird. Er gilt für alle Bereitstellungswege gleichermaßen: OneLake-/Delta-Export, Datei- und SQL-Export, DWH-Notebook (Teil B/D des Integrationshandbuchs) und die Data-Lineage in Microsoft Purview (siehe Kapitel 15) zeigen alle auf denselben Namen.

Stabil und unabhängig vom Anzeigenamen: Der technische Name wird beim Anlegen festgelegt und ändert sich danach nicht mehr von selbst. Benennen Sie das Dataset um, bleibt der technische Name unverändert — Views, Power-BI-Modelle und Pipelines, die die Tabelle lesen, brechen dadurch nicht.

Vorschlag beim Anlegen: MDM Lite leitet den technischen Namen aus dem Dataset-Namen ab — Kleinbuchstaben, deutsche Umlaute ausgeschrieben (ä→ae, ö→oe, ü→ue, ß→ss), alles außer Buchstaben/Ziffern zu einem einzelnen Unterstrich zusammengefasst (z. B. wird „Filialen München Süd" zu filialen_muenchen_sued). Ist der Vorschlag schon vergeben, hängt MDM Lite automatisch _2, _3, … an. Solange Sie das Feld beim Anlegen nicht selbst bearbeiten, folgt der Vorschlag live Ihrer Eingabe im Namensfeld.

Format-Regeln: Buchstaben (groß oder klein), Ziffern und Unterstriche, darf nicht mit einer Ziffer beginnen, maximal 64 Zeichen. Groß-/Kleinschreibung ist erlaubt (KostenStelle ist ein gültiger Name), zwei Namen, die sich nur in der Schreibweise unterscheiden, gelten aber als derselbe Name: KostenStelle und kostenstelle können nicht nebeneinander bestehen. Der Name muss je Mandant und Umgebung eindeutig sein — innerhalb derselben Umgebung darf ein technischer Name also nur einmal vergeben sein, während Test und Produktion unabhängig voneinander denselben Namen verwenden dürfen.

Reservierte SQL-Wörter: Namen wie order, group, select oder user sind erlaubt — MDM Lite blockiert das Speichern nicht. Sie erhalten aber einen Hinweis, dass Abfragen auf der Datenplattform den Namen dann in Anführungszeichen setzen müssen (z. B. SELECT * FROM "order").

Ändern (nur Admin): Nur ein Mitglied mit der Rolle Admin kann den technischen Namen nach dem Anlegen ändern — im Tab „Integration" des Datasets, Abschnitt „Bereitstellung auf der Datenplattform". Editor und Viewer sehen den Wert dort nur lesend. Jede Änderung wird mit Benutzer, Zeitpunkt sowie altem und neuem Wert im Änderungsprotokoll des Datasets festgehalten.

Achtung — alte Tabelle bleibt bestehen: MDM Lite löscht auf der Datenplattform nie eine Tabelle. Ändern Sie den technischen Namen eines bereits bereitgestellten Datasets, bleibt die bisherige Tabelle unter ihrem alten Namen unverändert dort stehen — sie wird ab sofort nur nicht mehr aktualisiert. Der nächste Export schreibt ausschließlich in die neue Tabelle. Eine berechtigte Person muss die alte Tabelle manuell auf der Datenplattform löschen und Views bzw. Berichte, die sie lesen, auf den neuen Namen umstellen. MDM Lite zeigt diesen Hinweis vor und nach dem Speichern an, wenn das Dataset bereits einmal bereitgestellt wurde.

Bestehende Datasets: Für Datasets, die schon vor diesem Feature einmal per OneLake exportiert wurden, wurde der technische Name einmalig aus dem tatsächlichen OneLake-Ordnernamen übernommen — sie behalten also exakt den Namen, den Konsumenten heute schon lesen; MDM Lite hat dabei keine bestehende Tabelle umbenannt.

In der API/MCP: Der technische Name steht als technicalName in GET /api/datasets, im Dataset-Detail sowie in der MCP-Antwort get_dataset_info.

Verfügbare Integrationspfade

PfadRichtungKurzform
OneLake ShortcutMDM Lite → FabricDataset als Parquet nach ADLS Gen2 exportieren; Fabric liest per Shortcut
Connect to DWHMDM Lite → FabricFabric Notebook generieren, das Änderungen aus MDM Lite zieht und eine Delta Table befüllt
Upload from DWHFabric → MDM LiteFabric Notebook generieren, das eine Lakehouse-Tabelle liest und das MDM-Lite-Dataset aktualisiert
Bulk-SyncMDM Lite → FabricEin Notebook, das alle veröffentlichten Datasets über die Bereitstellungstabellen-API abgleicht; für geplante Läufe

Schnellstart: Einzelnes Dataset synchronisieren

  1. Dataset öffnen → „Connect to DWH"
  2. Plattform: Microsoft Fabric wählen
  3. Zieltabellenname und API-Key konfigurieren; der Parameter SYNC_MODE im generierten Notebook steuert nur noch die Übertragungstechnik — auto (Standard, überträgt nur bei einem geänderten Tabellenstand) oder full (überträgt bei jedem Lauf neu, z. B. nach einem manuellen Eingriff in die Zieltabelle)
  4. Notebook als .ipynb herunterladen
  5. In Fabric importieren, API-Key über notebookutils.credentials.getSecret() einbinden, ausführen

Im Assistenten „Connect to DWH" heißt das Auswahlfeld für SYNC_MODE „Aktualisierungsart" mit den Optionen „Automatisch" (Standard, entspricht auto) und „Immer vollständig neu schreiben" (entspricht full). Das Speicherziel ist fest auf „Lakehouse (Delta-Tabelle)" gesetzt — es gibt keine Auswahl mehr, da der generierte Code kein Fabric Warehouse (mehr) bedient (siehe Integrationshandbuch).

Für den vollständigen Ablauf inkl. Azure Storage Setup, SAS-Token, OneLake Shortcuts, Bulk-Sync und Fehlerbehebung → Integrationshandbuch.

Aktuell halten: Bei den Export-Pfaden nach Fabric (OneLake Shortcut, Direkt-Export) schalten Sie unter Einstellungen → Fabric OneLake → Automatischer Export die Option „Automatisch exportieren (Veröffentlichung & Änderungen)" ein. Danach landet nicht nur das Veröffentlichen, sondern jede spätere Änderung an einem veröffentlichten Dataset automatisch auf der Datenplattform — in der Regel innerhalb von 30 Sekunden, bei Massenänderungen gebündelt als ein Export des Endstands. Ohne diese Option bleibt der Fabric-Stand auf dem letzten manuellen Export stehen. Details: A8 – Automatischer Export.

Notebooks und Umgebungen: Ein Notebook gehört zu der Umgebung, in der Sie es erzeugen. Erzeugen Sie es in Live, folgt es immer der Live-Umgebung (unverändertes Verhalten). Erzeugen Sie es in einer anderen Umgebung, z. B. „Test", steht dort im Parameterblock RDM_ENVIRONMENT = "test", jeder API-Aufruf des Notebooks sendet den Header X-Environment: test, eine Hinweis-Zelle nennt die Umgebung, und der Dateiname endet auf _test. So liest ein Test-Notebook nur Test-Daten (nie unbemerkt Live-Daten) und ein Upload-Notebook schreibt nur in die Test-Datasets. Den Wert RDM_ENVIRONMENT ändern Sie nicht. Verwenden Sie einen API-Key ohne Umgebungsbeschränkung oder einen, der auf genau diese Umgebung beschränkt ist; ein auf eine andere Umgebung beschränkter Key wird schon beim Erzeugen mit 400 api_key_environment_mismatch abgelehnt. Die Data-Lineage in Microsoft Purview wird weiterhin nur für Notebooks aus Live registriert.

Notebooks je Umgebung – Schalter, Key-Auswahl, Bindung:

  • Schalter „Notebook-Erzeugung in dieser Umgebung erlauben" (Einstellungen → Integrationen → Notebooks, nur Mandanten-Administratoren). In Live ist die Erzeugung ohne Einstellung erlaubt (unverändertes Verhalten), in jeder anderen Umgebung ist sie ausgeschaltet und muss dort ausdrücklich eingeschaltet werden. Ist der Schalter aus, antworten alle vier Erzeugungswege (einzeln und Sammel, Sync und Upload) mit 409 notebooks_disabled_for_environment; statt der Assistenten zeigt die Oberfläche einen Hinweis (für Administratoren mit Link zur Einstellung). Bereits erzeugte Notebooks bleiben unberührt: Sie lesen weiter über ihren API-Key. Um den Zugriff eines Notebooks zu stoppen, widerrufen Sie den Key. Jedes Umschalten wird im Änderungsprotokoll festgehalten.
  • Bindung sichtbar: In einer Nicht-Live-Umgebung nennen die Assistenten und die Notebook-Einstellungen die Umgebung („Notebooks, die Sie hier erzeugen, lesen aus bzw. schreiben in die Umgebung „Test“.").
  • Key-Auswahl: Die Assistenten bieten nur Keys an, die in der aktuellen Umgebung gültig sind: auf diese Umgebung beschränkte Keys und Keys ohne Beschränkung (als „alle Umgebungen“ markiert). Keys, die Sie direkt im Assistenten anlegen, sind auf die aktuelle Umgebung beschränkt (geringstes Recht) und funktionieren nur dort.

Hinweis für bestehende Nutzer: Wer bisher Notebooks in einer Nicht-Live-Umgebung erzeugt hat, muss den Schalter dort einmalig einschalten.

Zentrale Übersicht: Alle vier Notebook-Generatoren (Einzel- und Bulk-Sync in beide Richtungen) sind gebündelt auch über Einstellungen → Integrationen → Notebooks erreichbar — praktisch, wenn Sie nicht erst das jeweilige Dataset öffnen möchten. Diese Generatoren benötigen im Gegensatz zum OneLake-Shortcut-Pfad keinen Azure-Storage-Account, nur einen API-Key.

API-Endpunkte für eigene Integrationen

GET /api/datasets/{id}/delivery-table         → Bereitstellungstabelle (Schema + Zeilen), paginiert, ETag/304
GET /api/delivery-tables                      → Übersicht aller bereitstellbaren Datasets mit ETag (für Sammel-Abrufe)
GET /api/datasets/{id}/current                → aktuelle Version (versionierte Lese-API, kein Bereitstellungsweg)
GET /api/datasets/{id}/as-of?date=2025-12-31  → Stand zum Stichtag
GET /api/datasets/{id}/versions/{version}     → bestimmte Version
GET /api/datasets/changes?since=...           → alle geänderten Datasets (dataset-übergreifender Feed)
GET /api/server-time                          → Server-Zeitstempel

Alle Endpunkte erfordern einen API-Key (Authorization: ApiKey <API-Key>). Siehe API-Keys verwalten.

GET /api/datasets/{id}/changes entfällt: Der frühere zeilenbezogene Änderungs-Feed je Dataset antwortet seit diesem Release mit 410 Gone und verweist auf /api/datasets/{id}/delivery-table. Nutzen Sie stattdessen die Bereitstellungstabelle mit If-None-Match (liefert 304, wenn sich nichts geändert hat) — sie enthält bereits alle nötigen Zeitachsen (siehe Zwei Zeitachsen).

Für eigene Integrationen: Die versionsbezogenen Endpunkte (/current, /versions/{n}, /as-of, /export) liefern zusätzlich das Feld columns — den Spaltenstand, der zur jeweils gelieferten Version gehört (siehe Schema-Stand historischer Versionen) — sowie schema_snapshot_missing: true, wenn dieser Stand nicht aufgezeichnet wurde und ersatzweise das aktuelle Schema geliefert wird. Ein automatisierter Abnehmer, der Spalten strikt gegen ein erwartetes Schema prüft, sollte dieses Flag auswerten statt bei fehlenden Spalten hart abzubrechen. Vollständige Feldreferenz: design/api-spec.md ↗ (GitHub, ggf. Zugriff erforderlich).

Row-ID-Semantik (seit September 2026): Das Feld id einer Zeile (in /current, /versions/{n}, /as-of und im Diff als row_id) bezeichnet einen Zeilenzustand, nicht die Zeile über die gesamte Historie. Bleibt eine Zeile inhaltlich unverändert, behält sie dieselbe id über Commits, Massenänderungen, Import (Upsert/FullReplace), Umgebungskopie und Plattform-Import/-Aktualisierung hinweg — ändert sich der Inhalt, entsteht ein neuer Zeilenzustand mit neuer id. Eindeutig über Versionen hinweg ist deshalb nur das Paar aus Versionsnummer und id, nicht id allein. Schreiben Sie eigene Zeilen versionsübergreifend in eine Historientabelle, verwenden Sie diese Kombination als Schlüssel. Auch sys_created_at/sys_created_by folgen dieser Logik: Sie nennen den Zeitpunkt, seit dem der jeweilige Zeileninhalt unverändert existiert — eine unveränderte Zeile behält ihren ursprünglichen Zeitstempel auch über einen erneuten Import hinweg. Diese Semantik gilt ab sofort ohne Übergangsfrist für neu abgerufene Daten; ein Eingriff Ihrerseits ist nur nötig, wenn Sie Row-IDs bislang selbst versionsübergreifend als alleinigen Schlüssel gespeichert haben.


14. KI-Zugriff (MCP)

MDM Lite kann Referenzdaten für KI-Assistenten — Claude, Microsoft 365 Copilot und Copilot Studio — über das Model Context Protocol (MCP) bereitstellen. Der Zugriff ist ausschließlich lesend: Änderungen an Daten sind über MCP nicht möglich, sie erfolgen weiterhin nur in der Web-UI oder über die REST-API. Das gilt auch für das Schema: Das Zurücksetzen auf einen älteren Spaltenstand ist kein MCP-Werkzeug. Ein KI-Assistent kann das Ergebnis nur lesen (Spaltenstand, Versionsvergleich, Änderungsprotokoll).

Aufrufen: Einstellungen → Integrationen → MCP-Server. Ist das Feature für Ihren Mandanten nicht freigeschaltet, ist der Bereich gesperrt — wenden Sie sich an Ihren MDM-Lite-Administrator.

Die Seite zeigt:

Berechtigungen & Sichtbarkeit


15. Sensitivitätsklassifizierung & Microsoft Purview

MDM Lite kann Datasets in den Microsoft-Purview-Datenkatalog integrieren — ein separat lizenziertes Add-on. Ist es für Ihren Mandanten nicht aktiviert, bleiben die zugehörigen UI-Elemente (Purview-Tab, Sensitivitätskennzeichnung, Glossar-Spalte) ausgeblendet bzw. deaktiviert.

Aufrufen (Konfiguration): Einstellungen → Integrationen → Purview. Erforderliche Rolle: Admin.

Was die Integration bietet

Eingebaute Sensitivitätsstufen (auch ohne Purview)

Unabhängig vom Purview-Add-on trägt jede Spalte eine der Stufen public, internal (Standard), confidential oder restricted. Wer welche Stufe sieht, hängt von der Rolle auf dem Dataset ab (Betrachter bis internal, Editor bis confidential, Admin alles); ein API-Key kann mit maxSensitivityLevel zusätzlich begrenzt werden.

Eine Spalte oberhalb Ihrer Stufe ist für Sie nicht vorhanden — weder ihre Werte noch ihr Name erscheinen: nicht in Tabelle, Export und API, nicht in der Suche, im Beziehungen-Tab, in der Duplikaterkennung, in DWH-Upload-Notebooks und nicht im Import-Bericht. Fehlerberichte zeigen dann nur den Fehlercode und die Zeile (z. B. „Pflichtspalte fehlt"), ohne den Spaltennamen; die Anzahl der Fehler bleibt vollständig. Die Stufe einer Spalte ändern können Sie nur, wenn die alte und die neue Stufe innerhalb Ihrer eigenen liegen.

Purview je Umgebung einrichten

Purview gehört, wie die Bereitstellung auf der Datenplattform, zu einer Umgebung. Ein Dataset wird nur in die Purview-Konfiguration seiner eigenen Umgebung registriert. Hat die Umgebung keine eigene, aktivierte Konfiguration, registriert MDM Lite nichts. Es greift nie auf die Konfiguration von Live zurück. Eine neue Umgebung startet deshalb ohne Purview.

Voraussetzung: Rolle Admin und das aktivierte Purview-Add-on.

  1. Wechseln Sie im Benutzermenü in die Umgebung, die Sie einrichten möchten, zum Beispiel „Test".
  2. Öffnen Sie Einstellungen → Integrationen → Microsoft Purview. Die Kontextzeile oben nennt die Umgebung.
  3. Hat die Umgebung noch keine Konfiguration, zeigt die Seite „Für die Umgebung „Test" ist Purview nicht eingerichtet." Klicken Sie auf „Purview für „Test" einrichten".
  4. Tragen Sie Purview-Endpunkt, Azure-AD-Tenant-ID, Service-Principal-Client-ID und das Client Secret ein. Optional geben Sie eine Collection an. Speichern Sie, prüfen Sie mit „Verbindung testen" und aktivieren Sie die Integration.

Sie erkennen die erfolgreiche Einrichtung daran, dass die Übersicht „Purview je Umgebung" die Umgebung mit Endpunkt, Collection und dem Status „Aktiv" zeigt.

Collection (optional): Microsoft Purview wird meist mit einem Konto je Organisation betrieben. Eine Collection trennt die Assets der Umgebungen innerhalb dieses Kontos. Tragen Sie den Referenznamen der Collection ein (die Purview-Eigenschaft name, nicht den Anzeigenamen). Bleibt das Feld leer, landen die Assets in der Standard-Collection des Kontos. Die Collection muss in Purview bereits existieren, und der Service Principal braucht dort Schreibrechte.

Übersicht „Purview je Umgebung": Die Tabelle zeigt je Umgebung Endpunkt, Collection und Status („Aktiv", „Deaktiviert", „Secret nicht lesbar", „Nicht eingerichtet"). Mit „Zu dieser Umgebung wechseln" springen Sie in die Einstellungen einer anderen Umgebung. Haben Sie im Formular ungespeicherte Eingaben, fragt MDM Lite vor dem Wechsel nach.

Webhook-Secret je Umgebung: Das Webhook-Secret für den Rückkanal (Glossar-Begriffe, Sensitivitätskennzeichnungen) gehört zur Konfiguration der Umgebung. Richten Sie in Azure ein eigenes Event-Grid-Abo je Umgebung ein und hinterlegen Sie darin das Secret genau dieser Umgebung. Ein Ereignis mit dem Secret von „Test" betrifft nur Datasets von „Test". Änderungen an Glossar-Begriffen wirken dagegen mandantenweit.

So erkennen Sie Assets einer Umgebung in Purview: Neu registrierte Assets einer Nicht-Live-Umgebung tragen das Umgebungskürzel im Schlüssel (rdm://{Mandant}/{Umgebungs-Slug}/{Dataset-ID}). Der Anzeigename bleibt unverändert. Der Schlüssel der Live-Umgebung ändert sich nicht. Ein einmal vergebener Schlüssel bleibt unverändert. Eine geänderte Collection gilt ab dem nächsten Sync eines Datasets; Purview legt das Asset dann in der neuen Collection an bzw. verschiebt es dorthin.

Hinweis zur Bestätigung: Anders als bei der Bereitstellung auf der Datenplattform erscheint für Purview kein Bestätigungsdialog beim ersten Aktivieren in einer Nicht-Live-Umgebung. Purview erhält nur Metadaten (Name, Schema, Beschreibung, Status), keine Datenzeilen. Das Speichern der Konfiguration steht mit Umgebung im Änderungsprotokoll.

Hinweis für bestehende Nutzer: Vor Release 1.3 registrierte MDM Lite nur Datasets der Live-Umgebung. Bereits früher registrierte Nicht-Live-Assets in Purview bleiben bestehen und werden nicht automatisch gelöscht. Wie Sie sie erkennen und bereinigen, beschreibt das Betriebs-Runbook „Nicht-Live-Altartefakte bereinigen"; Ihr Support-Ansprechpartner stellt es Ihnen bereit.

Pro Dataset

Der Tab „Purview" eines Datasets zeigt den Synchronisierungsstatus (synchronisiert / fehlgeschlagen / nie synchronisiert) und bietet „Mit Purview synchronisieren" zum manuellen Anstoßen. Der Sync geht in die Purview-Konfiguration der Umgebung des Datasets und ist in jeder Umgebung verfügbar. Hat die Umgebung keine eigene, aktivierte Konfiguration, zeigt der Tab statt der Schaltfläche den Hinweis „Purview ist für diese Umgebung nicht eingerichtet" (Admins mit Link zu den Einstellungen). Ist das Add-on für den Mandanten nicht aktiviert, ist der Tab mit dem Hinweis „Purview nicht aktiviert" gesperrt.


16. API-Keys verwalten

API-Keys ermöglichen maschinellen Zugriff für ETL-Pipelines, ohne einen persönlichen Login zu verwenden.

API-Key anlegen (Admin)

  1. Einstellungen → Sicherheit → API-Keys (Route /settings/security/api-keys)
  2. „Neuen Key erstellen" klicken
  3. Name/Beschreibung eingeben (z. B. „Fabric Sync Job")
  4. Bestätigen — der Key wird einmalig angezeigt, sofort sicher speichern

In den Einstellungen angelegte Keys haben die Scopes read und write und sind nicht auf einzelne Datasets beschränkt. Keys, die Sie direkt im Assistenten „Mit DWH verbinden" (einzelnes Dataset oder alle Datasets) anlegen, erhalten nur read — die erzeugten Notebooks lesen ausschließlich.

Was die Scopes erlauben:

In der Key-Liste sehen Sie zu jedem Schlüssel den Scope und den Zeitpunkt der letzten Verwendung (last_used_at).

Wichtig: Der API-Key wird nur bei Erstellung vollständig angezeigt. Danach ist nur noch der Name sichtbar.

Umgebungs-Scope: Ein API-Key kann optional auf eine einzelne Umgebung beschränkt werden, sodass er z. B. nur die Test-Umgebung ansprechen darf. Sie wählen den Scope beim Anlegen im Dialog „API-Key erstellen“ im Feld Umgebung (Standard: „Alle Umgebungen“ = keine Beschränkung); die Key-Liste zeigt den Scope in der Spalte Umgebung. Über die API setzen Sie ihn mit dem Feld environment (siehe API-Spezifikation ↗ (GitHub, ggf. Zugriff erforderlich)). Ein auf eine Nicht-Live-Umgebung gescopter Key muss den X-Environment-Header bei jedem Request explizit mitsenden. Er erreicht keine Daten anderer Umgebungen — auch nicht über Funktionen, die ohnehin in eine andere Umgebung greifen: Beim Kopieren in eine andere Umgebung darf er dort keine Datasets anlegen und nur Ziel-Datasets aktualisieren, die aus dem jeweiligen Quell-Dataset stammen; „Sync now" für OneLake (export-all) ist Mandanten-Admins in der Oberfläche vorbehalten, ein API-Key kann es nicht auslösen.

Scopes und Dataset-Beschränkung: Auch die Scopes (scopes: read oder read/write) und die Beschränkung auf einzelne Datasets (datasetIds) lassen sich derzeit nur über die API festlegen (POST /api/tenants/api-keys, Feldnamen in camelCase — unbekannte oder falsch geschriebene Felder werden mit 400 abgelehnt). Ein beschränkter Key sieht und nutzt ausschließlich die genannten Datasets: jedes andere Dataset beantwortet die API mit 404, Listen zeigen es nicht, und der Key kann keine neuen Datasets anlegen. Dataset-IDs gelten je Umgebung — die Kopie eines Datasets in einer anderen Umgebung hat eine eigene ID.

Leere Angaben werden abgelehnt, nicht stillschweigend zu „alle": Ein fehlendes Feld (scopes, datasetIds, environment einfach weglassen) behält seine dokumentierte Bedeutung „alles/unbeschränkt" — das ist der Weg, den die Web-UI beim Anlegen nutzt. Eine leere Liste (scopes: [], datasetIds: []) oder ein leerer/reiner Leerzeichen-Wert (environment: "") ist dagegen ein Fehler (400), kein gültiger Weg, „keine Einschränkung" auszudrücken. Jede datasetIds-ID muss außerdem tatsächlich existieren, zu Ihrem Mandanten gehören und — bei gesetztem environment — in dieser Umgebung liegen, sonst 400 unknown_dataset_ids. Details und die vollständige Fehlercode-Tabelle: API-Spezifikation §12.2 ↗ (GitHub, ggf. Zugriff erforderlich).

Gesperrte Datasets: Hat ein Dataset eigene Dataset-Rollen, braucht auch ein API-Key dort eine eigene Rolle (Benutzer-ID apikey:{Key-ID}), sonst erhält er 403.

API-Key verwenden

Im HTTP-Request-Header:

Authorization: ApiKey <API-Key>

API-Key widerrufen

In der Key-Liste: „Widerrufen" klicken. Der Key ist sofort ungültig — alle laufenden Jobs, die ihn verwenden, erhalten ab sofort 401 Unauthorized.


17. E-Mail-Versand konfigurieren

MDM Lite verschickt E-Mails — vor allem Einladungen an neue Nutzer (siehe Nutzerverwaltung). Damit diese Mails zugestellt werden, muss ein Versandweg konfiguriert sein. Es gibt zwei Ebenen:

  1. MDM Lite built-in (Betreiber-Konto) — Standard: Versand über das zentrale, von der Data Prudentia GmbH (Anbieter von MDM Lite) bereitgestellte Absenderkonto. Jeder Mandant startet mit dieser Option; ist das Betreiber-Konto eingerichtet, funktioniert der Versand sofort — Sie müssen nichts tun. Die Mail kommt dann technisch vom Betreiberkonto, enthält im Text aber den Kontext: wer eingeladen hat und für welchen Mandanten. Antworten gehen per Reply-To an den einladenden Admin.
  2. Eigenes Konto des Mandanten (empfohlen): Damit Einladungen aus Ihrer eigenen Domain stammen, hinterlegen Sie ein eigenes Absenderkonto. Empfohlen wird Microsoft 365.

Es ist immer nur eine Option aktiv. Den Wechsel zwischen beiden steuern Sie über die Auswahl oben in der E-Mail-Einstellung (siehe Option wählen).

Aufrufen: Einstellungen → Integrationen → E-Mail. Erforderliche Rolle: Admin.

Option wählen (built-in oder eigenes Konto)

Oben auf der E-Mail-Seite wählen Sie per Auswahlfeld zwischen den beiden Optionen:

Zurückwechseln ohne Datenverlust: Wechseln Sie von der eigenen Konfiguration zurück auf das built-in-Konto, bleibt Ihre eigene Konfiguration (inkl. verschlüsseltem Geheimnis) erhalten — sie wird nur deaktiviert. Ein späterer Rück-Wechsel auf das eigene Konto ist daher ohne erneute Eingabe des Secrets möglich.

Warum Microsoft 365 und nicht klassisches SMTP? Microsoft hat den klassischen SMTP-Login (Basic Auth) in Exchange Online deaktiviert. Für den Versand aus einem M365-Postfach wird daher eine App-Registrierung mit moderner Authentifizierung verwendet. Für Nicht-M365-Postfächer steht weiterhin die SMTP-Option bereit.

Variante A — Microsoft 365 (empfohlen)

Voraussetzung ist eine App-Registrierung in Ihrem Microsoft-Entra-ID (Azure AD). Diese richtet Ihr Microsoft-365-Administrator einmalig ein:

  1. In Microsoft Entra ID → App-Registrierungen eine neue Registrierung anlegen.
  2. Unter API-Berechtigungen die Anwendungsberechtigung Mail.Send (Microsoft Graph) hinzufügen und Administratorzustimmung erteilen.
  3. Unter Zertifikate & Geheimnisse ein Client-Secret erzeugen und den Wert kopieren (wird nur einmal angezeigt).
  4. (Optional, empfohlen) Per Application Access Policy den Zugriff der App auf genau das Absenderpostfach begrenzen.

Anschließend im MDM Lite unter Integrationen → E-Mail den Anbieter Microsoft 365 wählen und eintragen:

FeldBedeutung
Verzeichnis-/Mandanten-IDDie Entra-ID (Azure-AD-Tenant-ID)
Anwendungs-(Client-)IDDie ID der App-Registrierung
Client-SecretDas erzeugte Geheimnis
AbsenderadressePostfach/UPN, aus dem gesendet wird, z. B. noreply@ihre-domain.de
AnzeigenameOptionaler Absendername, z. B. „Muster GmbH MDM Lite"

Variante B — SMTP (Alternative)

Für Postfächer außerhalb von Microsoft 365 wählen Sie den Anbieter SMTP und tragen ein: Host, Port (Standard 587), SSL/TLS, Benutzername, Passwort, Absenderadresse und optional Anzeigename.

Speichern, Testen, Aktivieren

Hinweis (Nachvollziehbarkeit): Jede Änderung an der E-Mail-Konfiguration (Anlegen, Ändern, Löschen) wird im Audit-Log protokolliert — ohne das Geheimnis selbst.

Plattform-Standard (Betreiber-Konto) einrichten (nur AppAdmin)

Das built-in-Konto, das alle Mandanten mit Option 1 nutzen, pflegt der AppAdmin zentral in der Oberfläche — eine separate Server-Konfiguration ist nicht mehr nötig.

Aufrufen: Plattform-Verwaltung (/admin) → Tab „E-Mail". Erforderliche Rolle: AppAdmin.

Für das Betreiber-Konto stehen drei Anbieter zur Verfügung — einer mehr als auf Mandantenseite:

AnbieterFelderWann sinnvoll
Microsoft 365 (Graph API)Verzeichnis-/Mandanten-ID, Client-ID, Client-Secret, Absenderadresse, AnzeigenameStandard, wenn der Betreiber selbst M365 nutzt — Versand aus einem echten Postfach der eigenen Domain
Azure Communication ServicesEndpoint (https://….communication.azure.com), Absenderadresse (DoNotReply@….azurecomm.net oder eigene verifizierte Domain), Access Key, AnzeigenameReiner Transaktionsversand ohne M365-Postfach; Authentifizierung über statischen Access Key statt OAuth
SMTPHost, Port, SSL/TLS, Benutzername, Passwort, Absenderadresse, AnzeigenameNur für Mailserver außerhalb von Exchange Online

Zusätzlich gilt:

Hinweis: Diese Plattform-Einstellung ist mandantenübergreifend und nur für AppAdmins zugänglich. Normale Mandanten-Admins sehen und ändern ausschließlich die E-Mail-Konfiguration ihres eigenen Mandanten.

Für Betreiber: Die vollständige Schritt-für-Schritt-Anleitung zur Einrichtung des Betreiber-Kontos (App-Registrierung in Entra ID, Mail.Send, Application Access Policy, ACS-Domain, Secret-Rotation, Fehlerbilder) steht im internen Plattform-Admin-Handbuch ↗ (GitHub, nur für Betreiber mit Repo-Zugriff).

Was passiert ohne Konfiguration?

Ist weder ein eigenes Konto noch ein Plattform-Standard hinterlegt, wird keine E-Mail versendet. Die Einladung wird trotzdem angelegt; Sie können den Einladungslink in diesem Fall manuell weitergeben oder den Versand später über „Erneut versenden" auslösen (siehe Nutzerverwaltung).


18. Nutzerverwaltung

Allgemeine Mandanten-Einstellungen

Unter Einstellungen → Allgemein (Route /settings/general) ändern Admins den Anzeigenamen des Mandanten — den Namen, unter dem Ihre Organisation in der Kopfzeile, der Mandantenauswahl und E-Mail-Einladungen erscheint. Wert eintragen und „Speichern" klicken.

Nur Nutzer mit der Rolle Admin oder AppAdmin haben Zugriff auf die Nutzerverwaltung.

Aufrufen: Profilmenü oben rechts → „Nutzer verwalten" (oder Einstellungen → Nutzer verwalten)

Nutzer einladen

  1. Tab „Einladungen" wählen
  2. E-Mail-Adresse und Rolle auswählen (Viewer / Editor / Admin)
  3. „Einladen" klicken

Der Eingeladene erhält eine E-Mail mit Bestätigungslink (gültig 7 Tage). Beim Klick meldet er sich mit seinem Microsoft-Konto an; danach wird sein Account automatisch dem Mandanten hinzugefügt.

Der Link allein genügt nicht: Angenommen werden kann eine Einladung nur von der Person, an deren Adresse sie verschickt wurde. Meldet sich jemand mit einem anderen Konto an, weist MDM Lite die Annahme ab („Diese Einladung wurde an eine andere E-Mail-Adresse gesendet") — auch dann, wenn der Link weitergeleitet oder abgefangen wurde. Laden Sie deshalb genau die Adresse ein, unter der sich die Person bei Microsoft anmeldet.

Voraussetzung: Der Mailversand muss konfiguriert sein, damit die Einladung tatsächlich zugestellt wird — siehe E-Mail-Versand konfigurieren. Ist kein Versandweg eingerichtet, wird die Einladung zwar angelegt, aber keine Mail verschickt.

Erneut versenden / widerrufen: In der Liste offener Einladungen können Sie pro Zeile die Mail erneut versenden (z. B. wenn sie nicht angekommen ist oder der Link abgelaufen ist; die Gültigkeit wird dabei auf 7 Tage zurückgesetzt) oder die Einladung widerrufen.

Rolle ändern

Im Tab „Mitglieder": Dropdown rechts neben dem Namen → neue Rolle wählen. Wirkt sofort.

Einschränkungen:

Nutzer sperren / entsperren

Schalter in der Zeile des Nutzers: Sperren unterbindet den Zugriff auf diesen Mandanten sofort (403 Forbidden) — auch mitten in einer laufenden Sitzung, denn die Prüfung erfolgt bei jedem Request neu und nicht nur beim Login. Ein bereits angemeldeter, gesperrter Nutzer wird also nicht erst beim nächsten Login ausgesperrt, sondern schon bei seiner nächsten Aktion. Das Konto und alle Rollen bleiben erhalten und können jederzeit entsperrt werden — im Unterschied zu „Entfernen" unten, das die Mitgliedschaft löscht. Diese Sperre wirkt nur im aktuellen Mandanten; Mitgliedschaften des Nutzers in anderen Mandanten sind davon nicht betroffen (siehe auch die mandantenübergreifende Sperre unter „Plattform-Verwaltung").

Nutzer entfernen

„Entfernen" in der Zeile des Nutzers: Entfernt die Mitgliedschaft vollständig. Der Nutzer muss neu eingeladen werden.

Plattform-Verwaltung (nur AppAdmin)

Nutzer mit der Rolle AppAdmin haben einen zusätzlichen, mandantenübergreifenden Verwaltungsbereich (Route /admin):


19. Rollenmodell & Berechtigungen

RolleDatasets lesenDatasets bearbeitenImportierenDatasets & Ordner anlegenOneLake-SyncNutzer verwaltenAPI-Keys
Viewer✅——————
Editor✅✅✅✅———
Admin✅✅✅✅✅✅✅
AppAdmin✅✅✅✅✅✅✅

Datasets & Ordner anlegen umfasst: neues Dataset (Formular, aus Datei, Massenimport), Ordner anlegen, umbenennen, verschieben und löschen. Viewer sehen die entsprechenden Schaltflächen im Explorer nicht, und Drag & Drop ist für sie abgeschaltet.

Dataset verschieben richtet sich nach der Rolle auf dem Dataset: Wer dort Editor ist, darf es in einen anderen Ordner verschieben — auch ein Mandanten-Viewer mit Dataset-Rolle Editor. Ein Mandanten-Editor ohne eigene Rolle auf einem gesperrten Dataset darf es nicht.

AppAdmin: Ein AppAdmin hat im gewählten Mandanten immer mindestens die Rechte eines Mandanten-Admins. Auf jedem Dataset gilt er als Dataset-Admin — auch auf gesperrten Datasets (mit eigenen Dataset-Rollen), ohne dort selbst eingetragen zu sein. Das ist der Support-Zugang des Betreibers. Er gilt nur im gewählten Mandanten. Jede Änderung, die ein AppAdmin vornimmt, steht mit seiner eigenen E-Mail-Adresse im Änderungsprotokoll.

Purview-Lineage: Das Notebook im Assistenten „Mit DWH verbinden" darf jeder erzeugen, der das Dataset lesen darf. Die Lineage im Purview-Katalog wird aber nur registriert, wenn Sie auf dem Dataset mindestens Editor sind.

Hinweis: AppAdmin hat zusätzlich mandantenübergreifende Plattformrechte — wird typischerweise nur für den Systemadministrator vergeben.


20. Plattform-Datenbibliothek

Die Plattform-Datenbibliothek („Bibliothek") liefert vorkonfigurierte, gepflegte Referenzdatensätze, die Sie mit einem Klick in Ihren Mandanten übernehmen. Statt ISO-Ländercodes oder Branchensystematiken selbst zu beschaffen und aufzubereiten, importieren Sie ein fertiges, versioniertes Dataset.

Verfügbare Datensätze

DatensatzQuelleTypKategorie
ISO 3166-1 – LändercodesISO 3166/MATabelleGeographie
ISO 4217 – WährungscodesISO 4217/MATabelleFinanzen
ISO 639-1 – SprachcodesISO 639/RATabelleGeographie
ISO 3166-2:DE – Deutsche BundesländerISO 3166/MATabelleGeographie
Incoterms 2020ICCTabelleHandel
UN/ECE Rec. 20 – Maßeinheiten (Auswahl)UNECETabelleLogistik
EU-MwSt-Sätze (mit Gültigkeitszeitraum)EU-KommissionTabelleFinanzen
NUTS 2021 – EU-RegionenEurostatBaumGeographie
NACE Rev. 2 – EU-BranchencodesEurostatBaumIndustrie
UN M.49 – WeltregionenUN StatisticsBaumGeographie
Datumsdimension (2000–2040)intern generiertTabelleZeit
Feiertage (DE, AT, CH · 2000–2040)intern generiertTabelleZeit
GS1-Präfixe – EAN/GTIN-LänderpräfixeGS1TabelleLogistik
IBAN-Formatregeln (ISO 13616)ISO 13616TabelleFinanzen
Deutsche Postleitzahlen (PLZ-Orte)Deutsche PostTabelleGeographie
Bankleitzahlen (BLZ/BIC, mit Gültigkeitszeitraum)BundesbankTabelleFinanzen

Datensätze vom Typ Baum (NUTS, NACE, UN M.49) werden mit ihrer Baumstruktur importiert; die EU-MwSt-Sätze und die Bankleitzahlen (BLZ/BIC) nutzen Gültig ab / Gültig bis (siehe Zeitliche Gültigkeit).

Bibliothek öffnen

Klicken Sie auf das Symbol 🌐 Bibliothek in der Aktionsleiste des Dataset Explorers. Die Bibliothek-Seite zeigt alle verfügbaren Datensätze als Karten.

Bekannte Einschränkung: Für die Kategorie „Zeit" (Datumsdimension, Feiertage) fehlt aktuell die passende Filter-Kachel samt Symbol in der Bibliothek-Oberfläche — beide Datensätze sind über die Suche trotzdem auffindbar. Als Bug zur Behebung vorgemerkt.

Vorschau

Auf einer Karte „Vorschau" wählen — ein Dialog zeigt das Schema (Spalten, Typen, Schlüssel) sowie die ersten 10 Datenzeilen. So prüfen Sie den Datensatz vor dem Import.

Importieren (Copy-on-Import)

  1. Auf der Karte (oder im Vorschau-Dialog) „Importieren" klicken
  2. Im Bestätigungsdialog den Import bestätigen — der Datensatz wird in den Ordner „Plattformdaten" kopiert
  3. Eine Erfolgsmeldung erscheint; über „Zum Dataset" springen Sie direkt zum importierten Dataset

Beim Import entsteht eine vollständige, eigenständige Kopie in Ihrem Mandanten (kein Live-Link). Sie können sie anschließend frei anpassen — eigene Spalten oder Zeilen ergänzen. Der Datensatz wird im Status Entwurf angelegt.

Bibliothek-Badge

Aus der Bibliothek importierte Datasets tragen auf der Detailseite ein Badge 🌐 Bibliothek: <slug> v<n>. Ein Klick darauf öffnet den zugehörigen Katalog-Eintrag.

Aktualisierungen übernehmen

Veröffentlicht der Plattform-Betreiber eine neue Version eines Datensatzes, erscheint auf der Detailseite des importierten Datasets ein Banner 🔔 Neue Plattformversion verfügbar.

Katalogverwaltung (nur AppAdmin)

Nur AppAdmins (Plattform-Betreiber) pflegen den Katalog: neue Datensätze registrieren, Metadaten bearbeiten, neue Versionen veröffentlichen und Datensätze deaktivieren. Diese Funktionen sind mandantenübergreifend und für normale Mandanten-Admins nicht zugänglich.


21. Häufige Fragen (FAQ)

Ich kann mich nicht anmelden — was tun?
Ihr Mandant wurde möglicherweise noch nicht freigeschaltet. Wenden Sie sich an den MDM-Lite-Administrator Ihres Unternehmens.

Ein eingeladener Nutzer hat keine E-Mail erhalten — was tun?
Prüfen Sie zuerst, ob ein Versandweg konfiguriert ist (Einstellungen → Integrationen → E-Mail, siehe E-Mail-Versand konfigurieren). Ohne Konfiguration wird keine Mail verschickt. Lassen den Empfänger zudem den Spam-Ordner prüfen. Anschließend können Sie die Einladung über „Erneut versenden" erneut auslösen oder den Bestätigungslink manuell weitergeben. Bei eigenem M365-/SMTP-Konto hilft der „Verbindung testen"-Button, die Zugangsdaten zu prüfen.

Ich habe einen zusammengesetzten fachlichen Schlüssel (z. B. Land + Segment + Jahr). Wie bilde ich ihn ab?
Legen Sie im Tab „Spalten" eine berechnete Spalte aus den beteiligten Spalten an (Trennzeichen |) und markieren Sie sie als Primärschlüssel. Der Import im Modus „Ergänzen & Aktualisieren" gleicht dann über diese Kombination ab. Die Schritte und Regeln stehen unter Berechnete Spalten.

Warum kann ich eine Zelle nicht bearbeiten, obwohl ich im Bearbeitungsmodus bin?
Berechnete Spalten sind immer schreibgeschützt, ebenso die Quellzellen bestehender Zeilen, wenn die berechnete Spalte der Primärschlüssel ist. Siehe Berechnete Spalten im Tab „Daten".

Mein Import schlägt fehl. Was tun?
Den Fehlerbericht genau lesen — er gibt pro Zeile und Spalte an, was nicht passt. Häufige Ursachen: fehlende Pflichtfelder, falsche Datumsformate (YYYY-MM-DD verwenden), Enum-Werte nicht in der Auswahlliste, Business Key doppelt in der Datei.

Kann ich eine versehentliche Änderung rückgängig machen?
Ja, über „Als neue Version wiederherstellen" im Tab „Verlauf" — siehe Version wiederherstellen (Restore). Das gilt für Datasets vom Typ Tabelle; für Datasets vom Typ Baum steht Restore noch nicht zur Verfügung — dort hilft der Versions-Diff zum manuellen Nachvollziehen der alten Werte, oder ein erneuter Import im Modus „Vollständiger Ersatz".

Ich brauche eine Hierarchie — muss ich den Typ Baum wählen?
Nicht unbedingt. Bei festen Ebenen (z. B. Land → Region → Kontinent) ist eine Hierarchie über Beziehungen zwischen mehreren Tabellen-Datasets meist die bessere Wahl: voller Funktionsumfang je Ebene (Restore, eigene Rollen, eigene Versionen). Nur wenn Einträge derselben Art beliebig tief und mit denselben Spalten verschachtelt sind (Organigramm, Kontenplan), ist Baum die richtige Wahl. Siehe Abschnitt 7.

Warum sehe ich ein Dataset nicht, das ein Kollege erstellt hat?
Prüfen Sie: Haben Sie mindestens die Rolle Viewer? Ist das Dataset im Status Active oder Draft? Im Draft-Status ist das Dataset für Viewer möglicherweise nicht sichtbar.

Kann ich Spalten im Schema nachträglich ändern oder löschen?
Ja, solange das Dataset im Status Draft ist. Nach Veröffentlichung (Active) sind Schema-Änderungen eingeschränkt — bestehende Daten dürfen nicht inkonsistent werden. Sprechen Sie komplexe Schema-Migrationen mit dem Admin ab.

Wie bekommt mein DWH automatisch aktuelle Daten?
Entweder über den automatischen OneLake-Export oder über das generierte Fabric-Notebook (siehe Bereitstellung auf der Datenplattform) oder über die REST-API mit API-Key. Für Notebooks: SYNC_MODE = "auto" (Standard) überträgt nur, wenn sich die Tabelle tatsächlich geändert hat.

Was passiert, wenn ich einen API-Key widerrufe, der noch in einem laufenden Job verwendet wird?
Der Job erhält beim nächsten API-Request sofort 401 Unauthorized. Es werden keine neuen Daten übertragen. Legen Sie vor dem Widerrufen einen neuen Key an und aktualisieren Sie zuerst die Job-Konfiguration.

Gibt es ein Limit für die Datenmenge pro Dataset?
Einzelne CSV/Excel-Dateien können bis zu 50 MB (Web UI) bzw. 100 MB (API) groß sein. Für größere initiale Datenmengen sprechen Sie mit dem MDM-Lite-Administrator.

Kann ich die Oberfläche auf Englisch umstellen?
Ja. Über den Sprachumschalter DE / EN rechts oben in der Kopfzeile. Die Auswahl wird im Browser gespeichert.

Mein Dataset zeigt „Änderungen ausstehend" — was bedeutet das?
Das Dataset wurde nach der letzten Veröffentlichung bearbeitet. Diese Änderungen sind für das DWH erst sichtbar, wenn Sie das Dataset erneut veröffentlichen (siehe Veröffentlichen & Zurückziehen).

Warum sieht mein DWH ein Dataset nicht?
Nur veröffentlichte Datasets erscheinen im Export und im Changes-Feed. Prüfen Sie den Status — Entwürfe und archivierte Datasets sind für automatisierte Abnehmer bewusst nicht sichtbar.

Wie bekomme ich fertige ISO-Codes oder Branchencodes, ohne sie selbst zu pflegen?
Über die Plattform-Datenbibliothek (Symbol 🌐 Bibliothek im Explorer). Dort importieren Sie u. a. ISO-Länder-, Währungs- und Sprachcodes, Incoterms, NUTS-/NACE-Systematiken, EU-MwSt-Sätze sowie deutsche PLZ, BLZ/BIC, GS1-Präfixe und IBAN-Formatregeln mit einem Klick.

Überschreibt eine Bibliotheks-Aktualisierung meine eigenen Anpassungen?
Nein. Beim Import entsteht eine eigenständige Kopie. Eine spätere Aktualisierung übernimmt die Plattform-Zeilen per Business Key (UPSERT) und legt eine neue Version an — Ihre selbst hinzugefügten Zeilen bleiben erhalten, und die Vorversion bleibt in der Historie verfügbar.

Ich finde den Ordner „Plattformdaten" — kann ich ihn löschen?
Nein. Es ist ein geschützter Systemordner für importierte Bibliotheks-Datensätze; er kann nicht umbenannt, verschoben oder gelöscht werden. Eigene Unterordner und Datasets dürfen Sie darin aber anlegen.

Was ist eine Umgebung, und wie wechsle ich sie?
Umgebungen (z. B. Produktion, Test) sind getrennte Datenräume innerhalb desselben Mandanten — jedes Dataset lebt in genau einer davon. Wechseln über das Profil-/Kontomenü oben rechts → Abschnitt „Umgebung". Details: Umgebungen (Test & Produktion).

Wie bekomme ich einen geprüften Datenstand aus der Test- in die Produktions-Umgebung?
Über „In Umgebung kopieren…" im Tab „Integration" des Datasets (Rolle Editor genügt) — im Modus „Bestehendes aktualisieren" landet der Stand als neue Version im Produktions-Dataset, die eigene Historie des Ziel-Datasets bleibt dabei erhalten. Für CI-gesteuerte Promotion steht derselbe Vorgang auch über die API bereit. Details: Umgebungen (Test & Produktion).

Ich kann keine Zelle in der Tabelle anklicken und bearbeiten — was mache ich falsch?
Zellen sind erst im Bearbeitungsmodus editierbar. Klicken Sie zuerst oben im Grid auf „Bearbeiten" — danach lassen sich Zellen bearbeiten, Zeilen hinzufügen und löschen. Details: Daten bearbeiten.

Ich kann den Primärschlüssel einer Zeile nicht mehr ändern — ist das ein Fehler?
Nein, das ist beabsichtigt: Der Primärschlüssel identifiziert eine Zeile eindeutig und ist bei bereits vorhandenen Zeilen schreibgeschützt. Legen Sie für einen anderen Schlüssel eine neue Zeile an und löschen Sie die alte.

Ich habe ein Dataset versehentlich angelegt — kann ich es vollständig entfernen, nicht nur archivieren?
Ja, über Einstellungen → Daten → Archivierte Datasets kann ein Admin ein zuvor archiviertes Dataset endgültig löschen (inkl. Historie und Audit-Log). Das ist unwiderruflich und getrennt von der reversiblen Archivierung. Details: Archivierte Datasets endgültig löschen.

In welchen Formaten kann ich ein Dataset exportieren?
JSON, CSV, Excel (.xlsx) und SQL (als INSERT-Skript, wahlweise mit vorangestelltem CREATE TABLE, in den Dialekten ANSI/PostgreSQL, T-SQL oder Fabric/Azure Warehouse). Details: Export.

Ich habe eine Spalte gelöscht — warum taucht sie in alten Versionen noch auf?
Das ist beabsichtigt: Jede Version merkt sich den Spaltenstand, der bei ihrer Entstehung galt. Eine entfernte Spalte bleibt deshalb beim Öffnen älterer Versionen, bei As-Of-Abfragen vor der Entfernung und im Versionsvergleich sichtbar, samt ihrer Werte. Nur der aktuelle Bearbeitungsstand (Head) sowie neue Versionen und Exporte zeigen sie nicht mehr. Sichtbar ist sie dabei nur für Nutzer, deren Berechtigung die letzte Klassifizierung der Spalte vor dem Löschen erlaubt. Details: Schema-Stand historischer Versionen.

Ich habe eine alte Version wiederhergestellt — warum ist die damalige Spalte trotzdem nicht wieder im Schema?
Weil der normale Restore ausschließlich Daten wiederherstellt, nicht das Schema. Das aktuelle Schema bleibt davon unberührt, und die Werte entfernter Spalten werden dabei nicht übernommen. Der Restore-Dialog zeigt die Abweichung vorab an. Wollen Sie Spalten und Daten zurück, nutzen Sie als Admin des Datasets „Daten und Schema wiederherstellen…“ (im Restore-Dialog) oder „Schema auf Stand v{n} zurücksetzen…“ (im Tab „Verlauf“). Details: Schema auf älteren Stand zurücksetzen.

Ich habe versehentlich Spalten gelöscht — wie bekomme ich sie zurück?
Wenn Sie Admin des Datasets sind: Öffnen Sie den Tab „Verlauf“, wählen Sie bei einer Version vor dem Löschen „Schema auf Stand v{n} zurücksetzen…“ und im Dialog „Schema und Daten von Version #n“ (mit den Werten von damals) oder „Nur Schema – die aktuellen Daten bleiben“ (Spalte kommt leer zurück). Prüfen Sie die Vorschau, lösen Sie ggf. Konflikte und bestätigen Sie. Es entsteht eine neue Version; die Historie bleibt unverändert, und die Klassifizierung wird dabei nie gesenkt. Editoren bitten einen Admin des Datasets darum. Für Baum-Datasets gibt es das nicht. Details: Schema auf älteren Stand zurücksetzen.

Kann ich das Zurücksetzen des Schemas über die API oder per KI-Assistent auslösen?
Nein. Es ist nur in der Web-Oberfläche durch einen Admin des Datasets möglich, weil dabei Konflikte bewusst entschieden werden. API-Keys und MCP lesen das Ergebnis nur.