Troubleshooting
Problem
After relocating elements between different files in Rational® Software Architect (RSA), that is, .efx or .emx files, the documentation field for the relocated element is empty.
Cause
There are two tags created in an .emx or .efx file when you add documentation to an element:
- <OwnedComment> - This tag will appear nested within the tag of its containing element.
- <Default : Documentation> - This tag will appear at the end of the file outside of the <uml : Model> tag.
When you move an element between files in RSA, the <OwnedComment> tag is moved along with the element, however, the <Default : Documentation> tag remains in the original file.
As long as both files are open (the original file location and the new file location), the documentation will appear correctly in RSA. However, if the original file is closed and only the new file is open, the documentation field will appear empty.
Resolving The Problem
Upgrading to a later version, release, modification, or fix pack of RSA will resolve the problem for all future elements that are moved. However, elements that were moved in RSA v7.0 base version will continue to exhibit the problem behavior. To fix the problem for elements that were moved in RSA v7.0, you will need to move the problem elements back to their original file location, and then move them back again to the new location.
Was this topic helpful?
Document Information
Modified date:
10 September 2020
UID
swg21266749