Support offline execution with Dynamics 365 for Microsoft Office

Offline mode is only supported on Dynamics 365 for Microsoft Office Outlook with Offline Access. You can register plug-ins to execute when the Outlook client is in online mode, offline mode, or both. Your plug-in code can check whether it is executing in offline mode by checking the IsExecutingOffline property.

When you design a plug-in that will be registered for both online and offline execution, remember that the plug-in can execute twice. The first time is while Dynamics 365 for Microsoft Office Outlook with Offline Access is offline. The plug-in executes again when Dynamics 365 for Outlook goes online and synchronization between Dynamics 365 for Outlook and the Dynamics 365 Server occurs. You can check the IsOfflinePlayback property to determine if the plug-in is executing because of this synchronization.

Impersonation in offline plug-ins

For plug-ins executing offline, any entities created by the plug-in are owned by the logged on user. Impersonation in plug-ins is not supported while in offline mode.

For additional information on impersonation, see Impersonation in plug-ins and Impersonate a user.

Register an offline plug-in

If your plug-in assembly contains code that supports execution while the Dynamics 365 for Outlook is offline, there is additional security that the Dynamics 365 Customer Engagement (on-premises) platform imposes on registered assemblies. For more information, see Walkthrough: Configure Assembly Security for an Offline Plug-in.

For general information about plug-in registration, see Register and Deploy Plug-Ins.

Debug an offline plug-in

General information on debugging plug-ins can be found in Debug a plug-In. When debugging a plug-in that executes while the client is offline, attach your debugger to the Microsoft.Crm.Application.Hoster.exe process on the computer where the client is executing.

See also

Plug-in Development
Supported messages and entities for plug-ins Write a plug-in