Printing a summary of 'Child' packages

This topic has 8 replies, 2 voices, and was last updated 12 years, 8 months ago by eadocX Support.

Viewing 9 posts - 1 through 9 (of 9 total)

Author

Posts
16 March 2012 at 12:40 am #5860
Patrick Radomski
Participant
Hi everyone.

Forgive me if this is put in the wrong place.

A bit of background;

My model has a package with child packages under it. Inside those child packages are use cases. It looks a little like this:
- Big package
Child package 1

Use case 1
Use case 2
Child package 2

Use case 3

[/ul]
[/ul]

I have a fairly nice template at the moment that provides a high level survey of all the use cases within the ‘big package’, split up by the child packages. That is all well and good.

My issue is, at the start of the template I wish to display a table that contains the name and notes field of all the child packages before we list the contents of each child package. A high level summary of how we have broken everything up.

So, under the ‘package’ profile, I added a section to list all related elements with a type of package that have a child relationship with the selected package. (as a side note, to display child elements you need to choose a parent relationship – I understand why, it is just confusing)

This works for all elements I have tried, except for packages. I assume it is due to the child packages already being listed elsewhere in the section, so it won’t put them in twice.

Is there any way I can get this working?

16 March 2012 at 3:42 pm #5861

eadocX Support

Participant

2 possibilities:
1 – give each of your Child packages a stereotype, then create an Element Report listing them, with a simple list of their children
2 – create a differernt kind of Word table-of-contents?

not tried either of these myself, but it might work

18 March 2012 at 8:19 pm #5862

Patrick Radomski

Participant

For tip 1 – there are 30 or so ‘big packages’ in the model, but each document is per each big package, so using this method I would need a different stereotype for each big package. Then for each analyst that is generating for their ‘big package’ they would need to re-configure the element report so that it picks up their packages not someone else’s. I would prefer not to go down this route.

Tip 2 – I don’t understand how a table of contents will help me create a table of names and notes.

Is there any reason why it won’t list child packages like this? It has no problem listing other child elements (use cases, objects, requirements) in exactly the same way (a simple table with the name and the description).

19 March 2012 at 10:57 am #5863

eadocX Support

Participant

OK – I’m clear now that I’m not clear about what you need 🙂

Perhaps you could attach a fragment of you model (screenshot will be fine) and a little example of what you’d like eaDocX to generate for you. Then I’ll hve a look. Doesn’t sound too impossible.

19 March 2012 at 9:50 pm #5864

Patrick Radomski

Participant

In the attached image, you’ll see the structure of the EA model.

Each document is generated at the ‘Big package’ Level.

Each document structure should be:

Big package heading / description etc
Big package Actors diagram
Table of actors in the diagram (they are from another package)
Big package survey diagram (which is just a diagram with all the child packages in it).

Table of all the packages in the survey diagram (or all the child packages under the ‘big package’. This table is just ‘Name’ and ‘Description’.

Then the rest of the document is a heading of each ‘child package’, the diagram under each one, and a table of all the use cases under each package.

I can get EA docX to do everything EXCEPT for a the table of all the packages in the survey diagram (child packages). It refuses to do this regardless of what I do.

This reply was modified 12 years, 8 months ago by Patrick Radomski.

20 March 2012 at 7:58 am #5866

eadocX Support

Participant

Ok – I think I’ve got it.
Short answer is – you can’t.
The most fundamental idea of eaDocX is that you define how a ‘thing’ gets printed, then wherever that ‘thing’ appears, it gets printed in the same way.
What I think you’re asking for is for, in one part of the document, Package things to print in a table, then later in the same section, for them to print Inline, with ll their children & child diagrams.
The only exception to this rule is for Element Reports, where we allow the formatting of the results to be different. This could give yo a bit of what you want – a list of the Child packages – but in a separate section.

We’ve had a long discussion about this, and decided that what you’re asking for is so different from the way that eaDocX works, at the very lowest level, that we can’t fix this for you.

20 March 2012 at 8:34 pm #5867

Patrick Radomski

Participant

I understand. Can’t go breaking the system for an edge case. I would recommend some sort of feedback when the user tries to get the system to do something like this (maybe an entry in the generation log – or a ‘completed but with errors’ message). It was very frustrating trying to figure out if it was against the principles of the system or if I just didn’t have the relationship and stereotype entered correctly.

Unfortunately my client doesn’t care if the software can’t do it (especially when standard EA templates can) – the table needs to be there. So, for those playing along at home, I have created another EADocX template and profile to just create the table and will then get the analysts to copy and paste this into the other generated document.

20 March 2012 at 10:11 pm #5868

Patrick Radomski

Participant

Wait, no, I lied.

Even in a different template it appears to be impossible to get the software to give me a simple table of packages.

The analysts will manually write the tables.

21 March 2012 at 7:18 am #5869

eadocX Support

Participant

The Brains Trust have met again, as you used the magic words ‘manually write’, which always encourages us to think harder: we don’t like ‘manual’:-)

How about:
1 – create a H1 heading in your document
2 – Add an Element Report, H2, listing the Child packages and their descriptions
I’ve tried this, and in my version (eaDocX 2.2) it does work
3 – Add the main section describing the Parent package, children, use cases etc, also has a H2.

OR
When you print your package diagram which has the child packages, make it show the contents of the packages (which you probably already do) AND tell the diagram to print the Notes field of the Packages. Then you’ll have all the info you need, albeit on a diagram rather than on a table.

Viewing 9 posts - 1 through 9 (of 9 total)

You must be logged in to reply to this topic.

Compare licence prices

Download a free trial