View source | Discuss this page | Page history | Printable version   
Toolbox
Main Page
Upload file
What links here
Recent changes
Help

PDF Books
Add page
Show collection (0 pages)
Collections help

Search

How to create an integration using CRM connector

Bulbgraph.png   This feature is available starting from 3.0PR20Q3.

Contents

Introduction

This documents describes how to create an integration with an external system using the new feature CRM Connector available in 20Q3.

To do that we will use this gitlab repository as a base

Different approaches to implement an integration with CRM

There are 2 different ways to implement an integration with CRM system. Below we analyze both.

CRMConnector approaches.jpg

Web Service integration

It is the recommended one because Openbravo server is removed from the equation whne communication with the CRM system happens. It is important to ensure that CRM server should support [CORS https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS] headers to allow cross-domain communication.

Use Openbravo as a proxy

In that case, all the request to the CRM API will pass through Openbravo Server. This is interesting in case that your integration does not allow CORS or if you need to generate data in openbravo or manipulate the data received by CRM API. However, using this approach, Openbravo Server will require more resources, that's why it is recommended to prioritize "Web Server" approach

Integration Module Source Code

Sample module implements the 2 approaches explained above, however we will focus in this case in proxy one because Openbravo Server acts as a external Web Service build inside Openbravo. This is a good introduction for both approaches.

Component provider implementation

Since a relevant part of CRM integration is written in javascript, a component provider should be created to inject into Openbravo Web POS source code the files that are part of this module.

Here you can check the component provider.

In the case of that module 3 javascript files and 1 css are added

Dataset

A dataset with all the information ready to be imported to window "CRM Configuration Window" is part of this module. We recommend to use a dataset to store this information. Doing that tasks like import/export API configuration will be easier and secure.

Here you have more details about how to create a dataset and how to import a dataset

To continue with this how-to it is needed to import the dataset which is already included in this module. (If your instance was created using Openbravo Sample data for modules this step is not required)

After applying the dataset at client level (*) using Enterprise_module_management window you should be able to see the data in "CRM Connector Configuration" window (see image below)


CRM Connector Configuration window with a configuration example

The final configuration step is to enable and define the CRM connector in the Client definition. This is done inside the Client's Information tab.

CRM Connector enabled for the client

CRM connector javascript API

To implement your custom CRM integration the class ExternalBusinessPartnerRepository should be extended

 
class SampleBpIntegrationProxy extends OB.App.Class
  .ExternalBusinessPartnerRepository {

There are some methods that can be (or not, depending on CRM needs) implemented.

Basic CRUD operations

Bulbgraph.png  

In this module, an ajax call was implemented to retrieve an object from CRM API. Check code here

Bulbgraph.png   In this module, an ajax call was implemented to retrieve an array of results from CRM API. Check code here
Bulbgraph.png   In this module, an ajax call was implemented to send the Object to the CRM API and create the new customer. Check code here
Bulbgraph.png   In this module, an ajax call was implemented to send the Object to the CRM API and update the customer. Check code here
Bulbgraph.png   In this module, an ajax call was implemented to retrieve from API the defaukt values to be shown in the form when a customer is going to be created. Check code here

User interaction operations

Bulbgraph.png   In this module, this method was implemented to show in the UI properties based on the value inserted in a property. Being more concrete, we have a property defined as boolean called "Athlete". When this property is filled, some additional properties appear in the form. Check code here
Bulbgraph.png   In this module, this method was implemented to autofill some properties when the value of other property changes. Being more concrete, when the name provided is GAL, using asynchrony (simulated with a promise and setTimeout) values for other properties are retrieved and filed. Check code here
Bulbgraph.png   In this module, this method was implemented to add a value for a property defined as combo. Doing it, instead of show the value of the combo we show the label.Check code here
Bulbgraph.png   In this module, this method was implemented to add options for a property defined as combo. We are loading country regions from a mocked external datasource and inserting them as options for a certain property.Check code here
Bulbgraph.png   In this module, this method was implemented to add options for a property defined as combo. We are loading country regions from a mocked external datasource and inserting them as options for a certain property. Apart from that, based on the default values we are showing some properties which by default are hidden. Check code here
Bulbgraph.png   In this module, this method was implemented to emphasize results which are marked as VIP. In that results we are adding a component to reflect it.Check code here
Bulbgraph.png   In this module, this method was implemented to add a property to the order when the BP is assigned to the order Check code here

DQM - Data Quality Managment

CRM connector is ready to be extended by adding a custom DQM provider. This document explains How to create a data quality management provider.

CRM Connector enabled for the client

After creating it, it should be configured at the organization level (see image above) adding the desired priority to the created DQM provider.

Bulbgraph.png   In this module, we have created validations for 2 properties (xEmail and xName) using an asynchronous approach for xName and synchronous approach for xEmail.Check code here

Retrieved from "http://wiki.openbravo.com/wiki/How_to_create_an_integration_using_CRM_connector"

This page has been accessed 28,764 times. This page was last modified on 18 June 2020, at 09:00. Content is available under Creative Commons Attribution-ShareAlike 2.5 Spain License.