Integración Java-Salesforce

Salesforce, clasificado dentro de la familia de los CRM (Customer Relationship Management), una herramienta que le facilitará la vida a quien quiera llevar un seguimiento de la actividad comercial de su empresa, gestionando clientes potenciales, clientes finales, contactos y ventas; entre otras acciones.

En este caso estamos hablando de una solución Cloud y como tal, su infraestructura será totalmente transparente, es decir, no nos tenemos que preocupar por dedicar esfuerzo a montar máquina, ni instalar software, para tener al menos un sistema funcionando.

Hablemos de la integración…

En este caso, para el desarrollo, hemos utilizado el lenguaje Java, así que vamos a ver qué opciones tenemos para comunicarnos con la plataforma.

De manera oficial, la empresa Salesforce ofrece un API vía REST o SOAP para poder interactuar con sus variados servicios. Ya es un primer paso, al menos sabemos que tendremos una colección de llamadas HTTP más o menos estándares, que podremos realizar mediante algunas herramientas conocidas como Jersey. Esto a las bravas puede ser un engorro, tener que picar cada una de las llamadas y parámetros a mano… Así que como todo buen progra vamos a investigar alguna solución más práctica y efectivamente, ya hay gente que se ha currado un envoltorio para utilizar dicho API, envolviendo las llamadas HTTP con simples objetos y servicios Java.

La librería en cuestión es force-rest-api , disponible tanto para clonar en github, como para descargar en java con Maven.

¿Cómo realizar la instalación?

Añadir a la sección <dependencies> del fichero pom.xml de nuestro proyecto

[java] <dependency>

<groupId>com.frejo</groupId>

<artifactId>force-rest-api</artifactId>

</dependency>
[/java]

Uso

La librería nos ofrece la clase ForceApi que será la que nos permita realizar toda comunicación con Salesforce.

Lo primero será instanciarla pasando la url, usuario y password en una Instancia de ApiConfig.

Código Java:

[java] ForceApi api = new ForceApi(new ApiConfig()

.setUsername(sfUser)

.setPassword(sfPassword)

.setLoginEndpoint(sfUrl));
[/java]

Desde aquí ya podremos realizar cualquier operación CRUD sobre los objetos de Salesforce, a destacar los métodos

query (String query, Class targetClass)

Devuelve una lista de Objetos de SF y transformados automáticamente a la clase que indiquemos. Se pasará por parámetro una consulta muy semejante al familiar SQL.

createSFObject (String type, Object object)

Se creará en salesforce el objeto enviado del tipo indicado por el parámetro type.

updateSFObject (String type, String id, Object object)

Se actualizará en Salesforce el objeto de tipo indicado por el parámetro type e identificado por el parámetro id.

deleteSObject (String type, String id)

Elimina un objeto en Salesforce de tipo type y referenciado por id.

Ya solo nos quedaría escribir las entidades que se han creado en Salesforce que serán las que interactúen con las de nuestro negocio. Me gustaría destacar que la librería utiliza los servicios REST con JSON, y para realizar el parseo utiliza por debajo Jackson, librería de transformación que estamos acostumbrados a utilizar en cualquier proyecto que publique un API. Así por ejemplo la entidad Lead (Candidato) quedaría de la siguiente manera.

Código Java:

[java] public class Lead {

@JsonIgnore

@JsonProperty(value = "Id")

private String id;

@JsonIgnore

@JsonProperty(value = "CreatedById")

private String createdById;

@JsonIgnore

@JsonProperty(value = "LastModifiedById")

private String lastModifiedById;

@JsonIgnore

@JsonProperty(value = "OwnerId")

private String ownerId;

@JsonIgnore

public String getId() {

return id;

}

@JsonProperty(value = "Id")

public final SFObject setId(final String id) {

this.id = id;

return this;

}

@JsonIgnore

public String getCreatedById() {

return createdById;

}

@JsonProperty(value = "CreatedById")

public SFObject setCreatedById(final String createdById) {

this.createdById = createdById;

return this;

}

@JsonIgnore

public String getLastModifiedById() {

return lastModifiedById;

}

@JsonProperty(value = "LastModifiedById")

public SFObject setLastModifiedById(final String lastModifiedById) {

this.lastModifiedById = lastModifiedById;

return this;

}

@JsonIgnore

public String getOwnerId() {

return ownerId;

}

@JsonProperty(value = "OwnerId")

public SFObject setOwnerId(final String ownerId) {

this.ownerId = ownerId;

return this;

}

@JsonProperty(value = "FirstName")

private String firstName;

@JsonProperty(value = "LastName")

private String lastName;

@JsonProperty(value = "Company")

private String company;

@JsonProperty(value = "CIF__c")

private String cif;

@JsonProperty(value = "Email")

private String email;

@JsonProperty(value = "Street")

private String street;

@JsonProperty(value = "City")

private String city;

@JsonProperty(value = "State")

private String state;

@JsonProperty(value = "Country")

private String country;

@JsonProperty(value = "PostalCode")

private String postalCode;

@JsonProperty(value = "Status")

private String status;

@JsonProperty(value = "MobilePhone")

private String mobilePhone;

@JsonProperty(value = "NIF__c")

private String nif;
[/java]

Notas:

*Los campos cuya JsonProperty termina en __c no son estándar en Salesforce, son personalizados.

**Los campos con un @JsonIgnore en el Getter son de sólo lectura en Salesforce.

Responsable del tratamiento	BELIKE SOFTWARE, S.L
Dirección del responsable	C/ Álvaro de Bazán, 10, CP 46010, Valencia (Valencia/València)
Finalidad	Sus datos serán usados para poder atender sus solicitudes y prestarle nuestros servicios.
Publicidad	Solo le enviaremos publicidad con su autorización previa, que podrá facilitarnos mediante la casilla correspondiente establecida al efecto.
Legitimación	Únicamente trataremos sus datos con su consentimiento previo, que podrá facilitarnos mediante la casilla correspondiente establecida al efecto.
Destinatarios	Con carácter general, sólo el personal de nuestra entidad que esté debidamente autorizado podrá tener conocimiento de la información que le pedimos.
Derechos	Tiene derecho a saber qué información tenemos sobre usted, corregirla y eliminarla, tal y como se explica en la información adicional disponible en nuestra página web.
Información adicional	Más información en el apartado “SUS DATOS SEGUROS” de nuestra página web.

Hablemos de la integración…

¿Cómo realizar la instalación?

Uso

Deja una respuesta Cancelar la respuesta

Cuéntanos qué necesitas y en qué quieres que te ayudemos

INFORMACIÓN BÁSICA SOBRE COOKIES