Author Topic: Attaching diagrams to elements  (Read 14324 times)

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8605
  • Karma: +256/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Attaching diagrams to elements
« on: August 31, 2007, 03:25:18 am »
Since less than a fortnight after a started using EA (over two years ago), I have consistently argued that [size=13]Composite Element[/size] is a misnomer for the functionality that is provided by being able to attach a diagram to an element.

Additional points were posted in: [size=13]Re: shape scripting/element properties[/size], [size=13]Double-Clicking for navigation[/size] and, perhaps most tellingly in: [size=13]Re: Default Diagram[/size] and [size=13]TIP: Adding Diagram to Interface element[/size]!  The latter one being the one I had recourse to this afternoon...  I wanted to add a linked diagram to an Artifact.

Here is yet another proposal...

To the <context Menu>Advanced> sub menu:

1) If the element is structural, add the Composite Element menu item and the Show Composite Diagram Contents (which, by the way, should be disabled is the element isn't composite).  Actioning the first option, will create a Composite Structure Diagram below the element.  Actioning the second, displays the contents of that diagram.
2) In addition, add a new menu item Attach Diagram to Element.  If this is actioned, a tabbed dialog displays.  One tab shows a browser to allow the user to browse for an existing diagram, the other tab displays the new diagram dialog will be opened asking for the type of diagram to create.  If a new diagram is requested, it is added below the element, otherwise the browsed for diagram is attached.  As with the Composite element menu options, an additional Show Attached Diagram Contents item (again, disabled if there is no attached diagram) allows the display of the diagram.
NOTE: If Composite Element is true, then Attach Diagram to Element is disabled (and vice versa).  That is, you can only set one of the options if none are currently set.
3) If the element is non-structural, then only the Attach Diagram to Element functionality is available.  This also applies to instances of structural elements.

I think this would allow the ability to move from arbitrary diagram element to related diagram.

It will not have escaped you that using the above functionality would allow more then one element to be attached to the same diagram.  Well, with a little "jiggery pokery" it is possible to do this with the current functionality!

Thoughts? Votes?
Paolo
[size=0]©2007 Paolo Cantoni, -Semantica-[/size]
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Martin Terreni

  • EA User
  • **
  • Posts: 672
  • Karma: +0/-0
  • Sorry, I can't write
    • View Profile
Re: Attaching diagrams to elements
« Reply #1 on: August 31, 2007, 05:54:22 am »
I think I didn't quite got it...
:-[
I change an element to be composite and lets assume it is indeed only composite := if you look at project tree it has its components but no diagram - how can you show content? just the plain graphic list of components?
And if it has an attach diagram why can't I just attach to it any diagram in tree? and if it has a diagram with elements in it (even element which are not under the original element in project tree) then it isn't a composite element?
How would you call such an element that if you drill into it you see how it is composed, but its parts do not belong to it?

I'm not sure you are wrong, I just don't see how this approach answers the above questions...
Recursion definition:
If you don’t understand the definition read "Recursion definition".

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8605
  • Karma: +256/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Attaching diagrams to elements
« Reply #2 on: August 31, 2007, 09:41:31 am »
Hi Martin,

What [size=13]Composite Element[/size] tries to get across is that the [  ] Composite Element menu item's marking has NOTHING to do with whether the element has any subordinate elements in the browser, merely with whether the element has a reference to a diagram which (at one time) was immediately underneath the element in the browser.

If you experiment with a couple of temporary elements and diagrams you should see what I mean.  Further, if you change the type of the element, you will see that the diagram remains and can be opened by double-clicking the "composite" element, but (depending on the type you've changed to) the ability to access the diagram via the menu items has disappeared.

As Thomas said in his reply to your posting in the above link, once you get used to the misnomer, it doesn't sound too bad.  But it's still a misnomer - for the reasons I mentioned in that post.  NOTE: the functionality of the [  ] Composite Element menu item has actually changed slightly from that at the time of the original posting, but not sufficiently to substantively change the thrust of my proposal here.

HTH,
Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

«Midnight»

  • EA Guru
  • *****
  • Posts: 5651
  • Karma: +0/-0
  • That nice Mister Grey
    • View Profile
Re: Attaching diagrams to elements
« Reply #3 on: August 31, 2007, 10:49:16 am »
And how!

Please also see (and vote for, mayhaps) the various bumps by Paolo.

David
No, you can't have it!

Martin Terreni

  • EA User
  • **
  • Posts: 672
  • Karma: +0/-0
  • Sorry, I can't write
    • View Profile
Re: Attaching diagrams to elements
« Reply #4 on: August 31, 2007, 01:15:02 pm »
Quote
Hi Martin,

What [size=13]Composite Element[/size] tries to get across is that the [  ] If you experiment with a couple of temporary elements and diagrams you should see what I mean.  Further, if you change the type of the element, you will see that the diagram remains and can be opened by double-clicking the "composite" element, but (depending on the type you've changed to) the ability to access the diagram via the menu items has disappeared.


This is an inconsistency I'm aware of and which should be fix, it seems I got so used to it I never though to report is as a bug (which it is). Yet I think it does not answer my questions, which were more conceptual.
Recursion definition:
If you don’t understand the definition read "Recursion definition".

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8605
  • Karma: +256/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Attaching diagrams to elements
« Reply #5 on: August 31, 2007, 02:03:01 pm »
Quote

This is an inconsistency I'm aware of and which should be fix, it seems I got so used to it I never though to report is as a bug (which it is). Yet I think it does not answer my questions, which were more conceptual.
OK Martin, now that I'm clearer on what you were looking for, I'll have a think and make some proposals.  In the meantime, if anyone has anything to add at the conceptual level, jump in...

Paolo
« Last Edit: August 31, 2007, 02:03:14 pm by PaoloFCantoni »
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

sargasso

  • EA Practitioner
  • ***
  • Posts: 1406
  • Karma: +1/-2
  • 10 COMFROM 30; 20 HALT; 30 ONSUB(50,90,10)
    • View Profile
Re: A rose is a fish is an aardvaark
« Reply #6 on: August 31, 2007, 09:06:11 pm »
TEMP POST!  This is a question

Paolo,

I'm not sure what you are asking for.  

Is is a clear and unabiguous differentiation between diagram links and structurally decomposable elements?

bruce

p.s. I'm only here now due to horse flu.  >:(
« Last Edit: August 31, 2007, 09:07:12 pm by sargasso »
"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.

Martin Terreni

  • EA User
  • **
  • Posts: 672
  • Karma: +0/-0
  • Sorry, I can't write
    • View Profile
Re: A rose is a fish is an aardvaark
« Reply #7 on: August 31, 2007, 10:18:41 pm »
Quote
p.s. I'm only here now due to horse flu.  >:(

What? Your horse got sick and you couldn't get to work? ;)
Recursion definition:
If you don’t understand the definition read "Recursion definition".

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8605
  • Karma: +256/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: A rose is a fish is an aardvark
« Reply #8 on: September 01, 2007, 12:26:37 am »
Quote
What? Your horse got sick and you couldn't get to work? ;)
No,  Here in OZ, we don't vaccinate horses against flu - because we don't normally have it.  However, a failure in quarantine precautions has allowed it to get in in NSW (where sagasso lives) so there is bedlam in the horse racing industry in the Australian Eastern States.

Perhaps bruce would have been in the bookies enclosure at the racecourse if he hadn't been posting  ;)

HTH,
Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8605
  • Karma: +256/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: A rose is a fish is an aardvaark
« Reply #9 on: September 01, 2007, 12:32:44 am »
Quote
I'm not sure what you are asking for.  

Is is a clear and unabiguous differentiation between diagram links and structurally decomposable elements?

Yes!  For those element types that can have a composite structure diagram created, then marking the Composite Element menu forces the creation of such a diagram.  However other diagram links are also possible if you don't want to use the CSD.  A separate menu item is available for that.  This menu item can be used genreally to create a diagramatic link - of some kind, even if the element can't have a CSD.

The quesiton of whether declaring an element to be composite should AUTOMATICALLY create a diagram is moot - hence (I think) Martin's conceptual level question.

Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Martin Terreni

  • EA User
  • **
  • Posts: 672
  • Karma: +0/-0
  • Sorry, I can't write
    • View Profile
Re: Attaching diagrams to elements
« Reply #10 on: September 01, 2007, 12:47:10 am »
OK, I think I got it.
A composite should have a digram of its parts, though having an attached diagram does not necessarily claim it is a composite element.
Did I get it right?
Recursion definition:
If you don’t understand the definition read "Recursion definition".

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8605
  • Karma: +256/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Attaching diagrams to elements
« Reply #11 on: September 01, 2007, 01:31:11 am »
Quote
OK, I think I got it.
A composite should have a digram of its parts, though having an attached diagram does not necessarily claim it is a composite element.
Did I get it right?
Yes, Martin...  Just having an attached diagram does NOT a composite make.

In addition, I think you should be able to mark an element as composite without having to supply a diagram.  To me, isComposite is just a property of the element.  How the element is a composite can be shown in many ways - Class Diagram, Composite Structure Diagram etc...

To be a composite you have to be a holonym with a partOf meronymy with your components.  This could be done directly in the browser - without any diagrammatic form at all...

HTH,
Paolo
Inconsistently correct systems DON'T EXIST!
... Therefore, aim for consistency; in the expectation of achieving correctness....
-Semantica-
Helsinki Principle Rules!

Martin Terreni

  • EA User
  • **
  • Posts: 672
  • Karma: +0/-0
  • Sorry, I can't write
    • View Profile
Re: Attaching diagrams to elements
« Reply #12 on: September 01, 2007, 03:05:25 am »
OK, now it makes sense, or as we say in Hebrew "it makes brain"  8)
Recursion definition:
If you don’t understand the definition read "Recursion definition".

sargasso

  • EA Practitioner
  • ***
  • Posts: 1406
  • Karma: +1/-2
  • 10 COMFROM 30; 20 HALT; 30 ONSUB(50,90,10)
    • View Profile
Re: Attaching diagrams to elements
« Reply #13 on: September 01, 2007, 04:17:18 am »
Quote
In addition, I think you should be able to mark an element as composite without having to supply a diagram.  To me, isComposite is just a property of the element.  How the element is a composite can be shown in many ways - Class Diagram, Composite Structure Diagram etc...

In that case 150 votes.

bruce

p.s. re horses, yes!!! For Gordsake its the spring carival.
Champaign, pretty girls, speedy horses, pretty girls, more champaign... and what did we get "OrseFlu".... ... ... ...
apparently at last count its taken about 36mill out of the industry.
« Last Edit: September 01, 2007, 04:18:57 am by sargasso »
"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.

jeshaw2

  • EA User
  • **
  • Posts: 701
  • Karma: +0/-0
  • I'm a Singleton, what pattern are you?
    • View Profile
Re: Attaching diagrams to elements
« Reply #14 on: September 01, 2007, 06:36:34 pm »
Quote
To be a composite you have to be a holonym with a partOf meronymy with your components...

I should think the composite must also have ownership of its Meronyms.  Or, are you including aggregates in this discussion as well?
Verbal Use Cases aren't worth the paper they are written upon.