General.IncludeConfig[]

Zu den Werten, die aus einer primären Konfigurationsdatenquelle gelesen werden, können Werte aus einer oder mehreren sekundären Quellen hinzugefügt werden.

Die JSON-Inhalte mehrerer Konfigurationen werden zu einer Gesamtkonfiguration zusammengefügt. Das kann z. B. zur Vermeidung redundanter Konfigurationen und/oder Teil-Konfigurationen dienen, wenn in mehreren primären Konfigurationen Inhalte auftreten, die sich wiederholen.

Damit dieselben Inhalte nicht mehrfach gepflegt werden müssen, können diese Inhalte in eine gemeinsam genutzte Include-Konfiguration ausgelagert werden. Diese Include-Konfiguration wird aus den primären Konfigurationen referenziert. In einer Include-Konfiguration können wiederum keine weiteren Include-Konfigurationen eingebunden werden.

In .IncludeConfig[] müssen die sekundären Konfigurationen in URI-Syntax (siehe Datenformat und Datenquellen) angegeben werden. Die Angabe kann als absoluter Pfad erfolgen oder als relativer Pfad, bezogen auf den Pfad der primären Konfiguration. Jede Konfiguration kann eine unvollständige Teilkonfiguration enthalten, denn erst aus der Gesamtheit aller Teile muss sich ein konsistenter Stand ergeben.

Die Zusammensetzung der Gesamtkonfiguration aus diesen Teilen erfolgt als erster Schritt noch vor der inhaltlichen Interpretation und Validierung der Daten. Voraussetzung hierfür ist, dass jeder Teil in valider JSON-Syntax vorliegt. Zum Verbinden von JSON-Daten kommt folgende generische Logik zum Einsatz:

Die Daten werden in der Reihenfolge, in der diese referenziert wurden, aus den sekundären Konfigurationen in die primäre Konfiguration eingefügt. Konfigurationseigenschaften, die in der primären Konfiguration bereits vorhanden sind, werden durch die Werte aus der sekundären Konfiguration überschrieben. Die Daten werden jedoch nur überschrieben, wenn es sich um elementare Eigenschaften handelt und die Werte dieser Eigenschaften in der sekundären Konfiguration nicht leer sind. Werte gelten als leer, wenn diese "null" sind. Eine leere Zeichenfolge "" stellt in diesem Kontext keinen leeren Wert dar und überschreibt somit einen Wert in der primären Konfiguration. Elemente gleichnamiger Arrays werden in der Reihenfolge, in der diese definiert wurden, aus den sekundären Konfigurationen an die jeweiligen Array-Elemente in der primären Konfiguration angehängt. Ausgenommen davon sind inhaltsgleiche Elemente, die nur einmal anstatt doppelt übernommen werden.

Aus fachlicher Sicht ist diese Behandlung der Array-Elemente nicht immer gewünscht. In einigen Fälle sollen z. B. Felder aus einer sekundären Konfiguration in einem bestehenden Feldkatalog der primären Konfiguration ergänzt werden, anstatt einen eigenständigen Feldkatalog anzufügen. Für bestimmte Elemente, die als Array strukturiert sind, findet daher eine inhaltsbasierte Nachverarbeitung der Konfigurationsdaten statt. Für das Endergebnis ist die aus dem Zwischenschritt resultierende Reihenfolge der Array-Elemente relevant. Diese Elemente enthalten Arrays mit Unterelementen, z. B. Feldauflistungen, die zu einem gemeinsamen Array zusammengefasst werden sollen. Diese Zusammenfassung erfolgt durch sukzessives Anhängen weiterer Elemente an das jeweils erste Array. Die Reihenfolge der Elemente wird dabei beibehalten.

Die globale Eigenschaft General.DebugWriteMergedConfig kann genutzt werden, um das Endergebnis der programminternen Dateizusammenführung zu Kontrollzwecken in Dateiform auszugeben.