PI30249: UPGRADING MODEL WITH TABLE IN DOCUMENTATION RESULTS IN TABLE AND/OR ITS CONTENTS BEING REMOVED

Rational Software Architect Designer 9.5.0
Rational Software Architect Designer for WebSphere Software Fix Pack 1 (9.5.0.1) for 9.5.0
Rational Software Architect Designer for WebSphere Software 9.5.0
Rational Software Architect Designer Fix Pack 2 (9.5.0.2) for 9.5.0
Rational Software Architect Designer for WebSphere Software Fix Pack 2 (9.5.0.2) for 9.5.0
Rational Software Architect Designer for WebSphere Software Fix Pack 3 (9.5.0.3) for 9.5.0
Rational Software Architect Designer Fix Pack 3 (9.5.0.3) for 9.5.0

APAR status

• Closed as program error.

Error description

• If you upgrade an IBM Rational Software Architect (RSA) v7.5.x
  model whose elements have a table in the rich text
  'Documentation' tab, to RSA v8.0.4 or v8.5.5.2, the contents of
  the table will disappear or the table itself will be removed.
  
  The following steps reproduce the problem:
  
  1. Open RSA v7.5.x and create a UML project and model
  
  2. Add, for example, a class to the model and an operation to
  the class
  
  3. Add a table to the operation, either with the rich text
  editor's 'Add Table' icon or copy/paste a table from another
  application
  
  4. Add text to each of the cells in the table and modify the
  cells' background color, as required
  
  5. Save the changes and close RSA v7.5.x
  
  6. Import the model into either RSA v8.0.4 or v8.5.5.2
  
  7. Check the operation's 'Documentation' tab
  
  Expected Result: The table appears exactly as it did when it was
  created in v7.5.x
  
  Actual Result in v8.0.4: The contents of some of the cells are
  missing or some of the cells themselves are missing.
  
  Actual Result in v8.5.5.2: The table is removed entirely and the
  following errors appear in the .log file:
  
  [?BEGIN ERROR?]
  
  !ENTRY com.ibm.xtools.richtext.gef 4 0 2014-11-24 06:53:16.781
  !MESSAGE index=4, size=4
  !STACK 0
  org.eclipse.emf.common.util.BasicEList$BasicIndexOutOfBoundsExce
  ption:
  index=4, size=4
   at org.eclipse.emf.common.util.BasicEList.get(Unknown Source)
   at
  com.ibm.xtools.richtext.gef.internal.editparts.TablePart.refresh
  Children(Unknown
  Source)
   at
  com.ibm.xtools.richtext.gef.internal.editparts.EMFEditPart.refre
  shVisuals(Unknown
  Source)
   at
  com.ibm.xtools.richtext.gef.internal.editparts.FlowTypePart.refr
  eshVisuals(Unknown
  Source)
   at
  com.ibm.xtools.richtext.gef.internal.editparts.EMFEditPart.refre
  sh(Unknown
  Source)
   at org.eclipse.gef.editparts.AbstractEditPart.addNotify(Unknown
  Source)
   at
  org.eclipse.gef.editparts.AbstractGraphicalEditPart.addNotify(Un
  known
  Source)
   at
  com.ibm.xtools.richtext.gef.internal.editparts.TablePart.addNoti
  fy(Unknown
  Source) ...
  
  AND
  
  !ENTRY org.eclipse.ui 4 0 2014-11-24 06:53:16.806
  !MESSAGE Unhandled event loop exception
  !STACK 0
  org.eclipse.swt.SWTException: Failed to execute runnable
  (java.lang.NullPointerException)
   at org.eclipse.swt.SWT.error(Unknown Source)
   at org.eclipse.swt.SWT.error(Unknown Source)
   at
  org.eclipse.swt.widgets.Synchronizer.runAsyncMessages(Unknown
  Source)
   at org.eclipse.swt.widgets.Display.runAsyncMessages(Unknown
  Source)
   at org.eclipse.swt.widgets.Display.readAndDispatch(Unknown
  Source)
   at org.eclipse.ui.internal.Workbench.runEventLoop(Unknown
  Source)
   at org.eclipse.ui.internal.Workbench.runUI(Unknown Source)
   at org.eclipse.ui.internal.Workbench.access$4(Unknown Source)
   at org.eclipse.ui.internal.Workbench$7.run(Unknown Source)
   at
  org.eclipse.core.databinding.observable.Realm.runWithDefault(Unk
  nown
  Source)
   at
  org.eclipse.ui.internal.Workbench.createAndRunWorkbench(Unknown
  Source)
   at org.eclipse.ui.PlatformUI.createAndRunWorkbench(Unknown
  Source)
   at
  org.eclipse.ui.internal.ide.application.IDEApplication.start(Unk
  nown
  Source)
   at
  org.eclipse.equinox.internal.app.EclipseAppHandle.run(Unknown
  Source)
   at
  org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.run
  Application(Unknown
  Source)
   at
  org.eclipse.core.runtime.internal.adaptor.EclipseAppLauncher.sta
  rt(Unknown
  Source)
   at org.eclipse.core.runtime.adaptor.EclipseStarter.run(Unknown
  Source)
   at org.eclipse.core.runtime.adaptor.EclipseStarter.run(Unknown
  Source)
   at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
   at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
   at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown
  Source)
   at java.lang.reflect.Method.invoke(Unknown Source)
   at org.eclipse.equinox.launcher.Main.invokeFramework(Unknown
  Source)
   at org.eclipse.equinox.launcher.Main.basicRun(Unknown Source)
   at org.eclipse.equinox.launcher.Main.run(Unknown Source)
   at org.eclipse.equinox.launcher.Main.main(Unknown Source)
  Caused by: java.lang.NullPointerException
   at
  com.ibm.xtools.richtext.gef.internal.figures.FlowTableLayout$Cel
  lConstraints.access$0(Unknown
  Source)
  
  [?/END ERROR?]
  
  There is no workaround.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * -                                                            *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * Upgrading model with table in Documentation results in table *
  * and/or its contents are being removed due to the internal    *
  * errors.                                                      *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• "Upgrading model with table in Documentation results in table
  and/or its contents will retain the contents with all the
  formats as expected. For additional information about the
  changes here, please see the tech note:
  http://www-01.ibm.com/support/docview.wss?uid=swg21966116
  
  "
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  SW ARCHITECT WI

• Fixed component ID

  5724I7001

Applicable component levels

• R800 PSY

     UP

• R801 PSY

     UP

• R802 PSY

     UP

• R803 PSY

     UP

• R804 PSY

     UP

• R850 PSY

     UP

• R851 PSY

     UP

• R900 PSY

     UP

• R910 PSY

     UP

• R911 PSY

     UP

• R912 PSY

     UP