Author Topic: Specification Manager - Child Diagrams And Embedded Images  (Read 1622 times)

wmather

  • EA Novice
  • *
  • Posts: 15
  • Karma: +0/-0
    • View Profile
Re: Specification Manager - Child Diagrams And Embedded Images
« Reply #15 on: January 02, 2018, 03:46:21 pm »
@qwerty - I bought your books and have "upsized" the access db to SQL Server to poke around the tables. Once I get the general structure of the DB I will be able to extract what I need. Your scripting book should hopefully answer some API questions around how to actually get EA to "export" the diagram to a non-vector based file format like jpg/png/tiff or whatever.

With all that completed, then doing the automation should be fairly simple. On another note, I will never use perl again! While at one time I could read sendmail.cf files without a manual, those days are long gone, so a nice structured easy to read language like C# or Java will suffice in my automation needs :)

Geert Bellekens

  • EA Guru
  • *****
  • Posts: 8384
  • Karma: +202/-25
  • Make EA work for YOU!
    • View Profile
    • Enterprise Architect Consultant and Value Added Reseller
Re: Specification Manager - Child Diagrams And Embedded Images
« Reply #16 on: January 02, 2018, 05:30:03 pm »
Although I've written a few document generators in my time, with the current state of affairs of the standard document generator, I cannot with good conscience recommend rolling your own anymore.
With virtual documents, SQL and scripting fragments, you can do almost anything you need using the standard RTF generator.
I agree, it not as much fun as writing your own, and it may not be in a fancy academic format as Latex, but most clients I work with don't care too much about my fun-level, or Latex. They just need Word documents with the contents they need from the model, and preferably in such a way that they can make (small) adjustments to the templates themselves.

I wrote a small article about the way I do document generation these days: https://bellekens.com/2015/11/12/tutorial-generate-complex-documents-from-enterprise-architect-with-a-two-step-semi-automated-approach/

If you still want to go for writing your own generator, you can take a look at my open source C# repositories on Github:

https://github.com/GeertBellekens/UML-Tooling-Framework
https://github.com/GeertBellekens/Enterprise-Architect-Add-in-Framework
https://github.com/GeertBellekens/Enterprise-Architect-Toolpack

Geert

qwerty

  • EA Guru
  • *****
  • Posts: 9590
  • Karma: +168/-148
  • I'm no guru at all
    • View Profile
Re: Specification Manager - Child Diagrams And Embedded Images
« Reply #17 on: January 02, 2018, 09:04:45 pm »
I also have to admit that my own generator has a lot of fun-added-value :-) I started with that in times when EA doc generator was a real PITA and it just lost me then. Maybe today I'd stick with it or take eaDocX instead. Anyhow, digging into automation is something you need in your daily work with EA. Eventually even when using their newer doc generator versions.

q.

wmather

  • EA Novice
  • *
  • Posts: 15
  • Karma: +0/-0
    • View Profile
Re: Specification Manager - Child Diagrams And Embedded Images
« Reply #18 on: January 03, 2018, 04:12:21 pm »
Thanks @qwerty! I did not need to read all your books to get a handle on the DB. But it gave me enough tips to figure out the API calls.

I have used a hybrid repository that queries the MDB directly to create a treeview of packages and diagrams. I can then select a diagram and export that to a JPG thus minimizing the slow EA API COM calls.

This simple POC has most of what I need to think about how to automate my documentation generation. I am now very glad I chose EA as I can use the tool to create all the UML I require, in a hierarchy that I want, and my own custom tool-chain to generate the documentation that I want in a format that I choose.