Previous Topic

Next Topic

Book Contents

Book Index

Set Up a Web Service

Before you can call a web service from a One-Step Action, you must first set up a web service. When you set up a web service, you define the following:

To set up a web service:

  1. Open the Web Service Manager.
  2. Select a scope and subfolder (if needed) for the Web service.
  3. Click the Create New button Create New Button.

    The Web Service Options window opens, displaying two pages (General and Methods; Accounts appears later if you select to use Basic Security).

    Web Service Options Window General Page

  4. Click the General page.
  5. Define general properties for the web service:
    1. Name: Provide a display name to use within CSM (this property can be searched in CSM Item Managers). It does not have to match the web service, although it is wise to do so.
    2. Description: Provide a description to use within CSM (this property can be searched in CSM Item Managers).
    3. URL: Provide the URL for the web service (ex: http://test.com/webservice/).
  6. Define the Service Type, either:
  7. Define the Security Type, either:
  8. Define web service call options:
  9. Click the Methods page.

    Web Service Options Window Methods Page

  10. Define a Web Service Method:
    1. Click the Add button to add a Method.

      The Web Service Method window opens.

      Web Service Method Window

    2. Define general properties for the Method:
      1. Name: Provide a name for the Method.
      2. Description: Provide a description for the Method.
      3. (Optional) Endpoint: Provide the additional URL path for the Method. Some services have an additional endpoint in the URL to access the Method. For example, if the full path to an addition Method is http://test.com/webservice/addNumbers, the base URL of the service is http://test.com/webservice/ and the endpoint would be addNumbers.
      4. Result Type: Select the data type to use when saving the results:
        • None.
        • Text (Default).
        • Number.
        • Boolean.
      5. Request Type: Select a verb that determines the way a web service is called.
        • POST.
        • GET.
        • PUT.
        • DELETE.

          Note: For most WSDL web services, the Method should be set to POST. For most REST web services, the Method should be set to GET. Only override these defaults if indicated by the web service’s documentation.

    3. Add the Parameters:

      Note: Most Methods require one or more parameters to be passed to the Web Service Method. For example, addNumbers would likely require passing two numbers that would be added together.

      1. Click the Add button.

        The Web Service Parameter window opens.

        Web Service Parameters Window

      2. Name: Provide a name for the parameter.
      3. Data Type: Select the data type for the parameter (Date/Time, Logical, Number, or Text).

        Note: With the WDSL (SOAP 1.1 or SOAP 1.2) Service Type, you can pass a text parameter that contains XML representing the full SOAP message. The full SOAP message will be included in the web service log if the logging level is set to Debug (refer to Configure Logging for a CSM Server or Web Application for more information).

      4. Header Parameter: Select this check box if the parameter is a header element. This adds the parameter value to the message header rather than the body content. Typically, the header parameter is named SOAPAction.
      5. Is SOAP Content: Select this check box if the parameter contains an XML value that includes all of the values (the entire SOAP content) that would otherwise be specified in individual parameters.

        Note: This check box is only displayed if WSDL (SOAP 1.1 or SOAP 1.2) is the selected web service method.

      6. Click OK.
  11. Click the Accounts page.

    Note: The page is only displayed if Basic is selected as the web service Security Type.

    Web Service Options Window Accounts Page

  12. Define one or more Web Service Accounts:

    Note: The Web Service Account is used when a web service simply requires a User ID and password to be passed with the web service call. You can define multiple accounts (ex: A basic account and an administrative account) and select the appropriate account when you define a Call a Web Service Action for a One-Step.

    1. Click the Add button.

      The Web Service Account window opens.

      Web Service Account Window

    2. Name: Provide a name for the Web Service Account.
    3. Description: Provide a description for the Web Service Account.
    4. User ID: Provide the username for the Web Service Account
    5. Password: Provide and confirm the password for the Web Service Account.
    6. Click OK.
  13. Click OK.

See Also

Define a Call a Web Service Action for a One-Step

Web Service Manager

Open the Web Service Manager

Configure Web Services One-Step Security Rights