crm to exchange synchronization - brite...
Post on 04-Jul-2020
4 Views
Preview:
TRANSCRIPT
CRM to Exchange Synchronization
Installation, Configuration and End-User Instructions
VERSION 1.0
DATE PREPARED: 9/1/2012
DEVELOPMENT: BRITE GLOBAL, INC.
2012 Brite Global, Incorporated. All rights reserved.
The information contained in this document represents the current view of Brite Global, Incorporated on the issues discussed
as of the date of preparation. Because Brite Global must respond to changing market conditions, it should not be interpreted to
be a commitment on the part of Brite Global, and Brite Global cannot guarantee the accuracy of any information presented
after the date of publication.
This document is for informational purposes only. BRITE GLOBAL MAKES NO WARRANTIES, EXPRESS, IMPLIED, OR
STATUTORY, IN THIS DOCUMENT.
Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no
part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any
means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written
permission of Brite Global, Incorporated.
Brite Global may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering
subject matter in this document. Except as expressly provided in any written license agreement from Brite Global, the
furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual
property.
Brite Global, Incorporated • 269 South Beverly Drive, #115• Beverly Hills, CA 90212 • USA
CONTENTS
Introduction ..........................................................................................................................................................................4
About Brite Global ............................................................................................................................................................4
CRM Configuration ..............................................................................................................................................................5
Entity Fields .......................................................................................................................................................................5
Form Configuration ..........................................................................................................................................................5
Dynamic Marketing List Requirements..........................................................................................................................5
Installation .............................................................................................................................................................................6
Prerequisites......................................................................................................................................................................6
Installation Process ..........................................................................................................................................................6
First Time Configuration ......................................................................................................................................................8
Choose Product Version ..................................................................................................................................................8
Personal Information .......................................................................................................................................................9
CRM Server Information ................................................................................................................................................10
Exchange Server Information ........................................................................................................................................12
Active Directory Login Information ..............................................................................................................................13
Running the Application ....................................................................................................................................................14
Adding List to Synchronize ...........................................................................................................................................14
Connecting to New Exchange Distribution Groups ...............................................................................................15
Connecting to Existing Exchange Distribution Groups ..........................................................................................15
Verifying the Exchange Distribution Groups Were Created .................................................................................15
Running the Synchronization Process .........................................................................................................................16
Verifying the Synchronization Process Results .......................................................................................................16
Removing or Deactivating List to Synchronize ...........................................................................................................17
Modifying the Application Settings .............................................................................................................................18
Exchange Settings ......................................................................................................................................................18
CRM Settings ..............................................................................................................................................................18
Registration .................................................................................................................................................................19
Exporting of Log Files ....................................................................................................................................................19
INTRODUCTION
The CRM to Exchange Synchronization is a Windows Forms application that communicates between Microsoft
Dynamics CRM and Exchange Server in order to Synchronize between the members of CRM Marketing Lists
and Distribution Lists that exist on the Exchange Server.
The application verifies the same members exist in both location, and modifies or adds information to the
Exchange Server based on changes in Microsoft Dynamics CRM.
This process enables sending e-mail via Microsoft Outlook/Exchange to the most updated lists of users and
contacts in Exchange.
ABOUT BRITE GLOBAL
Established in 2005, Brite Global is a leader in delivering
Microsoft Dynamics CRM and xRM solutions to business
customers. As a Microsoft Gold Certified Partner, Brite
Global has an impressive and rapidly growing list of
customers benefiting from Microsoft Dynamics CRM
solutions. We have embraced the Power of Choice by
providing our customers the choice of a hosted, on-
premises or hybrid delivery options.
Headquartered in Beverly Hills, CA with offices in Atlanta, GA and Europe, Brite Global provides CRM and
software solutions to business in multiple industries including Public Sector and Education, Financial Services,
Real Estate, Media and Entertainment, Not for Profit, Retail and Manufacturing, Sports and Recreation, and
Professional Services. For more information, visit www.briteglobal.com.
CRM CONFIGURATION
The following section details the required CRM changes necessary in order to successfully run the application.
These modifications can be done manually in the Customizations section of CRM or available via a Managed
Solution and can be imported into CRM.
ENTITY FIELDS
The table below lists the fields that are required in order to successfully run the Synchronization application.
These fields will hold the values of the Names of the Exchange Lists that will be synchronized with CRM as well
as whether or not the current list will be run in the next Synchronization Process.
Display Name Field Name Data Type Format Default Values
Exchange Distribution List Name xrm_exchangedlname Single Line of
Text Text (100)
Exchange Distribution List Status xrm_exchangedlstatus Two Options
Active = 1
Inactive = 0
Default Value = Inactive
FORM CONFIGURATION
After fields were added to the entity, that can be added to the form, but this is not a required practice. If they
are added to the form, the should be set to read-only fields so that no modifications will be done to them
directly from within the CRM environment.
DYNAMIC MARKETING LIST REQUIREMENTS
When creating Dynamic Marketing lists that have to be synchronized against CRM, there are a few column
requirements from the list. These requirements allow the synchronization of not only the name and email
address of the contact but additional fields that exist in CRM.
The following fields are required to be part of the Marketing List when creating Dynamic Queries:
First Name, Last Name, Full Name, Telephone 1, Email Address 1, Job Title, State Code
INSTALLATION
This section describes the installation process of the CRM to Exchange Sync application. The installation is very
straight forward, but make sure that the prerequisites below are completed.
PREREQUISITES
The following are the required prerequisites for the installation and execution of the CRM to Exchange
Synchronization Application:
EXCHANGE MANAGEMENT CONSOLE
Exchange Management Console must be installed on the Server or Workstation where this application will be
installed. This application does not have to be installed on the actual Exchange Server.
MICROSOFT.NET FRAMEWORK
The Microsoft .NET Framework version 4.0 must be installed on the machine that will be running the
application. The application utilizes several CRM assemblies that require this version of the .NET Framework.
The .NET Framework is not included in the setup package, so make sure to install it manually before running
Setup.
INSTALLATION PROCESS
To Start the installation process, unzip the provided file, and run the CRMExchangeSyncInstaller.exe Setup
Application.
Follow the instructions and provide the required information on the following screens:
Read and accept the End User License Agreement and enter the User Name and Organization that is installing
this product.
Click on the Install button to start the Installation.
Once the installation is complete, you will see the InstallShield Wizard Complete screen. Click Finish on the
Page. On your desktop you should not see the CRM to Exchange Sync icon, which will allow you to start the
application and configuration process.
FIRST TIME CONFIGURATION
When the application is run for the very first time various configuration settings have to be set in order to be
able to connect to both the CRM and Exchange Server from within the application. The table below contains a
list of all the information that will be required, as displayed in the subsections below.
Make sure that you have all the information available before running the application, as the configuration/
registration process will not be able to complete if information is missing, and the application will fail.
Screen Name Field Name Required Description
Serial Number Serial Number No
The Serial Number for the
Product. The Serial Number is not
required for running the trial
version of the Product.
Personal Information Company Name Not in Trial
Organization Name that
Purchased the Product. Not
required for Trial Version.
Personal Information First Name Not in Trial
First Name of person that
Purchased the Product. Not
required for Trial Version.
Personal Information Last Name Not in Trial
Last Name of person that
Purchased the Product. Not
required for Trial Version.
Personal Information Email Address Not in Trial
Email Address of person that
Purchased the Product. Not
required for Trial Version.
Personal Information Business Phone Number Not in Trial
Phone Number of person that
Purchased the Product. Not
required for Trial Version.
CRM Server Information CRM Server Service Url Yes The Url of the CRM WCF Service.
Exchange Server Information Exchange Server Name Yes
The Url of the Exchange Server. Do
not include http or https as part of
the url
Exchange Server Information Distribution List Organizational Unit Yes
The Organizational Unit where
new Distributions Lists will be
created.
Exchange Server Information Contacts Organizational Unit Yes The Organizational Unit where
new Contacts will be created.
Authentication Information Domain Username Yes
The Domain Username with
Access to Exchange Management
Console. Username will include
Domain Name and User Logon
Name.
Authentication Information Password Yes Password of User Domain Account
Authentication Information Confirm Password Yes Password of User Domain Account
CHOOSE PRODUCT VERSION
Choose whether the product you are installing is a trial version or a purchased version of the product.
If you are installing the trial version, leave the serial number field blank, either wise enter the serial number in
the required field.
PERSONAL INFORMATION
The personal information section is only required for Purchased Products. All fields on the personal information
section are required.
If no serial number was entered in the Serial Number screen, this Personal Information screen will not display.
CRM SERVER INFORMATION
The CRM Server Service Url is required in order to connect your application to the CRM Server and query your
list and contact entities. Enter the CRM Server Service Url in the following screen.
The Url is made out of the Server Name, Port, Organization name and finalized with the Organization Service
WCF Service file: XRMServices/2011/Organization.svc
EXCHANGE SERVER INFORMATION
In order to properly connect with Exchange Server and place the Distribution Lists and Contacts in the proper
locations, the Exchange Server name, Distribution Lists Organizational Unit and Contacts Organizational Unit
are required.
The screenshot below shows this required information
ACTIVE DIRECTORY LOGIN INFORMATION
In order to properly connect with Exchange Server a user account with full Access to the Exchange
Management Console is required. The final screenshot displays these requirements.
RUNNING THE APPLICATION
After the configuration has been completed and successful, the application will restart and the following screen
will be displayed. If there were errors during the configuration that do not allow the application to run
properly, a message will be displayed to the user and the application will close.
In order to create a Synchronization Process, we will need to create the relationship between the CRM
Marketing Lists and Exchange Server distribution Groups. Clicking on the Add New Group in the ribbon will
open the Add New List form and allow creating the relationship between CRM and Exchange.
The section below will explain how this is done.
ADDING LIST TO SYNCHRONIZE
When we open the Add New List form, we require
to select the name of a CRM Marketing List and an
Exchange Server Distribution Group.
If an Exchange Server Distribution Group does not
exist for the marketing list that we want to
Synchronize, we can create a New Distribution
Group for the Add New List form.
CONNECTING TO NEW EXCHANGE DISTRIBUTION GROUPS
If your Exchange Server does not have the distribution list that you want to synchronize with, when creating the
relationship between both systems, you can create the new distribution list from within the CRM to Exchange
Sync app.
Select the Name of the CRM Marketing List in
the Select CRM Group area of the form.
Click on the New button on the Select
Exchange Distribution List area of the form,
and type the name that you would like to
create for the new Distribution List.
When you save the record, a new Distribution
List will be created in Exchange and the
relationship between CRM and Exchange will
be created.
CONNECTING TO EXISTING EXCHANGE DISTRIBUTION GROUPS
If the Exchange Server already has the
Distribution List that you would like to create
the relationship with, you can simply select it
from the names of Existing Lists.
Select the Name of the CRM Marketing List in
the Select CRM Group area of the form.
Do not click on the New button on the Select
Exchange Distribution List area of the form, just
select the name of the Distribution List that you
would like to use.
When you save the record the relationship
between CRM and Exchange will be created.
VERIFYING THE EXCHANGE DISTRIBUTION GROUPS WERE CREATED
After you have added your new Distribution Groups in Exchange, you can open up Exchange Management
Console to verify that the Distribution Groups were successfully created.
RUNNING THE SYNCHRONIZATION PROCESS
After each time that you create a new relationship between CRM and Exchange the new Group will be added to
the list of Groups to be synchronized. Groups can be later on removed or disabled, so that not all the groups
will be included in the synchronization process.
In order to start the Synchronization Process, simple click on the Run Synchronization ribbon button. Upon
confirmation that you want to run the Synchronization, the process will commence.
The status bar at the button of the screen will show progress of each of the groups that is to be synchronized.
Once the Synchronization is complete, the status bar will show the Completed Sync message in blue stating
that you can verify the Synchronization results.
VERIFYING THE SYNCHRONIZATION PROCESS RESULTS
After the Synchronization process has been completed, you can compare the results between CRM and
Exchange Server to make sure that there are the same number of contacts under each list.
The screenshot below shows an example of the CRM Marketing List view and the Distribution Group View in
Exchange, both containing the same 13 users.
REMOVING OR DEACTIVATING LIST TO SYNCHRONIZE
If there is a list that you have in CRM that you would no longer be using for synchronization, you can remove it
from the Synchronization process by selecting the row in the grid of the application and clicking on the
Remove Group ribbon button. Clicking on the Remove Group will not delete the list from either CRM nor
Exchange Server, it will just remove the association (relationship) between both applications.
If you would like to temporarily cancel the association between CRM and Exchange, follow the same procedure,
but click on the Change Status ribbon button and select the Disable menu item from the list.
If you would like to later reactivate the list for a later run, follow the same procedure, but instead of choosing
the Disable menu item, choose the enable menu item.
Each record on the grid has a checkbox that is either Active or Inactive.
MODIFYING THE APPLICATION SETTINGS
After the initial configuration of the application, it is possible that some of the configuration settings might
change. This includes Exchange Server Configuration, CRM Server Configuration and Registration of the
product (activating a trial version of the product).
Clicking on the File Menu will allow the user to modify these results.
EXCHANGE SETTINGS
The Screenshot below shows the Exchange Settings that can be modified after the application has been initially
installed. This would be necessary if your Exchange Server has moved to another server or you need to change
the Organizational Unit where the Distribution List or Contacts will be stored.
CRM SETTINGS
The screenshot bellow shows the CRM Settings that can be modified. You will notice that only the CRM WCF
Service Url can be modified, as the User and Password are the current logged in user which will authenticate
against CRM.
REGISTRATION
The automated Registration Process is not available at this point.
EXPORTING OF LOG FILES
After your synchronization process has been completed you can export a log file containing a list of all the
contacts that were created and actions that were performed in Exchange on these Contacts.
The log file is stored in the C:\logs directory. If the directory does not already exist, it will be created for you.
Based on the security settings within, your environment you should allow files to be created in that directory.
To Export the log file click on the Export Log ribbon button showed below.
Although not required, it is a good practice to clear the log file after each Synchronization Process, although
CRM will automatically clear it the next time the application is run.
top related