Page History

...

...

1. Importing

Because a SOAP service is neatly defined within a WSDL, it is possible to import such a WSDL file in Blueriq. Go Close your project and go to File → Import → 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 needed files. 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.

...

You should get the message that the import was successful.

2. Mapping with Domain Model

Open your project and go the module which contains the web service. The module now has a Schema Set and a Soap Service. These can be found in the bar on the left side of the screen, as shown below.

...

These entities are the only singleton in your domain if you generated your domain automatically. Conceptually, they represent the envelope of your message (remember Chapter 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.

3. Creating a Service Call

Now that the web service is configured, you want to call it. To call a web service in studio, you need to create a service call. Chooses the AQ_WebServiceClient from the list of available service calls (do not forget to import the Blueriq library). Every operation in the WSDL needs its own service call.

...

• Service Module: The module in which the service is located.

• Service: Select SOAP in this case and the service to call. This can be multiple if more than one service is imported in the same module.

• Operation: This is the name of the operation which is going to be executed. You can look up the name in the WSDL.

• Url (optional): The URL of the web service. If none is provided, the URL in the WSDL is used. You can use this for debugging purposes, and send the service call to your local SoapUI mockservice.

• Configuration Module (optional): The name of the module where the data mapping is located. You only need to specify this if your domain model is not in the same module as the web service.

• Data Mapping (optional): The name of the data mapping to be executed when this operation is called.

• Username (optional): Username for services with authentication.

• Password (optional): Password for services with authentication.

4. Using the Web service

After you have created your service call, you can use it inside a flow. The web service throws a default event. 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.

...