DBSync for Salesforce & Microsoft Dynamics GP Integration is an easy to use application to integrate Salesforce Accounts/Contacts, Products and Opportunity with GP Customers, Items and SOP Transactions respectively. DBSync is also useful in migrating historical GP data into Salesforce or vice versa. DBSync provides Bi-directional sync with pre-built field to field map along with flexibility for more complex and dynamic mapping capability.
Data flow of Bi-directional integration between Salesforce & Microsoft Dynamics GP is shown in the below table.
Process Map of Bi-directional integration between Salesforce & Microsoft Dynamics GP is shown in the below image.
Pre-requisites for Integration |
In order to ensure that DBSync is configured to integrate data between Salesforce and Microsoft Dynamics GP instance, the following should be ensured.
- Microsoft.net Framework 4.0 and above.
- eConnect Service Pre-Installed with your GP software.
- Setup and Configuration of eConnect Runtime Service for the Domain and User accessing GP database.
DBSync package (DBSync GreatPlains Integration) Installation in Salesforce |
- Once you click on the above link, you will get a prompt to enter Username and Password of Salesforce instance. Provide the necessary Salesforce credentials to proceed with the package installation. The Salesforce user installing the package should have the administrative privileges to proceed with the installation.
- Next you will see the Package Installation Details & Components. Click on Continue to Approve Package API Access, Choose Security Level and complete Installation.
- Verify if the package installation was completed successfully and check for the 'Deployed' status of the DBSync Invoices object.
- Go to Setup > Create > Custom Objects menu to verify if the "Invoices" object has Deployed status. If it is not, click edit button adjacent to the Invoice object, and mark Deployed as checked, and click on 'Save' button.
- Follow the next steps to include DBSync fields into Page Layout.
- Go to Setup > Customize > Account > Page Layout. Click on edit and drag 'GPCustomerID' field on the page layout. Save the Account Page Layout.
- Go to Setup > Customize > Contact > Page Layout. Click on edit and drag 'GPContactID', 'UniqueContactID' fields on the page layout. Save the Contact Page Layout.
- Go to Setup > Customize > Opportunities > Page Layout. Click on edit and drag 'DOC ID', 'Doc Number', 'GPTransaction', ' GPTransactionID',' TransactionType' and ' Primary Contact' fields on the Page Layout.
- Go to Setup > Customize > Opportunities > Opportunity Products. Click on edit and drag 'GP TransactionID' field on the Page Layout.
- Click on Related List and drag Invoices object to the Page Layout.
- Click on the setup icon on the Invoices object in the Related List Section and hit 'edit properties' button. Select columns Invoices, Invoice number, Total Invoice Amount, Payments, Balance, Days Outstanding, and Transaction Date.
- After completing the process of adding all the necessary fields to the Opportunity page layout, click on the Save button on the top left had corner of the Opportunity Page Layout window to commit all the changes.
- Go to Setup > Customize > Opportunities > Fields, and under Opportunity Custom Fields & Relationships section, click on New button to create a new custom field of Data Type "Auto Number" in Opportunity page layout with the following parameters.
- Field Label : Auto Doc Number
- Display Format : DBSYNC{000000}
- Starting Number : 1
- Field Name : Auto_Doc_Number
- Click on Next and make sure all the check boxes under Visible column are checked. Once done, click on Next and make sure Opportunity Layout is marked as checked on the subsequent page and click Save to commit all the changes.
- Go to Setup > Customize > Product > Page Layout to move 'GPProductID, 'Location Code, 'Product Type' and 'Unit Of Measurement', 'PriceLevel', 'Class ID' and 'Currency ID' field to the Product layout.
- At this point, you have successfully completed configuration of your Salesforce instance for integration with Microsoft Dynamics GP.
Install & Configure eConnect Proxy Service |
- In order to establish connection between DBSync application and Microsoft Dynamics GP, you will need to download the eConnect Proxy Service from the below location.
http://www.mydbsync.com/dbsync2download/currentrelease/gp2010/eConnectProxyService.zip
- Once the file is downloaded, extract the contents of the file to any desired download location.
Note: The extract of the file contains two versions of eConnect Proxy service, eConenctProxy.exe for GP 2010 and eConnectProxy12.exe for GP 2013x.
- Once the right version of the eConnectProxy file is extracted, install the eConnectProxy Service using windows installutil utility.
- If the eConenctProxy is extracted to location "c:\ep\eConnectProxy12.exe", then navigate to Microsoft.net framework location and run the following command from the elevated command prompt window on your windows or windows server operating system.
C:\Windows\Microsoft.NET\Framework\v4.0.30319> installutil c:\ep\eConnectProxy12.exe
|
- Once you run the command, you will see a message in the command prompt as shown below acknowledging that the service has installed successfully.
- If for some reason, the service was not successfully installed, you can verify the error log details in the file eConnectProxy12.InstallLog or eConnectProxy.InstallLog files.
Note: Following are some of the known issues working with installtuil utility for any file downloaded from the internet and resolution steps to avoid / prevent them.
- If you are getting an error with regards to file permissions, right click on the eConenctProxy.exe file and click on UnBlock as shown below.
- Go to www.mydbsync.com & register for Free Trial. Ensure that Source & Target Adapters are Salesforce & Microsoft Dynamics GP respectively.
It is necessary that on-premise version of DBSync is used for Salesforce and Microsoft Dynamics GP Integration. In order to use DBSync On Premise, DBSync should be installed locally and DBSync Account should be switched to On Premise from On Demand.
The process of installing DBSync is explained in the below link.
http://help2.mydbsync.com/docs1/display/dbsync/DBSync+On-Premise+Installation
The process of switching DBSync Account from On Demand to On Premise is explained in the below link
http://help2.mydbsync.com/docs1/display/dbsync/DBSync+On+Demand+to+On+Premise
DBSync Configuration with Salesforce & Microsoft Dynamics GP |
- Login into www.mydbsync.com with your Username & Password.
- Once logged in, click on My Home from the menu and click on Launch button.
- Once launched, you will be redirected to DBSync Project page in the next tab.
- Click on the project SalesforceGreatPlains:BiDirectional and then click on Connectors on the left panel.
- You will see Salesforce & GreatPlains Connectors.
- Click on GreatPlains Connector and enter the details as mentioned below.
For GreatPlains
eConnectPort : 18888
Datasource : DESKTOPUSERNAME\MSSQLSERVER
Database name : <<GreatPlains Company Database name >>
- Click on Save and Validate Connection to save and validate your GreatPlains adapter.
- Click on Salesforce Connector select the appropriate End Point under Quick Setup tab. Click on Connect to Salesforce. This will take you to Salesforce login page. Enter your username & password to login to Salesforce. Once you login to Salesforce, your Salesforce connector is connected to your Salesforce instance. If you want to connect using different Salesforce instance, click on Disconnect in Quick Setup tab. Then, connect using the required Salesforce credentials.
- You can also use Advanced Properties tab to connect to your Salesforce instance. Go to Advanced Properties, fill in the Salesforce Username, Password & Security Token for your Salesforce Instance. Select the appropriate End Point. Once you enter all the required details, click on Validate Connection. If the validation is successful, click on Save to Save the Salesforce details. If the validation fails, you will see Validation Errors on the top right corner. Refer the details in Validation Errors section and make the necessary changes in Advanced Properties and click on Validate Connection again.
DBSync integration for Salesforce & Microsoft Dynamics GP can be run automatically using Scheduler or manually using the Run Button.
The detailed process of using Scheduler to run the integration is shown in the below wiki link.
http://help2.mydbsync.com/docs1/display/dbsync/Scheduler
Using the Run button to run the integration manually is explained below.
- Login into www.mydbsync.com with your Username & Password.
- Once logged in, click on My Home from the menu and click on Launch button.
- Once launched, you will be redirected to DBSync Project page in the next tab.
- Click on the project SalesforceGreatPlains:BiDirectional and then click on Connectors on the left panel.
- Upon successful validation of your connectors, you can click on Processes on the side panel. Click on the Run Now button available there.