Websydian v6.1 online documentationOnline documentation - WebsydianExpress v3.5

Maintain Service Structure

Overview

This function is used to maintain the service structure of the site you are logged into. The service structure is the overall structure of the services offered by the site.

The services offered by the site can be a mix of File, XML and SOAP services.

Tree structure page

The tree shows information about the current service structure.

For each element this information is shown: An icon and individual information dependent on the element type.

The order of the elements are fixed:

The tree structure supports a popup menu. You can right-click on a node in the Service structure tree and a popup menu is shown. The content of the popup menu reflect the possible choices on the element type in question.

Icons for element types

Each of the service elements has an icon representing the type of element and a status indication (for URL and Service Handler only).

The status indication is a small graphics representing the following states

Icon Element type
Root

Processor, active

Processor, inactive

Processor, for Intranet only

Criterion

Service Handler, active

Service Handler, inactive

Information shown for records in the tree structure

Parent Element Type Information
Root Services for [service url root]
Processor [url mask] ([description of processor])
Criterion [criterion name] [criterion value]
Service Handler [service handler name] Value: [value]
[service url root]

This is the root name for services. The URL is the 'Entry URL' and 'URL extension for identifying service request' concatenated.

[url mask]

This is the URL mask that indicates the name of the service in question.

The actual path to the service in question is [service url root][url mask].

[description of processor]

This is the description that has been entered on the Processor.

[criterion name]

This is the name of selected criterion.

[criterion value]

This is the value that must be matched with the incoming service request.

[service handler name]

This is the name of the selected Service handler.

[value]

This is the value that must match with the incoming service request.

Add

Select the place in the structure where you want to add an element and press the Add button or right-click to show the popup menu and then select Add.

The new element will be added in the structure as a child of the selected element.

Only Root, Processor and Criteria can have child elements added.

Update

Select the element you want to update and press the Update button or right-click to show the popup menu and then select Update.

Only Processor, Criterion and Service handler can be updated.

Remove

An element can be removed from the service structure when you select the element and press the Remove button or right-click to show the popup menu and then select Remove. You will then be asked to confirm the removal.

When you want to remove an element, the level(s) below will get removed too. In case of removing a handler, there are no levels below so just the selected handler will be removed.

Create WSDL

In order to create a WSDL file right-click on either the Service or Handler in question to show the popup menu. Select Create WSDL option.

The WSDL file will be generated and a download dialog will be shown in order for you to decide where to store the WSDL file.

This functionality is only available in WebsydianExpress for Windows and WebsydianExpress for Java.

This option is valid only for URL elements and Service handler elements where the SOAP action criterion has been chosen.

Note that WebsydianExpress has now knowledge of which port the web server uses.

This means that if you for instance access the site by the URL:

http://MYPC:8080/site/demosite - the WSDL will generate the URL:

http://MYPC/site/demosite for the soap address found under the service definitions.

You must correct this manually before delivering the WSDL to the clients.

The URL is found in the last section of the WSDL - and has the format:

<soap:address location="http://MYPC/express30win/site/demosite/..."/>

Comparison order of criteria

The incoming request is compared against the criteria in the order that they are shown in the service structure. In order to be able to change this order, you can use the two buttons Move up and Move down.

Move up and Move down are also available on the popup menu when you right click on a URL element or Service handler element that is based on the SOAP action criterion.

Move up

To move a Criterion further up in the comparison order, click on the Move up button or right-click on Criterion in question and select Move up on the popup menu.

Move down

To move a Criterion further down in the comparison order, click on the Move down button or right-click on Criterion in question and select Move down on the pop-up menu.

Handlers

This button opens a pop-up window where you can maintain the service handlers.

Processors

This button opens a pop-up window where you can maintain the service processors.

Criteria

This button opens a pop-up windows where you can maintain the selection criteria.

Related information

Understanding Service Structure
Documentation about the Service Structure.
Service Processor Background
Background document about the service processors
Selection Criteria Background
Background document about the selection criteria
Service Handler Background
Background document about the service handlers