Giter Club home page Giter Club logo

bcmmigrationassistant's Introduction

(You can also view this on the blog for Eric Legault Consulting Inc./Rockin' Software at http://www.ericlegaultconsulting.com/blog/?p=3044)

BCM Migration Assistant

The Business Contact Manager (BCM) Migration Assistant tool automates migration of business contacts, accounts, and opportunities to Outlook Customer Manager (OCM).

Key features of the BCM Migration Tool:

  • Migrates default business contacts, accounts, and opportunity fields to the equivalent Outlook Customer Manager fields
  • Ability to map default and CUSTOM BCM fields to Outlook Customer Manager fields
  • Automatically migrates BCM opportunity stages and creates new Outlook Customer Manager deal stages
  • Migrates Business Notes and Phone Log history to Outlook Customer Manager's activity timeline
  • Automatically links imported Contacts to Companies, and Deals to Companies and Contacts

overview

FAQ

Q: Do I need Outlook 2016 or the Outlook Customer Manager add-in installed to use the tool?

A: No. You just need to login with the tool using an Office 365 account in a subscription that has Outlook Customer Manager enabled.

Q: Do I need to run the tool on a PC with BCM installed or on the BCM server?

A: No. You can run the tool on any PC that has access to the BCM database on your network while logged into Windows as an authorized BCM user.

Q: Will the tool create duplicates of existing items or will it update them?

A: If an OCM Company or Contact exists with the same Display Name value in the equivalent BCM Account or Contact Full Name field, they will be UPDATED. The relevant fields will be updated with non-empty values from BCM

NOTE: Existing Deals are currently NOT being updated. You may wish to subscribe to the relevant issue to be notified when this logic changes.

Q: What happens if I run the migration again?

A: Previously imported items will NOT be updated, but existing items will be updated again if changes have been made in BCM.

Q: Is the tool free?

A: Yes. However, the tool is currently registered as an Office 365 application associated with Eric Legault Consulting Inc./Rockin' Software and hosted in that company's Office 365 tenant. This application will only work in its current state as long as it continues to be hosted in that tenant but there are no guarantees that the application will continue to work due to unforeseen circumstances with the application registration or the Office 365 subscription, or that it will continue to be available for installation from the URL published below. The code can always be changed to use a different application and tenant ID for a different Office 365 account, or compiled and distributed through other means.

Custom Migration Services

If you would like the migration to be done for you, or customized to accommodate special business scenarios or to export to a different data format, please contact Rockin' Software by email, web form or book an appointment online.

To start the migration, please use the following steps:

1. Install the BCM Migration Assistant tool

From the BCM machine (or the machine that host the SQL database for BCM), download and install the tool from https://www.ericlegaultconsulting.com/BCM_Migration_Tool/publish.htm

install

2. Connect to the BCM database

By default, the tool is configured to use the local SQL server name. If you are not sure of your BCM database info, please open Outlook and navigate to File > Business Contact Manager and look for "Manage Database" section below. For example:

If the BCM database name is "OCM10\MSSmallBusiness3", then use the following value in the tool:

SQL Server: OCM10\MSSMLBIZ

Database Name: MSSmallBusiness3

configure

After you check the information, click "Test Database Connection" before continuing.

3. Connect to Outlook Customer Manager

We recommend that you test the migration with a test Outlook Customer Manager account before running the tool while signed into your actual Office 365 production account. Outlook Customer Manager does not provide a functionality to delete migrated data, and you need to delete every migrated item manually in case you need to redo the migration.

To create a test account, you can sign up for a 30 day Office 365 Business Premium trial from https://go.microsoft.com/fwlink/p/?LinkID=507653 (please note that after you created an Office 365 account, it may take another 24 hours before Outlook Customer Manager appears on the test account).

After you are connected to the database, click the "Login to Office 365" label in the "Connect to Outlook Customer Manager" section and enter your O365 account email to connect when prompted. After you are connected, the account name will be displayed on the upper right corner.

connect

4. Map BCM fields to Outlook Customer Manager fields

For each entity type (Accounts, Business Contacts, and Opportunities), some of the default BCM fields are automatically mapped to default Outlook Customer Manager fields.

Optionally, you may map additional fields to Outlook Customer Manager custom fields (note: you will need to create the custom field before you run the tool (refer to this page for information on how to add custom fields in Outlook Customer Manager).

For example, see below if you want to map BCM's DoNotCall field (left column) to a custom field of the same name in Outlook Customer Manager (right column):

map

5. Migrate to Outlook Customer Manager

Click "Start" to begin the migration:

migrate

Review the migration reports for any errors during the migration.

bcmmigrationassistant's People

Stargazers

 avatar  avatar  avatar

Watchers

 avatar  avatar

Forkers

joshbooker

bcmmigrationassistant's Issues

Cannot Import Contacts

When getting to the import contact, the application identifies there are BCM contacts but does not import them.

<MigrateBusinessContacts>d__38.MoveNext��Ťù‹;Õ� �ContactsHelper�Found 4421 BCM Contacts:P ú®w�Œ;Õ�@&<RunGetOCMContactsAsync>d__30.MoveNext� ðÇÛ�Œ;Õ�� �'<MigrateBusinessContacts>d__38.MoveNext�Total contacts: 0P ÿv*�Œ;Õ�@�<FindPeople>d__21.MoveNext��üë^�Œ;Õ� €�FindPeople (offset: 0): <?xml version="1.0" encoding="utf-8"?><s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"><s:Header><h:ServerVersionInfo MajorVersion="15" MinorVersion="20" MajorBuildNumber="282" MinorBuildNumber="12" Version="V2017_11_14" xmlns:h="http://schemas.microsoft.com/exchange/services/2006/types" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/></s:Header><s:Body><FindPeopleResponse ResponseClass="Success" xmlns="http://schemas.microsoft.com/exchange/services/2006/messages" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"><ResponseCode>NoError</ResponseCode><People/><TotalNumberOfPeopleInView>0</TotalNumberOfPeopleInView><FirstMatchingRowIndex>-1</FirstMatchingRowIndex><FirstLoadedRowIndex>0</FirstLoadedRowIndex></FindPeopleResponse></s:Body></s:Envelope>��pNa�Œ;Õ�@@��ActivitiesHelper&<CreateContactActivities>d__4.MoveNext� Å°c�Œ;Õ�@��ContactsHelper"<CreateCompanyLinks>d__19.MoveNext����Linking 0 contacts� ��f�Œ;Õ� 0 contacts processed for linking€�@€��MigrationAssistant'<MigrateBusinessContacts>

Beta API Docs?

Hi Eric,

Great tool! How did you find documentation on the Outlook beta API for OCM?

Is there any docs on the /XrmXXX endpoints? and the extended properties required by OCM?

Thanks in advance.

Josh

Existing Deals are not updated

This may be addressed in a future build once we are able to add a custom property to a Deal to store the BCM ID for the related opportunity. This allows us to differentiate between existing and previously imported items, which does occur for Companies and Contacts are those entities are updated if they exist.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.