Essence Modeller. Datum: 31 mei 2011 Versie: 1.0. Consortium: Forum Standaardisatie, Ordina, RuleManagement Group, Het Expertise Centrum, Novay, TNO

Transcriptie

1 Essence D1.4 Datum: 31 mei 2011 Versie: 1.0 Auteurs: Maarten W.A. Steen (Novay) Consortium: Forum Standaardisatie, Ordina, RuleManagement Group, Het Expertise Centrum, Novay, TNO

2 Postbus AN Enschede +31 (0) Colosseum PV Enschede +31 (0) project.nl Dankbetuiging Dit werk is tot stand gekomen in het consortiumproject Essence Fase 1, waarin Belastingdienst, RuleManagement Group, Ordina, Het Expertise Centrum, Forum Standaardisatie, TNO en Novay samenwerken aan schaalbare oplossingen voor semantische interoperabiliteit. Het project is gefinancierd door bijdragen van Forum Standaardisatie, RuleManagement Group, Ordina en Het Expertise Centrum, aangevuld uit EZ cofinancieringsmiddelen van TNO. Onze dank gaat uit naar alle professionals die, in schrift en discussie, bijgedragen hebben aan dit werk. De Creative Commons Naamsvermelding Niet commercieel 3.0 Nederland Licentie is van toepassing op dit werk. Ga naar nc/3.0/nl/ of stuur een brief naar Creative Commons, 171 Second Street, Suite 300, San Francisco, California, 94105, VS om deze licentie te bekijken.

3 iii Inhoudsopgave 1 Gebruikershandleiding Installatie instructies Aan de slag Een nieuw model maken Modelleren Kwalitatief versus kwantitatief Automatische Layout Een model openen Exporteren en Printen Bekende issues Developer Documentation Metamodel Grafische syntax Editor Model en Code Repository... 9 Referenties Samenvatting Dit document bevat documentatie voor de Essence Modeller versie 0.3 dd. Maart Dit document is een weerslag van de huidige stand van zaken, voor de laatste versie van de tool en de documentatie, zie Docushare: Hoofdstuk 1 bevat gebruikersinstructies. Hoofdstuk 2 is gericht op ontwikkelaars.

4

5 1 1 Gebruikershandleiding De Essence Modeller is een protype modelleertool voor het maken van Essencemodellen. De taal daarvan staat in een ander Essence rapport beschreven (Quartel at al. 2011). Op een wiki ( 175) hebben we een aantal tips en trucs verzameld om met de Essence Modeller te kunnen werken. Deze hebben betrekking op versie Installatie instructies Als System Requirements noemen we: Intern geheugen (RAM) van ten minste 1500 MB Java Runtime Environment (JRE) versie 1.6+ Download de laatste versie van de Essence Modeller: EssenceModeller zip Dit archief uitpakken (unzip) naar harde schijf, bijv. C: of D:. Tip: creëer meteen een Shortcut op de Desktop naar EclipseModeller 0.3/eclipse/EclipseModeller.exe door in de Windows Explorer op deze file, rechter muisknop > Send to > Desktop (create shortcut). Dan kun je voortaan de modeller direct vanaf de Desktop starten. Het kan zijn dat werkdirectories naar voor jullie vreemde plekken verwijzen. 1.2 Aan de slag De Essence Modeller is een grafische editor voor het maken van Essence modellen. Daarnaast kan deze tool de modellen ook opslaan, inlezen, printen, exporteren en opmaken. De Essence Modeller kan worden gestart door de file EclipseModeller 0.3/eclipse/EclipseModeller.exe te executeren. Het is handig om even een Shortcut naar deze file op de Desktop te plaatsen (zie Tip hierboven) Een nieuw model maken Je kunt een nieuw model maken via het menu File > New > Essence Model. In de dialook die volgt kun je een naam en een locatie opgeven voor het te creeren model. De naam moet eindigen op ".esd". Tip: Denk bij het creëren van een nieuw model even goed na over de naam en de locatie, want dit is lastig aan te passen in een later stadium. Tip: Als je de filename of locatie van een model toch wilt veranderen dan kun je dat via de gewone windows explorer doen.

6 Modelleren Als je een Horizon of Concept creëert kun je die direct een naam geven. Als je de naam van een bestaand object wilt veranderen, selecteer dan het object en druk op toets F2. Conceptnamen kunnen over meerdere regels lopen. Je kunt regelovergangen invoeren terwijl je de naam typt met de toetscombinatie CTRL+ENTER. Als je in een keer een heleboel concepten of relaties wilt creëren, houdt dan de CTRLtoets ingedrukt terwijl je het desbetreffende element selecteert in het tool palette. In de Properties View (rechtsonder) kun je additionele eigenschappen van objecten inzien en wijzigen. Concepten hebben bijvoorbeeld een Definition en een Description. Hierin kun je een nadere definitie en beschrijving, toelichting of motivatie geven in tekst. Het model zelf en de horizon hebben ook een Description, waarin bronnen, aannames of nadere toelichting opgenomen kunnen worden. Er kunnen twee soorten relaties tussen concepten getekend worden: de contextrelatie en de grondrelatie. Ieder concept mag maximaal 1 contextrelatie hebben. De editor staat het tekenen van een tweede contextrelatie gewoon niet toe. Een concept mag meer dan 1 grondrelatie hebben, maar niet meer dan 1 naar hetzelfde concept. De editor geeft een foutmelding als dit toch geprobeerd wordt. Ook mag er geen contextrelatie en grondrelatie tussen dezelfde twee concepten bestaan, dus dat wordt ook gesignaleerd door de editor. Er wordt een waarschuwing gegeven als een concept een grondrelatie heeft naar zichzelf Kwalitatief versus kwantitatief Je kunt switchen tussen een kwalitatief (standaard instelling) en kwantitatief perspectief op het model, door te schakelen tussen de knoppen All Connector Labels en No Connector Labels in de toolbalk Automatische opmaak Met het commando Arrange All in het Diagram menu, Rechter muisknop menu en op de toolbalk kun je de automatische opmaak activeren. Het is ook mogelijk om automatische opmaak alleen toe te passen een deel (een selectie) van het model. Gebruik daarvoor het commando Arrange > Selection Een model openen Het is mogelijk om een bestaand model te openen via het menu File > Open... In de dialoog die volgt Browse en selecteer het Essence model dat je wilt openen. Dit moet een.esd file, oftewel een Essence Diagram file, zijn Exporteren en Printen Je kunt een model printen via het menu File > Print... Je kunt ook het model exporteren als plaatje. Selecteer hiervoor dat deel van het diagram dat je wilt exporteren, dan druk op rechter muisknop > File > Save As Image File... In de dialoog die volgt kun je vervolgens aangeven naar welke Folder, onder welke File Name en in welk Image Format (GIF, PNG, BMP, JPG, SVG, PDF) het diagram geexporteerd moet worden. Tenslotte is het mogelijk om (een selectie van) het diagram te copieren (Copy) en plakken (Paste) in een een andere applicatie, zoals Word of Powerpoint. Helaas is het op

7 3 dit moment (nog) niet mogelijk om modelelementen in een ander Essence model te plakken. 1.3 Bekende issues Op dit moment zijn de volgende issue bekend: 1. De Save As... menu optie werkt niet. Als je de filename of locatie van een model wilt veranderen dan moet je dat via de gewone windows explorer doen. 2. Gebruikers van versie 0.2 zullen misschien de *.esm files missen. Op verzoek van sommige gebruikers maken we nu geen onderscheid meer tussen.esd en.esm files. Alle modelinformatie zit nu in de.esd file, dus het klopt dat je de.esm niet meer kunt vinden. 3. Soms ontstaat er een inconsistentie tussen het diagram en het onderliggende model, bijvoorbeeld als je eigenschappen hebt veranderd in de Properties View. Als dit gebeurd, probeer dan eerst het diagram te verversen met F5 of Rechter muisknop > Update Essence Diagram. Als dit het probleem niet oplost, kun je de inhoud van het model inspecteren in de Outline View (rechtsboven). Daarin bevindt zich een Tree view op het model. Van hieruit kunnen inconsistente modelelementen, concepten en relaties, verwijderd worden door ze te selecteren, rechter muisknop > Delete. 4. Het is lastig om de afmetingen van de Horizon aan te passen. Als de Horizon te dun of te klein is geworden, kun je dit herstellen met rechter muisknop > Format > Auto Size. Als de Horizon te klein is, kun je deze verlengen door eerst flink in te zoomen op het model (bijv. tot 200%) en dan met de muis de rechter zijkant van de horizon op te pakken en naar rechts te trekken. 5. Het direct kopiëren van concepten en/of relaties in één model en deze vervolgens plakken voor hergebruik in een ander model kan op dit moment niet. Voor versiebeheer is het het eenvoudigst om in Explorer een kopie van de.esd file te maken en deze te gebruiken voor het maken van een nieuwe versie van het model.

8

9 5 2 Developer Documentation De Essence Modeller is een protype modelleertool voor het maken van Essence modellen. De tool is grotendeels gegenereerd uit modellen voor de taal en de notatie met behulp van Eclipse, een open source raamwerk voor software ontwikkelomgevingen: EMF: het Eclipse Modeling Framework (Eclipse, 2011a) en GMF: het Graphical Modeling Framework (Eclipse, 2011b). De taaldefinitie is vastgelegd in een EMF metamodel, dat hieronder is beschreven. De notatie, de grafische syntax, is gespecificeerd in een GMF Graph model, dat via een GMF Mapping model is gerelateerd aan het metamodel. 2.1 Metamodel Een Essence model bestaat uit Concepten, hun Context en hun Gronden. De Context van een Concept wordt gespecificeerd door een Context Relatie een lijn met een pijlpunt tussen het Concept en een ander Concept dat zijn Context vertegenwoordigd. De Gronden van een Concept worden gespecificeerd door Grond Relaties tussen het Concept en andere Concepten die de Gronden vertegenwoordigen. Binnen een model wordt de context afgesloten door een Horizon, d.w.z. dat Context Relaties, en eventueel ook Grond Relaties, ook naar de Horizon mogen lopen. Het basis (kwalitatieve) metamodel staat in Figuur 1. Figuur 1. Het basis metamodel voor de Essence taal. Een ContextModel bestaat uit een verzameling Concepten. Een Concept kan een Context en nul of meer Intexten (concepten waarvoor dit concept de context is) hebben. De Context is de ContextRelation, waarvan het Concept de Source is. De Intext is de verzameling van Context Relaties waarvan het Concept de Target is. Een Concept kan nul of meer Gronden hebben, gerepresenteerd door de Grond Relaties waarvan het Concept de Source is. Een Concept kan ook nul of meer Eigenschappen (Properties)

10 6 hebben, dat zijn die Grond Relaties waarvan het Concept de Target is. Context en Grond Relaties kunnen ook de Horizon als Target hebben. Daarom is de Horizon hier gedefinieerd als specialisatie van Concept. De modelelementen hebben daarnaast een aantal eigenschappen. Deze eigenschappen zijn in een verfijning van het metamodel weergegeven (Figuur 2). Figuur 2. Het Essence metamodel met eigenschappen. Een Concept heeft een Naam en een informele (tekstuele) Definitie. Een Context Relatie heeft een unieke Id(entifier). Ten behoeve van kwantitatieve modellering heeft een Grond Relatie daarnaast een Source en een Target Cardinaliteit. Tenslotte, is het mogelijk om Documentatie aan het Context Model en aan Concepten toe te voegen voor toelichting en/of verduidelijking. 2.2 Grafische syntax De grafische syntax voor Essence modellen, waarvan een voorbeeld in Figuur 3 staat, is gedefinieerd in een GMF Graph model (zie Figuur 4). Op basis hiervan wordt door GMF de code gegenereerd voor het weergeven en manipuleren van de grafische symbolen in de editor. Figuur 3. Voorbeeld van een Essence modelletje.

11 7 De Horizon wordt weergegeven door een grijze afgeronde rechthoek van initieel 800 bij 7 pixels. Concepten worden weergegeven door afgeronde rechthoeken van initieel 100 bij 40 pixels, met achtergrondkleur {R:228,G:179,B:229} (RGB code voor licht paars) en met daarin een grijze rechthoek van 80 bij 2 pixels. Daarnaast bevatten zij een label. Context Relaties worden weergegeven door een polyline connection met een pijlpunt polyline decoration. Grond Relaties worden weergegeven door een polyline connection zonder pijlpunt. Tenslotte zijn er nog een aantal labels gedefinieerd die op een Essence diagram kunnen voorkomen: HorizonLabel, SourceCardinalityLabel en TargetCardinalityLabel. Figuur 4. GMF Graph model voor de Essence notatie. Het GMF Graph model wordt verbonden met het EMF metamodel via een GMF Mapping model. Dit model is weergegeven in Figuur 5. Het mapping model bestaat uit een aantal mappings die ieder een element uit het metamodel verbinden met hun grafische representatie.

12 8 Zo wordt een Concept aan een ConceptNode gerelateerd en wordt er een bijbehorende label mapping aangebracht tussen het attribuut name en het Concept Label. De Horizon mapping is analoog. Verder is er een mapping die een ContextRelation relateerd aan een ContextRelation Connection met bijbehorende label mappings voor de cardinaliteiten. Tenslotte wordt het ContextModel zelf gerelateerd aan het Essence canvas de achtergrond van het diagram. In de Canvas Mapping wordt bovendien een relatie gelegd met het Toolbar Palette en het Essence metamodel. Figuur 5. GMF mapping model voor de Essence editor.

13 9 2.3 Editor Met enkele aanpassingen van de gegenereerde code komt de Essence Editor er dan uit te zien zoals het screenshot in Figuur 6. Hiermee kunnen interactief en grafisch Essence modellen worden geconstrueerd. De tool kan de modellen ook opslaan, inlezen, printen, exporteren en opmaken. Figuur 6. Screenshot van de Essence Modeller. 2.4 Model en Code Repository De hierboven beschreven modellen, alsmede de aangepaste code zijn te vinden in de Subversion repository van Novay. De URL van de repository is: Gebruik je favoriete SVN client (e.g. Subclipse, Tortoise) om de repository te benaderen. Hiervoor is wel een account op de SVN server nodig, dat is aan te vragen bij de beheerder:

14 10 In de Essence repository staan de volgende Eclipse projecten: nl.novay.essence/ In dit project zitten alle modellen: metamodel, graph model, mapping model, etc. nl.novay.essence.model/ Hierin staat de grotendeels genereerde modelmanagement code voor Essence modellen. nl.novay.essence.model.edit/ nl.novay.essence.model.editor/ nl.novay.essence.modeller/ Hierin staat de genereerde (in /src gen) en aangepaste (in /src) code voor de grafische editor. nl.novay.essence.modeller.properties/ Hierin staat handmatig toegevoegde code voor de property sheets. nl.novay.essence.modeller.ui.outline/ Hierin staat handmatig toegevoegde code voor de outline view.

15 11 Referenties Dick Quartel, Jack Verhoosel, Lianne Bodenstaff, Roel Stap, Maarten Steen en Paul Oude Luttighuis (2011), Essence taaldefinitie en denkwijze. Essence Fase 1, D1.1. Mei Eclipse (2011a), Eclipse Modeling Framework Project. Eclipse (2011b), Graphical Modeling Project.