Sparx Systems Forum

Enterprise Architect => Suggestions and Requests => Topic started by: Paolo F Cantoni on January 08, 2007, 04:33:06 pm

Title: IDEA: Stereotyped Template Diagrams
Post by: Paolo F Cantoni on January 08, 2007, 04:33:06 pm: Hi,

We've started to use the Template Package option to create a consistency in diagramming for our users. (See: Settings|Template Package...)

It wasn't obvious until we looked at this option that there needs to be a new diagram type (say) Data Model to handle database related diagrams. There's a new UML Data Modelling specification coming, and it's probable that they define new diagram types, however, in the absence of any specific direction from that source, adding Data Model under the Extended list of diagrams would be very useful.

However, what would be even more useful is the addition of the diagram stereotype to the diagram type. (Actually, that would also solve the Data Model template problem :))

If, when we created a new diagram, the dialog asked for an optional stereotype¹, the template package could contain multiple diagrams of the same type, differentiated by stereotype. The dropdown lists could indicate whether the type/stereotype had an associated template.

The stereotyping of diagrams is an increasingly useful mechanism. This type of support would really make it useful.

Thoughts? Votes?
Paolo
[size=0]©2007 Paolo Cantoni & Darren Sampson, Ripple Systems[/size]

¹ Which the creation of any object should anyway...
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: «Midnight» on January 09, 2007, 06:54:32 am: Yes, I agree.

While EA does seem to recognize diagram stereotypes in some cases, actually manipulating these through the UI, or even with an add-in, can be a real pain. At best, results are not great as things now stand.

David
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: Paolo F Cantoni on January 09, 2007, 08:31:23 pm: We've received a reply from Sparx indicating they are considering various solutions, but no commitment on implementation. Although the solution is not likely to use templated diagrams.

Neil has used the terms Re-use of extended diagram definitions to cover this concept. So perhaps on-going discussions could run along those (more general) lines...

Paolo
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: darren.sampson on January 09, 2007, 08:54:49 pm: While extended diagram definitions may be helpful for some situations (such as the Database diagram example), it seems to me that more flexibility in the existing template mechanism may be sufficient for many uses.

I mentioned one such use in my other post ([size=13]Idea: Show Diagram Stereotype in Project Browser[/size] (http://www.sparxsystems.com.au/cgi-bin/yabb/YaBB.pl?board=suggestions;action=display;num=1168400594;start=0#0))

As we define classes of diagrams, it would be extremely useful to have a template for each class of (say) component diagrams used in the Architecure.

From an outside point of view, it would seem that adding a stereotype combo to the New Diagram dialog would be a simple matter (given stereotype is a property of all diagrams). From that point, it should be simple to select the particular template to use when creating a new diagram by matching the stereotype.

If this is as small an effort as it seems from an outsider's point of view, it would be really handy while we wait for a more sophisticated solution.

Comments?

ps. I've noticed that diagram notes and text elements don't seem to be copied from the template. Getting a consistent base diagram including things like Diagram Notes would seem to be a typical use for a template. The properties seem to come over OK though.
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: alicecbrown on March 08, 2007, 11:48:13 am: Where can I find a definition of each stereotype given with the EA software?
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: Paolo F Cantoni on March 08, 2007, 01:45:20 pm: Quote
Where can I find a definition of each stereotype given with the EA software?
Alice,

See Settings|UML>Stereotypes... However, I think there are still some hard-wired stereotypes that aren't distributed in the list.

HTH,
Paolo
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: vnedelcu on March 14, 2007, 04:15:31 am: Hi Paolo,

This would be a good feature that I guess will help a lot the users.
So far I am using different apps to deal with Data Models (and diagramming) - I can use stereotypes, I can swith from ERD to IDEFIX whenever I want (actually I like these better than UML for DBs), I can easily define "abstract" tables with properties that are then inherited by the childern etc.
Having a better Stereotyped Template Diagram would perhaps convince me to use just one tool (EA) instead of using several.

Well done.
Vasile
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: alicecbrown on March 14, 2007, 04:51:40 am: I looked at the 'definitions', but it's AGAINST THE LAW to define concepts in their own terms. :D Not really, but certainly a wee bit disingenuous or ignorant, as the case might be. :-/
As unwise as the use of examples that use software or business terms in their example while trying to explain a concept that IS software or business development, so the cyclical use of the same terms in definitions. And I'm sure as few of you understood that last sentence as those of us out here who try to understand concepts without examples or poor ones. ???
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: sargasso on March 14, 2007, 12:06:30 pm: I think ??? I recall that some if not all the "old" standard stereotypes were, to some extent, sort-of, described in the old 1.4 or 1.5 specs.

They are, or were the last time I looked, available in the OMG vault.

As for the new standard stereotypes, I guess you could search the OMG development areas for some commentary, but it would probably be unwise to accept that any such definition found was the truth. Just accept them as ideas.

(As for cyclic definitions, I think all steretypes should be defined as recursive TLA's - just to keep the buzzards guessing ;D )

bruce

p.s. Sorry Paolo, I didn't think or mean to keep the highjack going.
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: thomaskilian on March 14, 2007, 12:31:57 pm: Alice, please define definition first. Please.
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: alicecbrown on March 15, 2007, 04:50:16 am: In German or English? Long ago, when AI was the rage, we learned that German was the easiest language for a computer to translate, being so rules-ridden. And Guess what? our chosen requirements language, English, is the worst. Why?
The problem with definitions in English is that words are so context driven: Consider the following mean everything, mean nothing words (that you should put in your Requirements Tutorial):
entity
data
phase
mode
thread
cycle
etc, etc, ad nauseum :-/
Hey that's it: let's just go back to Latin and the Good Old Days when flowcharts were all we needed. :P
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: mikewhit on March 15, 2007, 06:33:11 am: Quote
let's just go back to Latin and the Good Old Days when flowcharts were all we needed. :P
...or Ancient Geek ...
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: «Midnight» on March 15, 2007, 04:33:55 pm: But "nauseum" isn't an English word, and certainly means something.

Also I was there in the "Good Old Days" and I read classics in school back then. I don't recall needing flowcharts for Latin at all.

David
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: Paolo F Cantoni on March 15, 2007, 08:37:28 pm: Quote
But "nauseum" isn't an English word, and certainly means something.

Also I was there in the "Good Old Days" and I read classics in school back then. I don't recall needing flowcharts for Latin at all.

David
But then David neither is "et cetera". And besides, what's an English word anyway?

See the excellent book: [size=13]The Fight for English: How Language Pundits Ate, Shot, and Left [/size] (http://www.amazon.co.uk/Fight-English-Language-Pundits-Shot/dp/019920764X) by David Crystal.

As a person of Italian extraction, born in England, living in Australia for the last 40 years; having worked for a number of American companies and now working for a wholly owned subsidiary of a Singaporean conglomerate (see [size=13]Singlish[/size] (http://en.wikipedia.org/wiki/Singlish)) ???; I've learnt the benefits of trying to be as clear as you can be when you communicate 8).

Paolo
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: sargasso on March 15, 2007, 10:51:47 pm: Quote
what's an English word anyway

AFAIK "English" isn't.

'smatta anyway, wots ambiguous about engrish?

The next sentence is false.

The previous sentence is true.

b :)
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: Paolo F Cantoni on March 15, 2007, 11:01:32 pm: Quote
'smatta anyway, wots ambiguous about engrish?
What can you do with a person who can't even spell ingrish? ::)

Paolo (it's nearly beer o'clock in WA) 8)
Title: Re: IDEA: Stereotyped Template Diagrams
Post by: alicecbrown on March 23, 2007, 06:52:49 am: Anything that will help enforce (or at least remind the user) of good engineering practises and make our 'simulation'/'characterization' of the system we are designing more complete, will be appreciated.

I am an SQE on a medical device and, while death is not a real probability, a lot of wasted blood could be if we don't design this device so that, while the giving the operator unfettered power, it at least WARNS the operator of an unwise operation/button push.

Therefore, the more info the templates call for, and the more internal checks for consistency/contradictions, the less chance of seeing bugs embedded in the code.