Creating a WINDEV SOAP Server application

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Overview

Principle

How to create a SOAP Server application?

See also

Creating a WINDEV SOAP Server application

Overview

The SOAP Server application is an application containing all the procedures to run. These procedures are run by the SOAP client application.

Principle

The principle is as follows:

How to create a SOAP Server application?

Creating a SOAP Server application

To create a SOAP server application:

Create a WINDEV project.
Create the global procedures. Each global procedure can be run by the SOAP client.
Caution: the server application must have no interface (no window, report, trace window or dialog box). This application is also limited by the rights granted to the Web server.
Type (if necessary) the initialization code and the closing code of project. These two sections of code will be respectively run when loading and unloading the library on the server.
Create the library of your project (.WDL file). This file contains all the procedures of the project.

Remark: In the SOAP Client application, the name of the library used (WDL) must be specified in the namespace (see SOAPRun).

Caution: The transfers are not secured at the moment (the data transferred is not encrypted). The SOAP protocol should not be used to transfer sensitive data.

Hosting different versions of WINDEV SOAP servers

Different versions of WINDEV Web services can be hosted on a IIS HTTP server: to do so, define 2 different extensions in the Inetmgr.exe program (".soap12" and ".soap17" for example).

Two different versions cannot be hosted on an Apache server.

Running the test of your SOAP server application on the development computer

To run the test of your SOAP server application on the development computer:

Create the library (.WDL file) of your Server application. Create a project configuration to generate the library if necessary.
Configure the Internet server installed on your computer for your WINDEV application:
Configure the SOAP administrator (WDSOAPConfig.EXE application in "Data" directory of WINDEV). See Configuring the administrator for more details.
Restart your Web server.
Run the test of your SOAP client application.

Installing your application on a SOAP server

To install your application on a SOAP server:

Create the library (.WDL file) of your Server application. Create a project configuration to generate the library if necessary.

Caution: The WINDEV DLLs must not be renamed.
Create the setup program of your application: on the "Project" pane, in the "Generation" group, expand "Setup procedure" and select "Create setup procedure".
The following files must be selected for the setup:
- WDSOAPConfig.EXE application found in the "Data" directory of the setup directory of WINDEV.
- the WINDEV DLLs required to run your application. Check whether the following DLLs are selected: wdxxxobj.dll, wdxxxpnt.dll, wdxxxstd.dll and wdxxxvm.dll.
- the WINDEV DLLs specific to the HTTP server used: wdxxxsapa.dll for Apache 1.3, wdxxxsapa2.dll for Apache 2.0, wdxxxsiis for IIS, ...
Install the application on the server.
Configure the Internet server for your WINDEV application:
Configure the SOAP administrator. See Configuring the administrator for more details.
In order for the SOAP client to contact the server, the server address used in SOAPRun must have the following format:

<IP address of server>\Server.soap

Remark: If several soap server applications are installed on the same computer, you must necessarily install:

all the libraries (WDL) in the same directory.
all the WINDEV DLLs used in the same directory.

A single SOAP administrator will be installed and used.

Caution: The rights granted to the user of the http site are very important. If a WINDEV SOAP server must write into a file, write rights must be granted to the user of the site (Internet guest).