Änderungen in der Konfiguration

Checkliste

• Schema aktualisieren

  • JSON Schema appsettings.schema.json

  • XSD Schema

    • Converters

• (DatabaseConfigurationMigrationService erweitern)

• 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:

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: