Page History
This page
...
describes the steps
...
for calling a web service using the SOAP protocol. This page also give you background information
...
on how web
...
services work within the Blueriq architecture.
...
The following steps are required:
...
Table of Contents maxLevel 2 minLevel 2
| Info |
|---|
Not everything in the WSDL standard is supported. See our Web Services datasheet for the restrictions on the standard. |
Anchor ImportWSDL ImportWSDL
1. Importing
| ImportWSDL | |
| ImportWSDL |
Because a SOAP service is neatly defined within a WSDL, it is possible to import such a WSDL file in Blueriq.
To import a WSDL file:
- Make sure that the WSDL is supported. You can check that on the Web Services datasheet.
Info As Blueriq
...
Encore cannot retrieve files from external locations, you need to provide all required files in a flat zip file. If you are using import or include statements, make sure that they are changed to not point at remote locations. Expand title Example Instead of using
Code Block <wsdl:import location="http://www.example.com/webservices/exampleservice?wsdl=ExampleService.wsdl" namespace="http://www.example.com/"> </wsdl:import>use the following, and place CRMService.wsdl in the zip file when importing:
Code Block <wsdl:import location="ExampleService.wsdl" namespace="http://www.example.com/"> </wsdl:import>- In Blueriq Encore, select the branch level in the navigation panel → Import WSDL and provide the location of the WSDL file. If you have multiple files (for example: your WSDL is importing/including
...
- an XSD schema)
...
- , provide a
...
- ZIP file with all files needed
...
- .
- Select the project for the import and you can choose whether to create a new module, or overwrite an existing one.
- The option 'Generate Domain' will automatically generate a domain model for you, based on the XSD schema referred to from the WSDL. When this button is checked, entities, attributes and relations are created based on the type definitions of
...
- the XSD. When using an existing module, there may already be a domain model present, that uses identical names as in the XSD. When overwriting, conflicting elements are not created. Obviously, these problems do not occur if you use a new module. When 'Generate Domain' is unchecked, no domain model is generated for you. In that case, you can later match the elements from the XSD to
...
- your own domain (explained later)
...
- . In general, it is advised to use a separate module for every WSDL in order to not mix the domain model for the web service with the domain model of your business.
- After you press the
...
- "Select operations" button, you can choose which operations should be imported. These operations originate from the WSDL. You should only import the operations that you need, as the created domain model will be smaller
...
- in that case.
You should get the message that the import was successful.
- Now press the "Import" button and the WSDL should be imported.
2. Mapping with Domain Model
Open your project and go the
...
module which contains the web service. The module now has
...
...
and a SOAP Service. These can be found in the
...
navigation panel in the category named "Connectivity".
The Schema Set defines
...
which entities,
...
attributes and relations are used by the
...
web service (they map
...
the XSD to the domain model). The
...
SOAP Service defines which entities are sent (the message parts from the WSDL). You use these elements to define what entities, attributes and relation in your domain correspond to concepts in the WSDL and XSD.
| Tip |
|---|
If the domain model was |
...
generated in a new module, |
...
you can skip |
...
this step and go directly to Creating a Service Call. |
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
the screenshot and below.
These entities are the only singletons in your domain if you generated your domain automatically. Conceptually, they represent the envelope of your message (remember 2. Simple Object Access Protocol (SOAP)). You can recognize these entities by their name. They are postfixed with either REQUEST or RESPONSE. These entities have no attributes and only one relation. In the code, Blueriq will start at this singleton, and work its way along the relation to all (indirectly) connected instances while creating the XML for the message. When sending a message, you have to make sure that this relation is set, otherwise the SOAP envelope will be empty.
Anchor CreatingAServiceCall CreatingAServiceCall
3.
| CreatingAServiceCall | |
| CreatingAServiceCall |
Creating a Service Call
Now that the web service is configured, you might want to call it. To call a
...
web service in
...
Encore, you need to create a service call.
...
Choose the AQ_SoapServiceClient from the list of available service calls (do not forget to import
...
the BlueriqBasicModelling Library). Every operation in the WSDL needs its own service call.
Here you can define several attributes.
- Service Module: The module in which the service is located.
- Service: Select SOAP or REST service and select which service to call.
- Operation: This is the name of the operation which is going to be executed. You can look up the name in the WSDL.
- Url: The URL of the webservice. If none is provided, the URL in the WSDL is used.
- Configuration Module: The name of the module where the datamapping is located. You need to specify this if your domain model is not in the same module as the webservice.
- Data Mapping: The name of the data mapping to be executed when this operation is called.
- Username: A possible username, for services with logins.
- Password A possible password, for services with logins.
4. Using the Web service
After you have created your service call, you can use it inside a flow
...
. When the service is executed, it will read the data needed
...
from the domain model, starting from the singleton request instance. After receiving an answer from the server, the
...
web service will store the data
...
as new instances, starting from the singleton response instance
...
. If a data mapping is used, the mapping is executed after the domain module in the
...
web service module is filled.
A common error is that an empty message is sent to the server. The reason for this is that the domain model for the
...
web service is not correctly initiated. If the
...
web service returns an error message, Blueriq runtime will show
...
this error.
| Tip |
|---|
Usually you want to use a separate module for your web service. Read more about this in 7. Modules and Data Mapping |
| Panel | |||||||||
|---|---|---|---|---|---|---|---|---|---|
|
Overview
Content Tools