Add a SOAP reception. To add a new SOAP reception, use the Add User Defined Reception wizard. In the Add User Defined Reception wizard, you can define which WSDL file is to be used for the SOAP reception to be added, and which wsdl:port element in the WSDL is to be used.

Hint

The definitions of the SOAP reception to be added need to match the definitions of the receive and reply activities of the business process. Match the definitions of the SOAP reception and the business process according to either of the following:

• Define the receive and reply activities for the business process, and then add a SOAP reception that is suitable for the operations and message definitions of the receive and reply activities.
• Add a SOAP reception, and then change the definitions of the receive and reply activities for the business process so that the definitions are suitable for the contents of the SOAP reception.

To add a new SOAP reception:

1. In Service Definition List in the tree view, select and then right-click the service (business process) to which a new SOAP reception is to be added.
   A pop-up menu of the service list appears.
   
2. From the pop-up menu, select Add User Defined Reception.
   The Reception Type Selection wizard appears.
   

   

3. From the Reception type drop-down list, select SOAP Reception.
4. Click the Next button.
   The Add User Defined Reception wizard (1/2) appears.
   

   

5. Specify the values for Reception name and WSDL file.
   
   • Reception name
     Specify the name of a SOAP reception, by using the NCName definition characters of the XML Schema. Specify 1 to 40 bytes. The reception name must be unique within the business process.
     
   • WSDL file
     Specify the WSDL file to be used for the SOAP reception, by using the absolute path. Do not specify the WSDL file, by using the relative path (e.g., wsdldir\wsdlfile.wsdl) or UNC format (e.g., \\mypc\wsdldir\wsdlfile.wsdl).
     You can also select a WSDL file from the dialog box that is displayed after clicking the ... button.
     
6. Click the Next button.
   The Add User Defined Reception wizard (2/2) appears.
   When you click the Next button, if the message Failed to analyze the WSDL file is displayed, there is an error in the WSDL file.
   For details about the WSDL format when a Web service is used, see 2.6.1 Applicability of the service components that use Web service in the manual Service Platform Basic Development Guide. For details about the WSDL format when a user-defined reception is used, see 2.7.3 Notes on creating WSDL of a user-defined reception in this manual.
   

   

7. From the Specification of Port drop-down list, select the port to be used.
   In the drop-down list, the port name (value of the name attribute of the wsdl:port element) that is defined in the WSDL file specified in step 5 is displayed.
   
8. Click the Finish button.
   The SOAP reception is added to the business process, and the user-defined reception definition window appears.
   For details about the user-defined reception definition window, see 1.2.6 User-Defined Reception Definition Window in the manual Service Platform Reference Guide.
   

Note

If a warning message is displayed, check the contents of the displayed message by referring to the following parts in the manual Application Server Messages:

• If the displayed warning message begins with KDCCC:
  See 5.2 Messages from KDCCC0001 to KDCCC9999.
  
• If the displayed warning message begins with KDJW:
  See Chapter 10. Messages from KDJW00000 to KDJW99999 (Messages Output by Cosminexus Component Container).