Testing WSDLs

The TryIt tool provides a quick and easy way to test your service's WSDL file or any publicly available WSDL of the document/literal format. TryIt provides you a mechanism to test your WSDL by creating endpoints on the fly. You can test a WSDL before actually coding it and without the need of a third-party WSDL validator tool. TryIt functionality is provided by the following feature of the WSO2 feature repository:

Name: WSO2 Carbon - Tryit Feature
Identifier: org.wso2.carbon.tryit.feature.group

If the above feature is not included in your product by default, you can install it using the instructions given in section Feature Management .  

You can invoke the TryIt tool in any of the following ways:

Invoking TryIt from the tools section

Follow the steps below to invoke the TryIt tool.

1. Log on to the product's management console and se lect Tools -> TryIt .  

2. In the Enter URL field, type the location of the WSDL and click Try It. It may be a local file system path or a web URL. For example

   NOTE: If your browser blocks pop up messages, please enable them for the current domain.
   

3. The TryIt page opens. For example,

   
   The information in the above page is explained below:

   • Operations: The operations available in the WSDL appear on the left. For operations that take arguments, you see argument-type fields. The values specified in these fields are passed to the operations. For no-argument operations, you only see a button with the same name as the operation.
     
     Use the small yellow icon with the plus (+) sign to prioritize operations and add them under Priority Operations section. This is useful when you have a lot of operations in the TryIt page. You can organize them by adding operations you want into this section and switching between them easily.    

     The TryIt page is a full Ajax client and interacts with the service just as any other client does. So, it is a good way to verify that a service not only works, but is reachable by its clients. Note however that the TryIt page attempts to contact the Web service at the endpoint URL provided. If the domain or URL scheme of the service is different from the endpoint, the browser may impose security restrictions. In this case, the TryIt falls back to using a script-injection protocol to tunnel the Web service request. A wire trace of the communication with the browser shows the actual Web service messages used to communicate with the service.

     Also, since the TryIt page is fully asynchronous, it doesn't block while a Web service is being invoked. You can invoke several operations before one of them completes (though it doesn't have a way to display the results of the same operation invoked multiple times.)

   • Service Information : Click this link to view the information about the service

   • Using Endpoint: Use this link to change the endpoint of the service when there are multiple endpoints. You can also specify a customized endpoint.      
      

   • Request/Response Text Areas: There are two text areas in the TryIt page, each for request and response. You can switch the layout using either the Horizontal or the Vertical button.
     

     NOTE: If you do not give all the required parameters in the request message, an INCOMPATIBLE_PARAMETERS_ERROR is thrown when invoking data services using the Try-it tool.

     INFO: If you need more typing spac e (for instance, the parameters take a blob of XML), you can expand the size of the input field by clicking on the small icon in the lower right hand corner of each field.

4. Fill in the necessary parameters and click Send to invoke the operation. The return value immediately appears in the response text area.

Invoking TryIt from the service's dashboard

You can invoke the TryIt tool from the dashboard of a selected service too, as explained in the steps below:  

1.   Log in to the product's management console and select List under Services.  
2. The Deployed Services page appears, which lists all the currently deployed services. Select a service and click on it to view its dashboard.  
3. The service's dashboard appears. In the Client Operations panel, click Try This Service.
   
4. The TryIt page opens, which is explained in Step3 above.

Invoking TryIt by appending the service's endpoint

You can also invoke the TryIt page of a service by appending the service's endpoint reference with the string "tryit?". For example, http://<your-machine-ip>:<server port>/services/<service name>. It opens the TryIt page, which is explained in Step3 above.