Breaking Change in NetServer Scripting: Appointment Save Method Update

We want to inform you about a breaking change in SuperOffice NetServer Scripting that was introduced in version 10.5.4 with the release of the new Appointment Dialog.

What changed

Prior to v10.5.4, when saving new appointments, the SuperOffice web client used AppointmentAgent.Save method, which would raise the following NetServer scripting event:

static void BeforeSave(
       AppointmentEntity  appointmentEntity,
       RecurrenceUpdateMode  updateMode,
       Boolean  sendEmailToParticipants,
       EMailConnectionInfo  smtpEMailConnectionInfo,
       EMailConnectionInfo  imapEMailConnectionInfo,
       CancellationToken  cancellationToken,
       ref object  eventState
      );

Starting with v10.5.4, and the new Appointment dialog, the web client now uses AppointmentAgent.SaveWithCustomInvitation:

static void BeforeSaveWithCustomInvitation(
       AppointmentEntity  appointmentEntity,
       RecurrenceUpdateMode  updateMode,
       Boolean  sendEmailToParticipants,
       EMailConnectionInfo  smtpEMailConnectionInfo,
       EMailConnectionInfo  imapEMailConnectionInfo,
       String  emailBody,
       String  subject,
       String  templateLanguage,
       CancellationToken  cancellationToken,
       ref object  eventState
      );

Why this matters

This change can have cascading consequences for any onsite customizations that rely on the NetServer scripting event engine for automation.
If your scripts are tied to the previous AppointmentAgent.Save method, they may no longer trigger or behave as expected.

What you need to do

If your automation depends on AppointmentAgent.Save, you may need to update your scripts to handle AppointmentAgent.SaveWithCustomInvitation accordingly.

Our apologies

We regret not announcing this change sooner. We understand that late communication can cause avoidable disruptions, and we will strive to be more diligent in communicating such impactful changes ahead of time in the future.

If you are unsure whether this affects your environment, we recommend reviewing any custom scripts related to appointment creation and testing them against the new dialog in v10.5.4 and later.

Version 11 Breaking Changes

While on the subject, we announced (Apr. 2024) major breaking changes coming in v11. With regards to NetServer scripting events all event names have changed. All event names will have the Async suffice. Therefore, all existing event handlers will require updates accordingly.

Best regards