Book a Demo

Author Topic: Documentation for Activity Diagram Toolbox  (Read 14108 times)

jrob

  • EA Novice
  • *
  • Posts: 4
  • Karma: +0/-0
    • View Profile
Documentation for Activity Diagram Toolbox
« on: December 27, 2013, 03:01:38 am »
Hello,

I am working with EA 10.0.1009. I am using EA to model embedded software systems.

Can anyone point me to some documentation that details how to use the various elements in the Activity Diagram Toolbox?

I am a bit overwhelmed by all the options.

The "Activity" elements has a lot of "stereotype" options that sets up associated tagged values. I would like to know which of these stereotypes would be of value for my diagrams.

The "Action" element prompts for a selection of various action types (Atomic, Call Behavior, ..., Other). What is the difference and how are they used?

Do I drop "Action" elements inside an "Activity" element?

Do I link "Action" elements together to describe a software algorithm then generate code?

Are "Action Pins" analogous to input/output arguments of a C function of C++ method?

Does anyone have experience with documentation that speaks to these points?





qwerty

  • EA Guru
  • *****
  • Posts: 13584
  • Karma: +397/-301
  • I'm no guru at all
    • View Profile
Re: Documentation for Activity Diagram Toolbox
« Reply #1 on: December 27, 2013, 06:49:40 am »
IIRC Geert Bellkens has a worthwhile blog post on that topic (should be linked here somewhere on the board).

q.

Helmut Ortmann

  • EA User
  • **
  • Posts: 970
  • Karma: +42/-1
    • View Profile
Re: Documentation for Activity Diagram Toolbox
« Reply #2 on: December 27, 2013, 06:54:22 am »
Hello,

my personal view:

The quickest way is to
  • buy a book
  • make a training
  • get a coach for you and your team
 

Let me try to say it with some words. Forgive me for oversimplifying.

In UML an activity is a behavior. A behavior (an activity) can describe the behavior of a simple C-function or of a whole system, a part of a system or something else like a business process.

An activity diagram describes an behavior. Therefore it's a good idea to have an activity diagram for each activity.  

An activity, an activity diagram may contain arbitrary activities, actions, or control elements like decisions.

Actions are atomic operations where the modeler has no intention to refine them by means of UML.

Actions may be a bit confusing because of the many existing kinds. For the start you may need:
  • Atomic action (just the text and specification inside)
  • call operation action (call a method of a class)
  • call behavior action (call a behavior, an activity)

These elements together with:
  • Init
  • Final
  • Decision
  • Merge
  • Fork
  • Join
you have your basic toolset.

For the start: Learn to make valuable models. Think of yourself of an author who wants to explain your problem at hand to the invisible reader.

Stereotypes or tagged values are no concept to start with.

In my opinion most of the value of an UML model isn't generating a code but understanding the problem. After managing this you can look to code generation.

In mechanics we have:
  • side view
  • front view
  • top view

In UML we also have different views (diagram types) to our system at hand.

Therefore: Think about the best model kind for each type of problem. You may use a pincer to nail a nail into the wall.

Good luck,

Helmut




Coaching, Training, Workshop (Addins: hoTools, Search&Replace, LineStyle)

RoyC

  • EA Administrator
  • EA Practitioner
  • *****
  • Posts: 1297
  • Karma: +21/-4
  • Read The Help!
    • View Profile
Re: Documentation for Activity Diagram Toolbox
« Reply #3 on: January 13, 2014, 12:18:45 pm »
Is there nothing in the Help that gives you some guidance? There is a Help topic on the Activity Toolbox, and each element icon shown in that topic links to at least one topic on the element that you create using the icon. Or you can use the index to locate the topic on each element type.
Best Regards, Roy

Geert Bellekens

  • EA Guru
  • *****
  • Posts: 13523
  • Karma: +574/-33
  • Make EA work for YOU!
    • View Profile
    • Enterprise Architect Consultant and Value Added Reseller
Re: Documentation for Activity Diagram Toolbox
« Reply #4 on: January 15, 2014, 06:32:50 pm »
My blog post is UML Best Practice: There are no Activities on an Activity Diagram
But it doesn't cover all the different types of Actions.

About all these types of Actions. I know they exists, and as far I can see you can really make pseudocode-like specifications with them, BUT...
I hardly ever see any of those in the wild.
All I see from time to time is a CallBehaviorAction or a CallOperationAction, for further only simple Actions.

I also would not recommend specifying your behavior using this technique.

Geert

sargasso

  • EA Practitioner
  • ***
  • Posts: 1406
  • Karma: +1/-2
  • 10 COMFROM 30; 20 HALT; 30 ONSUB(50,90,10)
    • View Profile
Re: Documentation for Activity Diagram Toolbox
« Reply #5 on: January 28, 2014, 05:51:53 pm »
For some idiotic reason, I have accepted an invitational job to do some uml documentation.  Probably too hot to go fishing anyway.  So, I appear to be "back". And by crikey it's amazing what I have forgotten.
So thanks Geert for those pages, they at least bring somethings out of the foggy memory!

The client, of course, can't see why all this can't be done in Word and Visio, so graaaagh!

bruce
"It is not so expressed, but what of that?
'Twere good you do so much for charity."

Oh I forgot, we aren't doing him are we.

jrob

  • EA Novice
  • *
  • Posts: 4
  • Karma: +0/-0
    • View Profile
Re: Documentation for Activity Diagram Toolbox
« Reply #6 on: February 25, 2014, 12:37:30 am »
Thanks for your help!

There are a series of articles in "Journal of Object Technology" by Conrad Bock entitiled "UML 2 Activity and Action Models". Links to these articles are located in the "UML 2" section of Conrad's website:

http://www.conradbock.org/

These articles tell me that UML 2 support for activity diagrams has come a long way since I was exposed to UML back in the 90's. It seems to me that now we can use action elements on an activity diagram to describe software algorithms in great detail. The "Structured Activities" elements support loops and conditionals.