Book a Demo

Author Topic: Inconsistencies between Help and t_connectorTypes  (Read 9856 times)

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8626
  • Karma: +259/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Inconsistencies between Help and t_connectorTypes
« on: June 15, 2017, 03:55:15 pm »
There are inconsistencies between what the help says in .../User%20Guide/model_domains/transformingconnectors.html and the t_connectortypes table in the repository.

Connector_Type   Help Document
Abstraction      Abstraction
Aggregation      Aggregation
Assembly         Assembly
Association      Association
Collaboration      Collaboration
CommunicationPath      
Connector      Connector
ControlFlow      ControlFlow
Delegate         Delegate
Dependency      Dependency
Deployment      Deployment
ERLink         ForeignKey
Extension      
Generalization      Generalization
InformationFlow   InformationFlow
Instantiation      Instantiation
            Interface
InterruptFlow      InterruptFlow
Manifest         Manifest
Nesting         Nesting
NoteLink         NoteLink
ObjectFlow      ObjectFlow
Package         Package
ProtocolConformance      
ProtocolTransition      
Realisation      Realization
Sequence         Sequence
StateFlow      
Substitution      Substitution
            TemplateBinding
            Transition
Usage         Usage
UseCase         UseCase
            Uses

Should these be identical or, if not, why not?

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

qwerty

  • EA Guru
  • *****
  • Posts: 13584
  • Karma: +397/-301
  • I'm no guru at all
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #1 on: June 15, 2017, 05:48:25 pm »
I thought the Realisation had been deprecated (make the Z great again).

q.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8626
  • Karma: +259/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #2 on: June 15, 2017, 05:59:06 pm »
I thought the Realisation had been deprecated (make the Z great again).

q.
I may not have the latest list from t_connectortypes.  I got it from the last Jet4 version of the DB from last year.

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

qwerty

  • EA Guru
  • *****
  • Posts: 13584
  • Karma: +397/-301
  • I'm no guru at all
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #3 on: June 15, 2017, 06:49:55 pm »
I wanted to look into the link you provided, but the ... seem too far off to target any page.

FWIW: In my model the table has identical ConType/Descr. pairs, and Realisation.

q.

Eve

  • EA Administrator
  • EA Guru
  • *****
  • Posts: 8110
  • Karma: +119/-20
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #4 on: June 16, 2017, 08:59:26 am »
The value stored in the database should always be Realisation. I don't expect that to be changed for compatibility reasons.  Most places where you specify a type it can be spelled as Realization, and in the English version it should be displayed as Realization.

Having said that, I just checked the code for parsing the transformation output, it only seems to handle Realisation at the moment.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8626
  • Karma: +259/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #5 on: June 16, 2017, 09:42:32 am »
The value stored in the database should always be Realisation. I don't expect that to be changed for compatibility reasons.  Most places where you specify a type it can be spelled as Realization, and in the English version it should be displayed as Realization.

Having said that, I just checked the code for parsing the transformation output, it only seems to handle Realisation at the moment.
I think I noted this defect over a decade ago - when I was investigating Transformations.

However, to the original question.  How consistent should the two sets be?

@qwerty  I have local help files so my full link is: file:///C:/Program%20Files%20(x86)/Sparx%20Systems/User%20Guide/model_domains/transformingconnectors.html
Path is: Index.Model Domains.Model Transformation.Write Transformations.Connectors
The page is entitied: Connectors

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

qwerty

  • EA Guru
  • *****
  • Posts: 13584
  • Karma: +397/-301
  • I'm no guru at all
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #6 on: June 16, 2017, 05:51:40 pm »
That would give me a hard time hacking into your machine ;-) I only have a V12 .chm and it has only a chapter about element/package transformation, not about connectors. Well, ...

q.

Geert Bellekens

  • EA Guru
  • *****
  • Posts: 13523
  • Karma: +574/-33
  • Make EA work for YOU!
    • View Profile
    • Enterprise Architect Consultant and Value Added Reseller
Re: Inconsistencies between Help and t_connectorTypes
« Reply #7 on: June 16, 2017, 05:54:57 pm »
Just to be on the safe side, whenever I do a query on the database it includes something like
and c.Connector_Type in ('Realization','Realisation')

I do the same with Generalization/Generalisation.

Geert

Eve

  • EA Administrator
  • EA Guru
  • *****
  • Posts: 8110
  • Karma: +119/-20
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #8 on: June 19, 2017, 08:41:13 am »
I wanted to look into the link you provided, but the ... seem too far off to target any page.
Pro-tip. Just take the filename for the html document and append it to the root of the user guide on the website.

http://sparxsystems.com/enterprise_architect_user_guide/13.0/transform_connectors.html

Just to be on the safe side, whenever I do a query on the database it includes something like
and c.Connector_Type in ('Realization','Realisation')

I do the same with Generalization/Generalisation.
Really shouldn't be necessary. If you ever see Generalisation or Realization in the DB it's bad data inserted either by EA or another tool. (If using EA's sql search, alias the column name to prevent EA being too helpful)

However, to the original question.  How consistent should the two sets be?
In an ideal world, they would probably be the same. Factors like the expressiveness of the transform language or new connector types not being added everywhere (including documentation) mean that that isn't going to be the case.

Is there a problem you're attempting to overcome?

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8626
  • Karma: +259/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #9 on: June 19, 2017, 09:42:34 am »
[SNIP]

In an ideal world, they would probably be the same. Factors like the expressiveness of the transform language or new connector types not being added everywhere (including documentation) mean that that isn't going to be the case.

Is there a problem you're attempting to overcome?
Yes,  We do a LOT of declarative management of our MDG and we need an "Official" list of the types of elements and connectors so that our tables are correctly set up.

I would have expected the t_connectortypes table to hold the current set of "valid" types, but as you can see there are discrepancies between one official documentation and another.

As you suggest, the fact that this set is related to "transformation" would allow for them to be slightly different.  But I couldn't find in the NEW Help system where the equivalent list to the t_conectortypes table is (if any).  If you can publish the list here, that's enough for our needs at the moment.  As I said, our instance of t_connector types is a bit old and that may also explain any differences.  That's why I went to the current Help to try and find the "current" official list.

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

Eve

  • EA Administrator
  • EA Guru
  • *****
  • Posts: 8110
  • Karma: +119/-20
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #10 on: June 19, 2017, 02:25:57 pm »
For the purposes of creating a profile, you should be using the list provided by the metatypes dialog in EA. As it happens, that list is filled by t_connectortypes.

Including the actual list in the documentation is redundant, because we expect people to use the tools that are provided.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8626
  • Karma: +259/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #11 on: June 19, 2017, 04:47:38 pm »
For the purposes of creating a profile, you should be using the list provided by the metatypes dialog in EA. As it happens, that list is filled by t_connectortypes.

Including the actual list in the documentation is redundant, because we expect people to use the tools that are provided.
Thanks, Simon,

That's what I was after.  As I mentioned, our t_connectortypes is a bit old.  .Iis it maintained by newer versions on a pre-existing repository or do we need to manually keep it up to date (from later versions of EABase.eap)?

Paolo

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

Eve

  • EA Administrator
  • EA Guru
  • *****
  • Posts: 8110
  • Karma: +119/-20
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #12 on: June 20, 2017, 09:15:05 am »
EA updates t_connectortypes during load of a model.

Paolo F Cantoni

  • EA Guru
  • *****
  • Posts: 8626
  • Karma: +259/-129
  • Inconsistently correct systems DON'T EXIST!
    • View Profile
Re: Inconsistencies between Help and t_connectorTypes
« Reply #13 on: June 20, 2017, 09:36:45 am »
EA updates t_connectortypes during load of a model.
Excellent!  Thanks.

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