Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
This page goes threw the steps that you need to follow in order to be able to call a web service using the SOAP protocol. This page also give you background information you need to understand how web service work within the Blueriq architecture. 4 steps are required:
  • Importing
  • Mapping with Domain Model
  • Creating a Service Call
  • Using the Web service
Note

Not everything of the WSDL standard is supported. If you find that you have troubles performing one of the following steps, please also check in our Web Services datasheet to see if the service should work.

Importing

Because a SOAP service is neatly defined within a WSDL, it is possible to import such a WSDL file in Blueriq. 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) then 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 domain 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 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 is generated for you. In that case, you can later match the elements from the XSD to you own domain (explained later). In general, it is advised to use a separate module in order to not mix the domain for the web service with the domain of your business.

After you press the import 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 will be smaller then.

You should get the message that the import was successful.

...