Liquid Studio Documentation
In This Topic
    Web Service Test Client Overview
    In This Topic

    Web Services are typically called from applications, but sometimes it is useful to be able to call the yourself, either when developing or testing.

    The Web Service Browser, allows you to connect to a web service, select a given web method and call it.

    When you select a web method, the wizard automatically creates a sample request based on the Open API, WSDL or WADL descriptor. You will typically want to modify this before making the call to the web service.

    Calling a Web Service

    Once you have selected your Web Method, you can manually modify the request and send it to the web service using the "Call Web Service" toolbar button or using the "Web Services->Call Web Service" menu.

    Web Service Request

    The web service request screen defaults to displaying the 'Request Data' tab. In the WSDL example, you can see the Sample SOAP data that will be sent to the web method call in both a graphical and text view.

    You can change the Web Service method that will be called using the drop down controls (e.g. for WSDL you can change the Service, Port and Operation).

    Once the call has completed, the response XML is saved to the 'Response File' location and displayed in a new window suitable for the response type, e.g. XML or JSON.

    If the call fails you will receive an error message showing the error and, depending on the error, the error information may also be written to the 'Response File' location.

    It is often useful to look at the Output Window as detailed trace of the call and error and written out.

    Web Service Response

    As the sample builder steps randomly through the allowable elements described in the WSDL's embedded schema, your sample may not always reflect the request you would like. So you can create a new sample request by pressing the "Recreate Sample Request Data" toolbar button or using the "Web Service->Recreate Sample Request Data" menu.

    Custom Headers

    Your Web Service may require custom headers to be passed to it as Name Value pairs. You can add these by clicking the 'Custom Headers' tab. The values you add will be sent to the Web Service as part of the web method call.

    Authentication

    Your Web Service may require authentication to make the web method call. You can add authentication 'Authentication' tab. The values you add will be sent to the Web Service as part of the web method call.

    Viewing the Definition File

    You can also see the a detailed view of the definition file for the specified Web Service connection, e.g. for WSDL, you can click 'View WSDL...' button which will pull the WSDL down from the server and display it within the grphical WSDL Editor.