Från XML till JSON: databasdefinitioner i inställningar*

Gå till nederländsk version

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> kallas database (singular) eller databases (plural).
  • <database> kallas dataContainer (singular) eller dataContainers (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.