Versions Compared

Version Old Version 2 New Version Current
Changes made by

Paul Hindle

Paul Hindle

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space SCHUD and version 9.4

...

Panel
Warning
titleADVISORY NOTICE

SOAP Interface Update

ServiceScheduling 9.2.0.0 has made non-backwards compatible changes to the SOAP API interfaces. Users upgrading from a version prior to this release are required to consume the new WSDL and re-compile (if required) for their integration.

It is highly recommended that all integrations with the SOAP API interfaces are then re-tested. Details of changes to the SOAP API interfaces can be found in the ServiceOptimizer Integration Guide.

Note

Change to MPX structure

One of the changes made to the SOAP API interfaces in ServiceScheduling 9.2.0.0 was the addition of a new listReqEmps structure for the management of mandatory, preferred and excluded (MPX) employee details in the Request Appointments SOAP API, Book Appointment SOAP API, Book Dependency Group Jobs SOAP API, Book Split Dependency Group Jobs SOAP API and Book Non-Appointment Job SOAP API request structures and in the Get Job SOAP API and Get Employee Jobs SOAP API return structures.

Although the new listReqEmps structure (which supports managing the MPX details for up to 10 employees) has replaced the previous reqEmps structure (which supported managing the MPX details for up to 2 employees) in the documentation, the SOAP API WSDL includes both structures for setting of MPX details in the Request Appointments SOAP API, Book Appointment SOAP API, Book Dependency Group Jobs SOAP API, Book Split Dependency Group Jobs SOAP API and Book Non-Appointment Job SOAP API request structures.

The old reqEmps structure has been retained in the WSDL to allow previous integrations with these APIs to continue to book up to 2 MPX employees without the need to change this particular integration point. However, users of ServiceScheduling who elect not to upgrade to use the newer listReqEmps structure should be aware of the following:

  1. ServicePower will deprecate the reqEmps structure in a future major release of ServiceScheduling.
  2. Integrations with the Get Job SOAP API and the Get Employee Jobs SOAP API may need to be updated, as only the new listReqEmps structure is supported.
  3. Jobs booked with MPX options using the old reqEmps structure through the Request Appointments SOAP API, Book Appointment SOAP API, Book Dependency Group Jobs SOAP API, Book Split Dependency Group Jobs SOAP API or Book Non-Appointment Job SOAP API will not have their MPX information visible in ServiceGANTT. The MPX data will be stored in ServiceScheduling and respected by ServiceOptimizer when optimizing schedules; it is just that the details of the MPX data will not be able to be seen or updated through ServiceGANTT.

To overcome this limitation, users of the Request Appointments SOAP API, Book Appointment SOAP API, Book Dependency Group Jobs SOAP API, Book Split Dependency Group Jobs SOAP API or Book Non-Appointment Job SOAP API must update their integration to the new listReqEmps structure.

...

Panel
Warning
titleADVISORY NOTICE

SSL Support for the SOAP API Introduced

ServiceScheduling 9.2.0.0 introduced SSL support on web services alongside the old, non-SSL, interfaces. A separate port type is provided to support this. Customers requiring to use this feature need to ensure they follow the directions given in the ServiceOptimizer Admin Guide .