Seminar Umbraco – Grundlagen für Entwickler

Der Einstieg in Umbraco wird zuverlässig, wenn Inhaltsmodell, Rendering, Anwendungslogik und Betrieb nicht getrennt voneinander gelernt werden. Das Seminar führt deshalb durch ein vollständiges Projekt und erklärt jede technische Entscheidung in ihrem fachlichen Zusammenhang.

Über vier Tage entsteht eine kleine, mehrseitige Website mit strukturierten Inhalten, Blockbereichen, Formularverarbeitung, geschütztem Bereich und API-Ausgabe. Qualität, Sicherheit und Bereitstellung werden von Beginn an mitgeführt statt erst am Ende ergänzt.

Inhaltsverzeichnis

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

Zielsetzung

Ziel ist eine tragfähige Entwicklungsgrundlage, auf der weitere Spezialisierungen zu MVC, Backoffice-Erweiterung, Integration, Suche, Cloud oder Commerce aufbauen können.

Zielgruppe

Webentwickler, .NET-Entwickler, technische Quereinsteiger mit Programmiererfahrung und Projektteams vor dem ersten Umbraco-Projekt.

Voraussetzungen

Grundkenntnisse in C#, ASP.NET Core, HTML, CSS, HTTP und relationalen Datenbanken. Erfahrung mit Versionsverwaltung und einer Entwicklungsumgebung wird vorausgesetzt.

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 – Installation, Architektur und Projektstruktur

Der erste Tag schafft eine reproduzierbare Entwicklungsumgebung und ordnet die zentralen Systemkomponenten ein.

1. Schritt 1: Laufzeit, Datenbank, Entwicklungswerkzeuge und Projektabhängigkeiten prüfen und eine saubere lokale Installation erstellen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Anwendung, Backoffice, Inhaltsdaten, Medien, Konfiguration und Erweiterungen in der Gesamtarchitektur verorten. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Konfiguration nach Umgebung strukturieren, Geheimnisse aus dem Quellcode entfernen und sinnvolle Entwicklungsstandards festlegen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: Versionsverwaltung, ignorierte Dateien, Startdaten und Teamabläufe so vorbereiten, dass neue Arbeitsplätze reproduzierbar eingerichtet werden können. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Eine technische Grundprüfung mit Anmeldung, Inhaltszugriff, Medienablage, Protokollen und Datenbankverbindung durchführen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Tag 2 – Inhaltsmodelle, Razor und Blockbereiche

Der zweite Tag verbindet strukturierte Inhalte mit einer wartbaren Ausgabe.

1. Schritt 1: Document Types, Kompositionen, Datentypen und Validierung aus einem einfachen fachlichen Inhaltsmodell ableiten. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Generierte Modelle, Vorlagen, Layouts und Partials verwenden und Zugriffe auf Inhalte ohne unkontrollierte Zeichenketten strukturieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Navigation, Listen, Detailseiten und wiederverwendbare Komponenten mit klaren Ansichtsmodellen implementieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: Blockbereiche mit Inhalts- und Einstellungsmodellen aufbauen und jeden Block in einer gekapselten Darstellung ausgeben. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Medien, Bildzuschnitte, responsive Ausgabe und Alternativtexte in die Komponenten integrieren und auf fehlende Medien reagieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Tag 3 – Controller, Formulare, Mitglieder und APIs

Der dritte Tag ergänzt interaktive und geschützte Anwendungsfunktionen.

1. Schritt 1: Renderingpfade und Controller-Verantwortlichkeiten unterscheiden und nur dort eingreifen, wo eigene Anwendungslogik erforderlich ist. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Formularverarbeitung mit Eingabemodell, serverseitiger Validierung, Schutzmechanismen und verständlicher Rückmeldung umsetzen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Mitglieder, Anmeldung, Abmeldung, geschützte Bereiche und Berechtigungsprüfung in einen nachvollziehbaren Ablauf integrieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: Eigene API-Endpunkte mit klaren Verträgen, Autorisierung, Fehlerantworten und begrenzter Datenmenge bereitstellen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Services, Dependency Injection und Ereignisse verwenden, um Fachlogik von Darstellung und Infrastruktur zu trennen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Tag 4 – Qualität, Sicherheit, Bereitstellung und Projektabschluss

Der vierte Tag macht das Beispielprojekt testbar und betreibbar.

1. Schritt 1: Unit- und Integrationstests für Modelle, Services, Controller und zentrale Benutzerwege aufbauen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
2. Schritt 2: Protokollierung, Fehlerseiten, Health Checks und Diagnoseinformationen für Entwicklung und Betrieb sinnvoll konfigurieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
3. Schritt 3: Sichere Header, Anmeldung, Geheimnisse, Dateizugriffe, Paketpflege und minimale Berechtigungen anhand einer Prüfliste kontrollieren. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
4. Schritt 4: Build und Bereitstellung für Test und Produktion vorbereiten sowie Datenbank, Medien, Konfiguration und Rückfallstrategie berücksichtigen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.
5. Schritt 5: Das Gesamtprojekt anhand definierter Abnahmekriterien prüfen, technische Schulden erfassen und nächste Spezialisierungsschritte zuordnen. Die Umsetzung wird unmittelbar geprüft, fachlich eingeordnet und mit den notwendigen Betriebs- oder Qualitätsregeln dokumentiert.

Praxisübungen

• Aufbau eines vollständigen Umbraco-Projekts von der lokalen Installation bis zur bereitstellbaren Anwendung.
• Implementierung einer strukturierten Website mit Navigation, Blockbereichen, Medien und wiederverwendbaren Komponenten.
• Ergänzung eines validierten Formulars, eines geschützten Mitgliederbereichs und eines eigenen API-Endpunkts.
• Durchführung einer technischen Abnahme mit Tests, Sicherheitsprüfung, Health Checks und Bereitstellungsprobelauf.

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.