Help:SmartConnectImvertor
Inleiding
Deze ArchiXL-extensie importeert 1 of meerdere UML-modellen die zijn gemodelleerd conform de MIM-methodiek. MIM staat voor Metamodellering InformatieModellen en is een landelijk aanbevolen standaard voor gegevensmodellering. Zie ook de site van Geonovum.
Gebruik
Deze extensie kan worden gebruikt om de volgende modeltypen te importeren en te presenteren:
- SIM modellen, semantische informatiemodellen
- UGM modellen, uitwisselingsgegevensmodellen
- BSM modellen, berichtspecificatiemodellen
De importbestanden worden geleverd door Imvertor. De export uit Enterpise Architect van Sparx, met Imvertor plugin en gevalideerd door Imvertor. Dit levert een valide model op in de vorm van een ZIP-bestand, met daarin alle benodigde informatie. Dit bestand wordt aangeboden aan deze WikiXL-omgeving via de Speciale pagina SmartConnectImvertor
Het formulier voor de bestandsimport vraagt om een te uploaden bestand. Andere opties zijn:
- Test, kies dit als je eerst de inhoud van aan te bieden pagina's in wiki-formaat wil zien.
- Tekstfilter, gebruik deze optie als er 'vreemde' karakters in het bestand zitten die verstorend kunnen werken in de wiki. Overigens komt dit nauwelijks voor.
- Verstuur e-mailnotificatie na voltooiing. Als de import start, krijgt de betreffende gebruiker een mail op zijn bij aanmelding op de wiki opgegeven email-adres. Deze wordt direct verstuurd en geeft aan dat de import succesvol is verlopen. Let op: momenteel ordt deze nog te vroeg verstuurd. Houd anders de pagina SmartConnectJobsOverview in de gaten. Deze laat de voortgang van verwerking zien.
Als het bestand is geïmporteerd, kijk dan op de overzichtspagina DisplayImvertorModels om het geïmporteerde model te raadplegen.
Presentatie van het model
De presentatie van het model is ooit initieel opgezet conform de HTML-rapportage van Imvertor. Deze wordt default overgenomen. Om daar van af te wijken is het mogelijk om zelf de presentatie vorm te even naar eigen inzicht.
Configuratie algemene instellingen
Op de pagina Project:SmartConnectImvertor zijn een aantal instellingen aan te passen.
- Paginanaam: Keuze uit GUID/Naam. Dit bepaalt of de pagina een GUID als paginanaam krijgt of een betekenisvolle naam conform de Nederlandse API strategie. Een GUID is altijd uniek en gebaseerd op de GUID die wordt geleverd door Sparx Enterprise Architect.
- Prefix: Dit bepaalt of de GUID een prefix krijgt, bijvoorbeeld 'Id-'.
- Label: Het default label in veel overzichten van attributen heeft van origine Formaat,, dit kan aangepast worden, bv door de term 'Type' te gebruiken. Default staat deze op 'Formaat'.
- Toon lege waarden: De pagina's van modelonderdelen bevatten attributen met waarden. Default worden ook attributen met lege waarden getoond. Met deze instelling (keuze Ja/Nee, kan worden ingesteld of deze default wel (Ja) of niet (Nee) getoond worden.
- Basiskleur tabellen: Deze extensie bevat nogal wat tabellen waarvan de header een bepaalde kleur heeft. Deze kan hier worden ingesteld met een hexadecimale waarde, let op: zonder het verplichte '#'. Kijk bv op https://www.color-hex.com/ om een kleur te zoeken.
- Breedte afbeelding op view-pagina's: Dit bepaalt de breedte van getoond afbeeldingen op de default view-pagina's. Deze staat default op 800 pixels.
- URL thesaurus: De URL van de publieke thesaurusomgeving, indien van toepassing
Presentatie modelonderdelen
Elke modelonderdeel, bijvoorbeeld objecttypen of attribuutgroepen, kent een eigen instelling van wat er getoond en hoe het weergegeven dient te worden. Deze kan ook per onderdeel worden aangepast naar eigen inzicht.
Dit kan op twee manieren. Ga naar de pagina Overzicht IMV v2 implementatie. Daar staat per welk type welk sjabloon gebruikt en eventueel aangepast kan worden. Let wel, bij een update van de sjablonen worden deze aanpassingen overschreven. Er kan ook gewerkt kunnen worden met zogenaamde Custom-sjablonen. Deze worden niet aangepast bij nieuwe versie van de standaardsjablonen. Deze benadering geniet de voorkeur.
- Lijst-Sjablonen: Deze geven aan welke standaardeigenschappen per elementtype getoond worden. Uitleg RGB Lijst Sjablonen
- ShowData-Sjablonen: Deze kunnen extra informatie tonen, na een lijstsjablooon, bijvoorbeeld toon de Attribuutgroepen bij een Objecttype.
Customization van de presentie
Custom sjablonen vervangen het standaard sjablonen voor het betreffende elementtype. De SmartConnectImvertor-extensie kent twee typen weergave sjablonen RGBLijst-sjablonen en RGBShowData-sjablonen. Voor als deze type sjablonen kunnen zogenaamde Custom-sjablonen worden gemaakt. Dat zijn sjablonen met de toevoeging Custom in hun naam. Als ze bestaan worden deze gebruikt anders worden de standaardsjablonen (meegeleverd met deze extensie) getoond.
Voorbeeld
Als het het voorbeeld nemen van het concept Attribuutsoort. Deze wordt gestuurd door de volgende sjablonen:
- Gegevens: ATTRIBUUTSOORT. Dit is een wikipagina, behorend bij de extensie SmartCore. Hiermee worden de eigenschappen en relaties gedefinieerd en wordt de data ook toegekend aan deze pagina.
- Presentatie: Sjabloon:RGBLijstAlgemeen, deze toont de algemene eigenschappen voor elk elementtype. Met de configuratie worden wel of geen lege waarden getoond
- Presentatie: Sjabloon:RGBLijstAttribuutsoort, deze toont de specifieke eigenschappen van dit elementtype.
- Voor een nadere uitleg zie: Sjabloon:Uitleg RGB Lijst Sjablonen
Daarnaast zijn er specifieke templates voor elk elementtype om detailinformatie te tonen. bv:
- Presentatie: Sjabloon:RGBShowDataAttribuutsoort
- Presentatie: Sjabloon:RGBShowDataObjecttype Elementtypes kunnen ook voorkomen in RGBShowData-templates van anderen. Bijv: attribuutsoorten worden ook getoond bij Objecttypen:
Om voor een wiki aanpassingen te doen qua gegevens en de presentatie daarvan, gebruik dan de mogelijkheid om custom-templates in te zetten. Dat kan door naast de bovenstaande templates, een custom-variant aan te maken. Bv:
- Gegevens: Aanpassingen in het zetten van eigenschappen kunnen conform de SmartCore-extensie worden gemaakt in zogenaamde epilogue-templates, bv: Sjabloon:ATTRIBUUTSOORTEpilogue
- Presentatie: Sjabloon:RGBLijstAttribuutsoortCustom. Op basis van dezelfde voorwaarden, zie Sjabloon:Uitleg RGB Lijst Sjablonen, kan een wiki-specifieke presentatie opgezet worden.
- Presentatie: Sjabloon:RGBShowDataObjecttypeCustom. Variaties op de standaard detailinformatie van een elementtype
Kijk voor alle te gebruiken templates op: Overzicht IMV v2 implementatie of naar het SmartServerPages-importoverzicht: Project:SmartServerPages_(SmartConnectImvertor)
Geïmporteerde informatiemodellen
- Informatiemodel BOI2023 1.0
- Informatiemodel IMWA SIM 1.0
- Informatiemodel IMWA SIM 22.1
- Informatiemodel SIKB 14.5
Of kijk op: Overzicht van alle Imvertor-modellen
Verwijzen naar (delen van) informatiemodellen
Queries voor links en lijstjes met voorbeelden
| Modelinformatie | |
|---|---|
| [[Boi2023 1.0/doc/informatiemodel/boi2023 1.0}]] | Informatiemodel BOI2023 1.0 |
| {{#ask: [[Application::BOI2023]]}} | Informatiemodel BOI2023 1.0 |
| {{#ask: [[Application::BOI2023]][[Version::1.0]]}} | Informatiemodel BOI2023 1.0 |
| {{#ask: [[Categorie:INFORMATIEMODELLEN]]|format=ul}} | |
| Objecten | |
| [[Imwa sim 1.0/doc/objecttype/aansluitconstructie]] | Objecttype Aansluitconstructie |
| {{#ask: [[Name::Aansluitconstructie]]}} | Objecttype Aansluitconstructie, Objecttype Aansluitconstructie |
| {{#ask: [[Name::Aansluitconstructie]] [[Occurs in model.Application::BOI2023]]}} | Objecttype Aansluitconstructie, Objecttype Aansluitconstructie<ul><li>Subzoekopdrachten worden niet ondersteund voor waarden van de eigenschap "Application".</li> <!--br--><li>Het deel "BOI2023" van de zoekopdracht is niet begrepen.De resultaten kunnen afwijken van de verwachting.</li> <!--br--><li>Het deel "]]" van de zoekopdracht is niet begrepen.De resultaten kunnen afwijken van de verwachting.</li></ul> |
| {{#ask: [[Name::Aansluitconstructie]] [[Occurs in model.Application::BOI2023]] [[Categorie:OBJECTTYPEN]]|searchlabel=}} | Objecttype Aansluitconstructie, Objecttype Aansluitconstructie<ul><li>Subzoekopdrachten worden niet ondersteund voor waarden van de eigenschap "Application".</li> <!--br--><li>Het deel "BOI2023" van de zoekopdracht is niet begrepen.De resultaten kunnen afwijken van de verwachting.</li> <!--br--><li>Het deel "]]" van de zoekopdracht is niet begrepen.De resultaten kunnen afwijken van de verwachting.</li></ul> |
| {{#ask: [[Occurs in model.Application::BOI2023]] [[Categorie:OBJECTTYPEN]] |format=ul|limit=5|searchlabel=}} |
|
| Attributen | |
| {{#ask: [[Name::BAGIdentification]]|?Behoort tot klasse|headers=hide |format=ul|limit=5|searchlabel=}} | |
| {{#ask: [[Name::BAGIdentification]] [[Occurs in model.Application::BOI2023]]|?Behoort tot klasse|headers=hide |format=ul|limit=5|searchlabel=}} |
|
| {{#ask: [[Occurs in model.Application::BOI2023]] [[Categorie:ATTRIBUUTSOORTEN]] |?Behoort tot klasse|headers=hide |format=ul|limit=5|searchlabel=}} |
|
Views
{{ToonRGBImvertorView
|Model=Boi2023 1.0/doc/informatiemodel/boi2023 1.0
|Versie=
|Naam=zaaktype
|Resolutie=800px
|limit=1
|searchlabel=
}}
of eenvoudiger
{{ToonRGBImvertorView|Boi2023 1.0/doc/classdiagram/assembleren boi2023|800px}}
Resolutie: 800px. Toon op ware grootte
