Från och med version 27.0 läser Invantive UniversalSQL databasdefinitioner från settings*.json istället för settings*.xml. Befintliga XML-filer migreras automatiskt.
Stöd för XML-formatet är inte längre tillgängligt från Invantive UniversalSQL version 28.0 (planerad release runt början av 2028).
Varför
XML-formatet härstammar från 2009 och medför två problem som ett formatbyte löser.
- Verktyg: läsning eller generering av en inställningsfil kräver XPath och/eller XSLT. Däremot kan de flesta språk tolka JSON utan ytterligare bibliotek. Att generera en inställningsfil per kund eller per miljö blir en textmallövning snarare än en XML-övning.
- Föråldrade element: XML-formatet har mycket historia om databasanslutningskoncept. Många element stöds inte längre eller är inte relevanta. JSON-formatet använder de nuvarande koncepten, så det du läser är vad termen betyder.
Format
Formatet settings*.json liknar starkt XML-formatet. De viktigaste förändringarna är:
<connection>kallasdatabase(singular) ellerdatabases(plural).<database>kallasdataContainer(singular) ellerdataContainers(plural).
Till exempel:
{ "version": "5"
, "groups":
[ { "name": "ACME"
, "sortingOrder": 100
, "databases":
[ { "name": "acme-eol"
, "shortDescription": "Exact Online"
, "sortingOrder": 10
, "authentication": "Default"
, "dataContainers":
[ { "kind": "dataContainer"
, "provider": "ExactOnlineAll"
, "alias": "eol"
, "order": 10
, "connectionString": "..."
}
]
}
]
}
]
}
Kommentarer och efterföljande kommatecken tolereras när en fil läses. Kommentarer och efterföljande kommatecken försvinner om en produkt skriver om settings*.json-filen.
Migration
En ansträngning har gjorts för att göra migrationen så enkel som möjligt.
Första gången en produkt av version 27.0 läser en settings*.xml-fil för vilken ingen identiskt namngiven .json-fil finns, skapas den funktionellt identiska JSON-filen bredvid den. XML-filen lämnas oförändrad. Föråldrade egenskaper ignoreras.
Filer som produceras av automatisk upptäckning (settings-discovery*.xml) migreras aldrig eftersom de är associerade med en specifik huvudversion.
Vilket format används
| Version | Beteende |
|---|---|
| 26.0 och tidigare | settings*.xml används; en settings*.json-fil ignoreras. |
| 26.1 (BETA av 27.0) | settings*.json används; en identiskt namngiven settings*.xml ignoreras och används för att skapa JSON-varianten. |
| 27.0 | settings*.json används; en identiskt namngiven settings*.xml ignoreras och används för att skapa JSON-varianten. |
| 28.0 | settings*.json används; XML-formatet stöds inte längre eller används för att skapa JSON-varianten. |
När en miljö endast använder version 27.0 eller nyare kan alla settings*.xml-filer säkert tas bort när JSON-formatfilen finns.