<< Clic para mostrar Tabla de Contenidos >> Navegación:  Bizagi Studio > ¿Cómo hacer? .... > Temas de integración > Cómo integrar Bizagi con Salesforce

Introducción

La integración de Bizagi con un CRM como Salesforce, es soportada a través de más de una alternativa.

Esta sección presenta un ejemplo de cómo presentar en Bizagi todos los prospectos (leads) almacenados en Salesforce, mientras permite al mismo usuario crear un nuevo prospecto basado en la información ya ingresada en Bizagi:

 

 

Alternativas

Para algunos escenarios donde quiera que Bizagi se conecte a sus sistemas corporativos de CRM, ya sea para traer información (i.e., Prospectos, Cuentas, Oportunidades o Contactos) o para crear nuevos registros, usted cuenta con estas funcionalidades:

 

1. Conector de servicios Web de Bizagi

Le permite conectarse a servicios Web compatibles con SOAP sin necesidad de programar.

Para más información sobre el conector de servicios Web, consulte Invocar servicios externos desde Bizagi.

 

2. Librería de componentes de Bizagi

Le permite crear su propios componentes codificados y empaquetarlos en Bizagi, de tal forma que puede extender sus reglas de negocio usando dichos componentes directamente

Para más información sobre la funcionalidad de la Librería de Componentes de Bizagi, consulte Integrar APIs o código personalizado en Bizagi.

 

 

API de Salesforce

Como Salesforce se ofrece como un servicio en la nube el cual tiene un API que puede ser accedido por Internet, se requiere el uso de un ID de sesión dinámica para invocar todos sus métodos (por razones de seguridad en la nube, para restringir invocaciones de sus servicios en una franja de tiempo en la cuál dicho ID de sesión es válido).

El API de Salesforce basado en SOA utiliza un endpoint de autenticación que está separado del endpoint de servicio, lo cual implica que la lógica detrás sigue un flujo similar al usado por aquellos basados en OAuth exchanges (https://developer.salesforce.com/docs/atlas.en-us.api.meta/api/sforce_api_calls_login.htm).

 

Por lo tanto, utilizar el conector de Servicios Web no es óptimo ya que obtener un ID de sesión dinámico significa que necesita invocar primero el método de autenticación de Salesforce (a través de una autenticación con usuario, contraseña y un token de seguridad) para después, invocar el método deseado.

Para este ejemplo, el conector de servicios web puede resultar en tener que más de un llamado desde Bizagi a Salesforce y no se siguen las buenas prácticas del manejo de transacciones o de altos aspectos de seguridad cuando se manejan IDs de sesión.

Debido a lo anterior, en esta guía vamos a invocar Salesforce a través de su API de SOAP, pero a través de la  librería de componentes.

Para esta funcionalidad, desarrollaremos un componente personalizado que maneje el ID de sesión y todos los aspectos relacionados con el mecanismo de autenticación, como se encuentra disponible en Salesforce.

 

Antes de empezar

Antes de empezar con la integración ilustrada por esta guía, asegúrese de tener una cuenta válida en Salesforce.

 

 

Cuando lo haga, observe que necesita otorgar acceso a su máquina, de tal forma que se permita usar su cuenta de Salesforce, como se requiere por las políticas de seguridad de Salesforce.

Usted puede autorizar dicho acceso a su cuenta de Salesforce y configurar un token de seguridad, directamente en Ajustes Personales (Personal settings) presentados en su portal de Salesforce (i.e., https://na22.salesforce.com/_ui/system/security/ResetApiTokenEdit?retURL=%2Fui%2Fsetup%2FSetup%3Fsetupid%3DPersonalInfo&setupid=ResetApiToken).

 

 

¿Qué necesita hacer?

Adicionalmente a los requisitos de Salesforce, la siguiente lista ilustra un esquema de pasos que necesitan ser llevados a cabo para integrarse con Salesforce:

 

1. Cree su propio componente que se conecte a Salesforce

Este paso se hace fuera de Bizagi, utilice el IDE de su elección, por ejemplo Visual Studio, para producir una librería (una dll para la plataforma).

 

2. Registre el componente en Bizagi Studio

En este paso, utilice Bizagi Studio para importar la librería en su proyecto de Bizagi.

 

3. Configure una regla de negocio que invoque el componente

En este paso, utilice los métodos en dicho componente, de tal forma que puede invocar Salesforce desde cualquier punto de sus procesos de Bizagi.

Para completar estos pasos, necesitará haber incluido en su modelo de datos de su proceso e interfaces de usuario, las definiciones apropiadas ya sea para enviar información a Salesforce o para guardar la entrante.

 

Ejemplo

Para ilustrar cómo integrarse con Salesforce, partiremos de tener el proceso de Peticiones, quejas y reclamos como el que se encuentra disponible en Bizagi Xchange (https://www.bizagi.com/es/plataforma/xchange).

El objetivo principal de este proceso es asignar responsabilidades y hacer un seguimiento a los comentarios ingresados ya sea en una petición, una queja, un reclamo o una sugerencia; para manejarlos acordemente en toda la organización.

 

 

Como ejemplo, asumiremos que las peticiones de entrada son estrictamente sugerencias:

1.La persona a cargo de analizar la sugerencia ("Solucionador del caso", asignado a la tarea Analizar sugerencia) debe poder escoger crear un nuevo prospecto con los datos del solicitante.

2.Bizagi presentará una tabla con los prospectos actuales en Salesforce para el Solucionador del caso para usarla como una referencia en tiempo real.

Una vez la sugerencia ha sido analizada y asumiendo que el solicitante debe ser creado como un nuevo prospecto, Bizagi persistirá esta información en Salesforce.

 

Con todo, en esta guía se ejecutarán estos 2 puntos de integración con Salesforce agregando la configuración a la plantilla de proceso existente en las actividades Enviar Respuesta y Analizar Sugerencia.

La actividad Enviar Respuesta será el punto de integración donde Bizagi traerá todos los prospectos desde Salesforce (i.e una lectura), mientras que la actividad Analizar Sugerenciay será el punto de integración donde Bizagi enviará el nuevo prospecto (i.e una escritura).

 

 

Pasos

Los siguientes pasos y componentes son desarrollados como un ejemplo orientado a la plataforma.

 

1. Cree su propio componente que conecte con Salesforce

El primer paso antes de siquiera empezar a desarrollar el componente, es asegurarse de que ha preparado todo lo necesario para conectarse con Salesforce.

Adicionalmente, tener una cuenta y un token de seguridad como se describe antes en la sección Antes de empezar, también necesitará primero guardar la definición de dichos servicios haciéndolos disponibles para el API de SOAP de su cuenta de Salesforce.

El almacenado de la definición (el WSDL actual) se hace en su máquina local y debe ser almacenado por un Servidor Web de IIS en ejecución.

 

 

1.1 Localice el WSDL

Localice el WSDL iniciando sesión en el portal de Salesforce y después escribiendo API en el cuadro de búsqueda.

Dentro de los resultados de la búsqueda, busque la página Develop API:

 

 

1.2 Guarde el WSDL

Una vez la en la página API WSDL, descargue y guarde localmente el archivo WSDL generado por los Servicios Empresariales de Salesforce, utilizando la opción "guardar enlace como..." de su navegador:

 

 

Observe que este archivo debe tener la extensión .wsdl (además, el nombre completo para este archivo es "enterprise.wsdl").

 

1.3 Aloje el archivo en el IIS

Para hacer que el archivo esté disponible via web, guarde este archivo en la ruta local del inicio del IIS en C:\inetpub\wwwroot\.

La siguiente imagen muestra el archivo enterprise.wsdl almacenado en C:\inetpub\e wwwroot\LocalWS\:

 

 

1.4 Modifique el WSDL

Este paso es necesario para resolver un problema conocido que tiene Salesforce con respecto a sus definiciones WSDL.

Modifique el WSDL e incluya esta línea adicional:

<xsd:attribute name="tmp" type="xsd:string" />

dentro del la definición del elemento ListViewRecord.

 

Esto significa que debe cambiar la definición original:

<complexType name="ListViewRecord">

 <sequence>

           <element name="columns" type="tns:ListViewRecordColumn" maxOccurs="unbounded"/>

 </sequence>

</complexType>

 

Por esta:

<complexType name="ListViewRecord">

 <sequence>

           <element name="columns" type="tns:ListViewRecordColumn" maxOccurs="unbounded"/>

 </sequence>

 <xsd:attribute name="tmp" type="xsd:string" />

</complexType>

 

 

1.5 Verifique que el WSDL puede ser accedido desde web

En este punto, usted debe poder acceder a este WSDL a través del protocolo HTTP.

Use http://localhost/[RUTA_DE_SU_WSDL] desde el navegador de su elección, para verificar que el WSDL es accesible por web y que su estructura es un XML consistente después de haberlo modificado.

 

Como se especificó anteriormente, la siguiente imagen usa la carpeta LocalWS y por lo tanto, tiene el WSDL accesible en http://localhost/LocalWS/enterprise.wsdl:

 

 

1.6 Cree un nuevo proyecto de Visual Studio

Ahora que tiene todo lo necesario en Saleforce, proceda a crear el componente.

Para esto, cree una nuevo proyecto de clase de librería en la versión 4.0 del framework de .NET:

 

 

1.7 Agregue la referencia al servicio al WSDL

Como se describe en la documentación de Salesforce, agregue una referencia al servicio (service referenc) que apuntan al WSDL alojado en el IIS:

 

 

 

Observe que el namespace de la referencia del servicio ara este ejemplo, se llama sforce2.

Aunque usted puede darle que nombre que desee, tenga en cuenta que nombre sforce2 será referenciado en pasos adicionales en esta guía.

 

1.8 Agregue otras librerías

Incluya otras librerías necesarias, en especial la librería System.ServiceModel:

 

 

1.9 Ajuste los parámetros del buffer

Todos los proyectos .NET utilizan por defecto unos parámetros de buffer configurados con valores bajos, dirigidos a transacciones de pequeñas cantidades de datos.

Asegúrese de ajustar dichos parámetros de tal forma que pueda permitirle a su aplicación transmitir una cantidad mayor de datos (debe ajustarlos de manera medible para un entorno de producción, ya que estos ajustes son parte de las medidas de seguridad que mitigan los ataques de denegación de servicio).

Debido a que el ejemplo de Salesforce va a buscar todas los prospectos (aunque un aproximado de 22 registros), pero junto con una gran cantidad de información de metadatos, proceda a modificar los parámetros de la memoria: maxBufferSize, maxReceivedMessageSize y maxBufferPoolSize.

 

Para esto, edite el elemento binding que se encuentra directamente en el archivo app.config de su proyecto, de tal forma que utilice los siguientes valores (o como medidas de acuerdo a la información esperada que usted va a manejar):

 

<binding name="SoapBinding"  maxBufferSize="2147483647" maxReceivedMessageSize="2147483647" maxBufferPoolSize="524288">

 <security mode="Transport" />

</binding>

 

 

1.10 Codifique el componente

Incluya el código para Class.cs de su proyecto de clase de librería.

Usted puede usar el siguiente código basado en la documentación de inicio rápido de Salesforce(https://developer.salesforce.com/docs/atlas.en-us.api.meta/api/sforce_api_quickstart_steps_walk_through_code.htm):

 

 

 

 

Observe que la clase llamada Class1 ofrece 2 métodos que sirven como puntos de entrada para la lógica que Bizagi necesitará para el uso desde una perspectiva de procesos.

Estos métodos son:

•public String Query(String userName, String password, String securityToken): trae todos los prospectos a partir de los parámetros de autenticación.

•public String Create(String userName, String password, String securityToken, String firstName, String lastName, String company, String email): crea un nuevo prospecto a partir de los parámetros de autenticación y los 4 campos básicos y obligatorios del nuevo prospecto: el nombre, apellido, la compañía para la que trabaja y una dirección de correo electrónico.

 

Tanto el nombre de la clase (Class1) coom cada uno de los métodos anteriores, serán referenciados por el mismo nombre en pasos posteriores.

 

 

1.11 Construya la librería

Construya su proyecto de tal forma que produzca la librería necesaria en Bizagi.

Haga esto asegurándose de que se genera para su arquitectura de sistema (32-bit o 64-bit) y la versión del framework de .NET:

 

 

La imagen de arriba muestra la clase de librería MySalesforceLibrary.dll (como fue llamado por los pasos presentados anteriormente).

Recuerde dónde se genera esta clase, ya que la necesitará en pasos y configuraciones posteriores.

 

1.12 Pruebe su componente desde otro proyecto de Visual Studio

Aunque este es un paso adicional, se recomienda asegurarse del correcto funcionamiento de su componente cuando se invoca desde otro proyecto.

Este otro proyecto puede ser uno creado directamente en su solución de Visual Studio como un proyecto de consola.

 

 

Para esto, cree un nuevo proyecto de consola a esta misma solución:

 

 

Esto le ayudará a probar y verificar su componente (por ejemplo ver directamente en la consola los prospectos generados):

 

 

Asegúrese de incluir su clase de librería como referencia:

 

 

Después, copie y pegue exactamente el mismo contenido desde el archivo app.config del proyecto de clase de librería de Salesforce en el archivo app.config del proyecto de consola creado.

Esto significa que el app.config o el proyecto de Consola, deben tener la misma dirección del endpoint (endpoint address) y la configuración de los parámetros maxBufferSize, maxReceivedMessageSize y maxBufferPoolSize, se muestra a continuación:

 

,

 

Para la clase principal (llamada TestConsole en este ejemplo), usted puede utilizar el siguiente código y diligenciar userName, password y securityToken:

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using MySalesforceLibrary;

 

namespace TestConsole

{

   class Program

   {

       

       static void Main(string[] args)

       {

           String userName = "";                //your account's username here

           String password = "";                //your password here

           String securityToken = "";        //your security token here

           String objectType = "Lead";

 

           Console.WriteLine("Press an option (1-4) to run a test:");

           Console.WriteLine("\t" + "-> 1 to test the connection only");

           Console.WriteLine("\t" + "-> 2 to test querying all leads");

           Console.WriteLine("\t" + "-> 3 to test creating one lead");

           Console.WriteLine("\t" + "-> 4 to test all of the above");

 

           Class1 pr = new Class1();

           String option = Console.ReadLine();

           int optionInt;

           if (Int32.TryParse(option, out optionInt))

           {

               switch (optionInt)

               {

                   case 1:

                       pr.Connect(userName, password, securityToken, objectType);

                       break;

                   case 2:

                       Console.WriteLine(pr.Query(userName, password, securityToken));

                       break;

                   case 3:

                       Console.WriteLine(pr.Create(userName, password, securityToken,

                           "Jerome", "Jones", "AgilityCorp", "jj@agilitycorp.com"));

                       break;

                   case 4:

                       pr.Test(userName, password, securityToken, objectType,

                           "Jerome", "Jones", "AgilityCorp", "jj@agilitycorp.com");

                       break;

                   default:

                       Console.WriteLine("Not a valid option. Ending execution.");

                       break;

               }

           }

       }

   }

}

 

Ejecutando el proyecto de consola con el código anterior, le permitirán probar separadamente tanto la conexión como todos los métodos usados en este ejemplo (o puede extender estas posibilidades si implementa métodos adicionales):

 

 

2. Registre el componente en Bizagi Studio

Una vez haya construido la clase de librería y haya verificado que funciona correctamente, abra su proyecto de Bizagi Studio.

 

2.1 Abra la librería de componentes

Navegue a la pestaña de Herramientas en la cinta de opciones y dé clic en la opción Librería de componentes.

Dé clic en Agregar para registrar su componente de Salesforce:

 

 

2.2 Ingrese los detalles del componente

Ingrese los detalles de Nombre visual y Descripción.

Por último, localice y cargue la clase de librería, la cual en este ejemplo es MySalesforceLibrary.dll:

 

 

Dé clic en Finalizar y después en Ok.

 

2.3 Ingrese los detalles del componente

De la misma forma como se hizo con el Proyecto de Consola de Pruebas, necesita utilizar las mismas definiciones que le permitan a Bizagi como aplicación, ejecutar y trasmitir servicios de Salesforce.

Para esto, copie el contenido del archivo app.config del proyecto de la clase de librería de Salesforce, específicamente, aquellos dentro del elemento <system.serviceModel>, los cuales son <bindings> y <client>.

 

 

Desde el explorador de Windows, localice el archivo web.config de Bizagi y edítelo (por defecto en C:\Bizagi\Projects\[su_proyecto]\WebApplication).

Para editarlo, primero localice el elemento <system.serviceModel> y después, copie dicho contenido dentro del mismo:

 

 

Guarde el archivo cuando termine.

A partir de este punto, el componente ha sido empaqueta y puede ser usado libremente en cualquier regla de negocio de sus procesos.

 

 

3. Configure una regla de negocio que invoque su componente

Antes de configurar cualquier regla de negocio para utilizar el componente registrado, necesitará asegurarse previamente de que tiene las definiciones apropiadas en el modelo de datos y las opciones de Interfaz gráfica para manejar la información de Salesforce (i.e., los campos para el nombre del prospecto, el correo electrónico y la compañía en Bizagi).

Para ilustrar esta parte y producir una aplicación completamente ejecutable, recuerde que haremos cambios necesarios en la plantilla del proceso Peticion, Quejas y Reclamos que se descargó desde el Process Xchange.

 

3.1 Cree una entidad llamada Prospecto (Lead)

Edite el modelo de datos para que desde ahora tenga una entidad llamada Prospecto (Lead).

Para esto, vaya al diagrama del Modelo de datos del proceso (asistente del proceso paso #2) y cree una nueva entidad maestra:

 

 

3.2 Cree los atributos para la entidad

La información de la entidad Prospecto debe coincidir con la información del prospecto en Salesforce que esté considerada por el componente.

Por lo tanto, cree los siguientes atributos que corresponden a aquellos usados por el código provisto en el ejemplo: Nombre (Name), Compañía (Company), Estado (StateProvince), Correo Electrónico (Email), Estado del prospecto (LeadStatus) y Fecha de creación (CreatedDate).

 

 

3.3 Cree una entidad de relación

Cree una nueva relación para conectar el modelo actual de datos (desde la entidad de proceso llamada Solicitud de Quejas y Reclamos (Claim and Complaint request), con la entidad Prospecto (Lead) recientemente creada.

Para esto, dé clic en la opción Relación:

 

 

Para esta relación, asegúrese de seleccionar Solicitud de Quejas y Reclamos (Claim and Complaint request) como la Entidad 1 y Prospecto (Lead) como la Entidad 2:

 

 

Después, Selección la opción Colección (Uno-Muchos).

Esto le permite a las interfaces de usuario, presentar una tabla con la lista de prospectos, estos serán traídos a Bizagi desde Salesforce.

Bizagi llamará esta relación Prospectos (Leads).

 

 

Ahora que los cambios en el modelo de datos han sido completados, el diagrama del modelo debe mostrar la nueva relación que conecta la entidad Solicitud de quejas y reclamos (Claim and Complaint request) con la entidad Prospecto (Lead):

 

 

 

3.4 Abra las formas

Procederemos ahora a editar las interfaces de usuario existentes.

Para esto, vaya al paso #3 del asistente de proceso llamado Definir formas, y abra la forma de la actividad Analizar sugerencia (Analyse suggestion):

 

 

Tenga en cuenta que puede usar la información del solicitante que ya está almacenada en este punto (este conjunto de información es el que será enviado como un nuevo prospecto en Salesforce).

Por lo tanto, ajuste las interfaces de usuario para presentar la posibilidad de crear un Prospecto en Salesforce, solo necesita un botón con su acción respectiva.

 

3.5 Agregue un nuevo botón

Localice el control de Botón para agregarlo al grupo de información del solicitante:

 

 

Asegúrese de configurar su Etiqueta y la Etiqueta del botón y después, dé clic en Acciones y validaciones para definir la acción cuando se hace clic:

 

 

3.6 Defina la acción del botón

Agregue una nueva acción, la cual lanzará la integración con Salesforce cuando se da clic al botón Crearlo como Prospecto (Create as lead).

Configure la acción para ejecutar una regla, tal como se muestra a continuación:

 

 

Para la configuración del argumento, cree una nueva regla de negocio:

 

 

El código de la regla debe tener:

var myComponent = new MySalesforceLibrary.Class1();

myComponent.Create("", "", "",

 <ClaimandComplaintRequest.Customer.FirstName>,

 <ClaimandComplaintRequest.Customer.LastName>,

 "Agility Corp.",

 <ClaimandComplaintRequest.Customer.CustomerSnapshot.Email>);

 

 

Guarde la regla asegurándose de que no hay errores mostrados en Bizagi.

La nueva acción debe verse de manera similar a esta:

 

 

Aunque a este punto usted ya ha verificado la conexión con Salesforce desde Bizagi y creó prospectos utilizando el botón, vamos a ilustrar cómo configurar la parte en que se traen todos los prospectos.

 

3.7 Incluya una tabla para todos los prospectos

En la misma forma de la actividad, cree una pestaña adicional

 

 

Tenga en cuenta que la puede nombrar como "Prospectos Salesforce" o con el nombre de su elección, aunque la parte más relevante es asegurarse que incluyó la relación Prospectos (Leads) de su modelo de datos (i.e una colección, para ser mostrada por Bizagi como una tabla en tiempo de ejecución).

 

3.8 Configure la tabla

Establezca las propiedades de la tabla como de solo lectura (i.e es decir, Opciones de borrado, Opciones de adición y Opciones de fila deshabilitadas) después, incluya la información relevante del prospecto (Nombre (Name), Compañía (Company), Estado (StateProvince), Correo electrónico (Email), Estado del prospecto (LeadStatus) y fecha de creación (CreatedDate)), como se muestra a continuación:

 

 

Cierre y guarde la forma cuando termine.

 

3.9 Configure la regla de negocio desde las acciones de la actividad.

Vaya al asistente del proceso en el paso 4 llamado Acciones de la actividad.

 

 

Agregue una nueva acción a la actividad en el tiempo Al Salir de la actividad Enviar Respuesta (Send Answer):

 

 

Cree una nueva regla de negocio que tenga este código:

var myComponent = new MySalesforceLibrary.Class1();

var result = myComponent.Query("", "", "");

CEntityXmlHelper.fromXmlToEntityWithScopes(Me, result,false);

 

 

Guarde la regla siempre que se asegure de que no hay errores mostrados por Bizagi. Y eso es todo.

 

 

Ejecución

Ejecute su proceso utilizando el botón Ejecutar en Bizagi Studio.

Una vez se abra el Portal de Trabajo de Bizagi en el navegador, cree un nuevo caso del proceso Peticiones, quejas y reclamos:

 

 

En la primera tarea llamada Recibir solicitud (Receive request), usted diligenciará los detalles del solicitante (documento, nombre, correo electrónico) y asegúrese de seleccionar que la solicitud es una Sugerencia.

 

 

Dé clic en Siguiente cuando termine.

Usted verá a Bizagi en espera por un momento mientras trae los registros desde Salesforce.

 

En la tarea Analizar Sugerencia (Analyze Suggestion), usted puede ver todos los prospectos desde la pestaña Prospectos de Salesforce o utilizar el botón Crear como Prospecto para crear uno nuevo:

 

 

Ver todos los prospectos:

 

 

Cuando cree un nuevo prospecto, usted puede verificar su creación en el portal de Salesforce:

 

 

Tips para solución de problemas

Como se dijo previamente, se recomienda que se pruebe el componente en Bizagi una vez haya validado completamente que los métodos del mismo funcionen correctamente cuando fueron invocados desde otro proyectos de Visual Studio.

Una vez haya verificado esto y para solucionar problemas mientras se esté usando en Bizagi, depure el componente usando la opción "Adjuntar al proceso..." como se entrega con Visual Studio.

Para ello, tenga en cuenta que debe adjuntar a un proceso de IIS que ejecuta w3wp.exe:

 

 

Para esto, usted necesitará asegurarse de que la salida del componente esté empaquetada en Bizagi en modo Debug (Esto solo para ser usado en ambientes de desarrollo para propósitos de solución de problemas).

 

Cuando haga los cambios al componente y reconstruya su salida, asegúrese de cargar de nuevo esta librería en Bizagi Studio.

Para forzar que se tomen todos los cambios, puede reiniciar los servicios de IIS y borrar los archivos temporales o las versiones anteriores de los archivos dll de sus componentes.