Appendix

Additional information for specific topics can be found here.

Web Services

This chapter provides an overview of how to write your own web services with Fabasoft app.ducx.

Basically, there are two ways to create a new web service:

• Create a web service as a new WebServiceDefinition instance.
• Create a web service by extending the WebServiceConfiguration.

Web Service Definition

Creating a web service with a new instance of WebServiceDefinition is the recommended way. You just have to implement a use case and then expose it via a WebServiceDefinition.

You can call the web service via the following URL:

https://<host>/<vdir>/wsjson/MYDEMOAPP_111_100_MyWebServices/MyOperation

Web Service Configuration

Extending the WebServiceConfiguration is not as simple as creating a WebServiceDefintion but it allows you to control the input and output handling or creation of RESTful web services.

The following example shows a configuration of a web service:

You can call the web service with the following URL:

https://<host>/<vdir>/mywebservice

RESTful Web Services

If you are not familiar with the REST architecture please check out this Wikipedia article: http://de.wikipedia.org/wiki/Representational_State_Transfer

Basically, you can put this architecture into practice by extending the WebServiceConfiguration by adding the typical REST HTTP verbs (we call it friendlyurlallowedmethods):

Now you have to create the concrete web service:

JSONP

If you are not familiar with JSONP, consult: http://en.wikipedia.org/wiki/JSONP. Basically, all web services defined by WebServiceDefinition support JSONP.

You can set the JSONP parameter in GET requests. The parameter contains the name of the callback function that should be executed when the web service has finished.

Note that by using JSONP you are limited to GET requests, since this technique only includes an “external” script and you cannot “include” a script, for example with a POST request. Parameters can therefore not be passed within the request body, but only in the URL.

Create an HTTP Request

With app.ducx you can perform an HTTP request to gather information, for example from external web services.

OpenAPI

Fabasoft app.ducx allows you to import an OpenAPI service definition into your Fabasoft app.ducx project via an import wizard using “File” > “Import”. In the category “Fabasoft app.ducx” you will find an item called “OpenAPI Specification into Fabasoft app.ducx Project”.

On the next page, you have to select an OpenAPI specification in yaml format.

By finishing this dialog, an OpenAPI server definition will be transformed into the necessary types for a client class or a server class and an implementation template to implement the server with Fabasoft app.ducx expression code.

Note: The generated code contains a reference to the imported file so it is recommended to have the imported specification in the resources folder of the project.

Object Classes Without Mandatory Translation

The following table shows object classes that do not require a multilingual string.