Skip to main content
Kinetic Community

Microsoft Exchange Appointment Search

Overview

This handler searches the calendar of the configured user to retrieve data about individual Exchange appointments that fall within the parameters provided at run time.

Downloads

By downloading this file, you acknowledge that you agree to our Terms of Service

exchange_appointment_search_v1.zip

This handler requires that you are running at least Kinetic Task 2.0.

Detailed Description

This handler takes in the Recurring Event Master ID and a date range and returns all instance occurrence IDs found within the time frame.  The intended use of this event is to retrieve the ID of an event that is known to exist; therefore an exception is raised if no events are found within the timeframe provided.

The handler takes a starting and ending point which must be in UTC time. The other input is the Appointment ID that was returned when the recurring event was created (for a recurring event, the ID represents the container for ALL occurrences).

The handler will only return the ID of the first matching occurrence within the date range provided. 

Parameters

Name Description
Start Date The start of the new appointment in UTC with the format 'YYYY-MM-DD'.
End Date The end of the new appointment in UTC with the format 'YYYY-MM-DD'.
Subject A string to search the contents of the subject. Doesn't need to be an exact match, just checks if it contained in the subject.

Sample Configuration

Parameter Example Configuration
Start Date 2016-07-01T05:00:00
End Date 2016-07-07T05:00:00
Subject Client

Results

Name Description
appointments_json A JSON string representing the appointment.  Output includes:  id, subject, location, body, start, end, required attendees, optional attendees

 

Change Log

Version Date Description
1 2016-07-26

Initial Version