Managing the Veeva CRM Desktop for Mac
Users can install the app, sign in, and manage app updates. Ensure software requirements are satisfied and all appropriate VMOCs are configured to use the app.
Installing the App
Users can download the app installer directly or perform the following steps:
- Launch the media library from a call report.
- Select download & run Veeva CRM Desktop.
- Launch the downloaded DMG file.
- Move the app to the Applications folder.
- Move the DMG file to the Trash after the app is installed.
Users can launch the Veeva CRM Desktop app from the desktop icon and sign in with their Veeva CRM credentials. After signing in, the app remains running in the background and accessible from the app icon in the system tray even after ending a call or closing the window, and even if the user did not launch the app from a call. When the app window is closed, double-select the icon to reopen the app.
When using Engage meeting with Veeva CRM Desktop for Mac for the first time, users must grant screen recording permission. See Granting Screen Recording Permission for CRM Desktop (Mac) for more information.
When switching between users, perform the following best practices to avoid errors:
- Sign out of the app and all Salesforce tabs in open browser windows
- Use the same browser across all users
- Ensure the user displayed on the authentication page matches the user whose credentials were used to sign in
Updating the App
The app checks for version updates every time it is launched, a user successfully signs in, and after every full sync. Full syncs occur:
- When a user successfully signs in
- When a user performs a manual sync
- When updates to records for the following objects are detected online:
App updates can be optional or required.
When users are not in a call or an event, an update alert displays when there is an app version update. If the app window is minimized or closed when there is an update, the window automatically reopens and displays in the foreground.
When users are in a call or an event, app update alerts for optional and required app updates do not display until the call or event ends.
If the update is optional, users can:
- Initiate call mode or join a call to hide the alert until the call ends
- Select Update Now to update the app immediately. The app quits and automatically relaunches after the update completes. Users do not need to sign in again. Any unsynced CLM tracking data is saved and syncs after the app relaunches.
- Select Update Later to update the app at a later time. The Update Now button in the media library menu and tray icon menu becomes available. When users are ready to update the app, select Update from either menu.
If the app update is required, select Update Now to update the app immediately. The app quits and automatically relaunches after the update completes. Users do not need to sign in again. Any unsynced CLM tracking data is saved and syncs after the app relaunches.
The first time a user signs in to the app, a full sync occurs to sync all of the content in the media library. The app runs an incremental sync for every subsequent signin. An incremental sync updates records for the following objects:
- Call2_Detail_vod – Metadata Only
- Call2_Key_Message_vod – Metadata Only
- Call2_vod – Metadata Only
- Multichannel_Activity_Line_vod – Metadata Only
- Multichannel_Activity_vod – Metadata Only
- Multichannel_Consent_vod – Metadata Only
Incremental syncs are also triggered by updates to any of the following fields:
The maximum frequency incremental syncs can be run is every five minutes. Users can override the five-minute waiting period by performing a manual full sync.