PI17196: Rational Software Architect Design Manager BPMN text annotation image corrupted due to Rational Software Architect problem

Rational Software Architect 9.1
Rational Software Architect for WebSphere Software 9.1
Rational Software Architect 9.1.1
Rational Software Architect for WebSphere Software 9.1.1
Rational Software Architect for WebSphere Software 9.1.2
Rational Software Architect 9.1.2
Rational Software Architect for WebSphere Software Fix Pack 1 (9.1.2.1) for 9.1.2
Rational Software Architect Fix Pack 1 (9.1.2.1) for 9.1.2
Rational Software Architect Fix Pack 2 (9.1.2.2) for 9.1.2
Rational Software Architect Fix Pack 3 (9.1.2.3) for 9.1.2
Rational Software Architect for WebSphere Software Fix Pack 1 (9.1.2.3) for 9.1.2

APAR status

• Closed as program error.

Error description

• 1. Problem description and statement
  RSADM BPMN model Annotation text image corrupted on DB web
  client, which is due to an RSA problem.
  The problem is related with PMR #07267,999,760 PI14995 and ER
  RATLC02972047.
  
  The original problem in PMR 07267,999,760 was Annotation text
  missing after imported BPMN model to RSADM. It is due to a
  defect in the importer, which is PI14995. But once the importer
  problem is fixed, it will have another problem, the text
  annotation image is corrupted on the DM web client. And this
  problem is an RSA problem, in RSA's BPMN2 modeler plugin.
  
  The CR and APAR is created for tracking purpose, to deliver the
  fix in the next RSA release i.e. 9.1.
  
  The defect is identified by IBMer SAITOH Shuhichi
  (shu1@jp.ibm.com) and has been confirmed by RSADM developer
  Andrey Karaulov.
  
  The defect is in the
  CustomTextAnnotationEditPart$CustomTextAnnotationFigure class in
  the com.ibm.xtools.bpmn2.ui.diagram.custom plugin, which
  constructs the IFigure object for the TextAnnotation.
  In the class, layout of the text content is specified in the
  'paintOutline' method, instread of other method before painting.
  It worked for GUI (on screen or in RSA client), however it
  doesn't work for offscreen which is applied when RSA Design
  Manager generates image file from the model.
  
  You can see the behavior by the pluglet SAITOH Shuhichi created
  (see and run 'BPMNDiagram2PNGPluglet' pluglet in the attached
  'textannotation_img_broken_pluglet.zip').
  
  To fix the problem, layout for the text content should be
  specified before painting.
  For instance, moving the logic to t2bannhe 'createContents()'
  method, after it calls super.createContents(), would work.
  
  
  2. Customer Environment
  Server: OS: Windows Server Japanese (Test env: Windows 7
  Japanese)
  version; Software: Rational Software Architect Design Manager
  4.0.6
  (and Requirement Composer 4.0.6) with WebSphere Application
  Server, DB2
  (Test env: Tomcat/Derby)
  
  
  
  Client: OS: Windows 7 Japanese; Software: Rational Software
  Architext
  v9.0.0.1 and Design Manager Client 4.0.6
  
  3. When did this start happening? Did this always happen? What
  changed?
  Re-produceable
  
  4. Customer Impact
  The Annotation text will contain important information, the
  corrupted text on the DM web client will affect customer to see
  the entire information. Customer is going to use RSADM in
  production from May.
  
  5. What does Support expect from the Development team?
  Confirm the defect and provide testfix asap.
  
  6. Research and Reproduction steps
  
      * A. What did you find from reviewing existing documentation
  and SME?
  No related documentation or existing PMR / APAR found
  
      * B1. Is the problem reproducible? What are the steps to
  reproduce.
  Yes, Reproducible. Re-produce Step:
  0. Apply the testfix for PI14995 on RSADM 4.0.6. The testfix is
  attached in ER RATLC02972047.
  1. Create a new project, new BPMN model, add an annotation, add
  some text to the annotation.
  2. Import the project into RSADM.
  3. Check imported annotation.
  It can be reproduced in a clean installation of RSADM 4.0.6
  (Express Setup) with the testfix for PI14995
  
      * B2. If the problem is not reproducible, why not?
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  BPMN Annotation text missing after importing Rational
  Software Architect BPMN models into Rational Software
  Architect Design Manager
  

Problem conclusion

• The issue was that layout of labels was getting called in
  every paint call and was causing issue in Design Manager
  import. This has now been corrected. Now, the text
  annotation images appear correctly
  

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

  RSA DESIGN MANA

• Fixed component ID

  5725D7900

Applicable component levels

• R406 PSN

     UP