Generating WSDL/XSD artifacts
The goal of the service design phase is to produce a design and artifacts for message interfaces based on the business requirements. This step shows how to create and review Web Service Definition Language (WSDL) and XML Schema Definition (XSD) artifacts in the document literal wrapped style, based on the customizations already made when following the Customization Roadmap.
- Create a project, such as a static web project, in Rational Software
Architect (RSA) for the WSDL and XSD artifacts.
- Select from the RSA main menu.
- In the New wizard, select Static
Web Project under the Web category
and click Next.
Figure 1. Creating a static web project in RSA - Name the project IPS[version number]_WSDL and click Finish.
Figure 2. Reviewing a static web project in RSA
- Create a transformation configuration to support the UML-to-WSDL
transformation.
- Select Modeling > Transform > New Configuration from the main menu in RSA.
- Name the Uml2Wsdl transformation configuration,
set the Configuration file destination to the IPS_WSDL/WebContent project
folder, and select Service Oriented Architecture Transformations
> UML to WSDL as the transformation.
Figure 3. Creating a UML to WSDL transformation configuration - Keep the default Conceptual protocol selected and click Next.
- In the Source and Target wizard navigate
to and select IClaimHandling as the selected source and IPS_WSDL/WebContent as
the selected target.
Figure 4. Setting the source and target for a new transformation configuration - Click Finish to complete the creation of the transformation configuration.
- Configure the Uml2Wsdl.tc transformation
configuration.
- Open the editor for Uml2Wsdl.tc.
- In the Main tab, set the required merge
options. Select Silent merge.
Figure 5. Setting properties for a UML to WSDL transformation configuration - In the WSDL Options tab, right-click within
the Binding column in the Binding
options tab and select Set All Bindings > WRAPPED-DOCUMENT-LITERAL from
its menu.
Figure 6. Setting WSDL options for a UML to WSDL transformation configuration - In the Output Options tab, set the required
properties. Change the Data type processing option
to Process referenced data types and their derived types.
Figure 7. Setting output options for a UML to WSDL transformation configuration - Save Uml2Wsdl.tc.
- Run the UML-to-WSDL transformation.
- Select the Uml2Wsdl.tc file in the Project Explorer, right-click it, and select Transform > Run UML to WSDL from its menu.
- Verify the transformation configuration has successfully run.
Content must be created in IPS86_WSDL.
Figure 8. Verifying the file output of a UML to WSDL transformation
- Review the generated WSDL/XSD artifacts.
- Navigate to IPS8502_WSDL
> WebContent > com > ibm > ima > ips > Services > Transactional >
ServiceInterfaces > ClaimManagement and open ClaimManagement.wsdl.
Figure 9. Reviewing the contents of a WSDL file - If the WSDL editor only displays text, review Managing RSA capabilities.
- Verify the selectClaimAdjuster operation is created
with exactly one input, selectClaimAdjuster, and exactly one output selectClaimAdjusterResponseNote: RSA renames the request input parameter to match the name of the service operation as is best practice for document literal wrapped WSDL.
- Navigate to IPS8502_WSDL
> WebContent > com > ibm > ima > ips > Services > Transactional >
ServiceInterfaces > ClaimManagement and open ClaimManagement.wsdl.
- Verify the XSD structure for the request input parameter.
- In the WSDL editor for ClaimManagement.wsdl, open the input parameter type in the inline schema editor by selecting the arrow beside the selectClaimAdjuster input.
- Verify that the type of parameter selectClaimAdjuster contains an element
named selectClaimAdjusterRequest with a type
of selectClaimAdjusterRequest.
Figure 10. Reviewing the type of a WSDL input parameter - Expand the selectClaimAdjusterRequest type and verify
that the selectClaimAdjusterRequest type contains
a requestHeader element of the RequestHeader type,
and a claimFolder element of the ClaimFolder_TO type.
Figure 11. Reviewing the structure of a request type - Expand the RequestHeader and ClaimFolder_TO types
and verify their elements.
Figure 12. Reviewing the structure of request type attributes
- Verify the XSD structure for the response output parameter.
- In the WSDL editor for ClaimManagement.wsdl, open the output parameter type in the inline schema editor by selecting the arrow beside the selectClaimAdjusterResponseinput.
- Verify that the type of parameter selectClaimAdjusterResponse contains an
element named selectClaimAdjusterResponse with a type
of selectClaimAdjusterResponse.
Figure 13. Reviewing the WSDL output parameter type - Expand the selectClaimAdjusterResponse type and verify
that the selectClaimAdjusterResponse type contains
a responseHeader element of the ResponseHeader type, a claimAdjuster element of
the ClaimAdjuster_TO type and a claimFolder
element of the ClaimFolder_TO type.
Figure 14. Reviewing the structure of a response type
- Expand the ResponseHeader and ClaimAdjuster_TO types
and verify their elements.
Figure 15. Reviewing the structure of response type attributes