XML naar INI omzetten

XML kan willekeurig diep nesten; INI kent maar twee niveaus, secties en sleutels daarbinnen. Voordat er een geldig INI-bestand uit kan komen, wordt elk pad door de XML-boom samengevoegd tot één sleutel per eindwaarde, met de elementnamen aan elkaar geplakt door een punt.

Een element `<server><host>example.com</host></server>` wordt zo een sleutel `server.host` met de waarde `example.com` — de waarde zelf verandert niet, alleen de manier waarop hij wordt aangeduid.

Komt eenzelfde elementnaam meerdere keren voor op hetzelfde niveau — de gangbare manier waarop XML een lijst weergeeft — dan wordt elk voorkomen apart genummerd in de sleutelnaam, op dezelfde manier als een array bij een omzetting vanuit JSON.

Voor een korte lijst is dat overzichtelijk; voor een lange lijst van herhaalde elementen levert het een flink aantal aparte sleutels op in de INI.

Een XML-element kan zowel attributen als tekstinhoud dragen. Beide worden meegenomen in de omzetting, maar als losse sleutels — een attribuut `id` op een element `gebruiker` komt terecht als een eigen sleutel naast de sleutel voor de inhoud van dat element.

Controleer bij een complex bronbestand of alle relevante attributen zijn meegekomen, vooral wanneer de betekenis van een element grotendeels in zijn attributen zat in plaats van in de tekst ertussen.

De volgorde waarin de elementen in de XML voorkwamen, blijft hetzelfde in de INI-uitvoer — er wordt nergens gesorteerd. Voor een configuratiebestand waar leesvolgorde ertoe doet, blijft dat gedrag intact.

Elk element wordt in dezelfde volgorde als sleutel weggeschreven als waarin het in de brontekst voorkwam.

Commentaarregels in de XML — tussen `<!--` en `-->` — worden bij het lezen niet meegenomen, net als bij elk ander configuratieformaat op deze site. Namespaces en verwerkingsinstructies hebben in een plat sleutel-waardebestand als INI ook geen plek en worden weggelaten.

Is die informatie belangrijk, noteer ze dan apart voor je omzet, want ze komen niet automatisch terug.

XML kent net als INI eigenlijk alleen tekst — typering gebeurt aan de kant van de software die het bestand leest. Een waarde `8080` blijft dus de tekenreeks `8080`, in beide formaten.

Dat maakt deze omzetting in dat opzicht eenvoudiger dan een omzetting vanuit JSON, waar getallen en booleans wel als apart type worden vastgelegd voordat ze tot tekst worden.

Het lezen van de XML en het schrijven van de INI gebeurt in deze browsertab. Er wordt niets naar een server gestuurd, wat te controleren is via het netwerktabblad tijdens het omzetten.

Voor configuratie met interne servernamen of toegangsgegevens is dat relevant.

Tot honderd XML-bestanden tegelijk neerzetten kan; elk bestand wordt onafhankelijk verwerkt en het resultaat komt terug als één ZIP met de INI-bestanden erin.

Praktisch voor wie een reeks configuraties uit een oudere XML-gebaseerde applicatie in één keer wil overzetten.