In dit document geven we alle informatie die je nodig hebt om te gaan werken met de Imvertor addin van Enterprise Architect. Het is een opstart-document, dat je verder leidt naar informatie die je kunt gebruiken in het werken aan informatiemodellen.

Dit document is gereed voor publicatie.

Welkom bij Imvertor SaaS

Welkom bij Imvertor SaaS!

Deze software as a service wordt gerealiseerd door Armatiek Solutions BV. De service is bereikbaar via Sparx Enterprise Architect (EA), middels een zogenaamde addin, dat wil zeggen een software component die is toegevoegd aan EA.

Als het goed is ben je geregistreerd als gebruiker. Hierover heb je een mail ontvangen: “Welkom bij Imvertor!”. Is dat nog niet het geval, vraag dan aan jouw contactpersoon binnen de organisatie om een account.

In de welkomsmail staat wie de owner is, je gebruikersnaam en je paswoord. De “owner” is de naam van jouw organisatie in de configuraties van Imvertor. Gebruikersnaam is opgegeven door jouw organisatie, en het paswoord is gegenereerd door de SaaS.

Je kunt zelf het paswoord aanpassen via de addin. Die moet wel zijn geïnstalleerd. Lees hier hoe je die kunt installeren.

Er is aparte documentatie van de Imvertor SaaS. Dit document behandelt allerlei aspecten van het werken met Imvertor, inclusief de open source component.

Er is een MIM primer voor als je MIM modellen wilt gaan ontwikkelen. Die primer maakt de MIM standaard toegankelijker en bevat een uitgewerkt voorbeeldmodel.

Een Imvertor run (“job”) kun je sturen met properties. Lees hier meer over properties in Imvertor.

Als jouw organisatie heeft besloten het model als een compleet document te laten genereren door Imvertor, kun je hier wat meer lezen over die “Documentor” module.

Wanneer je organisatie gebruik wil maken van de OpenAPI module van Armatiek, dan kun je hier lezen hoe je de de OpenAPI module kunt inzetten.

Als je vragen of suggesties hebt, mail dan naar imvertor-saas@armatiek.nl.

Veel succes!

Het Armatiek Solutions Team

Installeren van de software

Als je met Imvertor aan de slag wilt, moet je deze stappen volgen.

In deze stappen kan het natuurlijk zijn dat de software al door jouw organisatie is ingesteld. Controleer in dat geval de juiste versie van de addin.

Stap 1: Vraag je Imvertor account op. Jouw Imvertor-beheerder of Armatiek Solutions (info@armatiek-solutions.nl) heeft dit account aangemaakt. Dit is wel afhankelijk van de SaaS-inrichting van jouw organisatie. Dit account is een naam (je naam, CamelCased) en een wachtwoord. Met deze combinatie kunt je taken uitvoeren en toegang krijgen tot het Imvertor-dashboard.

Stap 2: Installeer Enterprise Architect. De software kan worden gedownload van de Sparx-pagina's. Selecteer a.u.b. versie 15 (32 bit) of hoger (64 bit).

Stap 3: Installeer Enterprise Architect.

Stap 4: Download hier de Imvertor-addin : 32 bits (alle EA-versies), 64 bits (EA 16 of hoger, vraag je Imvertor-beheerder). Stop EA vóór de installatie.

Stap 5: Installeer de addin (diubbelklik op het EAImvertorAddinSetup*.exe bestand dat je hebt gedownload). Het is aan te raden om de addin met beheerdersrechten te installeren.

Het kan zijn dat Microsoft Defender de melding hieronder geeft.

NB Dit kan ook in het engels zijn: Windows protected your PC / Microsoft Defender Smartscreen prevented an unrecognized app from starting. [..]

Je klikt dan op Meer informatie (of More info), en daarna: Toch uitvoeren (of Run anyway).

Ook kun je een vraag zien of je de software wilt installeren: Wilt je toestaan dat deze app van een onbekende uitgever wijzigingen aan jouw apparaat aanbrengt? Klik op Ja.

De addin installatie begint.

Stap 6: Klik op okay om te installeren.

Hierna is de addin beschikbaar in jouw EA installatie.

Om dit vast te stellen start je Enterprise Architect. Je gaat naar Specialize, en daaronder zie je Imvertor SaaS (Armatiek) staan.

Staat die er niet? Kijk dan onder Specialize > Manage Addin. Als EAImvertorAddin er niet bij staat, met vinkje Loaddeze on start, dan moet je contact opnemen met jouw Imvertor-beheerder.

Als je andere problemen ondervindt kan deze informatie helpen.

Nb EA 15 (32 bits) en hoger (64 bits) en de bijbehorende EA Imvertor-addins kunnen naast elkaar worden geïnstalleerd.

Instellen van de addin voor jouw situatie

Eenmaal geïnstalleerd kun je Imvertor instellen voor je EA-omgeving. Open eerst een model. Ga daarna naar Specialize / Imvertor (Armatiek) / Settings.

In het instellingendialoogvenster kun je je eerst introduceren als de gebruiker en vervolgens enkele standaardinstellingen kiezen.

1. Typ de URL van de Armatiek service voor Imvertor: https://imvertor.armatiek.nl/

2. Typ indien nodig een proxy. Vraag je beheerder of een proxy nodig is. Als je het niet weet, laat het dan leeg.

3. Typ jouw gebruikersnaam/wachtwoord, zoals via een e-mail verstrekt door Armatiek Solutions. Deze informatie blijft bewaard op je machine. Je kunt je wachtwoord ook eerst aanpassen.

4. Klik op "Check/Save". Hiermee wordt alle (mogelijk nieuwe) informatie van de server opgehaald en worden de overige velden ingevuld/ingesteld in overeenstemming met de configuratie van jouw organisatie.

5. Kies een standaard verwerkingsmodus in de vervolgkeuzelijst. Vraag je Imvertor beheerder naar de aard van de verwerkingsmodi die voor jouw organisatie zijn ingericht.

6. Selecteer een bestand met standaardeigenschappen of laat het leeg. Dit bestand bevat properties, zoals elders besproken.

7. Selecteer een standaard geschiedenisbestand of laat het leeg. Geschiedenisbestanden worden gebruikt door het Kadaster en kunnen door elke andere eigenaar worden gebruikt; Bij twijfel leeg laten.

8. Selecteer een modeldoc map (optioneel). Deze map bevat de Documentor-bestanden die moeten worden gebruikt bij het maken van de Respec-documentatie. Wanneer deze map leeg is of niet gevonden wordt, wordt de Respec documentatie niet aangemaakt. Zie informatie over Documentor in Imvertor. Dit is alleen van toepassing wanneer dit voor jouw organisatie is ingericht.

9. Stel de time-out seconden en het vernieuwingsinterval in voor de berichten (voortgang) die worden weergegeven in het invoegvenster (optioneel).

10. Wijzig de locatie van de resultatenmap die alle ZIP-resultaten bevat (optioneel).

11. Controleer of diagrammen moeten worden opgenomen in de exports (vereist wanneer documentatie diagrammen moet bevatten).

12. Klik op "Check/Save" en Imvertor is klaar om je jobs te verwerken.

Nu moet je ook de toolbox importeren voor het metamodel dat je wilt gebruiken. Het metamodel wordt vastgesteld door jouw organisatie en moet worden aangeleverd door jouw Imvertor-beheerder.

Ga naar Find command… (EA16) of in het menu /search (EA17) en zoek MDG. Kies voor Publish technology / Import MDG technology. Zoek het aangeleverde Toolbox XML bestand, en importeer het. Vaak is het nodig hierna EA even opnieuw op te starten.

Selecteer in het venster Toolbox Visibility, all perspectives, en selecteer het profiel op basis van de naam van dat profiel (meerdere aanvinkvakjes).

Vanaf nu kun je de constructies naar een diagram (en project) slepen en neerzetten.

We hebben ook in een apart document wat hulp en tips verzameld over het maken van een informatiemodel.