OutlookEX UDF - Meeting Item: Difference between revisions

From AutoIt Wiki
Jump to navigation Jump to search
m (+Category:OutlookEX_UDF)
mNo edit summary
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
[[Category:OutlookEX_UDF]]{{WIP}}
[[Category:UDF]]
Here you'll find detailed description if you work with Meeting items.  
[[Category:Outlook]]
== Wrapper functions ==
Here you find detailed information about how to work with Meeting items.
The following functions are "''wrappers''" that combine multiple function calls to mimic functions available in the "''original''" Outlook UDF.<br />
This should make your scripts a bit shorter and live a bit easier.
=== CreateAppointment ===
The wrapper function ''CreateAppointment'' allows to create an appointment, setting subject, body, start and end date, duration, location, reminder, recurrence information etc. in one go. This wrapper function mimics the function of ''_OutlookCreateAppointment'' of the original UDF.
 
Example:
 
<syntaxhighlight lang="autoit">
#include <OutlookEx.au3>
$oOL = _OL_Open()
Global $sStart = StringLeft(_Nowcalc(),16)
Global $sEnd  = StringLeft(_DateAdd("h", 3, _NowCalc()), 16)
_OL_Wrapper_CreateAppointment($oOutlook, "Test Appointment", $sStart, $sEnd, "My office", False, "Testbody", _
    15, $olBusy, $olImportanceHigh, $olPrivate, $olRecursWeekly, $sStart, _DateAdd("w", 3, $sEnd), 1)
_OL_Close()
</syntaxhighlight>
 
This creates an appointment and sets subject, start and end date/time of the first occurence, location, body, importance, sensitivity, recurrence type to weekly and end of recurrence to 3 weeks later.
 
== Tips & Tricks ==
== Tips & Tricks ==
=== Send a meeting invitation ===
=== Send a meeting invitation ===
Line 32: Line 13:
Global $oOL = _OL_Open()
Global $oOL = _OL_Open()
; Create an appointment and set some properties
; Create an appointment and set some properties
$oItem = _OL_ItemCreate($oOutlook, $olAppointmentItem, "*\Calendar", "", _
$oItem = _OL_ItemCreate($oOL, $olAppointmentItem, "*\Calendar", "", _
   "Subject=Meeting", "Start=" & _DateAdd("D", 3, _NowCalcDate() & " 08:00:00"), "Duration=60", _
   "Subject=Meeting", "Start=" & _DateAdd("D", 3, _NowCalcDate() & " 08:00:00"), "Duration=60", _
   "Location=Building A, Room 10", "RequiredAttendees=<Name Firstname>", "MeetingStatus=1")
   "MeetingStatus=1")
; Add required recipients you want to invite to the meeting
_OL_ItemRecipientAdd($oOL, $oItem, Default, $olRequired, "Recipients name 1",  "Recipients name 2")
; Add optional recipients you want to invite to the meeting
_OL_ItemRecipientAdd($oOL, $oItem, Default, $olOptional, "Optional user 1")
; Add a meeting room
_OL_ItemRecipientAdd($oOL, $oItem, Default, $olResource, "Meeting Room 1")
; Send the meeting request
; Send the meeting request
_OL_ItemSend($oOL, $oItem)
_OL_ItemSend($oOL, $oItem)
</syntaxhighlight>
</syntaxhighlight>


This creates an appointment in the senders calendar and sends a meeting request to attendee <Name Firstname>. The meeting starts in 3 days from today at eight o'clock and lasts an hour.
This creates an appointment in the senders calendar and sends a meeting request to the optional and required attendees plus the administrator of the meeting room. The meeting starts in 3 days from today at eight o'clock and lasts an hour.


=== Cancel a meeting and send cancel requests to the attendees ===
=== Cancel a meeting and send cancel requests to the attendees ===

Latest revision as of 09:27, 27 July 2023

Here you find detailed information about how to work with Meeting items.

Tips & Tricks

Send a meeting invitation

Set property MeetingStatus to value '1' (the meeting has been scheduled) and send the item to the attendees.

Example:

#include <OutlookEx.au3>
; Open the connection to Outlook
Global $oOL = _OL_Open()
; Create an appointment and set some properties
$oItem = _OL_ItemCreate($oOL, $olAppointmentItem, "*\Calendar", "", _
  "Subject=Meeting", "Start=" & _DateAdd("D", 3, _NowCalcDate() & " 08:00:00"), "Duration=60", _
  "MeetingStatus=1")
; Add required recipients you want to invite to the meeting
_OL_ItemRecipientAdd($oOL, $oItem, Default, $olRequired, "Recipients name 1",  "Recipients name 2")
; Add optional recipients you want to invite to the meeting
_OL_ItemRecipientAdd($oOL, $oItem, Default, $olOptional, "Optional user 1")
; Add a meeting room
_OL_ItemRecipientAdd($oOL, $oItem, Default, $olResource, "Meeting Room 1")
; Send the meeting request
_OL_ItemSend($oOL, $oItem)

This creates an appointment in the senders calendar and sends a meeting request to the optional and required attendees plus the administrator of the meeting room. The meeting starts in 3 days from today at eight o'clock and lasts an hour.

Cancel a meeting and send cancel requests to the attendees

Set property MeetingStatus to value '5' (the scheduled meeting has been cancelled) and re-send the item to the attendees.

Example:

#include <OutlookEx.au3>
; Open the connection to Outlook
Global $oOL = _OL_Open()
; Get the appointment you want to cancel
$aResult = _OL_ItemFind($oOL, "*\Calendar", "", "[Subject]='Meeting'", "", "", "EntryID")
$oItem = _OL_ItemModify($oOL, $aResult[1][0], Default, "MeetingStatus=5")
; Send the meeting request
_OL_ItemSend($oOL, $oItem)

This removes the appointment from the senders calendar and sends a cancel request to every attendee.