Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

8/15/2019 - The elandings system has had public SOAP webservices available for use since ~2012. The 2012 webservices make use of older technology that make them them challenging to work with. Some of these technologies are likely to be retired from out from under us in the coming years, as Java upgrades.

The 2012 webservices require that you get an XML XSD definition from elandings staff, so that you can parse XML responses into Java or C# Objects.

The 2012 webservices make use of long lists of unnamed arguments. For example findUserLandingReports_001() has 25 arguements, that could appear to the developer as "arg1, arg2, arg3..." These long lists are arguements are hard for developers to work with.

The 2019 Webservices attempt to address these weaknesses.

The 2019 Webservices WSDL includes the XML XSD definition, so that Java or C# can automatically generate the Object classes for you.

The 2019 Webservices allow you to pass Objects with named elements to represent the complex list of arguements. These objects tend to be far easier to understand, think about and work with. 

The 2019 Webservices make use of updated libraries that should be safe as Java upgrades in the near future.

We would encourage 3rd-party systems to migrate to the 2019 webservices sooner rather than later. This will allow eLandings and our partners to be better positioned to