You are viewing an old version of this page. View the current version.
Compare with Current
View Page History
« Previous
Version 24
Next »
Overview
Data Flow
Process Map
Pre-requisites for Integration
DBSync package (DBSync GreatPlains Integration) Installation in Salesforce
Install & Configure eConnect Proxy Service
DBSync Profile Setup
DBSync Installation
DBSync Configuration with Salesforce & Microsoft Dynamics GP
Running the integration
Overview
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
Data flow of Bi-directional integration between Salesforce & Microsoft Dynamics GP is shown in the below table.
![](/docs/download/attachments/4522045/worddav36989f802ed823b2f89c1bed1ba4b077.png?version=1&modificationDate=1411253570000&api=v2)
Process Map
Process Map of Bi-directional integration between Salesforce & Microsoft Dynamics GP is shown in the below image.
![](/docs/download/attachments/4522045/worddav7ca604142476a43dd68a01b820db6332.png?version=1&modificationDate=1411253570000&api=v2)
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.
- 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.
![](/docs/download/attachments/4522045/eConnect_log.png?version=1&modificationDate=1430165641000&api=v2)
- 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.
![](/docs/download/attachments/4522045/win7-unblock.jpg?version=1&modificationDate=1430168833000&api=v2)
DBSync Profile Setup
- Go to www.mydbsync.com & register for Free Trial. Ensure that Source & Target Adapters are Salesforce & Microsoft Dynamics GP respectively.
DBSync Installation
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 as show.
- 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.
Running the integration
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://help.mydbsync.com/docs/display/dbsync/Scheduler
Using the Run button to run the integration manually is explained below.
- Upon successful validation of your adapters, you can proceed to the Process Builder console either by double-clicking on the PDL on the right-hand column of DBSync console or by right-clicking and selecting the option Open. The below screenshot illustrates the same.
![](/docs/download/attachments/4522045/worddav0ce43e8dd86ed9aefa9176dbe02cd5d4.png?version=1&modificationDate=1411253574000&api=v2)
- The process builder page opens up. Before you can initiate the integration, select the Log level as All from the drop down and click Save button as highlighted in the below screenshot. Now click on Run button to start the integration process.
![](/docs/download/attachments/4522045/worddav18dadb38c69e15604d72511772f1650d.png?version=1&modificationDate=1411253575000&api=v2)
- The various boxes with connection established between each one of them are referred to as "STATES" or "WORKFLOWS". Each of these workflows can be activated or de-activated based on the requirement. These workflow rules can be activated by having their respective checkboxes checked.
![](/docs/download/attachments/4522045/worddav6b845596afbc52b0c0e9ae0ee076f515.png?version=1&modificationDate=1411253575000&api=v2)
- Once you have activated the necessary WORKFLOWS, click on the save button to save the configuration before initiating the integration Process.
SalesforceGreatPlains:BiDirectional |