Finding a particular diagram type in your published website
The reason why it is not being generated is probably because the XML template you have chosen to generate does not include that diagram type amongst the reports that are being generated. You need to add that diagram type to one of the reports being run by the XML template. You can either add it as a starting report, or make sure that it is “gathered” in one of the reports that runs (for example a report that might generate child diagrams for a particular symbol), depending on how you want the user to be able to navigate to the diagram in the output.
When understanding how information is generated through System Architect Publisher, it is important to think of the hierarchy of the reports that have been chosen to generate information, and how you want information to be presented and navigated to in the output.
A common misconception about reports generated with System Architect Publisher is that if a report is specified as a default report for all Diagrams in the Class Default tab, then that report is run for all diagrams in the encyclopedia. This is not true. That default report is run for all diagrams 'encountered' during the running of the starting reports and sub-reports, if a particular report has not been specified for that diagram type in the Specify Reports tab.
For example, you might have Use Case diagrams in your encyclopedia that are not generated. To troubleshoot this issue, complete these tasks:
1 In System Architect Publisher, open the XML template used to generate the website.
2 Click the Type Defaults tab. Click + next to Diagrams in the System Architect Types list
Click + next to Find Use Case diagrams. See if there is a report listed. Even if there is a report listed (which will be the default report run for all Use Case diagrams encountered during the running of reports), this does not mean that a report will be run for Use Case diagrams.
3 Click the Class Defaults tab.
See if there is a report listed under Diagrams in the System Architect Classes list. Even if there is a report listed (which will be the default report run for all diagram types (including Use Cases) encountered during the running of reports), this does not mean that a report will be run for Use Case diagrams.
4 Click the Specify Reports tab.
View the reports in the Starting Pages list on the right side. Click on the '+' mark next to each one to see what Diagram Type the report is being run for. If Use Case diagrams are not being generated in the website output, you will probably not find any reports being run for Use Cases in this list. Use Cases might be included in one of the other reports specified on the page: for example, you might have a report that runs for Business Process diagrams, that outputs contained symbols, and their child diagrams. If Use Case diagrams happen to be the child diagrams of these process symbols, they will be output in the generated output. You would need to examine each report specified to see if this was the case. Again, since you are not getting Use Case diagrams in the output, this is probably not the case.
Adding diagram type to the generated output
You can add diagram type to the generated pages:
1 Decide how you want your diagram type (for example, a Use Case diagram type) navigated to in the output. Do you want them output as a starting report, or do you want them output as a part of another report, such as, for example, a “child diagram to a process symbol”?
2 To add a diagram type to a starting report, click + (plus sign) next to Generic Reports in the Available Reports list (on the Specify Reports tab).
3 Drag Diagram Report (Generic Reports) to the Start The website with These Reports list, and put it above “Starting Pages”.
The Diagram Report (Generic Reports) is added to the bottom of the list of Starting Pages.
4 Click + next to the Diagram Report (Generic Reports) at the bottom of the Starting Pages list.
Notice that it has Diagram Activity assigned to it by default.
5 Right-click Diagram Report (Generic Reports), and then click Report Start Criteria.
6 In the Report Start Criteria dialog, change the type from the default, Auto-Decomposition, to the diagram type you want output (for example, Use Case diagram type). Click OK.
7 Run the template: click the Setup tab, and then click Run.
8 To generate a a diagram type as a subordinate part of another report (see step 1 above), create a report that generates your diagram type as dependent output to another definition, and add this report to the template (either as a starting report or a default report).