Messages

1

Automation Interface, Add-Ins and Tools / Re: Documenting Decision Tables, how?

« on: February 12, 2019, 05:08:49 am »

Hello Geert,

thanks for the answer! My first Impression was, decision tables must be somewhere stored in "t_objecttests" or "t_objectscenarios". And while These table are very important in evaluating Scenarios for Actions and other stuff, the decision tables are not stored there.

Now I found something, however. t_document has Elements of type "DecisionTree". There is a field "BinContent", which Looks like a ZIPped binary field. I'll try to extract the Content there and see what I can do with it.


Regards
Frank

Without having looked into it, there a reasonable chance this information is stored as some kind of xml format somewhere in the database.
If I need to find out something like this I fire up the profiler on my SQL server and see what SQL update/insert statements are being executed by EA.

Geert

2

Automation Interface, Add-Ins and Tools / Documenting Decision Tables, how?

« on: February 09, 2019, 05:19:02 am »

I'm at a loss when it Comes to simple decision tables. I have to create a Report for Actions and (among other Things like Scenarios, associated use cases etc.) those Actions have decision tables.

Any idea how to document them? Where are those decision Matrices stored? It would be OK for me to just know the SQL tables where those simple DMN table Information is stored and I could use the Automation Interface.

Or is the solution simpler and those tables are something like relationship Matrices?
Any tips?

3

Suggestions and Requests / Add DocumentGenerator.DocumentClassifierFeature()

« on: February 09, 2019, 05:16:21 am »

The Automation class "DocumentGenerator" knows about ".DocumentElement()", ".DocumentPackage()" and ".DocumentDiagram()" (among other functions), but not about ".DocumentAttribute()", ".DocumentMethod()" etc. This is a shortcoming, because I cannot document those Features individually but only within a template with outer element selector. For example, I'm not able to intercept between Parameters of individual methods etc.

4

Automation Interface, Add-Ins and Tools / RedefinedToolbox for Package Diagrams?

« on: November 16, 2018, 02:53:11 am »

We are using EA 13 (13.0.1306). For my company I modeled special toolboxes (restricted
elements and relationships compared to standard UML) and diagram types (just derived from
standard UML, no special stereotype profiles, with one exception). I used toolbar profiles
and diagram profiles, respectively.

I want to use the adapted diagram types the newly adapted toolboxes. According to
https://www.sparxsystems.com.au/enterprise_architect_user_guide/10/extending_uml_models/overriding_default_toolboxes.html
we can override most predefined UML diagram types. 

With some astonishment however, I noticed, that UML::Package is missing.
Aren't Package diagrams also part of the UML? Which diagram type from
the above page would be needed to redefine the toolbox for the Package diagram
(if possible at all)?


Regards
Frank

5

Automation Interface, Add-Ins and Tools / Re: Is there an #OPERATIONID# analogue to #OBJECTID# ?

« on: October 17, 2018, 11:30:57 pm »

Thanks for clarification, Geert!

6

Automation Interface, Add-Ins and Tools / Is there an #OPERATIONID# analogue to #OBJECTID# ?

« on: October 16, 2018, 08:42:27 pm »

Hello, I want to create Activity Diagrams for Operations, which have the Activity owning that diagram set as op.Behavior. Now I created a "Document Script" template pointing to a VB script evaluating operations and their activity diagrams. This VB script then in turn invokes a document template printing out images (compare this e.g. to https://zubkiewicz.com/nonlinear-generation-of-documentation-in-sparx-enterprise-architect/). From that document script I would like to be able to give the operation's  "OperationID" as argument to the VB script in the vain of "#OBJECTID#". That means I would like to give something like "#OPERATIONID#". That doesn't seem to exist?

Background info: the diagrams get printed anyway (I think, either as member of the owning package or as child elements of the owning class). However, I would like to see them printed directly after the method gets processed, not at the end or beginning of the class who owns the operation.

7

Automation Interface, Add-Ins and Tools / Re: Add Quick Linker Definition: to which Profile Type?

« on: August 04, 2018, 12:20:49 am »

Thanks for putting the record straight, Simon!

8

Automation Interface, Add-Ins and Tools / Add Quick Linker Definition: to which Profile Type?

« on: August 03, 2018, 02:53:11 am »

In addition to my own diagram types and toolbox profiles, I would like to restrict quick linker selection of elements to match those connectors I defined in my toolbox profile(s).

Now I see for example documentation like https://www.sparxsystems.com/enterprise_architect_user_guide/10/extending_uml_models/add_quick_linker_definition_to.html. It's not entirely clear to me, which profile type is meant: is is (exclusively) a profile in the sense of adapting stereotypes to metaclasses or can it be also a "diagram profile" or "toolbox profile"?

I want to avoid having to create a metaclass/stereotype profile solely for the purpose of adapting the quick linker feature. Instead I want to add a definition to my diagram profile and include it then in my new toolbox/diagram MDG.

9

Automation Interface, Add-Ins and Tools / Re: VBScript won't find Template anymore after packaged as MDG Technology

« on: July 11, 2018, 01:52:44 am »

Thanks regarding the script location.

The code for invocation of the template is

' actual RTF generation for one requirement and a given template
function documentReq(docGenerator, req, template)
    dim reqSuccess

   Session.Output "template name: """ & template & """"
   reqSuccess = docGenerator.DocumentElement(req.ElementID, 1, template)
    if reqSuccess then
        Session.Output "Requirement """ & req.Name & """ successfully evaluated"
    else
        ReportWarning "Error evaluating requirement """ & req.Name & """, (ID: " & req.ElementID & "): "  & docGenerator.GetLastError()
    end if
   
   documentReq = reqSuccess
end function

Of course "template" was initialised before correctly.

10

Automation Interface, Add-Ins and Tools / Re: VBScript won't find Template anymore after packaged as MDG Technology

« on: July 05, 2018, 11:51:18 pm »

I'm unable at the moment with step "link your template to the MDG script(s)". They won't be found.
That being said I think, I have to clarify again, that it's the VB script that's unable to find the templates,
not the other way around. The script(s) get always been found by the templates.

I wonder, whether the templates are found by some namespace / name combo or just by GUID?
In the former case, there should be a chance then just to "prefix" the template name with some
additional path / folder name to get them found? Didn't find anything like that in the MDG .xml
or .mts file, though.

On a related note: does anybody know in which SQL table scripts and templates are stored?
We were unable to find imported scripts. I know that there are stored locally when you
"import to user" a MDG Technology, but on a SQL server, they should be stored in some
database table, no?

11

Automation Interface, Add-Ins and Tools / Generated Hyperlinks work for RTF and DOCX, not for PDF

« on: July 05, 2018, 03:00:09 am »

Hello,

as far as I understand, EA document generator will produce
bookmarks for each element and package. We can refer to
those bookmarks within the same document template but also
from other templates.

I create a list of requirements as part of my normal document
generation.

Now, I create a list of requirements as an appendix using
a custom template and a custom SQL query.


The query is

   select t_object.ea_guid + t_object.Name as [Req-Hyperlink], t_object.ea_guid as CLASSGUID, t_object.Object_Type as CLASSTYPE
   from t_object
   where t_object.Stereotype = 'Func. Req.' and t_object.Package_ID = #Package#

   
In the (custom) template I refer to [Req-Hyperlink] as

        custom >
   Functional Requirement {Req.Hyperlink}
        < custom
   

The SQL query and template produce entries in the generated
documents like

   Functional Requirement Close Mailbox
   
and "Close Mailbox" has a hyperlink (or bookmark reference, depending on how you view it) as

   "BKM_FEF4D7AD-98FE-456c-9E34-03603C99C7CC"

This bookmark(s) seems to be present in the document   


Now the problem: for RTF and DOCX, jumping from hyperlink at the end of the document
to referenced element (here: requirement) in the midst of the document
works as expected, but _not_ for PDF. For PDF it will just jump to the end if you click on
a hyperlink (or <CTRL>-click on it). Is that normal? Is it a known problem?
In the latter case: is there something wrong with how I do it? The SQL and template fields
work for both .eap and SQL server (here Oracle), so this isn't the problem I guess.

12

Automation Interface, Add-Ins and Tools / Re: VBScript won't find Template anymore after packaged as MDG Technology

« on: July 04, 2018, 08:27:22 pm »

It could be ambiguous at times.
Once you've imported the MDG, remove your local scripts so that you'll only have the MDG script to choose from.

If you repackage after doing this, the mapping will (should) work as Geert mentioned.

I actually tried that. Removed the local scripts, tried to recreate the MDG Technology. But the MDG "Wizard" couldn't find the scripts that were imported before! They aren't visible. So I cannot recreate the MDG Tech. Now I could copy the imported templates (into "user" ressources), but I guess I will run into the same problem as before.

13

Automation Interface, Add-Ins and Tools / Re: VBScript won't find Template anymore after packaged as MDG Technology

« on: July 04, 2018, 01:39:45 am »

Hello,

I imported the MDG Tech into my development model. Now, as described below, I have two identical document generators in Ressources. However, I don't get what exactly is meant with the next step:

- open the template fragment properties and select the MDG script instead of the model script

Geert

Do you mean the properties of a particular selected and open template / fragment? I don't find a "path" field in the properties. How can I point to a different location? Or do you mean some property of the imported MDG Tech? I'm puzzled.

14

Automation Interface, Add-Ins and Tools / Re: VBScript won't find Template anymore after packaged as MDG Technology

« on: July 03, 2018, 02:47:10 am »

Thank you Mr. Bellekens, I will try out this trick and report back!

15

Automation Interface, Add-Ins and Tools / Re: VBScript won't find Template anymore after packaged as MDG Technology

« on: July 02, 2018, 08:45:47 pm »

Depends when your MDG Technology was built. As per the last line of my last post - "If your technology was built with an older version, you may need to re-build it using EA 13 or higher."

Using EA 13, build your MDG Technology file again. Hopefully this resolves the problem.

Well, I guess not. Because I built the MDG Tech with exactly the same version, I experienced the problem with (13.0.1306). Any further ideas?