This documentation is for WSO2 Business Rules Server 2.1.0.View documentation for the latest release.

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The TryIt Try-it tool is provided by WSO2 as 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 with a mechanism to test your WSDL by creating endpoints on the fly. It helps to test a WSDL before actually coding it, without the need of a third-party WSDL validator tool. This functionality is provided by the following feature of the WSO2 feature repository:

...

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

Info
titleNote

The TryIt The Try-it tool does not support relative schema imports and WSDL imports at the moment. WSO2 will provide this feature in a future release.

...

1. Log on to the product's management console and select " Tools -> TryIt Try-It."

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

...

3.

Anchor
step3
step3
There are two text areas on the TryIt page, each Try-It tool for request and response. You can switch the layout using y clicking either "Horizontal" or "Vertical" buttons.  

Fill in the necessary parameters. If you need more typing space (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 corner of each field.

Invoke the operation by clicking the "Send" button. The return value immediately appears in the response text area.

Choosing Endpoints

You can change the endpoint for the service, if there are multiple endpoints. You can also specify a customized endpoint.

1. Click on the "Using Enpoint - ...." link. Select a new endpoint from the list and specify the address of the new endpoint.

Viewing the Service Information

1. To view the information about the service click on the "Service Information" link.

Prioritizing Operations

1. Use the small yellow icon with the plus (+) sign to prioritize operation.

...

2. The chosen operation is added to the "Priority Operations" section.

This will be useful when you have a lot of operations in the "TryIt" pageTry-It tool. Then you can add operations you want into this section and switch among them easily.

The TryIt page Try-It tool is a full Ajax client and interacts with the service just as any other client would. Therefore, 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 Try-It tool attempts to contact the Web 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 Try-It tool falls back to using a script-injection protocol to tunnel the Web web service request. A wire trace of the communication with the browser will not show the actual Web web service messages used to communicate with the service.

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

Invoking

...

the Try-It tool through a Service's Dashboard

The TryIt tool can also invoked from the dashboard of a selected service. Service dashboard is part of the service management functionality provided by the following feature:

...

The above feature is bundled by default in all service-hosting WSO2 middleware products. If the product you are using doesn't does not have this feature installed, you can do so by following the instructions given in section Feature Management. 

Follow the instructions below to try out the WSDL of a selected service.1.

  1. Log on to the product's management console and

...

  1. click List

...

  1. under

...

Image Removed

...

  1. Services to open the Deployed Services

...

  1. page

...

  1. where all the currently active services are listed out.
    Image Added
  2. Select a service and click on it to view its dashboard.

...

For example,

Image Removed

3. The service's dashboard appears. In the "Client Operations" panel, you can see the link "Try This Service."

...

  1. You will see the Try This Service link n the Client Operations panel. 
    Image Added
    When you click

...

  1. the Try this service

...

  1. link, you will be directed to the page where the operations available for your service will be displayed. When you give the parameters for the operation, a button corresponding to your service appears. You can check whether your service provides the desired output by using this option. For more information, refer to the steps from Step3

...

  1.  above.

    The

...

  1. Try-It tool of a service can also be invoked by appending the service's endpoint reference with the ?tryit string

...

  1. . For example, http://<your-machine-ip>:<server port>/services/<service name>?tryit