Running Diagram Word Reports results in "there are no diagrams in the encyclopedia" error in Rational System Architect

Technote (troubleshooting)


Problem(Abstract)

Attempts to run Word Reports for Diagrams results in "there are no diagrams in the encyclopedia" error when you have a subset of diagram permissions in IBM Rational System Architect (SA).

Symptom

Steps to Reproduce:

  1. Create an Enterprise Encyclopedia in SA.

  2. Create a new User in SA Catalog Manger (SACM).

  3. Create a new Role in SACM.

  4. Assign all Macro permissions the new Role.

  5. Assign all Menu permissions to the new Role.

  6. Assign a subset of Diagram permissions to the new Role.

  7. Assign the new Role to the new User.

  8. Assign the Enterprise Encyclopedia to the new Role.

  9. Assign the Enterprise Encyclopedia to the User.

  10. Extract all diagrams from a Samples Encyclopedia to the Enterprise Encyclopedia in SA.

  11. Open the Enterprise encyclopedia in SA as the new User.

  12. Run the menu
    Reports > Word Reports > Diagram Reports


The full error message is as follows:

There are no diagrams in the encyclopedia.

Cause

There can be many causes of this issue as follows:

  • Cause #1: A product defect logged with reference number TLOG#22531.
    This issue was originally reported with SA version 10.4 in the year 2006, on older Microsoft Word versions for example version 2003.

    In SA version 11.3.0.2 released in the year 2009 the issue was fixed. (Note: Office 2010 support brought in with SA version 11.4.1 and later).

    The menu that generates the 'Word Reports' uses SA macros implemented in Microsoft Visual Basic for Applications (VBA) SA_AF.mac and SAAuto.mac in the SA installation for example;
      • C:\Program Files\IBM\Rational\System Architect Suite\System Architect

        or,
      • C:\Program Files (x86)\IBM\Rational\System Architect Suite\System Architect

  • Cause #2: Incorrect Role assigned in SACM.


    or

  • Cause #3: Incorrect Role assigned in SA Encyclopedia Manager (SAEM).


    or

  • Cause #4: Incorrect macro security setting.


    or

  • Cause #5: Incorrect Diagram Permissions for your Role.


    or

  • Cause #6: No Diagrams exist that you have Permissions for your Role.

Diagnosing the problem

For Cause #1: A product defect reported with reference number TLOG#22531

Check you are using a fixed version of SA with a supported version of Microsoft Office and the correct macro files. You can check the path for the macros in your sa2001.ini file in your user profile, for example:

    • C:\Documents and Settings\myusername\Local Settings\Application Data\Telelogic\System Architect

      or,
    • C:\Users\myusername\AppData\Local\Telelogic\System Architect

For Cause #2: Incorrect roles assigned in SACM

Check the roles you have assigned in SACM by expanding the node for the user name under "Users & Groups" node.

For Cause #3: Incorrect role assigned in SAEM

Check the roles you have assigned in SAEM in the "Login Properties".

For Cause #4: Incorrect macro security setting

You can check::

  1. The macro security setting using the SA menu "Tools ->Macro->Security".

  2. Can you run the report from Microsoft Word as follows:
    1. In Microsoft Word open the SADiags9.dot file from the SA installation Templates folder.

    2. Run the Microsoft Word menu "Add-Ins > SA Diagrams > Show Diagrams".


For Cause #5: Incorrect Diagram Permissions for your Role.

Check that diagram permissions for your Role in SACM.

For Cause #6: No Diagrams exist that you have Permissions for your Role.

Expand the diagrams node in SA and check is there any.

Resolving the problem

Solution #1: A product defect reported with reference number TLOG#22531

    • Install SA fix pack version 11.3.0.2 or later downloadable from IBM Fix Central.

      And,
    • Use a supported Microsoft Office version: 2003 or 2007 or 2010 (with SA version 11.4.1 or later). Use IBM Passport Advantage to download newer SA versions.

      And,
    • Use the macros delivered by the SA installation.

Solution #2: Incorrect roles assigned in SACM

Use SACM to copy all macro and menu permissions from the Administrator Role to the new Role.

Solution #3: Incorrect role assigned in SAEM

Use SAEM:

  1. Create the SAUser role from the menu "Tools > Create SAUser Role".

  2. Assign the SAUser in your "Login Properties".

  3. Check you have a "Permit" on the Encyclopedia in your "Login Properties".

Solution #4: Incorrect macro security setting

Use SA to set the macro security to low as follows:

  1. Select the menu "Tools ->Macro->Security".

  2. Select Low.

  3. Press OK.

Solution #5: Incorrect Diagram Permissions for the Role.

Use SACM to ensure that the Role has Read permissions on the diagram as follows:

  1. Expand the Roles node.

  2. Expand your Role type.

  3. Select the Diagram Permissions node.

  4. Right click on a Diagram Type.

  5. Select Properties.

  6. Select Read.

  7. Press OK.

Solution #6: No Diagrams exist that you have Permissions for your Role.

Create one or more Diagrams that you have Permissions for your Role.

Rate this page:

(0 users)Average rating

Add comments

Document information


More support for:

Rational System Architect
General Information

Software version:

11.0, 11.1, 11.2, 11.3

Operating system(s):

Windows

Reference #:

1649549

Modified date:

2013-10-04

Translate my page

Machine Translation

Content navigation