About the Catalog and Test Pages

When you compile a web service class, the class compiler creates a convenient catalog page that you can use to examine the web service. This catalog page provides a link to a simple test page.

To see these CSP pages:

In Studio, display the web service class.
Click View > Web Page.

The catalog page is immediately displayed. Its URL is constructed as follows:

base/csp/app/web_serv.cls

Here base is the base URL for your web server (including port if necessary), /csp/app is the name of the web application in which the web service resides, and web_serv is the class name of the web service. (Typically, /csp/app is /csp/namespace.) For example:

http://localhost:57772/csp/samples/MyApp.StockService.cls

Access to These Pages

These CSP pages are part of a Caché web application, as noted in the previous chapter. If there is no web application for the namespace you are using, you cannot access these pages. Also, by default, these pages are inaccessible. To enable access to them, open the Terminal, go to the %SYS namespace, and enter the following commands:

set ^SYS("Security","CSP","AllowClass",webapplicationname,"%SOAP.WebServiceInfo")=1
set ^SYS("Security","CSP","AllowClass",webapplicationname,"%SOAP.WebServiceInvoke")=1

Where webapplicationname is the web application name with a trailing slash, for example, "/csp/mynamespace/". This access is enabled by default for the /csp/samples web application.

Also, you can use these pages only if you are logged in as a user who has USE permission for the %Development resource.

Notes on These Pages

The catalog page displays the class name, namespace, and service name, as well as the comments for the class and web methods. The Service Description link displays the WSDL; for information, see the section “Viewing the WSDL,” later in this chapter. The page then lists the web methods, with links (if you have the suitable permissions). The link for a given method displays a test page where you can test that method in a limited fashion.

Notes about this test page:

It does not enable you to see the SOAP request.
It does not test the full SOAP pathway. This means, for example, it does not write to the SOAP log that is discussed later in this chapter.
It accepts only simple, literal inputs, so you cannot use it to call methods whose arguments are objects, collections, or datasets.

This book does not discuss this page further. To test your web service more fully, generate and use a web client as described later in this book.