Fra XML til JSON: databasedefinisjoner i innstillinger*

Gå til nederlandsk versjon

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> kalles database (ental) eller databases (flertall).
  • <database> kalles dataContainer (ental) eller dataContainers (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.