Web Service Server entity

A SOAP Web Service Server or JSON Web Service Server entity contains the main logic to publish services. It listens for incoming requests and executes the relevant service operation.

The XML representation of a SOAP Web Service Server entity is a .4wsprg file. The XML representation of a JSON Web Service Server entity is a .4wsjprg file.

When a Web Service Server entity is implemented from the diagram, a .4gl source file is generated which contains the MAIN function for the application. This .4gl file is also used to combine the other generated .4gl files into a Genero application.

The generated code can be customized; see Adding custom code.

Any changes to the BA diagram are included in the subsequent re-generating of the program code.

Properties

The Type property is set to "WebServiceServer" for a SOAP Web Service Server entity, and "WebServiceServerJSON" for a JSON Web Service Server entity.

The Namespace property must be set for a SOAP Web Service Server entity.

All properties of a Web Service group of a Record node and of a RecordField node are applicable to the SOAP Web Service Server.

The properties of Web Service group of RecordField node are not applicable to JSON Web Services, except the Public property.

Implementing the Web Service Server

To implement a Web Service Server, right-click on the Web Service Server entity and select Implement SOAP Web Service Server or Implement JSON Web Service Server. An XML definition file (.4wsprg for SOAP or .4wsjprg for JSON) is generated, containing the logic for the MAIN function.

When the Web Service Server is implemented, new context menu options appear as in Table 1.

Table 1. Context Menu Options
Menu Option Description
Open Opens the definition file in the Code Editor.
Execute Program / Build Program Builds and/or executes the source code for the Web Service Server based on the related entities in the diagram.
Locate in Project Locates and highlights the selected item in the project.