Sync Volunteer Data with Bloomerang

Use Bloomerang Volunteer to turn on automatic syncing or to start a manual sync. You can also verify that a sync completed successfully.

In this article:

Set Priority System

Select which system takes priority if a data conflict happens after a two-way sync. The information from the priority system is what is used in both systems. Options are:

  • Date last modified — The record with the most recent changes takes priority.
  • Bloomerang Volunteer — The record in Bloomerang Volunteer takes priority.
  • Bloomerang Donor — The record in Bloomerang Donor takes priority.

In these scenarios, the sync must prioritize one system over the other. That may differ from the priority system you chose.

  • Scenario 1 — A newly created constituent is added to the Volunteer Group in Bloomerang when a constituent email and a volunteer email match.
  • Scenario 2 — A newly created volunteer is added to the connected Bloomerang Volunteer organization when a volunteer email and a constituent email match.

Tip: Organization Managers receive email and bell notifications when the system resolves a data conflict. See Enable or Disable Sync Notifications to change settings.

Include or Exclude New Volunteers in Syncs

Before you turn on automatic syncing or start a manual sync, decide whether to:

  • Automatically sync all new volunteers and volunteers
  • Automatically sync only some new volunteers

New volunteers include volunteers who you manually add or import, or who sign up themselves.

When you sync volunteers, Bloomerang donor management adds the volunteers as constituents. By default, new volunteers do not automatically sync from Bloomerang Volunteer to Bloomerang donor management. You can change this setting.

Automatically Sync All New Volunteers

To automatically sync all new volunteers:
  1. Select My Organizations icon_home
  2. Select your organization.
  3. Select Integrations
  4. On the Bloomerang Donor tile, click Edit Settings. 
    integrations_blooomerangdonor_connected 
  5. Turn on Default Sync Status of New Users
    integrations_bloomerangdonor_default_sync

After you turn on Default Sync Status of New Users:

  • All new volunteers added after you turn on this setting are included in syncs, except for individual volunteers who you manually exclude.
  • For each volunteer, the Sync Status is Included. 
  • After the next sync, the Bloomerang Donor - Last Sync status changes to Synced, and the Bloomerang Donor - Account Number shows the Bloomerang account number.

If you turn off Default Sync Status of New Users:

  • All new volunteers added after you turn off this setting are excluded from syncs, except for individual volunteers who you manually include.
  • For each volunteer, the Sync Status is Excluded.
  • For volunteers who have never synced, Bloomerang Donor - Last Sync is Unsynced, and Bloomerang Donor - Account Number is Not Available.

Automatically Sync Only Some New Volunteers

You can select individual volunteers to include or exclude in syncs.

For example, you might decide to turn on Default Sync Status of New Users, but manually exclude some volunteers from the sync.

Or, you might keep the Default Sync Status of New Users setting off, but manually include some volunteers in the sync.

To automatically sync only some new volunteers:
  1. Select My Organizations icon_home
  2. Select your organization.
  3. Select Volunteers.
  4. To open a volunteer record, click the volunteer’s name.
  5. Click Profile Details.
  6. To include this volunteer in syncs, change the Sync Status to Included
    vms_org_staff_profile_bd_sync
  7. To exclude this volunteer from syncs, change the Sync Status to Excluded.

View the Sync Status for Volunteers

On the volunteer list, you can view the sync status for each volunteer. By default, these columns appear in the volunteer list:

  • Sync Status: Included or Excluded
  • Account Number
  • Last Sync Date
  • Last Sync Time

You can add more filters to view a list of volunteers  who:

  • Synced on, before, after, between certain dates
  • Have synced
  • Have never synced
  • Are included or excluded from syncs
  • Are no longer mapped to syncs

You can also export the list.

To view the sync status for volunteers:

  1. Select My Organizations icon_home.
  2. Select your organization.
  3. Select Volunteers.
    Bloomerang Donor filters appear in the volunteer list.
    staff_bloomerangdonor
  4. To add filters, select Filters icon_filter.
  5. Select Integration Filters: Bloomerang Donor.
  6. Select Last Sync Date/Time. 
    staff_filters_integration-1
  7. Select an option.
    staff_filter_last_sync-1
  8. Click Filter.
  9. When asked if you would like to display the matching columns, select Yes.
    Bloomerang Donor filters appear in the volunteer list.
  10. Select Sync Status.
  11. Select one of these options:
    • Is included in the sync to Bloomerang Donor
    • Is excluded from the sync to Bloomerang Donor
    • Is no longer mapped in the sync to Bloomerang Donor
      To understand and resolve what causes volunteers to no longer sync, see Bloomerang Donor Integration
  12. Click Filter.
  13. When asked if you would like to display the matching columns, select Yes.
  14. To view the volunteer list, click the X symbol in the upper right.
  15. On the volunteer list, scroll right to view the Bloomerang Donor filters.
    staff_bloomerangdonor_filters

Automatically Sync Data

We recommend that you turn on automatic syncing. It saves you time and makes sure you don’t forget to sync new data. When you turn on automatic syncing, the sync runs automatically once every hour. 

To automatically sync data, in Bloomerang Volunteer:

  1. Select My Organizations icon_home
  2. Select your organization.
  3. Select Integrations.
  4. On the Bloomerang Donor tile, click Edit Settings.
    integrations_blooomerangdonor_connected
  5. Turn On Automatic Syncing.
    The sync runs automatically once every hour. The sync might take some time to complete.
    integrations_bloomerangdonor_auto_sync

Manually Sync Data

If you turn on automatic syncing, you can still select to manually sync. You might manually sync if you need to sync data immediately, before the next scheduled automatic sync. A manual sync performs the same operations as an automatic sync.

A manual sync does not affect automatic syncs, which continue to run after a manual sync. During the next automatic sync, only records that were created, modified, or deleted since the manual sync are included in the automatic sync. 

To manually sync data:

  1. Select My Organizations icon_home
  2. Select your organization.
  3. Select Integrations.
  4. On the Bloomerang Donor tile, click Edit Settings.
  5. Select one of these sync options:
    • Sync Now: Sync only constituent or volunteer information that changed since the last sync. This is the fastest option.
      integrations_bloomerangdonor_manual_sync
    • Resynchronize:  Sync all constituent and volunteer information, regardless of whether it changed since the last sync. You might do this if you notice that data in Bloomerang Volunteer and Bloomerang donor management doesn't match.

Verify a Data Sync in Bloomerang Volunteer

After a data sync, you can view the results in Bloomerang Volunteer and Bloomerang donor management. To understand which data syncs between systems, see Bloomerang Integration.  

To verify a data sync in Bloomerang Volunteer:

  1. Select My Organizations icon_home
  2. Select your organization.
  3. Select Volunteers. Constituents synced from Bloomerang appear as new volunteers in the list.
  4. Select a volunteer. Constituent information synced from Bloomerang appears in the volunteer record.

To view a complete record of the sync, view a log summary or download a .CSV log file. You might do this to troubleshoot an issue. For information about logs, see View Bloomerang Donor Logs.

Verify a Data Sync in Bloomerang

To verify a data sync in Bloomerang donor management, see View Data Synced from Bloomerang Volunteer in the Bloomerang Knowledge Base.

Enable or Disable Sync Notifications

To keep you informed when the system resolves a data conflict during sync, Bloomerang Volunteer sends notifications to Organization Managers. Bell and email notifications are turned on by default.

To enable or disable notifications:

  1. Select My Organizations My Organizations icon
  2. Select your organization.
  3. Select General Settings.
  4. Select Notification Settings.
  5. In the Bloomerang Donor Notifications section, turn on or turn off notifications:
    • Sync Status — Notifies you when the system detects duplicate constituents and successfully syncs from Bloomerang Volunteer to Bloomerang Donor.
    • Remap Status — Notifies you when Volunteers are no longer mapped in the sync.

Related