SOAP API changes by version
The purpose of this topic is to identify changes to the Unica Campaign SOAP API for customers who are currently using the API. If you upgraded from a prior version, review the following information to determine whether you need to make changes to your application code.
Versions and backwards-compatibility
Future versions of the CampaignServices API are compatible with earlier versions, with all minor and maintenance releases that share a major version number. However, reserves the right to break compatibility with the earlier version for "dot zero" (x.0) major releases.
- Data interpretation changed
- Business logic changed, that is, the service method functionality
- Method parameters and / or return types changed
- New method added
- New data type that is added and its usage that is restricted to new methods
- New type added to an enumerated type
- a new version of an interface is defined
continues to support the published WSDL, SOAP client, and the version of Apache Axis that is used to implement the SOAP offering until at least the next major release. Practically speaking, this is accomplished by supporting several version-specific web services concurrently. ( already supports several versions of this service internally.)
Changes in v9.1.2
There were no API changes in version in v9.1.2.
Changes in v9.1.1
stopFlowchart includes a new input parameter, runId, to support a clustered listener environment.
Changes in v9.1
There were no API changes in version 9.1.
Changes in v9.0
There were no API changes in version 9.0.
Changes in v8.6
API changes implemented in v8.6:
- The SOAP engine was upgraded from AXIS version 1.4.1 to AXIS2 1.5.2.
- The WSDL was restructured to deal with issues that handle the required and optional parameters.
- The Client API .jar file changed due to the WSDL changes. As a result, the generated stubs and classes changed. The Client API method parameters did not change, but the constructors of supporting value objects were modified for the AXIS2 WSDL2Java converter usage.
- The Web Service URL points to:
http://<host>:<port>/Campaign/services/CampaignServices30Service
and the corresponding WSDL is retrieved at:
http://<host>:<port>/Campaign/services/CampaignServices30Service?wsdl
If you are upgrading to Unica Campaign version 8.6 or higher and you currently use the Unica Campaign Services API, you must modify your application code.
Depending on whether you use the client API or the WSDL, see the following sections for details: