Settings.xml XML-formaat voor virtuele SQL databases

Bestanden in het settings.xml bestandsformaat worden gebruikt om virtuele databases te definieren binnen de on-premises producten van Invantive zoals het Invantive Query Tool, Invantive Data Replicator en Invantive Control for Excel.

Databases zijn gegroepeerd in groepen. Elke database bestaat uit een of meerdere zogenaamde “datacontainers”, samen met definities voor eventuele routering en uitwijkverbindingen. Datacontainers en andere Invantive SQL-concepten staan verder uitgelegd bij de SQL grammatica.

Het settings.xml bestandsformaat is gebaseerd op XML in bij voorkeur Unicode formaat en werkt op alle operating systems: Windows, MacOS, Linux, Android en iOS.

De formele definitie van het settings.xml XML-formaat is te vinden op Settings.xml Format XML Schema Documentation.

Bestandslocatie

Het settings.xml-bestand wordt gezocht op verschillende locaties. Meestal zijn deze bestanden te vinden in %USERPROFILE%\invantive, maar andere mappen kunnen ingesteld worden. Bovendien kun je bij het opstarten van de Invantive softwareproducten voor Windows opgeven waar het settings.xml-bestand staat.

Speciale varianten

Invantive producten maken zelf tijdens de “ontdekkingstocht” een eigen settings-discovery-*.xml bestand, met daarin de ontdekte lokale en cloudverbindingen.

Voorbeeld

Een voorbeeld van de inhoud van een settings.xml bestand is:

<?xml version="1.0" encoding="utf-16"?>
<!-- Voorbeeld bestand Exact Online Nederland met Belgie
-->
<settings xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  version="5"
  VersionUpdateDate="2020-11-27T12:09:59.0756754Z">
  <group
    iconResourceName32="exact_online_32.png"
    sortingOrder="0"
    name="ACME"
    id="a9a1a317-f173-4410-8447-298fa4344a9a">
    <connection
      IconResourceName16="exact_online_16.png"
      sortingOrder="10"
      id="c149becf-01d3-4a58-9ee7-7369f34bdff5"
      name="Exact Online NL plus BE"
      authentication="Default">
      <database
        order="10"
        alias="be"
        provider="ExactOnlineAll"
        connectionString="api-url=https://start.exactonline.be"
        AllowConnectionPooling="false" />
      <database
        order="20"
        alias="nl"
        provider="ExactOnlineAll"
        connectionString="api-url=https://start.exactonline.nl"
        AllowConnectionPooling="false" />
    </connection>
  </group>
</settings>

In deze database “ACME” zijn zowel een Exact Online België als Exact Online Nederland datacontainer gelijktijdig benaderbaar met SQL-statements.

De connectionString bevat de driverattributen met afwijkende instellingen als een puntkomma-gescheiden lijst. In dit geval wordt api-url ingesteld.