You are viewing the documentation for Blueriq 16. Documentation for other versions is available in our documentation directory.
You can create your own web service using Blueriq, commonly referred to as BaaS (Blueriq as a Service). It is possible to create a SOAP service or a REST service.
For a SOAP service, first import a WSDL/XSD File.
For a REST service, first define the incoming request and outgoing response using the REST service editor and an imported XSD file or Domain schemas.
Webservice
After creating the webservice (in the configuration module), the following properties need to be provided.
Property | Description |
---|---|
Service module | Select the interaction module in which the SOAP/REST service is defined. This module is used to process the incoming request and is considered the source module. The target module of a web service is always the entry point module of the project. It is possible for the source and target module to refer to the same module. |
Service definition | Next select the Soap or Rest service which you want to expose. Both type of services are combined in the service definition dropdown. |
Validate requests | If you check the validate option, each incoming request is validated against the specified validation rules. |
Operations
After selecting the service definition, a list of operations that are defined in the service will appear. Select an operation in the list and fill in the properties.
Property | Description |
---|---|
Exposed | Each operation may be exposed or unexposed. After an operation in the service has been exposed, it is possible to retrieve both the service URL and the OpenAPI specs URL in the runtime dashboard widget names "Exposed Blueriq Webservices": |
Data mapping | If the web service module you selected is not compatible with the entry point module, a data mapping must be provided. The data mapping must have a source module that is compatible with the web service module, and a target module that is compatible with the entry point module. Only data mappings that have 1) their source module compatible with the web service module and 2) their target module compatible with the entry point module are listed. |
Flow | Specify the flow to be started for handling the incoming request. Only flows from the scope of the entry point module can be selected. |
Roles | If you want a user to be authenticated with certain roles, you may specify them here. |