Imvertor release v4.5

Versie bijgewerkt t/m 23 december 2025

Nieuwe OpenAPI module

• De nieuwe OpenAPI module is toegevoegd als alternatief voor de VNG OpenAPI oplossing. Zie https://armatiek.nl/doc/imvertor/openapi/

MIM format (serialisatie)

• MIM format filenaam krijgt default: naam van het model
• Correcties in MIM serialisatie m.b.t. relaties. Dit is beschreven in #633.
• Mixin in mim serialisatie expliciet opgenomen als kenmerk. Zie #634.
• Correctie op MIM serialisatie schema voor backward compatibility. Deze aanpassing zorgt ervoor dat xml instanties die met eerdere versies van Imvertor werden gemaakt voor MIM 1.2 nog steeds valide zijn.
• Herstel mogelijke MIMversie warden in MIM serialisatie. De waarden denken nu alle mogelijke MIMversie waaarden af, voor betreffende MIM versie. Zie #651
• Beperk de meegeleverde schema's in MIM serialisatie tot de juiste versie. Wanneer versie 1.2 serialisatie is uitgevoerd, alleen 1.2 schema's meeleveren.
• Aanvullende correctie op MIM serialisatie schema voor backward compatibility. Deze aanpassing zorgt ervoor dat xml instanties die met eerdere versies van Imvertor werden gemaakt voor MIM 1.2 nog steeds valide zijn. Zie ook #651
• Introductie van tv/mimformat en tv/@norm = janee in tagsets. Nodig voor aansluiting op MIM export formaat. Dit is nu ook onderdeel van XMI omzetting.

Respec documentatie

• Niet meer het proces afbreken bij metadata fouten in Respec. Zie #573
• Introductie van metadata van model en domein in catalogus. Dit is de implementatie van #484 door middel van de introductie van de cli/includemodelinfo
• URLs die als waarde van een tagged value voorkomen zijn geen link. Deze links worden niet actief in de catalogus. Het blijven gewone "strings" en je kunt er niet op klikken. Zie #565
• Locatie van data van waardenlijst kunnen weergeven als Respec link. Moet een URL in een data locatie (alsnog) worden weergegeven als link? In een eerdere slag is besloten dit default als platte tekst te tonen in Respec. zie #565
• Weergave van Mixin in Respec is verbeterd. Als de generalisatie mixin is, wordt in de documentatie wordt nu niet meer aangegeven "is specialisatie van" maar "overerft eigenschappen van".
• <levels show=> attribuut aangebracht in docrules. Hiermee kan een bepaald kenmerk geheel niet worden getoond op verzoek. Geïntroduceerd tbv. Waterschapshuis.
• "Show-relation-name" geïntroduceerd. Dit is een nieuwe parameter binnen de docrules. Hiermee wordt aangegeven dat de relatienaam in een rol-gebaseerd model niet getoond wordt in het overzicht van relaties van een objecttype.
• Wanneer toelichting onderaan, dan niet als "regel" opnemen. Dit wordt vastgelegd in de parameter "explanation-location".
• Introductie van subheaders in Respec. De kopjes Overzicht attributen, associaties en toelichting onder o.a. een objecttype beschrijving zijn onterecht als volwaardige kopies (secties) opgenomen. Dat kan men nu tegengaan door de parameter "use-subheaders-in-respec" te zetten. Hiermee worden dit gewone kopjes zonder dat er naartoe gelinkt kan worden. Dit is het gevolg van eisen die HWH stelt. Doorgevoerd voor niemand anders, maar als optie nu beschikbaar.
• Nieuwe parameters voor documentatie opgenomen: "url-as-link", "show-short-attribute-cardinality", "show-short-attribute-unit"
• Herkenning van nieuwe parameters in configuratie. Ook verbeterde verwerking van @order: Als een doc-rule een order 000 heeft vervalt deze doc-rule en wordt het niet getoond in de documentatie.
• Verbeterde weergave Respec voor korte weergave attributen. Verzoek van HWH. Zie #656
• KardinaliteitBron toegevoegd aan respec regels. In respec kan nu dus ook worden weergegeven wat de kardinaliteit van de bron van een relatie is.
• Default voor CLI parameter includemodelinfo is "no" De oude situatie was dat van model en domein de metadata niet getoond wordt. Met deze parameter kan deze nu wel getoond worden.
• Default Respec positie van Toelichting voor MIM is: as-row. Was: at-bottom.

Algemeen

• Een Supplier is een supplier van zichzelf. Voorheen werd een <supplier> element samengesteld waarbij de supplier gegevens onttrokken werden van een hoger gelegen imvert:packages element. Nu kan dat ook de imvert:packages zelf zijn.
• Introductie van tvmissingaswarning property. Zie #572
• Enumeratiewaarden worden niet genormaliseerd. In eerdere releases werd deze waarde onder water "als een attribuutnaam" genormaliseerd. Dit heeft verkeerde bij-effecten, en dit is daarom veranderd. De opgegeven waarde is gelijk aan de originele waarde. Zie #602
• Update conceptual-schemas.xml. Referentie naar NEN3610:2022 toegevoegd
• Introductie van relatieve paden in report. Zichtbaar in Transformations overview.
• Correctie op Json schema compiler. De compiler ging ervan uit dat een Json metaschema was gespecificeerd; dat hoeft echter niet.
• Foutmelding als canonizatie niet compleet is. Zie #621
• Subfolder in XSD folderstructuur kan versie i.p.v. release bevatten. Dit kan worden ingesteld door een owner parameter "release-folder-name". Zie #622
• Introductie van Default input voor potentieel meerdere configuraties. Deze defaults kunnen worden aangesproken als er werkelijk "standaard" waarden voorzien zijn voor bepaalde onderwerpen. Technische verbetering. Gestart met default voor docrules. Alle docrules die gelijk zijn aan de default zijn verwijderd uit de eigenaar profielen.
• Correctie in de samenstelling van compare. Zie #419
• Waarschuwing bij niet beschikbare codelijsten wordt foutmelding. Zie #638
• Alle codelist locatie waarschuwingen nu als fout. Zie #638
• Een fout in het uitlezen van de XMI blokkeert niet meer. Voorheen werd de configuratie daardoor niet uitgelezen, waardoor het niet mogelijk was een net report te genereren.
• Correctie van properties in json arrays. Zie #586
• Registreren van het aantal errors/warnings geoptimaliseerd. Voorheen werden nieuwe tellingen van meldingen direct naar de configuratie geschreven; dit is vervangen door éénmalig bij afronding van de step. Ook is een maximum aantal errors ingevoerd; dit náást het max aantal warnings. Aangenomen wordt dat het kunnen nalezen van meer dan bijv. 500 meldingen geen meerwaarde heeft. De reden voor deze verandering is de grote impact die een grote hoeveelheid meldingen (grofweg > 1000) heeft op de performance, omdat deze bewaard worden in het geheugen om er later over te rapporteren in het Report. Zie #652
• MIM versie moet in EA (op basis van de toolbox zoals deze wordt gegenereerd) worden ingetikt. Ze kan niet meer gekozen worden uit een lijst omdat men gemakkelijker naar recentere versies van MIM moet kunnen overschakelen, zonder de EA toolbox te moeten herladen.
• Correctie op ophalen van tagged value waarden. Eerdere correctie was te streng. Er is nu een <body> element toegevoegd aan imf:get-tv-value(), wat beter aansluit bij de aard van de teruggeven waarde.
• Enumeraties worden niet meer automatisch als MIM enums opgevat. Dat is een feature geweest die moet komen te vervallen. Het model in EA moet compleet zijn en conform MIM.
• Twee plaatjes in een modeldoc worden niet meer "samengevoegd". Zie #661
• Toestaan dat bepaalde tagged values al dan niet xhtml content kunnen hebben.
• Introductie van "metamodel nature". Code voor het samenstellen van ea toolbox houdt rekening met die nature.
• Module ApcModifier verwijderd. Deze wordt niet (meer) gebruikt.
• Nieuwe Check of een rol in rol-gebaseerde modellen een naam heeft. Zie #664
• Nieuwe Check of relaties alleen naar objecttypen verwijzen. zie #665
• Laatste versie van SKOS AP NL ontologie opgenomen in de software.
• Implementatie van nieuwe rapportage eis voor missende tagged values. De tagged values die verplicht maar niet zijn opgegeven worden weggaletan, getoond of als fout gemeld op basis van de property tvmissingaswarning. Zie #459
• Nieuwe HTML encoding lijst waarden: regeleindes. Zie #685
• Tussenbestand *.embellish hernoemd naar *.modeldoc. Was verwarrend omdat er twee files zijn met *.embellish.
• Versie en fase fouten worden waarschuwingen. Voorheen waren dat fouten. Wanneer geen versie of fase is opgegeven wordt uitgegaan van 0.0.0 en 0, respectievelijk.
• De FATAL error wanneer geen (conceptual schema) mapping wordt gevonden wordt gewone ERROR. Zie #686
• Ophalen van de tagged values hield geen rekening met dubbelingen. Sommige TV's kunnen meermaals vookomen, zoals "Begrip". Deze moeten worden doorgegeven maar dat ging niet goed.

IHW

• Alleen nog conceptuele en logische modellen. De aansluiting bij VNGR SIM/UGM/BSM is verlaten.
• XML schema generatie ingericht op ISO 19136
• Conceptual Mappings toegevoegd. Betreft IMGEO211 en NEN3610-2022
• Configuratie voor OGC Json schema's aangemaakt. IHW kan nu ook Json schema's conform de OGC Best Practices samen laten stellen.
• Aanpassingen aan weergave catalogus. Zie #680

MInJenV

• Introductie van nieuwe owner MinJenV.
• MinVenJ sluit aan op MIM 1.2 en niet op VNG-R SIM.
• Verwijzingen naar VNG Realisatie vervangen door verwijzingen naar Ewout124.
• Nu ook bekend aan YamlCompiler. Voorheen werd MinJenV nog niet herkend als een gebruiker van de BSM conversie. MINJenV is nu toegevoegd.

VNG-R

• Neem docrule op zodat Respec catalogi kunnen worden samengesteld
• Aanpassing van compare keys. Dit lost het probleem op van de vergelijking van E-mail adres naast E-mailadres.

Kadaster

• Arc en ArcString opgenomen in GML profiel. Zie #631
• Kardinaliteit als kop van Respec kolommen ipv Card

HWH (Waterschapshuis)

• Documentatie aanpassingen. Font ingesteld op Math. Keuzes gemaakt voor bepaalde waarden van docrules.
• Omzetting van structuur van Respec documentatie. Detailinformatie sectie wordt niet getoond, enumeratiedetails worden onder de enumeratie zelf geplaatst.
• IMWA schema uitgebreid met basis datatypen en codelijsten
• Enumeraties krijgen code als eerste kolom. Zie #642
• Mogelijkheid geven objecttypen, enumeraties e.d te sorteren. Sortering vindt plaats op originele naam van het construct. Er is een parameter voor opgevoerd: "sort-in-domain". Dit is default no, voor HWH is het yes. Zie #642
• Introductie van Asap fonts en aanpassingen aan Respec documentatie.
• Kleurstelling Respec aangepast. Kleur aqua opgenomen.

Geonovum

• Correcties op SKOS en Shacl validatie daarvan. Zie #591
• Correctie op <th> elementen n.a.v. WCAG analyse. Zie #647

BRO

• Added the value for microSiemens/centimeter. Reason: BROSVO-2324.
• Includemodelinfo gezet op "no"
• Waarden kunnen nu HTML opmaak hebben. HTML ondersteund als opmaak van alle items in een respec serialisatie. Dit is vereist door BRO voor waardenlijst waarde-definities. Zie #663
• Correctie weergave van ingelezen lijsten, en witruimtes. Zie #679 Tevens correctie breedte van kolom 1. Zie #682