...
Checkliste
Schema aktualisieren
JSON Schema
appsettings.schema.jsonXSD Schema
Converters
(
DatabaseConfigurationMigrationServiceerweitern)Dokumentation anpassen
Konfigurations Migrations Guide v10.0.0-main14165 aktualisieren
Konfigurationsschlüssel aktualisieren
Template Projekt aktualisieren
Schema
JSON Schema
Kann die geänderte Konfiguration über das appsettings.json konfiguriert werden, so muss auch das Schema dementsprechend aktualisiert werden. (Siehe Validierung der appsettings & Schema referenz)
XSD Schema
Kann die geänderte Konfiguration über XML Layouts angepasst werden, so muss auch das XSD Schema aktualisiert werden. Sobald sich das XML Schema verändert müssen auch die Converter aktualisiert werden. Von XML zu Layout gibt es das Overlay. Von Layout zu XML gibt es den XmlModelSerializer.
DatabaseConfigurationMigrationService
Dieser service wurde geschrieben um die Konfigurationen die in die Datenbank geschrieben werden automatisch zu migrieren. In diesem Service sind drei Listen mit Migrationsaktionen, diese sind folgendermassen aufgeteilt:
Name | Beschreibung |
|---|---|
| Konfigurationsschlüssel die nur umbenannt wurden |
| Konfigurationsschlüssel die nicht mehr existieren |
| komplexe changes der Konfiguration die aber ein definitives Resultat haben |
Die Konfigurationsschlüssel sollten immer in lower-case sein, wobei der neue Name bei _renamedKeys im korrekten casing sein sollte.
Dokumentation
Die Konfiguration ist an mehreren Orten dokumentiert. Die wichtigsten dabei wären:
Titel | Beschreibung |
|---|---|
Dokumentation aller verwendeten Konfigurationsschlüssel und deren mögliche Werte sowie Standartwert | |
Guide der helfen soll Konfigurationen zu migrieren |