Author Topic: MDG installation  (Read 6887 times)

Guillaume

  • EA Practitioner
  • ***
  • Posts: 1370
  • Karma: +42/-2
    • View Profile
    • www.umlchannel.com
MDG installation
« on: May 26, 2016, 11:06:36 pm »
Hi,

I'm defining for a client an MDG that includes a UML profile, custom searches, and a model template (model wizard).
I'm getting 2 XML files: the MDG and the model template XMI export. I found that the latter must be copied to C:\Program Files (x86)\Sparx Systems\EA\ModelPatterns so it can be picked up.

As a result, it appears more suitable to provide this MDG via a Windows Installation file. I noticed that some MDG are available with an installation file (e.g. CORBA from Sparx). Is there any documentation on this on Sparx or anywhere else?

thanks
Guillaume

Blog: www.umlchannel.com | Free utilities addin: www.eautils.com


Uffe

  • EA Practitioner
  • ***
  • Posts: 1859
  • Karma: +133/-14
  • Flutes: 1; Clarinets: 1; Saxes: 5 and counting
    • View Profile
Re: MDG installation
« Reply #1 on: May 27, 2016, 12:37:48 am »
Hi Guillaume,


I think that the location attribute of the Model tag that you specify in the MTS file can be an absolute path. It's only if it's relative that EA prepends it with {InstallDir}\ModelPatterns (meaning that if you only specify a file name, that's where EA will look for it).

If this holds true, you can specify the same directory where you deploy your MDG Technologies (or some subdirectory thereof).

So I'd look into that before going to WiX, but if you do take that route it should be pretty straightforward. I wouldn't drop my stuff into the EA installation directory, but creating your own is easily done, and if you want to get really fancy you can add it to HKCU\Software\Sparx Systems\EA400\EA\OPTIONS\MDGTechnologyPathList.

HTH,


/Uffe
« Last Edit: May 27, 2016, 06:31:33 pm by Uffe »
My theories are always correct, just apply them to the right reality.

Guillaume

  • EA Practitioner
  • ***
  • Posts: 1370
  • Karma: +42/-2
    • View Profile
    • www.umlchannel.com
Re: MDG installation
« Reply #2 on: May 27, 2016, 01:39:33 am »
Hi Uffe,

I confirm that an absolute path provides an alternative to the ModelPatterns EA folder.
I played with WiX before for my addin so I'll create a new installation project if I need to provide an installation file.

Thanks
Guillaume
Guillaume

Blog: www.umlchannel.com | Free utilities addin: www.eautils.com


Glassboy

  • EA Practitioner
  • ***
  • Posts: 1367
  • Karma: +112/-75
    • View Profile
Re: MDG installation
« Reply #3 on: May 27, 2016, 07:30:27 am »
I always distribute the MDG and the associated models into the same directory to keep it simple.

qwerty

  • EA Guru
  • *****
  • Posts: 13584
  • Karma: +396/-301
  • I'm no guru at all
    • View Profile
Re: MDG installation
« Reply #4 on: June 15, 2020, 01:17:32 am »
Just want to pop up this one too. WHERE IS THE DOCUMENTATION OF THAT RTF-STUFF?

q.

Geert Bellekens

  • EA Guru
  • *****
  • Posts: 13387
  • Karma: +564/-33
  • Make EA work for YOU!
    • View Profile
    • Enterprise Architect Consultant and Value Added Reseller
Re: MDG installation
« Reply #5 on: June 15, 2020, 01:24:39 am »
here: https://www.sparxsystems.com/enterprise_architect_user_guide/15.1/modeling/model_templates2.html it says:
Quote
If you want your template to have supporting documentation displayed in the right-hand panel of the Model Wizard, create a .rtf file containing this documentation in the same directory location as the XML file. The .rtf file should also have the same filename as the XML file. You could also create the .rtf file within a Document Artifact element in the model, and then export the file (the 'Document-Edit > File > Save as (Export to File)' ribbon option) to the location of the Pattern XML file. This keeps the documentation within your development model.

Geert

qwerty

  • EA Guru
  • *****
  • Posts: 13584
  • Karma: +396/-301
  • I'm no guru at all
    • View Profile
Re: MDG installation
« Reply #6 on: June 15, 2020, 03:26:40 am »
Thanks, Geert. In that case the documentation is wrong since it does NOT show the rtf in the wizard preview.

A word to the documenter "should also have the same filename" does not seem to make sense. Is this a recommendation? Shouldn't that be "must"? Just asking.

q.

PeteEA

  • EA Novice
  • *
  • Posts: 13
  • Karma: +0/-0
    • View Profile
Re: MDG installation
« Reply #7 on: June 17, 2020, 11:25:36 pm »
Same filename means without the extension. E.g. if the wizard pattern is ABC.xml then the RTF description needs to be ABC.rtf. It's probably also a MUST - how otherwise would EA know which RTF to associate with with pattern XML, in the absence of any means to specify?

My experience is that the RTF also had to be in the C:\Program Files (x86)\Sparx Systems\EA\ModelPatterns folder along with the pattern XML file, otherwise the RTF doesn't get displayed. The RTF file doesn't get displayed if the XML and RTF file are located using an absolute path - this is obviously a bug as the XML pattern can be accessed from an absolute path and a shame as it makes it harder to share as individual users need to put the file within their installation directory and repeat that each time changes are released.

qwerty

  • EA Guru
  • *****
  • Posts: 13584
  • Karma: +396/-301
  • I'm no guru at all
    • View Profile
Re: MDG installation
« Reply #8 on: June 18, 2020, 01:45:10 am »
I just sent a support request to Sparx. Will let you know what the outcome will be.

q.

P.S. I tried putting the patterns in the EA program folder but it does not show the rtf. Well, I'll wait what will come. Hope dies at last. It's already in the state of coma, so I would not be astonished if it won't survive.
« Last Edit: June 18, 2020, 02:39:17 am by qwerty »

qwerty

  • EA Guru
  • *****
  • Posts: 13584
  • Karma: +396/-301
  • I'm no guru at all
    • View Profile
Re: MDG installation
« Reply #9 on: June 18, 2020, 04:39:01 pm »
As I expected:
Quote from: Sparx support
Unfortunately it is currently only possible to display an RTF file in the Model Wizard when the XMI and RTF files are both in the default location (i.e. under the EA installation folder in Program Files). We consider this a bug and will fix it for a future release.

The issue has been confirmed and will be investigated further by our development team. The reference number for this issue is 20064987.

q.