Představení Jak se s Active Diagrams pracuje Jak to funguje
Otázky a odpovědi Cena a licence Stažení
Představení
Při své praxi se velmi často setkávám s touto opakující se činností: analytici modelující v nástroji Sparx Enterprise Architect, přičemž své výsledky – diagramy – kopírují do dokumentu ve Wordu. Ten následně slouží jako projektová dokumentace, kterou si může otevřít kdokoliv jiný ve firmě. Pokud však v diagramu dojde ke změně, analytik musí znovu otevřít dokument, najít místo, kde je diagram používán, totéž nalézt v „éáčku“ a ručně diagram znovu synchronizovat do dokumentu.
Poznáváte se? Štve vás to? Pak pro vás mám řešení: rozšíření do Wordu nazvané Active Diagrams.
Co umí? Jestliže budete vkládat diagramy z EA pomocí Active Diagrams do wordového dokumentu, pak jejich aktualizace je otázkou stisku jednoho tlačítka. Toť vše. Jedno jediné tlačítko.
Zaujalo Vás to? Čtěte dále.
Jak se s Active Diagrams pracuje
Zhlédněte dvouapůlminutové video, kde uvidíte živou ukázku, nebo pokračujte čtením pod ním.
Po nainstalování se na záložce Doplňky (resp. Add-ins) ve Wordu zobrazí čtyři nová tlačítka v části nazvané EA Active Diagrams:
Prvním krokem při použití doplňku je nutnost Wordu, resp. editovanému dokumentu říct, odkud má diagramy brát. Po stisku tlačítka Link with EAP se zobrazí jednoduchý dialog, kam stačí zadat cestu k EAP souboru nebo link k repository na serveru (connection string):
Tento krok stačí udělat pro jeden dokument pouze jednou, zůstane-li i repository na stejném místě.
Nyní již můžete přikročit ke vkládání diagramů. Zvolte tlačítko Add New Diagram, které zobrazí stromovou strukturu velmi podobnou Project Browseru známém z EA:
Pozor prosím na to, že první zobrazení tohoto dialogu v otevřeném diagramu trvá řádově sekundy, neboť rozšíření vytváří novou instanci EA v paměti. Další vložení diagramu je již mnohem rychlejší, instance EA v paměti zůstává až do uzavření editovaného dokumentu.
Zde vyberte diagram a stiskem tlačíka OK zajistíte vložení diagramu do dokumentu.
Uvedený dialog má tři záložky. Druhá je příprava pro další verzi, kdy bude možné diagram vyhledávat dle názvu, třetí umožňuje vložit diagram zadáním GUID diagramu. Nejjednodušší cesta, jak toto GUID zjistit, je v EA najít diagram v Project Browseru a přes volbu v kontextovém menu Copy/Paste -> Copy Node GUID to Clipboard jej zkopírovat do schránky.
Active Diagrams si informace o diagramu (metadata) drží v atributu obrázku nazvaném AlternativeText.
Od této chvíle, kdykoliv zvolíte tlačítko Refresh, se všechny takto vložené diagramy budou aktualizovat. A je jedno, zda je v dokumentu jeden nebo jich tam máte třicet osm. Aktualizace všech proběhne na jedno tlačítko!
V případě, že označíte diagram vložený pomocí tohoto nástroje, můžete si zobrazit podrobnější informace o diagramu.
Vyvolání tohoto dialogu provedete na záložce Doplňky, kde je v části Active Diagrams zaškrtávací pole Show Task Pane. Pokud nevidíte všechny hodnoty, zaktualizujte digramy. S nimi se načtou i odpovídající metadata a položka Internal Version se z 1 změní na 2 či vyšší.
Požadavky na nastavení počítače
Pro používání rozšíření Active Diagrams potřebujete mít na počítači nainstalovaný:
- Microsoft Word 2013 a vyšší
- Sparx Enterprise Architect
Dobrá zpráva: Dokument, ve kterém používáte diagramy z EA pomocí tohoto rozšíření, MŮŽE upravovat i takový uživatel, který nemá ani EA, ani toto rozšíření. Jediné, o co je ochuzen, je aktualizace diagramů.
Jak to funguje
Použité komponenty
Implementace případů užití
Propojení s EAP souborem
- Uživatel vyvolá dialog pro zadání názvu souboru (viz obrázek výše).
- Je-li tento zadán, rozšíření Active Diagrams jej uloží do uživatelské proměnné v dokumentu nazvané EAPFILE.
Cestu lze uživatelsky zkontrolovat ve vlastnostech dokumentu (standardní dialog aplikace Word).
Vložení diagramu
Po zadání GUID diagramu je požádán Sparx EA, aby diagram uložil na disk do dočasného adresáře v podobě .emf souboru. Poté je tento soubor vložen jako linkovaný obrázek do dokumentu, přičemž je řečeno, aby se obrázek ukládal společně s dokumentem. Tím je zajištěno, že dokument může otevřít a obrázky vidět i takový uživatel, který nemá Enterprise Architect nainstalovaný.
Refresh
Rozšíření Active Diagrams po stisku tlačítka Refresh projede všechny obrázky v dokumentu a pokud byl některý z nich vložen pomocí tohoto rozšíření, je aktualizován.
To, že byl obrázek vložen pomocí Active Diagrams, je dáno ve vlastnosti obrázku AlternativeText, která obsahuje řetězec podle následujícího vzorce (hodnota GUID odpovídá GUID danému diagramu v EA, zde je pouze ilustrační hodnota):
ActiveDiagrams;Version=1.0;GUID={268B0FB1-69AB-4270-84D1-EF9306B19669}
Otázky a odpovědi
Rozšíření mi nejde nainstalovat. Co s tím?
Předně musíte mít oprávnění na instalaci software. Pokud jej nemůžete získat (např. kvůli firemní bezpečnostní politice), je nutné, aby bylo rozšíření nainstalováno pod jiným účtem.
Někteří uživatelé hlásí problém s instalací nové verze, ačkoliv oprávnění mají. V takovém případě je třeba jít do nastavení počítače a předchozí verzi odinstalovat ručně.
Word nechce rozšíření akceptovat. Co s tím?
Je třeba povolit rozšíření bez certifikátu podepsaných certifikační autoritou. To se dělá ve Wordu v nastavení bezpečnosti (Menu Soubor, volba Možnosti, sekce Centrum zabezpečení, tlačítko Nastavení Centra zabezpečení, sekce Doplňky a tam odškrtnout Vyžadovat podepsání doplňků aplikací důvěryhodným vydavatelem). V některých případech (podniková bezpečností politika) tato políčka nedovolí změnit. Do další aplikace takové politiky lze políčka nastavit v registrech v klíči HKEY_CURRENT_USER\Software\Policies\Microsoft\office\15.0\word\security zadat novou DWORD hodnotu nazvanou requireaddinsig a nastavenou na nulu nebo použít tento reg soubor.
Používám rozšíření Active Diagrams. Může takové dokumenty používat i uživatel bez tohoto rozšíření či bez aplikace Sparx Enterpise Architect?
Ano. Dokumenty, do kterých vložíte diagramy pomocí rozšíření Active Diagrams, mohou číst a upravovat i uživatelé, kteří toto rozšíření či EA nemají. Pouze takto vložené diagramy nemohou aktualizovat.
Cena a licence
Doplněk je možné používat bezplatně. Můžete však přispět na jeho minulý i budoucí rozvoj nějakou drobnou částkou.
Stažení a instalace rozšíření
Po stažení souboru ActiveDiagrams.zip tento rozbalte a spusťte setup.exe
. Pokračujte podle pokynů instalačního programu.
Zdrojové kódy najdete na stránkách GitHubu.