UDM Tutorial — Stufe 1: Die erste App

🎯 Ziel dieser Stufe: Am Ende haben Sie eine funktionierende App mit Kundenverwaltung und Auftragsliste — inklusive Formularen und Berechtigungen.

Rollen in dieser Stufe

Rolle	Was sie kann	Einschränkungen
Sachbearbeiter	Kunden und Aufträge anlegen, bearbeiten	Kein Löschen, nur eigene Aufträge
Teamleiter	Alle Aufträge sehen und bearbeiten	—
Vertriebsleiter	Alle Daten einsehen	Nur Lesen, keine Bearbeitung

Überblick: Was wir bauen

In dieser Stufe arbeiten wir uns durch alle 5 Schichten von UDM — von der Datenbank bis zur fertigen App:

   Was wir konfigurieren:                Was entsteht:

   Schicht 1: Subsystem "Vertrieb"      Datenbankverbindung
         |
   Schicht 2: Entity "Kunden"           Tabellen mit Feldern
              Entity "Aufträge"          und Beziehungen
         |
   Schicht 3: Datasource "Alle Kunden"  Abfragen mit
              Datasource "Alle Auftr."   Spaltenauswahl
         |
   Schicht 4: View "Kundenliste"        Tabellenansichten
              View "Auftragsliste"       und Formulare
              Dialog "Kunde bearbeiten"
              Dialog "Auftrag bearbeiten"
         |
   Schicht 5: App "Auftragsmanagement"  Menü mit Navigation
              Rollen & Berechtigungen    und Zugriffskontrolle

Übersicht: Wir arbeiten uns von Schicht 1 (unten) nach Schicht 5 (oben) vor.

Schritt 1: Subsystem anlegen — „Wo leben die Daten?“

🎯 Nach diesem Schritt ist die Datenbankverbindung eingerichtet und der Datenbereich „Vertrieb“ angelegt.

Was ist ein Subsystem? Stellen Sie sich einen Aktenschrank vor. Das Subsystem ist die Beschriftung des Schranks — z. B. „Vertrieb“ oder „Personal“. Es gruppiert zusammengehörige Datenobjekte und definiert, in welcher Datenbank die Daten gespeichert werden.

Öffnen Sie den Admin Client
Melden Sie sich im UDM Admin Client an. Sie sehen das Hauptmenü mit den Verwaltungsbereichen.

Screenshot: Admin Client Hauptmenü
Navigieren Sie zur Subsystem-Verwaltung
Klicken Sie auf System → Subsysteme. Hier sehen Sie die bereits vorhandenen Subsysteme.
Neues Subsystem anlegen
Klicken Sie auf „Neu“ und geben Sie folgende Daten ein:

Name Vertrieb

Beschreibung Kunden- und Auftragsdaten

Datenbankverbindung Wählen Sie die bereitgestellte Verbindung aus

Screenshot: Subsystem-Dialog mit ausgefüllten Feldern
Speichern
Klicken Sie auf „Speichern“. Das Subsystem „Vertrieb“ ist angelegt.

✅ Kontrollpunkt: In der Subsystem-Liste erscheint der Eintrag „Vertrieb“. Die Datenbankverbindung ist grün markiert.

Schritt 2: Entities anlegen — „Was wird gespeichert?“

🎯 Nach diesem Schritt existieren die Datenobjekte „Kunden“ und „Aufträge“ mit allen Feldern und der Beziehung zwischen ihnen.

Erinnerung aus Stufe 0: Ein Entity ist ein Karteikasten — es definiert, welche Informationen zu einem bestimmten Geschäftsobjekt gespeichert werden.

Entity „Kunden“

Entity-Verwaltung öffnen
Navigieren Sie zu Datenmodell → Datenobjekte. Klicken Sie auf „Neu“.
Entity benennen

Name Kunden

Subsystem Vertrieb

Beschreibung Kundenstammdaten

Felder (Properties) hinzufügen

Wechseln Sie zum Tab „Felder“ und legen Sie folgende Felder an:

Feldname	Datentyp	Pflicht	Hinweis
`Kundennr`	Text	Ja	Wird per Nummernkreis automatisch vergeben
`Firmenname`	Text	Ja
`Ansprechpartner`	Text	Nein
`Email`	Text	Nein
`Telefon`	Text	Nein
`PLZ`	Text	Nein
`Ort`	Text	Nein
`Strasse`	Text	Nein

Screenshot: Entity „Kunden“ mit Feldern

Entity „Aufträge“

Neues Entity anlegen

Name Auftraege

Subsystem Vertrieb

Beschreibung Kundenaufträge

Felder hinzufügen

Feldname	Datentyp	Pflicht	Hinweis
`Auftragsnr`	Text	Ja	Automatisch per Nummernkreis
`Bezeichnung`	Text	Ja
`Status`	Text	Ja	Standardwert: „Entwurf“
`ErstelltAm`	Datum	Ja	Automatisch beim Anlegen
`FaelligAm`	Datum	Nein
`Gesamtbetrag`	Zahl (Dezimal)	Nein
`ZugewiesenAn`	Text	Nein	Name des Sachbearbeiters

Beziehung zum Kunden herstellen
Wechseln Sie zum Tab „Beziehungen“ und legen Sie eine FK-Beziehung an:

Ziel-Entity Kunden

Feldname KundeId

Anzeigename Kunde

Das erstellt den Verweis „Auftrag gehört zu Kunde“ — genau wie in Stufe 0 beschrieben.

Screenshot: FK-Beziehung Auftrag → Kunde

✅ Kontrollpunkt: Unter „Datenobjekte“ sehen Sie „Kunden“ und „Auftraege“ im Subsystem „Vertrieb“. Der Auftrag hat eine FK-Beziehung zum Kunden.

Schritt 3: Nummernkreise einrichten

🎯 Kunden und Aufträge erhalten automatisch fortlaufende Nummern wie K-0001 und A-2026-0001.

Wie ein Nummernblock: Statt dass jeder Sachbearbeiter sich eine Nummer ausdenkt, vergibt das System automatisch die nächste freie Nummer — lückenlos und eindeutig.

Nummernkreis-Verwaltung öffnen
Navigieren Sie zu Automatisierung → Nummernkreise.

Nummernkreis für Kunden

Name	`Kundennummern`
Präfix	`K-`
Startwert	`1`
Stellen	`4` (ergibt K-0001, K-0002, ...)
Ziel-Entity	`Kunden`
Ziel-Feld	`Kundennr`

Nummernkreis für Aufträge

Name	`Auftragsnummern`
Präfix	`A-{YYYY}-` (mit Jahreszahl)
Startwert	`1`
Stellen	`4` (ergibt A-2026-0001, ...)
Ziel-Entity	`Auftraege`
Ziel-Feld	`Auftragsnr`

✅ Kontrollpunkt: Beim Anlegen eines neuen Kunden wird automatisch eine Kundennummer vergeben. Beim Anlegen eines Auftrags erscheint eine Auftragsnummer mit Jahreszahl.

Schritt 4: Datenquellen anlegen — „Welche Daten anzeigen?“

🎯 Nach diesem Schritt gibt es Datenquellen, die festlegen, welche Daten in welcher Form abgefragt werden.

Entity vs. Datenquelle: Das Entity definiert, was gespeichert wird. Die Datenquelle definiert, wie die Daten abgefragt werden — welche Spalten angezeigt werden, ob gefiltert wird, und ob Daten aus verknüpften Tabellen dazukommen.

Datenquelle „Alle Kunden“

Datasource-Verwaltung öffnen
Navigieren Sie zu Datenmodell → Datenquellen. Klicken Sie auf „Neu“.
Datenquelle konfigurieren

Name Alle Kunden

Basis-Entity Kunden

Filter Kein Filter (alle Datensätze)
Spalten auswählen
Wählen Sie die Spalten aus, die in der Abfrage enthalten sein sollen:

Kundennr, Firmenname, Ansprechpartner, Email, Telefon, Ort

Datenquelle „Alle Aufträge“

Neue Datenquelle anlegen

Name Alle Auftraege

Basis-Entity Auftraege
Spalten auswählen — inklusive Kundename
Wählen Sie: Auftragsnr, Bezeichnung, Status, FaelligAm, Gesamtbetrag

Zusätzlich: Fügen Sie über die FK-Beziehung das Feld Kunden.Firmenname als Spalte „Kunde“ hinzu. So sehen Sie in der Auftragsliste direkt den Kundennamen statt einer ID.

Screenshot: Spaltenauswahl mit FK-Feld „Kunden.Firmenname“

Datenquelle „Meine Aufträge“

Gefilterte Datenquelle

Name Meine Auftraege

Basis-Entity Auftraege

Filter ZugewiesenAn = [Aktueller Benutzer]

Dieser Filter zeigt nur Aufträge an, die dem angemeldeten Benutzer zugewiesen sind.

✅ Kontrollpunkt: Unter „Datenquellen“ sehen Sie drei Einträge: „Alle Kunden“, „Alle Auftraege“ und „Meine Auftraege“.

Schritt 5: Ansichten einrichten — „Wie sieht es aus?“

🎯 Nach diesem Schritt gibt es Tabellenansichten für Kunden und Aufträge.

Datenquelle vs. Ansicht: Die Datenquelle legt fest, welche Daten abgefragt werden. Die Ansicht (ViewElement) legt fest, wie sie dargestellt werden — als Tabelle, Diagramm, Kanban-Board oder Dashboard.

Ansicht „Kundenliste“

Ansichtselement-Verwaltung öffnen
Navigieren Sie zu Ansichten → Ansichtselemente. Klicken Sie auf „Neu“.
Ansichtselement konfigurieren

Name Kundenliste

Ansichtstyp Liste / Grid

Datenquelle Alle Kunden

Spalten konfigurieren

Legen Sie fest, welche Spalten in der Tabelle erscheinen und in welcher Reihenfolge:

Spalte	Breite	Sortierung
Kundennr	100px	—
Firmenname	auto	Aufsteigend (Standard)
Ansprechpartner	auto	—
Ort	150px	—

Screenshot: Kundenliste im User Client

Ansicht „Auftragsliste“

Neues Ansichtselement

Name Auftragsliste

Ansichtstyp Liste / Grid

Datenquelle Alle Auftraege

Spalten konfigurieren

Spalte	Breite	Sortierung
Auftragsnr	130px	—
Bezeichnung	auto	—
Kunde	200px	—
Status	130px	—
FaelligAm	120px	—
Gesamtbetrag	120px	—

✅ Kontrollpunkt: Unter „Ansichtselemente“ gibt es „Kundenliste“ und „Auftragsliste“, beide vom Typ „Grid“.

Schritt 6: Formulare erstellen — „Wie bearbeite ich Daten?“

🎯 Benutzer können Kunden und Aufträge über Formulare anlegen und bearbeiten.

Ansicht vs. Dialog: Die Ansicht zeigt eine Übersicht (z. B. Tabelle). Der Dialog ist das Formular, das sich öffnet, wenn Sie einen Datensatz anklicken oder „Neu“ wählen.

Dialog „Kunde bearbeiten“

Dialog-Verwaltung öffnen
Navigieren Sie zu Formulare → Dialoge. Klicken Sie auf „Neu“.
Dialog konfigurieren

Name Kunde bearbeiten

Entity Kunden

Formularfelder anlegen

Feld	Elementtyp	Pflicht
Firmenname	Textfeld	Ja
Ansprechpartner	Textfeld	Nein
Email	Textfeld	Nein
Telefon	Textfeld	Nein
Strasse	Textfeld	Nein
PLZ	Textfeld	Nein
Ort	Textfeld	Nein

Tipp: Das Feld „Kundennr“ wird nicht ins Formular aufgenommen — es wird automatisch vom Nummernkreis vergeben.

Screenshot: Dialog „Kunde bearbeiten“ im Designer

Dialog „Auftrag bearbeiten“

Neuen Dialog anlegen

Name Auftrag bearbeiten

Entity Auftraege

Formularfelder anlegen

Feld	Elementtyp	Pflicht	Hinweis
Bezeichnung	Textfeld	Ja
Kunde	Lookup (ComboBox)	Ja	Zeigt Firmenname, speichert FK
Status	Dropdown	Ja	Werte: Entwurf, Offen, In Bearbeitung, Erledigt, Storniert
FaelligAm	Datumsfeld	Nein
Gesamtbetrag	Zahlenfeld	Nein

Kunden-Lookup konfigurieren
Das Lookup-Feld ist besonders wichtig: Es zeigt dem Benutzer eine Auswahlliste mit Kundennamen, speichert aber intern den Verweis (FK) auf den Kunden. So muss niemand eine Kundennummer eintippen.

Screenshot: Lookup-Konfiguration für Kunden-Auswahl

✅ Kontrollpunkt: Die Dialoge „Kunde bearbeiten“ und „Auftrag bearbeiten“ sind angelegt. Im Auftragsdialog zeigt das Kunden-Feld eine Dropdown-Auswahl.

Schritt 7: App zusammenstellen — „Das Menü“

🎯 Die App „Auftragsmanagement“ steht mit Menüstruktur im User Client bereit.

App-Verwaltung öffnen
Navigieren Sie zu Apps → Anwendungen. Klicken Sie auf „Neu“.
App konfigurieren

Name Auftragsmanagement

Beschreibung Kunden- und Auftragsverwaltung

Menüpunkte anlegen

Fügen Sie der App folgende Menüeinträge hinzu:

Menüpunkt	Ansichtselement
Kunden	Kundenliste
Alle Aufträge	Auftragsliste
Meine Aufträge	Auftragsliste (mit Datasource „Meine Auftraege“)

Screenshot: App-Menükonfiguration

Schritt 8: Benutzer & Rollen — „Wer darf was?“

🎯 Die drei Rollen (Sachbearbeiter, Teamleiter, Vertriebsleiter) sind mit unterschiedlichen Berechtigungen eingerichtet.

Rollen anlegen

Navigieren Sie zu Benutzer → Rollen und erstellen Sie:

Rolle	Entity „Kunden“	Entity „Auftraege“
Sachbearbeiter	Lesen, Erstellen, Bearbeiten	Lesen, Erstellen, Bearbeiten (nur eigene)
Teamleiter	Lesen, Erstellen, Bearbeiten	Lesen, Erstellen, Bearbeiten, Löschen (alle)
Vertriebsleiter	Nur Lesen	Nur Lesen

Testbenutzer anlegen
Erstellen Sie unter Benutzer → Benutzerverwaltung mindestens einen Benutzer pro Rolle zum Testen.

Screenshot: Benutzerverwaltung mit Rollenzuweisung

Ergebnis: Ihre erste App testen

Melden Sie sich im User Client als Sachbearbeiter an. Sie sollten nun:

Die App „Auftragsmanagement“ im Menü sehen
Einen neuen Kunden anlegen können (Kundennummer wird automatisch vergeben)
Einen neuen Auftrag anlegen und den Kunden per Dropdown auswählen
In der Auftragsliste den Kundennamen neben dem Auftrag sehen

Screenshot: Fertige App im User Client — Kundenliste und Auftragsliste

✅ Kontrollpunkt — Stufe 1 abgeschlossen!

Subsystem „Vertrieb“ angelegt
Entities „Kunden“ und „Auftraege“ mit Feldern und FK-Beziehung
Nummernkreise für automatische Kunden- und Auftragsnummern
Drei Datenquellen (Alle Kunden, Alle Aufträge, Meine Aufträge)
Tabellenansichten für Kunden und Aufträge
Formulare mit Lookup-Feld für die Kundenauswahl
App mit Menüstruktur
Drei Rollen mit unterschiedlichen Berechtigungen

Was kommt als Nächstes? In Stufe 2 machen wir die App lebendig: Aufträge durchlaufen einen Freigabe-Workflow, Benachrichtigungen werden automatisch verschickt, und Hintergrund-Jobs erinnern an fällige Aufträge.

← Stufe 0: Datengrundlagen Weiter zu Stufe 2: Aktionen & Prozesse →

Name	`Vertrieb`
Beschreibung	`Kunden- und Auftragsdaten`
Datenbankverbindung	Wählen Sie die bereitgestellte Verbindung aus

Name	`Kunden`
Subsystem	`Vertrieb`
Beschreibung	`Kundenstammdaten`

Name	`Alle Kunden`
Basis-Entity	`Kunden`
Filter	Kein Filter (alle Datensätze)

Name	`Meine Auftraege`
Basis-Entity	`Auftraege`
Filter	`ZugewiesenAn = [Aktueller Benutzer]`

Name	`Kundenliste`
Ansichtstyp	Liste / Grid
Datenquelle	`Alle Kunden`

Name	`Auftragsliste`
Ansichtstyp	Liste / Grid
Datenquelle	`Alle Auftraege`

Name	`Auftragsmanagement`
Beschreibung	`Kunden- und Auftragsverwaltung`

Ziel-Entity	`Kunden`
Feldname	`KundeId`
Anzeigename	`Kunde`

Stufe 1 — Die erste App: Auftragsmanagement

Überblick: Was wir bauen

Schritt 1: Subsystem anlegen — „Wo leben die Daten?“

Schritt 2: Entities anlegen — „Was wird gespeichert?“

Entity „Kunden“

Entity „Aufträge“

Schritt 3: Nummernkreise einrichten

Schritt 4: Datenquellen anlegen — „Welche Daten anzeigen?“

Datenquelle „Alle Kunden“

Datenquelle „Alle Aufträge“

Datenquelle „Meine Aufträge“

Schritt 5: Ansichten einrichten — „Wie sieht es aus?“

Ansicht „Kundenliste“

Ansicht „Auftragsliste“

Schritt 6: Formulare erstellen — „Wie bearbeite ich Daten?“

Dialog „Kunde bearbeiten“

Dialog „Auftrag bearbeiten“

Schritt 7: App zusammenstellen — „Das Menü“

Schritt 8: Benutzer & Rollen — „Wer darf was?“

Ergebnis: Ihre erste App testen