Fra og med versjon 27.0 leser Invantive UniversalSQL databasedefinisjoner fra settings*.json istedenfor settings*.xml. Eksisterende XML-filer migreres automatisk.
Støtte for XML-formatet er ikke lenger tilgjengelig fra Invantive UniversalSQL versjon 28.0 (planlagt for utgivelse rundt starten av 2028).
Hvorfor
XML-formatet stammer fra 2009 og har to problemer som et formatbytte løser.
- Verktøy: å lese eller generere en innstilling krever XPath og/eller XSLT. Imidlertid analyserer de fleste språk JSON uten tilleggslibrer. Generering av en innstillingsfil per kunde eller per miljø blir en tekstmaløvelse i stedet for en XML.
- Utdaterte elementer: XML-formatet har mye historie på databasekoblingskonsepter. Mange elementer støttes ikke lenger eller er ikke relevante. JSON-formatet bruker de nåværende konseptene, så det du leser er det begrepet betyr.
Format
settings*.json-formatet ligner sterkt på XML-formatet. De viktigste endringene er:
<connection>kallesdatabase(ental) ellerdatabases(flertall).<database>kallesdataContainer(ental) ellerdataContainers(flertall).
For eksempel:
{ "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 og etterfølgende komma tolereres når en fil leses. Kommentarer og etterfølgende komma forsvinner hvis et produkt skriver settings*json-filen på nytt.
Migrering
Det er gjort en innsats for å gjøre migreringen så enkel som mulig.
Første gang et produkt i versjon 27.0 leser en settings*.xml-fil der det ikke finnes en .json-fil med identisk navn, opprettes den funksjonelt identiske JSON-filen ved siden av. XML-filen forblir uendret. Utdaterte egenskaper ignoreres.
Filer som produseres ved automatisk oppdagelse (settings-discovery*.xml) migreres aldri ettersom de er knyttet til en spesifikk hovedutgivelse.
Hvilket format brukes
| Versjon | Adferd |
|---|---|
| 26.0 og tidligere | settings*.xml brukes; en settings*.json-fil ignoreres. |
| 26.1 (BETA av 27.0) | settings*.json brukes; en identisk navngitt settings*.xml ignoreres og brukes til å lage JSON-varianten. |
| 27.0 | settings*.json brukes; en identisk navngitt settings*.xml ignoreres og brukes til å lage JSON-varianten. |
| 28.0 | settings*.json brukes; XML-formatet støttes ikke lenger eller brukes til å lage JSON-varianten. |
Når et miljø bare bruker versjon 27.0 eller nyere, kan alle settings*.xml-filer trygt fjernes når JSON-formatfilen eksisterer.