ArjanLoeffen
commented
3 months ago Het is niet mogelijk om plaatjes direct op te nemen in een notitie in EA. Vanuit de notities moet dus worden verwezen naar een plaatje dat op en andere manier is opgenomen in EA, en dat daarvandaan door Imvertor kan worden ingevoegd op de juiste plek.
Mogelijk aanpak zoeken in:
Diagram plaatje
Plaatjes drag&drop op een diagram dat speciaal daarvoor is geïntroduceerd. Dit "diagram plaatje" kan dan worden ingevoegd op de plek waar er naar verwezen is, door middel van een Hyperlink/Diagram image.
- In de XMI krijgt dat de vorm:
$diagramimg://{BB416021-498A-4ba5-A518-57403C3F3A8D}. - Het diagram wordt niet inline getoond; kan worden opgeroepen met ctrl-click.
- Het diagram is onderdeel van SVN en de QEA database.
- Het zgn. diagram krijgt een naam mee (linksboven), hetgeen niet aantrekkelijk is voor gewone plaatjes in content.
Link naar File
Alle plaatjes kunnen á la Documentor worden verzameld op een vaste plek en meegeleverd in het Respec documentatie proces. Naar betreffende plaatje kan worden verwezen via Hyperlink/File.
- In de XMI krijgt dat de vorm:
[hele lokale pad naar plaatje].png - Het plaatje wordt niet inline getoond; kan worden opgeroepen met ctrl-click.
- Het plaatje is as-is op te roepen vanuit de ZIP zoals overgedragen; dit volgt dan de aanpak van Documentor documenten.
Link naar Image manager
Het plaatje kan worden ingeladen via de image manager (Settings/Images). De image manager kan worden aangevuld met Add new.
- In de XMI krijgt dat de vorm:
$imageman://id=761587016;mdg=Global;name=Klepstuw;type=Bitmap; - Het plaatje wordt niet inline getoond; kan alleen worden opgeroepen met ctrl-click.
- De image manager bewaart het plaatje in de EA database (qea file).
- Het plaatje wordt als base64 in de XMI meegeleverd als ernaar wordt gerefereerd vanuit een notitie veld. Bij importeren van de XMI wordt het plaatje weer opgenomen in de image manager.
- TODO We moeten uitzoeken hoe het zit met de SVN import/export. gaat het (base64) plaatje dan ook mee?
Via properties dialoog
Je kunt ook een file (plaatje) toevoegen in de "Properties" dialoog van bv een Class/Objectype. Het is hiermee echter niet mogelijk te verwijzen vanuit een plek in notities naar dat plaatje.
Te kiezen oplossing?
Er lijken twee oplossingen acceptabel:
- Beste optie voor iedereen: gebruik de image manager. Imvertor OS lees het plaatje vanuit de XMI uit en zet het onder de opgegeven naam klaar in de export folder. De verwijzingen resulteren in een weergave van het plaatje in de Respec omgeving wanneer ernaar onder die naam wordt verwezen.
- Aanvullende optie voor Documentor gebruikers: het verwijzen naar het plaatje op het filesysteem (link naar file). Eis daarbij is dan wel dat de plaatjes op een vaste plek in de Documentor folder worden geplaatst (documentor folder wordt meegegeven in de Add-in dialoog). Voorkeur heeft dat de plaatjes ook een unieke naam hebben. De naam van het plaatje is dan voldoende om vast te stellen welk plaatje moet worden ingevoegd. Dit is echter geen eis als plaatjes worden gegroepeerd in folders onder een vaste startfolder, en de sub-paden naar het plaatje worden opgenomen in de notitie (default gedrag van EA).
Er is nog wel wat uit te zoeken m.b.t. omvang en plaatsing van de plaatjes.
Imvertor kan de XMI en de diagrammen, wanneer correct aangeleverd, verwerken in aangeboden catalogus documentatievorm (op dit moment Respec en MsWord). Onderzoek of het mogelijk is ook andere plaatjes, gebonden aan een construct in de UML en/of aan de notities daarop, op te nemen in de uiteindelijke catalogus info.
Neem hierbij ook mee dat deze plaatjes vanuit Enterprise Architect zouden kunnen worden aangeleverd.