Book a Demo

Author Topic: Detailed settings for RTF-templates  (Read 4851 times)

chrvi

  • EA User
  • **
  • Posts: 75
  • Karma: +0/-0
  • There are so many hidden features...
    • View Profile
Detailed settings for RTF-templates
« on: October 31, 2007, 08:05:49 am »
Hello,

first of all I'd like to ask whether it is possible to run generating of RTF documentation (with our own teplate) non-interactively, i.e. programmatically via automation interface. And if it is possible, how can I do that?

If it's not possible, please, ignore the following, since we won't be able to use EA templates then...
We're trying to write our own RTF templates and have some troubles (probably due to lack of knowledge) which limit us rather much. We just can't find filtering, conditional options and contraints:
How can we set the template not to process all elements but let's say UseCases only?
How can we set the template to process only classes having a tagged value A with "xxx" value?
How can we set the template to display the whole content of some class linked file? (We're able to display the linked file path or size but can't display its content - at least for linked text files this would be really nice)
In short, we're missing a possibility of some "ifs and thens"...

Is there an area in the EA help file describing this issue and we just missed it? Or is it a bit more complicated?

Thanks,

Radek
« Last Edit: October 31, 2007, 08:10:50 am by chrvi »
Radek

«Midnight»

  • EA Guru
  • *****
  • Posts: 5651
  • Karma: +0/-0
  • That nice Mister Grey
    • View Profile
Re: Detailed settings for RTF-templates
« Reply #1 on: October 31, 2007, 10:51:13 am »
Quote
Hello,

first of all I'd like to ask whether it is possible to run generating of RTF documentation (with our own teplate) non-interactively, i.e. programmatically via automation interface. And if it is possible, how can I do that?

If it's not possible, please, ignore the following, since we won't be able to use EA templates then...
We're trying to write our own RTF templates and have some troubles (probably due to lack of knowledge) which limit us rather much. We just can't find filtering, conditional options and contraints:
How can we set the template not to process all elements but let's say UseCases only?
How can we set the template to process only classes having a tagged value A with "xxx" value?
How can we set the template to display the whole content of some class linked file? (We're able to display the linked file path or size but can't display its content - at least for linked text files this would be really nice)
In short, we're missing a possibility of some "ifs and thens"...

Is there an area in the EA help file describing this issue and we just missed it? Or is it a bit more complicated?

Thanks,

Radek

I've done this a few times over the years, with quite acceptable results. It's more complicated than we can go into in a forum though.

For a start, take a look at the XML interface. In report generation you are generally only reading the model, so this interface provides a way to traverse the repository and pick out the parts you want.

You can also just read the model as a database, querying and reporting on the results. You can create views and stored procedures on an EA repository. If so you must be careful not to break the repository, and be prepared to maintain your code if the EA schema (or how it's used) changes.

David
No, you can't have it!

chrvi

  • EA User
  • **
  • Posts: 75
  • Karma: +0/-0
  • There are so many hidden features...
    • View Profile
Re: Detailed settings for RTF-templates
« Reply #2 on: October 31, 2007, 12:37:32 pm »
Eee... I'm afraid I didn't get it... I'm sorry...

I hoped it would be quite easy - just to enhance our templates a bit in EA Document Template Editor, add some conditions when particular information shall or shall not be displyed in the generated documentation.

I would like to have templates creation process as simple as possible (using the Document Template Editor if possible) but I still need to use conditions for data processing.

If I can't use Document Template Editor somehow to accept conditions for processing data, I won't use these templates at all.


And then I hoped you'd tell me about some special method in automation interface for running the documentation (based on the template) ganeration process.

Your response is too advanced for me I must say... But thank you anyway for your answer, David :-)
Radek

gpc

  • EA User
  • **
  • Posts: 111
  • Karma: +0/-0
    • View Profile
Re: Detailed settings for RTF-templates
« Reply #3 on: November 01, 2007, 04:34:51 am »
Hi Radek,
Yes as far as I know the template method doesn't allow for any conditional logic. Please someone correct me if I'm wrong, PLEASE  :).