Tutorials

Help for those using Umple to model and program

The entries below are for _users_of Umple , i.e. those who want to model or program various types of systems using Umple.

• Representing basic attributes and associations (Umple tutorial 1 from Tim Lethbridge's Blog)

• Basic state machines (Umple tutorial 2 from Tim Lethbridge's Blog)

• Umple mixins. (Umple tutorial 3 from Tim Lethbridge's Blog)

• The Umple User Manual. You can work through this sequentially, or search it. It contains links to live examples that you can experiment with through UmpleOnline

• Presentations about Umple

• A wide variety of examples

• How to install the Eclipse Plugin for Umple

• VIDEO A: Using UmpleOnline Tim Lethbridge walks you through the features of the UmpleOnline website, including editing models textually and graphically, and generating Java code.

• VIDEO B: Developing a simple library system with Umple This demonstrates writing a system textually in Umple that incorporates UML associations, attributes and state machines, as well as a little embedded Java code. The tool used is UmpleOnline. The video also shows how to look at the generated API.

• VIDEO C: Basic syntax for associations (with an explanation of multiplicity) and generalization

• VIDEO D: An in-depth look at state machines, both in UML and Umple This video explores a UML state machine for a garage door, and its Umple equivalent. It illustrates concepts such as events, transitions, guards, entry actions, exit actions and do activities.

• umplerun(.jar) A command line tool for executing commands against an umple model.

Help for those developing and improving Umple

This section helps show you to enhance, edit and fix Umple itself. For example, perhaps you are extending the language with new constructs, or adding additional testing, or fixing a bug.

We suggest that the first thing you do is to learn to use Umple, as described above. Then you can learn to improve it by becoming a contributor, as described below

• Umple on Github - Go here to explore the code base and all the Wiki entries

• UPDATED VIDEO 1: Setting up Eclipse so that you can become a developer of Umple (Indigo) - YouTube Video Below. This is an updated video to the one below by Miguel showing how to install Umple within Eclipse's latest version Indigo. Run time 2:27 minutes.

• Previous version VIDEO 1: Setting up Eclipse so that you can become a developer of Umple. Andrew Forward demonstrates the first steps of setting up your development environment in order to make some changes to the language. It illustrates pointing Eclipse at the checked-out subversion repository, setting up an Eclipse project pointing to relevant directories in that project. It is suggested that you copy this URL and point your video player, such as QuickTime to it so it will stream to you. Total download file size 215MB. Run time 28 minutes.

• Development Setup

• VIDEO 2: Installing the Eclipse Umple Plugin. This allows you to compile Umple from within Eclipse. File size 50 MB. Run time 9 minutes.

• Installing the Eclipse Plugin

• Compiling Umple against the Correct Version of Umple

• Building your project

• VIDEO 3: Setting up Ant. Ant is used to build Umple, however it is important to have the right version and plugins. If you have trouble, this video will show you some of the steps we took to get the right version of ant and certain plugins installed. YouTube video. Run time 8:40.

• VIDEO 4: Extending the Umple Grammar and Populating the Metamodel. This shows, in particular our rigorous adherence to test-driven development. Size 330MB. Run time 59 minutes.

• How to run automatic test suites for Umple

• Editing Generic Templates EditingGenericJetTemplates

• Configuring UmpleTL Projects Configuring Jet Projects

Git Help

• Creating shortcuts using Aliases

• Dealing with Branches

To create a branch with changes you have made (or will make) then push so a PR can be made on github

git add WHATEVER

git status
git checkout -b NEWBRANCH
git commit -m 'DESCRIPTION'
git push --set-upstream origin NEWBRANCH

Repeat git push if you make further changes

Go on Github to make a pull request out of your changes.

<a href='Hidden comment: Please add back once we have real examples. = Tutorial Ideas (Empty Pages) =

The following tutorials have not been written yet, or have not be converted into Wiki format

• [Tutorial_SettingUpDevelopmentEnvironment]
• [Tutorial_AddNewLanguageFeature]
• [Tutorial_CreateNewUmpleBuild]
• [Tutorial_Updating_Umple_Xtext_Editor]
• [Limitations]
• [Trouble_Shooting]
• [Architecture] '>