Using MS Outlook Delegated Calendars¶
Tip
Also see this article to learn how to process emails in LinkPoint Connect(ME) over Delegated access
Note
Also see this UVM article to learn how to configure and work with Delegated mailbox access
The Delegated calendars feature allows Delegates, LinkPoint Connect(ME) users with granted delegate access permissions in MS Outlook to view, manage, and sync in Salesforce calendar items of other users, calendar Organizers (Delegators), also viewing the contextual Salesforce data about associated records in LPC Sidebar.
When a meeting or appointment is created, modified, moved, or deleted in delegated access scenario, its associated Salesforce records and Salesforce calendar are updated correspondingly through LPC synchronization, so other concerned individuals in your Salesforce Org can see the changes in the records immediately and react to them.
Please refer to this article for detailed information on how calendar items are processed by LinkPoint Connect(ME) selectively or automatically.
Prerequisites and Permissions¶
Delegated Calendar access and Delegated Inbox access have the same prerequisites; either of these mailbox data access scenarios or both can be configured if the below prerequisites are met. Handling of MS Outlook Tasks or Contacts by LinkPoint Connect(ME) via delegated access is currently not supported
- To carry out scenarios through delegated access both involved mail accounts should have LPC Add-In installed and Sync activated. Both accounts should have a dedicated LPC license
- The two accounts should belong to the same MS Exchange instance and Salesforce Org
- All LPC functions are only available if the mailbox Owner (Delegator) grants Calendar Editor permissions for the Delegate, so it is the recommended permissions level
Also see the section “Supported LPC Actions for Delegated Scenarios for Calendar Items” below for details on all available use cases.
Setting Up Delegated Calendar Access in MS Outlook¶
Please refer to the following Microsoft guides to learn how to set up delegated calendar permissions in MS Outlook and use this feature:
The following delegated access permission types are available:
Editor: has full calendar management permissions.
Author: has full calendar management permissions, apart from modifying or processing calendar items created by the Organizer.
Reviewer: this permissions type is insufficient for managing delegated calendars. It only allows viewing calendar entries; no item sharing in Salesforce or linking to Salesforce objects is possible with this permissions type.
Managing calendar entries using the delegated calendars feature with LinkPoint Connect(ME) Add-In requires Author or Editor permissions to be set up: File > Info tab > Account Settings > Delegate Access > Calendar picklist.
Delegated calendar permissions can be set up individually: {MS Outlook Calendar view} > Folder tab > Calendar Properties
The required permissions level for LinkPoint Connect(ME) delegated calendars management are Can edit or Delegate.
Note
The Delegate can see my private items or Can view private events setting allows a Delegate with Editor or Author permissions to view as well as modify items which the calendar Organizer marked as private. With this setting enabled a Delegate can also remove the private mark from calendar items.
Setting Up Shared Calendar Access in Salesforce¶
In order to allow Events in the Organizer’s Salesforce calendar to be created or modified by LinkPoint Connect(ME) via a Delegate’s Salesforce account the necessary shared calendar permissions should also be set up in Salesforce. Refer to the following Salesforce help articles to learn how to do that: article 1; article 2.
Delegated Calendar Items Syncing in Salesforce¶
To sync a delegated calendar item in Salesforce (initial sharing), you can either assign it the blue Salesforce category in MS Outlook or find and select a relevant existing record and then click the Save button at the top of LinkPoint Connect(ME) Sidebar. If LPC insta-sync is enabled, an item shared this way will be saved in Salesforce instantly. Otherwise it will be saved on the following sync session.
Important
Regardless of who modifies/updates a calendar item, for the changes to be conveyed to Salesforce the item’s Organizer must have one’s LinkPoint Connect(ME) synchronization enabled
Supported LPC Actions for Delegated Scenarios for Calendar Items¶
Granted permissions | Available actions | Salesforce Destination | |
---|---|---|---|
Calendar access | Delegate + Calendar permissions Editor [the only scenario fully compatible with LinkPoint Connect(ME)] |
Manage and process in LPC calendar items created by the Owner or the Delegate, as well as inbound meeting invites (on the Owner’s behalf) All saving scenarios in the Calendar using LPC Sidebar or custom category |
Ownerβs Salesforce account |
Send a meeting invite (send on behalf of) | Configured as a Delegate with no special Calendar permissions set | Save created items in Compose mode using LPC Sidebar or custom category | Ownerβs Salesforce account |
Delegate + Calendar permissions Author | View Calendar and respond to meeting invites, create meeting invites and process in LPC only items created by Delegate using LPC Sidebar or custom category | Ownerβs Salesforce account | |
Delegate + Calendar permissions Reviewer | No LinkPoint Connect(ME) actions available, can only view the Sidebar | n/a |
LinkPoint Connect(ME) Delegated Calendars Access Troubleshooting¶
Delegated calendars sync issues may occur mainly on initial item sharing in Salesforce, caused by either one of the following issues: LinkPoint Connect(ME) sync errors, insufficient MS Outlook delegated calendar permissions, insufficient Salesforce permissions.
- Since initial sharing (creation) of events in Salesforce is performed by LinkPoint Connect(ME) synchronization, the Organizer’s sync must be running for the calendar updates made by a Delegate to be applied In Salesforce. If sync is not running for the Organizer, LinkPoint Connect(ME) will not be able to save the item created or modified by the Delegate in Salesforce. The corresponding error notification will be displayed that sync is not enabled for the Organizer
-
Once the corresponding Salesforce event record has been created, its further updates and modifications can be performed directly from via the Organizer’s or Delegateβs LinkPoint Connect(ME) Add-In; the changes will be conveyed immediately and will not depend on the sync interval. This way, even if sync is not running for the calendar item Organizer, saving changes to an already existing Salesforce event object can be performed if the Delegate has the permissions to access this event in Salesforce
-
If the Delegate does not have the permissions to view the corresponding Salesforce event (however, the Add-In can still obtain the Salesforce event ID from MS Exchange), saving will not be allowed with an error notification that the user has insufficient Salesforce account permissions to save this event
Note
The same error message is displayed if the event was removed from Salesforce and LinkPoint Connect(ME) was unable to down-sync this change to MS Exchange
- If the Delegate does not have the permissions to modify a corresponding Salesforce event, there will appear an error notification that user has insufficient Salesforce account permissions to update this event, suggesting to contact the Organizer to get the required permissions in Salesforce
Note
Delegated calendars also support using the Send calendar availability and Send meeting time slots features so the Delegate can generate these links for the Delegator’s calendar
Delegated Calendars and LPC Meeting Scheduler¶
LinkPoint Connect(ME) features Time Slots or Calendar Availability can be used for a Delegated access calendar. Generated meeting’s formal initiator gets auto-defined based on the content of the From field.
After LPC Autumn update 2108 (September 2021), the resulting meeting slots reservation page also includes an indicator showing if the meeting’s initiator.
We would love to hear from you