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.