Editing a Cloud Connector Service for a SOAP-Based Provider
Editing a cloud connector service for a SOAP-based provider consists of specifying the operation, the business object associated with the operation, the headers to include in the service, the input/output signature that determines how the user interacts with the service, optional parameters to include in the input/output signature, and descriptive comments or usage notes, if any. You edit a cloud connector service using the service editor in Designer.
Keep the following points in mind when editing a cloud connector service:
webMethods CloudStreams provides a default connector virtual service for policy enforcements, called WmCloudStreams.SoapVS. If this service does not meet the needs of your
CloudStreams project, ensure that an appropriate connector virtual service has been created for your project. For more information about
CloudStreams connector virtual services, see
Administering webMethods CloudStreams.
In pipeline, document, and input/output validation, the data validation applies
constraints to its variables. Constraints are the restrictions on the structure or content of variables. For more information about icons for constrained variables, see
Viewing the Constraints Applied
to Variables.
To edit a cloud connector service for a SOAP-based provider
1. Open Designer if it is not already open.
The service opens in the cloud connector service editor.
3. On the Operation tab, from the Connector Virtual Service list, select the connector virtual service to be used for policy enforcement.
For more information about CloudStreams connector virtual services, see Administering webMethods CloudStreams.
4. To configure the operation, business object, fields, and data types of fields, click 
next to Operation. Designer displays the Operation and Business Object Configuration wizard. a. Select the operation you want the cloud connector service to execute, and then click Next.
When you change an operation, Designer clears all the metadata that were associated with the previously selected operation, including the headers, parameters, and data types of fields. You can select the metadata that the updated operation requires in the next steps.
Note: | Designer displays the appropriate pages of the Operation and Business Object Configuration wizard depending on whether the selected operation requires metadata, such as a business object, fields, and data types of fields. |
b. In the Select the Business Object page, select a business object and click Next.
c. In the Select Fields page, specify the fields or parameters to use in the request/response body for the object.
The mandatory fields or parameters for the business object are selected by default, and cannot be cleared.
d. You can add new custom fields by clicking 
and entering the custom field details in the Add a new custom field dialog box. You can add custom fields only for the operations that support custom fields. Custom field names should be unique within the available fields. While adding a custom field as the child of another custom field, the field name must be unique among all the children of the parent field. The following table lists the different toolbar buttons available in the Select Fields page: Select... | To... |
| Collapses all of the expanded fields. |
| Add a new custom field. |
| Edit a custom field. |
| Delete a custom field. |
| Move a custom field down in the list. |
| Move a custom field up in the list. |
| Promote a custom field in the hierarchy (that is, move the field one level up in the hierarchy). |
| Demote a custom field in the hierarchy (that is, make the selected custom field a child of the preceding parent custom field). |
e. If you want to configure concrete types for the abstract types in the operation you selected, click Next. If the operation you selected does not have any abstract type field, click Finish.
f. In the Configure Data Types of Fields page, select a value from the list of values next to the abstract type to configure concrete types for the abstract types in the operation.
g. Click Finish. Designer displays a confirmation message. Click OK to update the operation. Designer replaces the existing operation and associated metadata with the updated or default information.
5. On the Headers tab, do the following:
a. To include a header as part of the service signature, select the Active check box next to the header.
b. To specify a default value for the header variable, click the Default Value box next to the variable and type or paste a default value. If the variable is null in the input pipeline, this default value will be used at run time. The value given at run time always take precedence over the default value. However, if the existing default value is of type "fixed default", the overwrite will fail.
c. Repeat the above steps in the Output section of the tab to select the SOAP headers whose contents you want to add to the service’s output pipeline.
Note: | If the operation you selected on the Operation tab has mandatory headers, Designer displays those headers in gray. You cannot edit or delete a mandatory header. |
6. If the operation you selected has predefined input parameters (for example, the Query and QueryAll operations have the where and limit parameters), you can configure them on the Parameters tab as follows:
a. To specify a default value for a parameter, click the Default Value box next to the parameter. Then, type or paste a default value. If the variable is null in the input pipeline, this default value will be used at run time. The value given at run time always take precedence over the default value. However, if the existing default value is of type "fixed default", the overwrite will fail.
b. If a predefined parameter is not mandatory, you can activate/de-activate the parameter by clicking the Active check box.
If a predefined parameter is mandatory, Designer displays the parameter in gray and the Active check box is selected. You cannot de-activate or delete a mandatory parameter.
c. To move a parameter up in the list, select the parameter and click 
. To move a parameter down in the list, select the parameter and click 
. 7. If you want to add other parameters to the service signature, such as variables to be replaced at run time with a user’s input, do the following on the Parameters tab:
a. Click . b. Assign a name to the new parameter. If you want to rename the parameter later, click its name and type a new name.
c. To specify a default value for the parameter, click the Default Value box next to the parameter. Then, type or paste a default value. If the variable is null in the input pipeline, this default value will be used at run time. The value given at run time always take precedence over the default value. However, if the existing default value is of type "fixed default", the overwrite will fail.
d. You can activate/de-activate the parameter by clicking the Active check box, or you can delete it by selecting the parameter and clicking 
. e. To move a parameter up in the list, select the parameter and click . To move a parameter down in the list, select the parameter and click . 8. On the Input/Output tab, do the following:
a. To have the server validate the input to the service against the service input signature, select the Validate input check box.
b. To have the server validate the output to the service against the service output signature, select the Validate output check box.
c. Review the service’s input and output signature and make any necessary changes as follows:
To change the... | Go to the... |
Virtual service name, operation, business object, fields, and data types of fields | Operation tab |
List of headers in the requestHeaders or responseHeaders sections, or their default values | Headers tab |
List of parameters in the parameters section, or their default values | Parameters tab |
The requestBody and responseBody sections are derived from the operation you selected on the Operation tab. The value of $connectionAlias is derived from the connection pool you specified when you first created the cloud connector service. The fault section is derived from the operation response. You cannot change these values in the editor.
9. On the Logged Fields tab, do the following:
a. Select the check boxes next to the fields you want to log at run time.
b. If you want to create an alias for a logged field to make it easier to locate in Designer, click the Alias box next to a field and type the alias name.
For more information about logged fields, see the section on logging input and output fields in Designer.
10. On the Summary tab, review the details about the cloud connector service.
11. On the Comments tab, enter descriptive comments or usage notes, if any.
12. Click File > Save to save your changes.
