Seminar Umbraco – MVC, Razor und Routing

Wartbare Umbraco-Anwendungen trennen Inhaltszugriff, Darstellung und Fachlogik. Das Seminar zeigt, wann ein einfaches Template genügt und wann Ansichtsmodelle, Controller, eigene Routen oder Services erforderlich sind.

Eine Beispielanwendung wird über drei Tage um Listen, Detailseiten, Formularlogik, Mitgliederzugriff, benutzerdefinierte Routen und API-Funktionen erweitert. Jede Erweiterung wird mit Tests und klaren Fehlerzuständen abgesichert.

Inhaltsverzeichnis

• Zielsetzung
• Zielgruppe
• Voraussetzungen
• Seminarinhalte
• Praxisübungen
• Methodik

Zielsetzung

Ziel ist die sichere Nutzung des ASP.NET-Core-MVC-Modells innerhalb von Umbraco mit klaren Verantwortlichkeiten und gut testbarer Anwendungslogik.

Zielgruppe

Umbraco- und .NET-Entwickler mit Verantwortung für Templates, Controller, APIs oder individuelle Anwendungsfunktionen.

Voraussetzungen

Gute Kenntnisse in C#, ASP.NET Core MVC, Razor, Dependency Injection, HTTP und Umbraco-Grundentwicklung.

Seminarinhalte

Die Themen werden in aufeinander aufbauenden Arbeitsschritten behandelt. Jeder Schritt wird demonstriert, in der Übungsumgebung umgesetzt und anhand festgelegter Prüfkriterien kontrolliert.

Tag 1 – Modelle, Templates und Ansichtslogik

Der erste Tag strukturiert Inhaltszugriff und Rendering.

1. Schritt 1: Models Builder, generierte Inhaltstypen und Aliasstabilität einordnen und einen typisierten Zugriff ohne verstreute Zeichenketten aufbauen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Layouts, Templates, Partials und Komponenten nach Verantwortlichkeit strukturieren und redundante Abfragen vermeiden. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Ansichtsmodelle für Listen, Navigation, Detailseiten und kombinierte Datenquellen entwerfen und über einen klaren Mapper befüllen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: Medien, Varianten, Fallback und fehlende Werte in der Darstellung robust behandeln. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Rendering mit Unit- und Integrationsprüfungen sowie reproduzierbaren Testinhalten absichern. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Tag 2 – Routing, Controller und Mitgliederfunktionen

Der zweite Tag ergänzt gezielte Eingriffe in Anfragen und Benutzerinteraktion.

1. Schritt 1: Standardrouting, veröffentlichte Routen und Gründe für benutzerdefinierte Eingriffe nachvollziehbar unterscheiden. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Route Hijacking oder Render Controller für eine Seite mit zusätzlicher Fachlogik implementieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Formularverarbeitung über einen geeigneten Controller mit Eingabemodell, Validierung, Schutz und Rückmeldung umsetzen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: Mitgliederanmeldung, Autorisierung, geschützte Inhalte und Rücksprung nach Anmeldung in einen konsistenten Ablauf integrieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Content Finder und eigene Routenkonvention für einen fachlich begründeten Adressfall entwickeln und auf Konflikte testen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Tag 3 – APIs, Services, Notifications und Qualität

Der dritte Tag kapselt Fachlogik und stellt kontrollierte Schnittstellen bereit.

1. Schritt 1: Eigene API-Controller mit begrenzten Datenverträgen, Statuscodes, Validierung und Autorisierung bereitstellen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Umbraco-Services sowie Content- und Media-APIs gezielt verwenden und Schreiboperationen von Lesemodellen trennen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Notifications oder Ereignisse für Validierung, Reaktion und Integration einsetzen, ohne schwer nachvollziehbare Seiteneffekte zu erzeugen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: Dependency Injection, Lebensdauern, Caching und Fehlerbehandlung für testbare Services konfigurieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Controller-, Routing-, API- und Berechtigungstests ausführen und typische Leistungs- sowie Sicherheitsfehler korrigieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Praxisübungen

• Implementierung einer typisierten Listen- und Detailansicht mit eigenem Ansichtsmodell.
• Umsetzung eines benutzerdefinierten Renderingpfads und eines validierten Formulars.
• Erstellung eines geschützten Mitgliederbereichs mit kontrollierter Weiterleitung.
• Bereitstellung und Test eines API-Endpunkts sowie einer ereignisgesteuerten Validierung.

Methodik

Kurze Fachvorträge wechseln mit Live-Demonstrationen, geführten Umsetzungen und selbstständigen Übungen. Zwischenstände werden anhand nachvollziehbarer Prüfschritte kontrolliert. Typische Fehlkonfigurationen und Störungsszenarien werden bewusst einbezogen, damit nicht nur der Normalfall, sondern auch Diagnose, Korrektur und sichere Rücknahme beherrscht werden.