Microsoft Exchange Appointment Update
Overview
This handler updates an existing appointment in Microsoft Exchange.
Downloads
By downloading this file, you acknowledge that you agree to our Terms of Service
This handler requires that you are running at least Kinetic Task 2.0.
Detailed Description
This handler uses the Exchange Web Services (EWS) to create an appointment in Exchange using the Viewpoint Ruby Gem. After checking for various input errors, the handler passes the data to the Viewpoint Gem which formats the input to XML and communicates with the Exchange server. If the exchange appointment is successfully updated, no out is returned.
For an update, the only The only data that needs to be entered is the Appointment ID and the Send Invitations fields. Provide the information that is changed for all other fields. When updating the attendee lists, include ALL individuals, not just the additional people Choose the 'Send Invitations' carefully. A good standard choice is 'SendToAllAndSaveCopy,' which will send all updates to all the attendees. 'SendToChangedAndSaveCopy' is a good option when only adding attendees (just the new attendees will be notified).https://community.kineticdata.com/@api/deki/files/11889/exchange_appointment_update_v2.zip
The V2 handler, allows dates/times to be input in UTC or a specific time zone, with UTC being the default. Time zones are entered by selecting one of the menu options, which look similar to this: "(UTC-05:00) Eastern Time (US & Canada)". US-based time zones appear at the top of the list for convenience. Be sure to choose the proper timezone based on daylight saving time as appropriate (i.e., "(UTC-07:00) Arizona" instead of "(UTC-07:00) Mountain Time (US & Canada)".
Parameters
V2 Handler
| Name | Description |
|---|---|
| Appointment ID | ID of the appointment to be update. |
| Subject | The subject of the new appointment. |
| Location | The location of the new appointment. |
| Body | The body of the new appointment. |
| Start | The start of the new appointment with the format 'YYYY-MM-DDTHH:mm:ss' in 24hr time (13:00 == 1:00PM) |
| End | The end of the new appointment with the format 'YYYY-MM-DDTHH:mm:ss' in 24hr time (13:00 == 1:00PM) |
| Manually Enter Time Zone? | Yes if you want to manually specify a time zone. No if you want to pass times in UTC. |
| Time Zone Name | **This parameter only appears if 'Manually Enter Time Zone?' is set to Yes. **This is flagged as a required field so when it does appear the proper required field flag is shown. If the field is not used, the handler will look like it is incorrectly configured because a required field is not populated. If using this field, choose a time zone from the menu that matches the dates/times that will be provided. |
| Required Attendees | A comma separated list of email addresses that should be required to attend the appointment. |
| Optional Attendees | A comma separated list of email addresses that can optionally attend the appointment. |
| Send Invitations | How meeting requests are handled. Must be one of 'SendToNone','SendOnlyToAll','SendToAllAndSaveCopy'. Default is 'SendToAllAndSaveCopy' |
V1 Handler
| Name | Description |
|---|---|
| Appointment ID | ID of the appointment to be update. |
| Subject | The subject of the new appointment. |
| Location | The location of the new appointment. |
| Body | The body of the new appointment. |
| Start (UTC) | The start of the new appointment in UTC time with the format 'YYYY-MM-DDTHH:mm:ss' in 24hr time (13:00 == 1:00PM) |
| End (UTC) | The end of the new appointment in UTC time with the format 'YYYY-MM-DDTHH:mm:ss' in 24hr time (13:00 == 1:00PM) |
| Required Attendees | A comma separated list of email addresses that should be required to attend the appointment. |
| Optional Attendees | A comma separated list of email addresses that can optionally attend the appointment. |
| Send Invitations | How meeting requests are handled. Must be one of 'SendToNone','SendOnlyToAll','SendToAllAndSaveCopy'. Default is 'SendToAllAndSaveCopy' |
Sample Configuration
v2 Handler
| Parameter | Example Configuration |
| Appointment ID | AAMkADVjNDJY2rEhHPAAId5ubLAAA= (Note: The appointment ID has been shortened here for readability.) |
| Subject | Client Meeting |
| Location | East Conference Room |
| Body | We will be meeting with the client to discuss their latest project. |
| Start | 2016-07-14T15:00:00 |
| End | 2016-07-14T16:30:00 |
| Manually Enter Time Zone? | No (Enter times in UTC) |
| Time Zone Name | |
| Required Attendees | joe.user@acme.com,john.smith@acme.com |
| Optional Attendees | test.user@acme.com |
| Send Invitations | SendToAllAndSaveCopy |
Results
This handler does not provide any output.
Change Log
| Version | Date | Description |
|---|---|---|
| 1 | 2016-07-26 | Initial Version; only allows UTC dates/times as input
|
| 2 | 2016-07-26 | Uses the Viewpoint Ruby Gem; allows time zone selection for date/time values |