Many-to-Many über eine Verbindungstabelle

Worum es geht

Bei einer n:m-Beziehung (Many-to-Many) stehen auf beiden Seiten viele Objekte: Eine Gruppe hat viele Rollen, eine Rolle steckt in vielen Gruppen. Eine relationale Datenbank bildet das mit einer dritten Tabelle ab, der Verbindungstabelle: je Verbindung eine Zeile mit den beiden ids.

In CDMS gibt es dafür zwei Wege:

Weg 1: MANYTOMANY

erDiagram
    ROLE ||--o{ SYSTEM_ROLE_GROUPS : "groups"
    GROUP ||--o{ SYSTEM_ROLE_GROUPS : "roles"
    ROLE {
        uuid id
        string name
    }
    GROUP {
        uuid id
        string name
    }
    SYSTEM_ROLE_GROUPS {
        uuid role_id
        uuid group_id
    }

Du legst im Hub an einem der beiden Modelle ein Feld vom Typ MANYTOMANY an, die Gegenseite entsteht mit demselben Typ. Die Verbindungstabelle (hier system-role-groups) erzeugt der Generator. Sie hat nur die beiden Fremdschlüssel.

POST /api/rest/system/group/create
{
  "data": {
    "name": "Vertrieb",
    "roles": [ { "name": "angebot-lesen" }, { "name": "angebot-schreiben" } ]
  },
  "response": ["id", "name", { "field": "roles", "response": ["id", "name"] }]
}

{
  "data": {
    "id": "g1…",
    "name": "Vertrieb",
    "roles": [
      { "id": "r1…", "name": "angebot-lesen" },
      { "id": "r2…", "name": "angebot-schreiben" }
    ]
  },
  "meta": { "error": false }
}

Das geht, weil roles an der Gruppe das Flag CREATE hat. Eine bestehende Rolle verknüpfst du mit ihrer id: "roles": [{ "id": "r1…" }]. Von der anderen Seite geht es genauso: "groups": [{ "id": "g1…" }] an einer Rolle.

Weg 2: ein Verbindungsmodell

erDiagram
    USER ||--o{ GROUP2USER : "groups"
    GROUP ||--o{ GROUP2USER : "users"
    USER {
        uuid id
        string lastname
    }
    GROUP2USER {
        uuid id
        datetime rangeFrom
        datetime rangeTo
    }
    GROUP {
        uuid id
        string name
    }

Hier ist die Verbindung ein eigenes Modell Group2User mit zwei Pflichtfeldern vom Typ MANYTOONE (user, group) und eigenen Feldern (rangeFrom, rangeTo). User.groups und Group.users sind 1:n-Listen auf das Verbindungsmodell, jeweils mit CREATE, UPDATE und DELETE.

- name: "Group2User"
  fields:
    - name: "user"
      relationship: "MANYTOONE"
      reference: { id: "m-user", name: "groups" }
      rules: { required: true }
    - name: "group"
      relationship: "MANYTOONE"
      reference: { id: "m-group", name: "users" }
      rules: { required: true }
    - name: "rangeFrom"
      "@type": "DateTimeField"
    - name: "rangeTo"
      "@type": "DateTimeField"

PATCH /api/rest/user/update/u1…
{
  "data": {
    "id": "u1…",
    "groups": [
      { "group": { "id": "e882…" }, "rangeFrom": "2026-10-01 00:00:00" }
    ]
  },
  "response": ["+", { "field": "groups", "response": ["+",
                { "field": "group", "response": ["name"] }] }]
}

{
  "data": {
    "id": "u1…",
    "lastname": "Müller",
    "groups": [
      { "id": "m1…", "rangeFrom": "2026-10-01 00:00:00", "rangeTo": null,
        "group": { "id": "e882…", "name": "Vertrieb" } }
    ]
  },
  "meta": { "error": false }
}

Jeder Eintrag in groups ist eine Verbindungszeile. Ohne id legt CDMS sie an. Das Pflichtfeld user der Zeile schickst du nicht mit, CDMS setzt es selbst, weil die Zeile über den Benutzer angelegt wird. group ist ein reiner Verweis per id.

Verbindung entfernen, ein Ende löschen

Fallen

Wie es weitergeht

• Beziehungstypen und Flags: Beziehungstypen und Recursive-Flags
• Von welcher Seite schreiben: Beide Seiten einer Beziehung
• Was mit entfernten Mitgliedern passiert: Listen als Zielzustand