Technote (troubleshooting)
Problem(Abstract)
Attempts to generate a web site results in some missing diagram types from the view pane in Publisher (SA Publisher) for IBM Rational System Architect.
Symptom
After running SA Publisher not all diagrams appear in the diagram tree in the explorer pane of the generated web site when viewed in your internet browser. For example, you notice the following diagram types are missing:
NSOV-01 Service TaxonomyNSV-01 System HierarchyNSV-01 System Interface DescriptionNSV-12 Service Provision
For example this is what you see:
Cause
The provided template files for SA Publisher do not include all diagram types. The provided template files are meant as a starting point to either use as is, or modify a copy to use for your requirements.
Diagnosing the problem
Check that the diagram type you need to show is listed in the template file you used with SA Publisher. That template file can be either the provided or a custom file.
Resolving the problem
If the diagram types to display are not in the template file (for example the types as described in the Symptoms here) then follow these steps:
- Use a copy of the template file and in the copy add in the diagram types.
For example, a provided template file to base yours on could be:
C:\Program Files (x86)\IBM\Rational\System Architect Suite\SA Publisher\Templates\DoDAF.xml
- Add the following lines to the section between the lines
<StartReports>and</StartReports>of your template file:
<StartReport ID="page Generic Reports//Diagram Report_13" ReportFile="Generic Reports" ReportName="Diagram Report" IsHomePage="False" SAClass="1" SAType="278" SATypeName="NSOV-01 Service Taxanomy" ExecuteAllItemsOfType="True" StyleSheet="\Stylesheets\diagrams.xsl"/>
<StartReport ID="page Generic Reports//Diagram Report_14" ReportFile="Generic Reports" ReportName="Diagram Report" IsHomePage="False" SAClass="1" SAType="277" SATypeName="NSOV-01 System Hirearchy" ExecuteAllItemsOfType="True" StyleSheet="\Stylesheets\diagrams.xsl"/>
<StartReport ID="page Generic Reports//Diagram Report_15" ReportFile="Generic Reports" ReportName="Diagram Report" IsHomePage="False" SAClass="1" SAType="273" SATypeName="NSOV-01 System Interface Description" ExecuteAllItemsOfType="True" StyleSheet="\Stylesheets\diagrams.xsl"/>
<StartReport ID="page Generic Reports//Diagram Report_16" ReportFile="Generic Reports" ReportName="Diagram Report" IsHomePage="False" SAClass="1" SAType="299" SATypeName="NSOV-12 Service Provision" ExecuteAllItemsOfType="True" StyleSheet="\Stylesheets\diagrams.xsl"/>
Note: If your diagram type is not one of the above and you need to know the the SA Type number for your diagram, you can get this in System Architect by opening the diagram and in the properties window under theAccess datasection there is aType NumberField. When you know that, then you can modify the sample code above and use the type numbers and names that you require.
- Save the template file.
- Run SA Publisher and in the generated web site in the explorer pane as viewed in your internet browser, you should now see the links to the diagrams that were missing before.
For example, this is what you should now see:
Rate this page:
Copyright and trademark information
IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at www.ibm.com/legal/copytrade.shtml.