Innovator 11 excellence. Anbindung an Visual Studio. Einführung, Installation und Konfiguration. Connect. Roland Patka.

Transkript

1 Innovator 11 excellence Anbindung an Visual Studio Einführung, Installation und Konfiguration Roland Patka Connect

2 Inhaltsverzeichnis Einführung... 1 Innovator Add-in im Visual Studio registrieren... 1 Innovator Add-in starten... 2 Einstellen von Lizenzserver und Port... 3 Anmelden und anzuzeigende Stereotype konfigurieren... 3 Quelldateien Ihrem Projekt hinzufügen... 5 Öffnen von Quellcode aus der Modell-Ansicht... 6 Sprung vom Quellcode zur Modell-Ansicht... 6 Wechseln zum Innovator-Modellbrowser... 7 Abmelden... 7 Einführung Die Anbindung von Innovator Object excellence an das Visual Studio erfolgt über ein Add-in 1. Das Innovator Add-in stellt die Repository- und Modellansichten von Innovator als integrierten Bestandteil der.net-entwicklungsumgebung zur Verfügung. In der Innovator-Modellansicht können Sie von jedem Modellelement aus in den Innovator- Modellbrowser wechseln. Von dort aus steht Ihnen die gesamte Innovator-Funktionalität zur Verfügung. Wenn es zu dem Modellelement eine aus Innovator generierte Quelldatei in Ihrem Projekt gibt, so können Sie diese Quelldatei im Visual Studio von der Innovator-Modellansicht aus öffnen. Von der generierten Quelldatei aus können Sie ebenfalls in den Innovator-Modellbrowser oder zum Innovator Add-in wechseln. Innovator Add-in im Visual Studio registrieren Damit das Innovator Add-in im Visual Studio unter Extras>Add-In-Manager als verfügbares Addin aufgelistet wird, muss Folgendes gegeben sein: 1. Das Verzeichnis, in dem die Add-in-Datei MID.Innovator.VStudio.AddIn (eine Datei im XML-Format) liegt, muss dem Visual Studio bekannt sein. 2. In der Add-in-Datei muss das <Assembly>-Tag den Pfad auf den Speicherort der Add-in- Binärdatei MID.Innovator.VStudio.AddIn.dll enthalten. Um dem Visual Studio das Verzeichnis mit der Add-in-Datei bekannt zu geben:» Rufen Sie im Visual Studio den Menübefehl Extras>Optionen auf.» Selektieren Sie Umgebung und dann Add-In/Makrosicherheit. 1 Die Edition Ihrer Visual-Studio-Version muss Add-ins unterstützen. 1

3 » Fügen Sie mit Hinzufügen das Verzeichnis hinzu, in dem sich die Add-in-Datei befindet. Hinweis Das Innovator Add-in MID.Innovator.VStudio.AddIn liegt nach der Installation von Innovator 11 unter <Innovator-Installationsverzeichnis>/inoexe. Um den Pfad der Add-in-Binärdatei in der Add-in-Datei zu ändern:» Öffnen Sie mit einem XML- oder Texteditor die Add-in-Datei MID.Innovator.VStudio.AddIn.» Fügen Sie zwischen den Tags <Assembly>... </Assembly> das Verzeichnis und den Dateinamen der Add-in-Binärdatei MID.Innovator.VStudio.AddIn.dll hinzu, z. B. <Assembly>C:\Programme\Innovator\11.3\inoexe\MID.Innovator.VStudio.AddIn.dll</Assembly>» Achten Sie darauf, dass zwischen den Tags <Version>... </Version> die richtige Version Ihres Visual Studios steht, z. B. 8.0 für Visual Studio 2005, 9.0 für Visual Studio 2009 usw.» Speichern Sie die Add-in-Datei MID.Innovator.VStudio.AddIn. Hinweis Die Innovator Add-in-Binärdatei MID.Innovator.VStudio.AddIn.dll liegt nach der Installation von Innovator 11 unter <Innovator-Installationsverzeichnis>/inoexe. Innovator Add-in starten Um das Innovator Add-in im Visual Studio zu starten:» Rufen Sie im Visual Studio den Menübefehl Extras>Innovator 11 Repositorybrowser auf. oder alternativ:» Rufen Sie im Visual Studio den Menübefehl Extras>Add-In-Manager auf.» Selektieren Sie in der Liste der verfügbaren Add-ins das Innovator 11 AddIn.» Bestätigen Sie mit [OK]. Hinweis Taucht das Innovator 11 AddIn nicht in der Liste der verfügbaren Add-ins auf, so ist es im Visual Studio noch nicht registriert (siehe vorhergehenden Abschnitt Innovator Add-in im Visual Studio registrieren ). Das Innovator Add-in startet mit der Repository-Ansicht, wobei die Verbindungseinstellungen (Lizenzserver und Port) verwendet werden, mit denen es beendet wurde. Beim ersten Start werden Ihre Verbindungseinstellungen in Innovator verwendet. Auch andere Einstellungen (anzuzeigende Stereotype, Code-Generierungs-Verzeichnis usw.) werden modell- und benutzerspezifisch abgespeichert. 2

4 Einstellen von Lizenzserver und Port Um für die Repository-Ansicht den Lizenzserver und Port einzurichten:» Klicken Sie auf das Symbol Einstellungen in der Symbolleiste des Innovator Add-ins. Alternativ können Sie über das Kontextmenü (rechte Maustaste klicken und Einstellungen auswählen) dieselbe Dialogbox aufrufen. Die Dialogbox Einstellungen erscheint.» Geben Sie den Namen Ihres Innovator-Lizenzservers und die Portnummer ein.» Bestätigen Sie mit [OK]. Sie erhalten im Add-in die Repository-Ansicht als Baumstruktur. Anmelden und anzuzeigende Stereotype konfigurieren Um sich mit einem Innovator-Modell zu verbinden:» Selektieren Sie in der Repository-Ansicht das Modell.» Klicken Sie auf das Symbol Anmelden in der Symbolleiste des Innovator Add-ins. Alternativ können Sie die linke Maustaste doppelklicken oder über das Kontextmenü (rechte Maustaste klicken und Anmelden auswählen) dieselbe Dialogbox aufrufen. Die Dialogbox Anmelden erscheint.» Geben Sie Ihre Innovator Anmeldedaten ein (Benutzer, Passwort und ggf. Rolle).» Klicken Sie auf [Anmelden]. Sie erhalten in einem weiteren Ansichtsfenster die Modell-Ansicht als Baumstruktur. Sie können sich in beliebig viele Innovator-Modelle einloggen, für jedes einzelne wird ein eigenes Ansichtsfenster geöffnet. Beim ersten Aufruf erhalten Sie die Meldung Stereotypauswahl führt zu leerer Anzeige. Bitte weitere oder andere Stereotype über das Menü Einstellungen/Anzeigekonfiguration hinzufügen., da noch keine Stereotype für die Anzeige eingestellt worden sind. Um Stereotype für die Anzeige einzustellen:» Klicken Sie auf das Symbol Einstellungen in der Symbolleiste der Modell-Ansicht: Die Dialogbox Einstellungen erscheint.» Klicken Sie auf die Schaltfläche [Hinzufügen...]. 3

5 Die Dialogbox Stereotypauswahl erscheint.» Aktivieren Sie die Auswahlfelder der Stereotype, die angezeigt werden sollen. Über das Kontextmenü können Sie alle Stereotype mit Alle checken auswählen.» Bestätigen Sie die Selektion mit [OK]. In der Dialogbox Einstellungen werden die anzuzeigenden Stereotype aufgelistet.» Bestätigen Sie mit [OK]. In der Modell-Ansicht wird der durch die Stereotype gefilterte Baum des Modells angezeigt. Sie können jederzeit weitere Stereotype für die Anzeige hinzufügen oder entfernen. Das Innovator Add-in sorgt dafür, dass die eingestellten Stereotype nach Ausloggen für das betreffende Modell und den betreffenden Benutzer abgespeichert werden und nach Neustart wieder zur Verfügung stehen. Zusätzlich können Sie die Liste der anzuzeigenden Stereotype in eine XML-Datei speichern bzw. diese aus einer XML-Datei in die Anzeigeliste einlesen. Um anzuzeigende Stereotype in eine XML-Datei zu speichern:» Klicken Sie auf das Symbol Einstellungen in der Symbolleiste der Modell-Ansicht. Die Dialogbox Einstellungen erscheint.» Klicken Sie auf die Schaltfläche [Konfiguration abspeichern...]. Die Dialogbox Speichern unter... erscheint.» Wählen Sie ein Verzeichnis und einen Dateinamen aus.» Klicken Sie auf [Speichern]. Die XML-Datei sieht dann beispielsweise wie folgt aus: <?xml version="1.0"?> <stereotypes> <item> <voclclass>clclass</voclclass> <stereotype>class</stereotype> <profile>object excellence</profile> </item> <item> <voclclass>clclass</voclclass> <stereotype>c#class</stereotype> <profile>c#</profile> </item> <item> <voclclass>clproperty</voclclass> <stereotype>c#property</stereotype> <profile>c#</profile> </item> : </stereotypes> 4

6 Für jeden Eintrag in der Anzeigeliste wird ein Tripel gespeichert, das aus Folgendem besteht: Innovator- vocl (API-Name) der Modellklasse, Name des Stereotyps und Name des Profils, in dem das Stereotyp definiert ist. Den Innovator- vocl eines Elements können Sie sehen, wenn Sie im Innovator-Modellbrowser das entsprechende Element selektieren, den Menübefehl Hilfe/Was ist das? aufrufen und den Eintrag API-Name aufklappen. Sie können analog dazu über die Schaltfläche [Konfiguration laden...] Stereotype aus einer XML-Datei in die Anzeigeliste laden. Hinweis Dies kann z.b. die Datei VStudio.AddIn.xml sein, die unter <Innovator- Installationsverzeichnis>/inoexe liegt und eine Vorauswahl an anzuzeigenden Stereotypen enthält. Die XML-Datei muss das oben beschriebene Format haben: <stereotypes> <item> <voclclass>innovator-vocl der Modellklasse</voclclass> <stereotype>stereotypname</stereotype> <profile>profilname des Stereotyps</profile> </item> : </stereotypes> Die Stereotype aus der XML-Datei werden in die Anzeigeliste zu den bereits bestehenden Einträgen hinzugefügt. Hinweis Das Speichern und Laden der Stereotype über die XML-Datei kann vor allem dann sehr hilfreich sein, wenn Sie in verschiedenen Modell-Ansichten von Innovator die gleiche Anzeigekonfiguration verwenden möchten. Da Stereotype über eine Datei in die Anzeigeliste hinzugefügt werden können, kann es vorkommen, dass auch Stereotype geladen werden, die in dem betreffenden Innovator-Modell gar nicht vorhanden sind. Diese Einträge werden in der Anzeigeliste separat unter Im Modell NICHT gefunden gruppiert. Die Stereotype, die im betreffenden Modell nicht vorhanden sind, werden zwar in der Anzeigeliste gespeichert, doch für die Anzeige des Baums in der Modell-Ansicht ignoriert. Quelldateien Ihrem Projekt hinzufügen Sie können die generierten (oder beliebige) C#-Quelldateien aus einem bestimmten Verzeichnis einem in Visual Studio geöffneten Projekt hinzufügen. Um C#-Quelldateien einem Projekt hinzuzufügen:» Klicken Sie auf das Symbol Einstellungen in der Symbolleiste der Modell-Ansicht. Die Dialogbox Einstellungen erscheint.» Wechseln Sie in das Register Quelldateien.» Geben Sie im Feld Code-Generierungs-Verzeichnis das C#-Quellenverzeichnis ein oder wählen Sie es über die Schaltfläche [Auswählen...] aus. 5

7 » Wählen Sie ein Projekt aus (in der Auswahlliste werden die im Visual Studio geöffneten Projekte angeboten).» Klicken Sie auf die Schaltfläche [C#-Quellen hinzufügen]. Alternativ können Sie auch mit [OK] bestätigen und in der Symbolleiste der Modell-Ansicht auf das Symbol klicken. Alle C#-Quellen im angegebenen Verzeichnis werden rekursiv mit der Struktur der Unterverzeichnisse dem selektierten Projekt hinzugefügt. Öffnen von Quellcode aus der Modell-Ansicht Voraussetzung für das Öffnen von Quellcode ist, dass zum betreffenden Innovator-Element Quellcode in Ihrem im Visual Studio geöffneten C#-Projekt existiert, der aus Innovator generiert worden ist (bzw. der die zugehörige inno-uri enthält). Jedes Innovator-Element kann eindeutig durch seine inno-uri identifiziert werden. Diese wird bei der Code-Generierung aus Innovator als Kommentar in die betreffende Quellcode-Datei geschrieben. Die Suche beim Öffnen des Quellcodes aus der Innovator-Sicht erfolgt über die inno-uri des betreffenden Elements. Sie können somit generierte Dateien oder Klassen auch umbenennen, die Zuordnung geht dadurch nicht verloren. Die Kommentarzeile mit der inno-uri sollten Sie allerdings nicht löschen. Um Quellcode aus der Modell-Ansicht zu öffnen:» Selektieren Sie ein Element im Baum der Modell-Ansicht des Add-ins, zu dem Sie in Ihrem C#- Projekt (aus Innovator generierten) Quellcode gespeichert haben.» Klicken Sie auf das Symbol in der Symbolleiste der Modell-Ansicht. Alternativ können Sie dieselbe Aktion über das Kontextmenü ausführen: Rechte Maustaste klicken und Sprung zum Quellcode auswählen. Die entsprechende Quellcode-Datei wird (falls vorhanden) in der Code-Ansicht des Visual Studio geöffnet oder aktiviert. Sprung vom Quellcode zur Modell-Ansicht Um vom Quellcode zur Modell-Ansicht des Add-ins zu wechseln:» Öffnen Sie in der Code-Ansicht von Visual Studio die betreffende Quellcodedatei und setzen Sie den Kursor in eine beliebige Zeile unter die Kommentarzeile mit der inno-uri des Innovator- Elements, zum dem Sie wechseln möchten.» Klicken Sie die rechte Maustaste und wählen Sie Sprung zum AddIn-Innovator-11-Modell. Das entsprechende Innovator-Element wird (falls vorhanden) in der Modell-Ansicht des Add-ins selektiert. 6

8 Wechseln zum Innovator-Modellbrowser Sie können sowohl von der Modell-Ansicht des Add-ins als auch vom Quellcode zum Innovator- Modellbrowser wechseln. Um vom Add-in zum Innovator-Modellbrowser zu wechseln:» Selektieren Sie ein Element im Baum der Modell-Ansicht des Add-ins.» Klicken Sie auf das Symbol in der Symbolleiste der Innovator-Sicht. Alternativ können Sie dieselbe Aktion über das Kontextmenü ausführen: Rechte Maustaste klicken und Öffne mit Innovator 11 auswählen. Der Innovator-Modellbrowser erscheint und das betreffende Element wird im Modellbrowser selektiert. Klassen- und Komponentendiagramme werden zusätzlich geöffnet. Um vom Quellcode zum Innovator-Modellbrowser zu wechseln:» Öffnen Sie in der Code-Ansicht des Visual Studio die betreffende Quellcodedatei und setzen Sie den Kursor in eine beliebige Zeile unter die Kommentarzeile mit der inno-uri des Innovator- Elements, zum dem Sie wechseln möchten.» Klicken Sie die rechte Maustaste und wählen Sie Öffne mit Innovator 11. Der Innovator-Modellbrowser erscheint und das betreffende Element wird darin selektiert. Abmelden Um die Verbindung zu einem Innovator-Modell zu trennen:» Klicken Sie auf das Symbol Logout in der Symbolleiste der Modell-Ansicht.» Bestätigen Sie die Sicherheitsabfrage mit [OK]. Die Modell-Ansicht wird geschlossen. Hinweis Beim Beenden des Add-ins erfolgt automatisch das Logout aus allen Innovator- Modellen. Copyright 2010 MID GmbH Innovator 11.3 Connect Visual Studio doc Bei Fragen wenden Sie sich bitte an unsere Hotline. Telefon: +49 (0)911 / , support@mid.de. Dieses Dokument finden Sie neben anderen auch im exklusiven Login-Download-Bereich für Innovator-Wartungskunden unter Ihre MID MID GmbH, Eibacher Hauptstraße 141, Nürnberg Telefon: +49 (0)911 / , Fax: +49 (0)911 / , info@mid.de, Internet: 7