Messages

1

General Board / Auto-wrapping a table row exceeding the printable page size?

« on: October 23, 2025, 11:12:18 pm »

Dear EA experts,

we are currently struggling with a table in which some of the cells have more content than fits on the printable page of the RTF template, i.e. the bottom of the cell supersedes the page footer and is then cropped at the page bottom. Is there a way to format the table such that the row will be split across pages in case it is too big for a single page?

You probably wonder why we can have so much content in a single table cell, hence a bit of background. The table specifies test cases that are to be conducted manually. First column is the steps to execute, second column the expected output and third column contains checkboxes for pass/fail. The test instructions as well as expected output can grow quite large in particular test cases.

Thanks a lot in advance for your advice

Markus

2

General Board / Re: Roundtrip Engineering with C++ and Doxygen comment style

« on: July 09, 2021, 05:23:43 pm »

Thank you so much, bruce, that was incredibly helpful to move a big step forward. I was desperately trying to find such options in Code->Options and ended up in the code templates.

My plan is now to do a reverse engineering of the initial model and then do unidirectional forward engineering of the headers. That would not be perfect but good enough.

A few questions are remaining for me. I would like to customize the comment generation by modifying the code templates. But I am unable to find...

... the documentation of "what is what", e.g. when generating the code for a class in the model, which code templates are used for which aspects of the class
... the definitions of macros. E.g. in the "Class Notes" template, macros called JAVADOC_COMMENT, CSTYLE_COMMENT,... are called, but I cannot find the place where I can change them
...how to use the values of custom tags assigned to a class or operation in the code generation template

Any pointer in the right direction (documentation) would be much appreciated.

3

General Board / Roundtrip Engineering with C++ and Doxygen comment style

« on: July 07, 2021, 07:25:49 pm »

Hi all,

there are several discussions about this topic, but they are quite old, and rather than replying the forum suggested to post a new one.

My primary goal would be a full roundtrip engineering using the Doxygen commenting style. Especially I would like to use
@brief for class and operation descriptions and
@param for operation parameters
@return for explanations on the returned values of operations

See Appendix below for an example of our commenting style.

It seems that EA 14 still does not support that. With the configuration I am currently using (see below) it does the following:

• adds the full class comment to the element notes of the class (with all "/**" etc. characters enclosing the comment)
• adds the attributes with their documentation, the "//"-comments are handled as desired: The "//" is removed and the comment is transferred to the attribute notes
• Adds the operations but ignores all comments - it just adds a generic comment somehow resembling the class name
• parameter documentation is entirely ignored

My major problem here is that I need to document a value range for the parameters of each method. Handling values outside this range will be subject to testing, and for tracing the test cases to these requirements, I will inevitably need this documentation in EA. And for usability reasons, I also inevitably need this documentation in the Doxygen comments.

So my questions are:
 

• Is there any way to synchronize parameter documentation with C++ comments (Whether in Doxygen style or not) without having to synchronize it manually?
• Is there a way to get rid of the Doxygen annotations (like @brief) in the class documentation that removed them from the element notes but keeps them in the C++ header?
• Older posts on this topic mentioned configuration options for handling comments in synchronization which I am unable to find in EA 14. Are they still present, and if so, how can I find them?

Thank you very much for any hints.

Appendix
Our commenting scheme looks like this:

[/list]

Code: [Select]

/**
 * @brief This is a class comment
 */
class ClassName
{
public:
/**
* @brief Verifies the parameters against the valid value range and then performs the operation. It uses the configuration file to...
*
* @param  [in] param1Name Description of parameter and value range
* @param  [inout] param2Name Description of parameter and value range
         *
* @return 1 in case of successful operation
         * @return -2 in case of insufficient memory
         * @return -4 in case that the configuration file is invalid
*/
int doSomething (const std::string &param1Name, std::string &param2Name);

private:
        // name of the configuration file
        std::string m_configFileName;
}


4

General Board / Re: Control diagram image resolution for RTF export (EA v14.0)

« on: March 27, 2020, 01:29:59 am »

SOLVED

Thanks to the hints about Preferences->Appearance, I now found a working configuration which exports diagrams properly from EA -> RTF (MS Word) -> PDF using MS Word's "Save As.." operation:

Code: [Select]

Renderer: Enhanced-2
Image Quality: High
GDI Plus Metafiles: Checked
After playing with border widths, renderers and image quality, I found this configuration is working fine for me. I have not tested other combinations, but in my impression checking "GDI Plus Metafiles" was the significant change. At least, toggling this setting and leaving the other settings unchanged makes my problem appear/disappear.

Thanks again!

5

General Board / Re: Control diagram image resolution for RTF export (EA v14.0)

« on: March 26, 2020, 08:11:51 pm »

Thank you. I tried all Renderes, but it did not make a difference regarding my problem. But thank you for pointing me to it. I see that there are several other options to play with. I will continue my investigation.

Thanks to the Sparx support for not telling me: "This is a MS word problem" and for providing new proposals fast. Stay healthy!

6

General Board / Re: Control diagram image resolution for RTF export (EA v14.0)

« on: March 25, 2020, 09:27:11 pm »

Thank you Eve! Maybe our issue is different, so far I have only seen diagonal lines which are missing completely or ending "in nomansland".

"Changing the renderer" means "change format from metafile to bitmap" - right? I have done this already and it did not help.

We could update to EA 15 but to be honest we are a bit hesitant. We hardly got used to the UI changes and rearrangements in EA 14, and so far we had a steep learning curve with every new major release. But I will take this into consideration.

Thanks again,

Markus

7

General Board / Re: Control diagram image resolution for RTF export (EA v14.0)

« on: March 25, 2020, 12:04:12 am »

Thank you very much Geert, it is always good to know that you are around :-D

I did not try that but now I did, and unfortunately it does not help. Thanks for the tip anyway, it was definitely worth a try.

Is there any way to control the resolution / DPI for the image export?

8

General Board / Control diagram image resolution for RTF export (EA v14.0)

« on: March 20, 2020, 01:25:57 am »

Hi all,

due to requirements of our development process we must export our model to PDF. This can be easily done by using RTF template. EA then saves the model to RTF format, which we open in Word and then "Save As...PDF".

Since we have updated to EA 14, we find that association arrows are completely missing or ending abruptly. The problem is not present in the RTF document opened in word, it occurs upon converting to PDF with word. Using the Windows 10 Print to PDF feature displays the images fine. However, we do these exports frequently, so every extra step hurts a bit.

The problem does also not occur if we copy/paste the images into the word document. We suspect that the problem is related to the resolution that EA uses when creating the RTF.

Is there any way to control the image resolution for exported diagrams in RTF export?
Has anyone else faced this problem and knows a solution?

Thank you very much for your replies!

9

General Board / Re: Get value of inherited tag value in RTF

« on: October 13, 2016, 07:08:12 pm »

Thank you, Glassboy!

OMG that was so obvious, sorry for that.

However, this way of solving it imposes new problems to my report generation. In my report I have a table that displays the attributes / tagged values of the element (in my case architecture components and tagged values like "Safety Class" or standard attributes like "StereotypeEx"). It shall list the element's values and its inherited values. But I am either in the "element" section or in the "inherited attributes section", I cannot render them both into the same cell.

Anyway, now I know about the possibilites and limitations, so thanks again!

Markus

10

General Board / Re: Get value of inherited tag value in RTF

« on: October 13, 2016, 02:02:02 am »

Hi,

I just stumbled across the same problem - any answer available yet?

Best Regards,

Markus

11

General Board / Re: Relationship Matrix with SQL Search

« on: September 30, 2016, 11:13:33 pm »

Thank you very much for answering, Geert!

However, I just figured out that my problem was actually caused by the name I had assigned to the custom query which was "Requirement + Risk Keys for <name of my project>". After I renamed the query to "TestQuery", it works in the relationship matrix as well.

BTW: Now it also works when I include the t_object.* in the SELECT clause.

However, thanks again - you were indirectly helpful in solving my problem, for I tried your hint in a trivial query called "TestQuery" and incrementally included more and more of my acutal query till I found out that it completely works.

Markus

12

General Board / Re: Relationship Matrix with SQL Search

« on: September 29, 2016, 11:09:11 pm »

Hi,

I have a very similar issue (EA 12.0), however, capitalizing the AS does not help.

Code: [Select]

SELECT t_object.ea_guid AS CLASSGUID, t_object.Object_Type AS CLASSTYPE, t_object.Name, t_object.*  FROM

((((((t_object INNER JOIN t_package AS ObjectParent ON  t_object.package_id = ObjectParent.package_id)

LEFT JOIN t_package AS PackageParent1 ON (ObjectParent.Parent_ID = PackageParent1.package_id))
LEFT JOIN t_package AS PackageParent2 ON (PackageParent1.Parent_ID = PackageParent2.package_id))
LEFT JOIN t_package AS PackageParent3 ON (PackageParent2.Parent_ID = PackageParent3.package_id))
LEFT JOIN t_package AS PackageParent4 ON (PackageParent3.Parent_ID = PackageParent4.package_id))
LEFT JOIN t_package AS PackageParent5 ON (PackageParent4.Parent_ID = PackageParent5.package_id))

WHERE

...

The query collects particular types of requirements from different sub-packages that belong to the same project in a multi-project repository.
Same issue as for Maggie:  It returns the expected results in the SQL view. It does not populate the source/target column in the relationship matrix.

Any ideas?

Thank you very much in advance