Try OpenEdge Now
skip to main content
Configuring OpenEdge SOAP Web Services : Working with SOAP Web services : Updating a deployed SOAP Web service : Updating the definition and deployment information
Updating the definition and deployment information
You must disable a SOAP Web service before you can update it. You can verify if the SOAP Web service is disabled by checking its status.
Once you enable the SOAP Web service for client access, avoid making any changes to this deployment information, as client implementations depend on its stability. To make the same SOAP Web service available using different information (for example, to add a new operation or use a different WSDL Style/Use), deploy a new SOAP Web service for the application with a different name or in a different WSA context, and with the new information you want to use.
To update a SOAP Web service:
1. Click Resources in the management console menu. All resources managed by your console appear in the grid frame.
2. Filter or search for the WebServices Adapter broker instance where the SOAP Web service you want to update is currently deployed.
3. Click the WebServices Adapter broker instance. The WebServices Adapter details page appears.
4. Under Deployed SOAP Web services, click Update.
5. Type the path and name of the WSM file for the SOAP Web service that you want to update.
6. Click Submit to update deployment information. The SOAP Web service name for an update is read-only and preset from the initial deployment. Initial values for other fields are set from existing information in the new WSM file, and you can change them as necessary. The fields that you can update include:
*SOAP Web service Namespace — Any value you choose to uniquely qualify the names for operations and parameters used to define the SOAP Web service.
*SOAP Action — A string that the client application is required to place in the SOAPAction HTTP header when accessing a SOAP Web service hosted by the WSA instance. The SOAPAction HTTP header is required for all HTTP messages that carry SOAP messages and is used by intervening security servers (such as firewalls) to determine if each HTTP message is allowed to pass through to its destination. The default is a blank string, but can be any string required by the intervening security servers on the network.
*Append to SOAP Action — Indicates whether or not to append the specified SOAP Action value to any other SOAP Action values generated for the SOAP Web service SOAP messages by SOAP Web service clients.
*WSDL Style/Use — Specifies the SOAP format to use when sending or receiving SOAP messages for this SOAP Web service. The value that you choose is dependent on what your anticipated SOAP Web service clients can support.
7. Click Submit. A confirmation message appears.
You might need to document additional information about the updated SOAP Web service for use by SOAP Web service client developers. For more information, see the chapter on client requirements in OpenEdge Development: Web Services.