Fixes are available
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 number
PM45504
Reported component name
SW ARCHITECT WI
Reported component ID
5724I7001
Reported release
755
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt
Submitted date
2011-08-11
Closed date
2011-11-18
Last modified date
2011-11-18
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
[{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SSYKBQ","label":"Rational Software Architect Designer for WebSphere Software"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"755","Edition":"","Line of Business":{"code":"LOB45","label":"Automation"}},{"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Product":{"code":"SS4JCV","label":"Rational Software Architect for WebSphere Software"},"Component":"","ARM Category":[],"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"755","Edition":"","Line of Business":{"code":"LOB15","label":"Integration"}}]
Document Information
Modified date:
18 November 2011