Published Web Service

Last modified: February 13, 2024

1 Introduction

This document describes the properties of a published web service. If you want a general overview of how Mendix publishes microflows as web services, see Published Web Services.

2 Operations

Provide the actual operations of which the web service is composed. Each of these operations is a Microflow.

See Operations.

3 Settings

3.1 Validate Against WSDL

If set to ‘yes’, incoming requests will be validated against the WSDL.

Default: Yes

3.2 Authentication

The authentication settings to define for communicating with the web service.

3.3 Target Namespace

This is the value of the targetNamespace attribute in the published WSDL file for this service. In Mendix, a target namespace must be a valid Uniform Resource Identifier (URI). For more information on XML namespaces, see Wikipedia.

It is important to correctly configure the target namespace before publishing your WSDL to third parties. Changing it later might break the third-party applications that call your published web services.

3.4 Generated XML

Select Include tags for associations if you need to include tags for associations in XML. This is usually not necessary, and support for this will be removed in a future version.

To see the effect of this checkbox, consider a person with two dogs and a cat. When you do not select Include tags for associations, the XML looks like this:

1
2
3
4
5
<Person name="John">
  <Dog name="Max" />
  <Dog name="Rex" />
  <Cat name="Chester" />
</Person>

When you do check Include tags for associations, the XML looks like this:

1
2
3
4
5
6
7
8
9
<Person name="John">
  <Person_Dog>
    <Dog name="Max" />
    <Dog name="Rex" />
  </Person_Dog>
  <Person_Cat>
    <Cat name="Chester" />
  </Person_Cat> 
</Person>

3.5 Export WSDL File and Export XML Schema Definition

By using these buttons, you can save the generated WSDL file, and its XML schema definition on your local hard drive. You can do this already before running your project, unlike when you download it from http://localhost:8080/ws-doc/ .

3.6 Documentation

Documentation can be used to describe what the web service is used for.