PM45504: UML documentation of schema package not in XSD file after UML-to-WSDL transformation

Rational Software Architect Interim Fix 1 for 8.0.4.2
Rational Software Architect for WebSphere Software Interim Fix 1 for 8.0.4.2

APAR status

• Closed as program error.

Error description

• When generating a WSDL and dependent XSD from a Rational
  Software Architect UML model, the XSD does not include the UML
  comment information of the schema package.
  
  The following steps reproduce the problem:
  
  1. Create a blank Service model ('MyDataTypes') and appy the XSD
  transform profile to it.
  2. Add a package ('Test')
  3. Add a Simple Type ('MyType')
  4. Add restriction relationship from MyType to XSD Primitive
  Type String
  5. Add a Class Message type ('TestMessage')
  6. Add an attribute ID of type 'MyType' created in Step 3.
  7. Add an annotation or comment to the diagram contained in
  package 'Test' where you add documentation:
  
  'This is an annotation for my DataTypes'
  
  8. Create a Service blank Service Model ('MyServiceModel')
  9. Add a package ('MyInterfaces')
  10. Add a Simple Service Interface ('ServiceInterface')
  11. Add an operation 'myOp' to 'ServiceInterface' of return Type
  'TestMessage' created in Step 5
  12. Create a UML-to-WSDL transformation by selecting the
  'MyInterfaces' package as the Source and the project where the
  models resides as the Target.
  13. Go to the transformation configuration's Output Options tab
  and set to 'Data type processing' to 'Create comple XSD schemas
  and process all the derived data types'
  14. Run the UML-to-WSDL transformation and check the .xsd file
  
  Expected Result:
  
  ??xml version='1.0' encoding='UTF-8'??
  ??xsd:schema targetNamespace='http://Test/'
      xmlns:xsd='http://www.w3.org/2001/XMLSchema'
  xmlns:xsd_1='http://Test/'?
    ?xsd:annotation?
      ?xsd:documentation?This is an annotation for my
  DataTypes?/xsd:documentation?
    ?/xsd:annotation?
    ?xsd:complexType name='TestMessage'?
      ?xsd:sequence?
        ?xsd:element name='ID' type='xsd_1:MyType'/?
      ?/xsd:sequence?
    ?/xsd:complexType?
    ?xsd:simpleType name='MyType'?
      ?xsd:restriction base='xsd:string'/?
    ?/xsd:simpleType?
  ?/xsd:schema?
  
  Actual Result:
  
  ??xml version='1.0' encoding='UTF-8'??
  ?xsd:schema targetNamespace='http://Test/'
      xmlns:xsd='http://www.w3.org/2001/XMLSchema'
  xmlns:xsd_1='http://Test/'?
      ?xsd:simpleType name='MyType'?
          ?xsd:restriction base='xsd:string' /?
      ?/xsd:simpleType?
      ?xsd:complexType name='TestMessage'?
          ?xsd:sequence?
              ?xsd:element name='ID' type='xsd_1:MyType' /?
          ?/xsd:sequence?
      ?/xsd:complexType?
  ?/xsd:schema?
  
  Workaround: The UML-to-XSD transformation generates the
  documentation correctly.
  

Local fix

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  Schema documentation is not generated for referred in-line
  XSDs in UML-WSDL Transform. While it works fine for UML-XSD
  Transforms.
  

Problem conclusion

• This issue is occurring because there is missing function
  call for generating documentations  for referred inline XSD
  schema
  

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

• R755 PSN

     UP