Page History

...

The Schema Set defines which entities, attributes and relations are used by the webservice (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. If the domain model was created automatically in an empty module, then you can skip the configuring these elements, because they are automatically set up correct and directly go to Creating a Service Call.

Schema Set Editor

Open the Schema Set, and unfold the schema. You can choose which entity is mapped to this type in XSD schema, as can be seen below. In this case, the anonymous complex type of the element “add” in the XSD schema is mapped to the entity “add” in the domain model (the red box). It is good to realize that in general entities that are based on elements in an XSD schema are not singleton.

...

You can add validations on attributes. These are used when exposing Blueriq as a service, and are of no interest when calling another web service.

Soap Service Editor

The Soap Service Editor lets you configure the messages that you want to send to your web service and how you store messages received from the web service. For each operation, the web service needs two singleton entities: a Request entity and a Response entity, which will be used to create the message. When you create the domain automatically, you will find these along with the other entities of the domain. You can use the soap service editor to create mappings for these, if you did not create the domain automatically, see below:

...

Here you can define several attributes.

• 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: 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: 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. This parameter is optional.

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

• Username: A possible username, for services with authentication.

• Password A possible password, for services with authentication.

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 needed data 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 an error, because error messages are not supported yet.