Getting Started with Enterprise Architect and Subversion Prepared by: Gerald R. Gray, CIMple Integrations Kay Stefferud, Enernex Agenda • • • • • EA Strengths/Weaknesses Pre-requisites Access Setup & Configuration Creating common OpenSG diagrams EA Uses and Benefits • Supports IT system, software, and business processes • Models, designs, builds, and tests software • Uses standard Unified Modeling Language (UML) • Can be used to create: – Business Process Models – Class diagrams and software artifacts • Central repository for process and IT system information • Interfaces with version control package e.g. Subversion • Fast, built-in or custom document generation & HTML EA Weaknesses • May be a poor choice for complex system diagrams – Visio is “prettier” – PowerPoint also an option • Complex User Interface – Extensive feature set may lead to confusion – Time saving “tricks” difficult to learn • Diagrams not useful if team doesn’t see value – UML/BPM may be used currently at their site – Some users intimidated by tool Pre-requisites • Sparx Enterprise Architect – http://www.sparxsystems.com.au/ – Version 8 just released – $135 - $699 depending on version • Subversion – Command-line client (required) • http://www.open.collab.net/downloads/subversion/ – TortoiseSVN (optional) • http://tortoisesvn.net/downloads Access • Credentials to UCAIUG Microsoft SharePoint site • Added to the Source Code Access group in the UCAIUG SharePoint user management (Tony Adams, Kay Clinard) • Coordinate with the appropriate team, OpenADE, OpenADR, OpenAMIENT Installation • Install – Enterprise Architect (v7.5 or greater) – Subversion command-line client • http://www.collab.net/downloads/subversion/ – TortoiseSVN (Windows) • http://tortoisesvn.net/downloads Working Directory Creation • C:\OpenSG\Test\Working – In Windows Explorer, right-click on folder • Using TortoiseSVN repo browse to: – http://svn.ucaiug.org/svn/cimugrepo • Enter credentials if prompted • Right-click on folder in left-hand panel • Select Export… to directory created above EA Configuration • Start Enterprise Architect • Open the project • From main menu select – Project Version Control Version Control Settings… EA Configuration – – – – Create a unique name Select Subversion type Point to working directory Subversion exe path should prepopulate – Click Save EA Configuration • Right-click on Package • Select Package Control • Select Add Branch to Version Control… • The key icon is added to each package Common OpenSG Diagrams • Use Case • Business Process – Integration Requirements • Sequence Diagram Adding a Use Case • Project Browser – New Package – Storm Trooper Use Cases – New Diagram – Use Case – In the workspace add • Actors, cases, associations – Saves changes, check-in package Adding a Business Process • Project Browser – Add New Package – Saloon Business Processes – New Diagram – Activity – Open workspace, right-click for Swimlanes and Matrix… – Add swimlanes – Add Activity and flows Integrations Requirements • Addition to the Activity diagram – Typically a hand-off from the business user to the architect/software – Object flow between two activities, typically spanning actors (swimlanes) – Add requirement (from common tools) • Add Integration to Type • Use object node to identify service Adding Sequence Diagram • Project Browser – Add New Package – Saloon Sequence Diagrams – New Diagram – Saloon Sequence – Cleanup • Open workspace – Add Actors – Add flows (asynchronous) – Add returns (“Is Return” checkbox) Reference • EA Free Trial – http://www.sparxsystems.com/products/ea/trial.html • Subversion Documentation – http://svnbook.red-bean.com/en/1.5/index.html • EA Tutorials and Online Help – http://www.sparxsystems.com/resources/index.html • Test Repository – http://svn.ucaiug.org/svn/TestRepos/