Grundlagen: Modell, Schichten, Endpunkte
Was ein CDMS-Modell ist, auf welcher Ebene seine Daten liegen, durch welche Schichten eine Anfrage läuft und welche Endpunkte ein Modell bekommt.
Themen dieser Fachlichkeit
- 1.Modell-Ebenen: System, Mandant, Benutzer
Jedes Modell gehört zu einer von drei Ebenen. Die Ebene entscheidet, in welcher Datenbank die Daten liegen und ob jemand nur seine eigenen Zeilen sieht.
- 2.Ein Modell, vier Gestalten
Ein Modell existiert zur Laufzeit als Entity (Datenbank), DTO (Antwort), Payload (Eingabe) und Metadaten (Beschreibung). Hier steht, wann welche Gestalt im Spiel ist und wie gemappt wird.
- 3.Systemfelder, die der Server setzt
Felder wie
id,_createdOn,_userId,_MODELTYPEund_versionsetzt CDMS selbst. Hier steht, wann welches Feld gesetzt wird und was der Client davon mitschicken darf. - 4.Der Weg einer Anfrage durch die Schichten
Filterkette, REST-Layer, System-Layer, Persistenz, Commit: was jede Station prüft, was sie entscheidet und mit welchem Fehler sie abbricht. Getrennt für Lese- und Schreibvorgänge.
- 5.Welche Endpunkte ein Modell hat
Der feste Satz von Operationen pro Modell (create, read, update, delete, query, history, rollback, Datei) und wie die Endpunkt-Liste im Modell einzelne Operationen ein- und ausschaltet.
- 6.Singletons: genau ein Objekt
Manche Modelle gibt es nur einmal pro Scope, etwa Einstellungen eines Benutzers. Hier steht, wie die Pfade ohne ID funktionieren und was bei doppeltem Anlegen oder fehlendem Objekt passiert.
- 7.Abstrakte Modelle und
@typeEin Oberbegriff mit mehreren konkreten Typen, etwa „Kunde“ mit Privat- und Firmenkunde. Hier steht, wie die Hub-API Anfragen an den richtigen Untertyp weiterleitet und wann der Client
@typeangeben muss. - 8.Das Antwortformat:
dataundmetaJede Antwort hat dieselbe Hülle. Hier steht, was in
dataundmetasteckt, bei Einzelobjekt, Liste, Historie und Fehler.