Integrador
El integrador de gestión de relaciones | CRM es una herramienta destinada a facilitar la integración de otros sistemas disponibles en el mercado con Relationship Management | CRM y viceversa. Permite crear y gestionar integraciones mediante configuraciones de sistema, o parametrización, sin necesidad de desarrollar nuevas fuentes.
En términos de ejecución, el Integrator solo ejecuta lo que se configuró para él, no realiza todas las acciones automáticamente. Lo que hace el Integrador es interpretar y ejecutar las configuraciones de una determinada integración, ya registrada, en el momento en que está llamada a ejecución, a través de una URL. Con eso, es necesario configurarlo correctamente y ejecutar la llamada. Existen tres tipos de ejecución, que tienen la misma estructura de configuración, cada uno con su propia peculiaridad:
Para utilizar el Integrador, es necesario utilizar un software capaz de realizar solicitudes, creando el paquete HTTP con parámetros específicos en elencabezamiento. Para ello recomendamos el softwarecartero.
La ejecución de cada integración es llamando a una URL, con algunos parámetros de ejecución de la integración informados y puede contener parámetros configurados para una integración exclusiva, además de los valores obligatorios, de la siguiente manera:
- EMPRESA_ID o EMPRESA_FILIAL_ID: Identificador de empresa de CRM o identificador de qué empresa y sucursal de CRM, según el sistema del cliente para múltiples empresas;
- BASE_CRM: nombre de la base de datos de clientes en CRM;
- INTEGRACAO_SERVICO_ID: identificador del servicio a ejecutar;
- TOKEN_CRM: clave de seguridad que permite acceder a una determinada base de datos, según permiso. Este valor debe agregarse en elencabezamiento de la solicitud.
TOKEN_CRM es obligatorio en todas las integraciones.
Ejemplo:
URL para llamar a una integración particular: https://Integrador.crmsenior.com.br/Integrador/integrar.php?empresa_id=1&base_crm=crmsenior&servico_integracao_id=1
Complete el paquete con la herramienta Postman para enviar la solicitud:
params
Headers
Cada identificador de empresa de CRM por cliente genera un archivo de registro de errores y accesos, que registrará los pasos realizados y los errores encontrados durante la ejecución, ya sean advertencias o errores fatales, para posibles correcciones. Para que se realice cualquier integración, es necesario configurar los datos de la conexión en un archivo que será cargado por el integrador.
El Integrador se basa en cinco tablas CRM, donde se realiza una consulta de acuerdo a la integración a realizar y la información relacionada para la integración entre los sistemas, a saber:
| Tabelas | Descripción |
|---|---|
| CONNECTION_INTEGRATION | Esta tabla es responsable de configurar las conexiones de acceso del integrador a los proveedores o receptores de datos. |
| INTEGRACIONES | Se definen las integraciones con un sistema dado y sus particularidades. |
| CAMPOS_INTEGRATION | Describió todos los campos que formarán parte de la integración y sus equivalentes, en el sistema receptor o proveedor. |
| DEPENDENCIAS | ¿Cuáles son las dependencias de una integración dada, es decir, los valores originados en otras tablas del sistema? |
| NORMAS |
Las reglas de ejecución de la integración, al estar vinculadas a los campos, se ejecutarán para ajustar la información de acuerdo con el sistema, receptor o base de datos de clientes en CRM que esté preparado para recibir. |
Para poder ajustar la información de integración a medida que el sistema está preparado para recibir, es necesario cargar las reglas disponibles. La mayoría de las reglas que se ejecutan son parte del integrador, código integrado y cargado por el integrador en tiempo de ejecución.
Para cada tipo de integración se carga un código de regla diferente, ya que se comportan de manera diferente para cada tipo. Hay casos en los que es necesario crear reglas específicas para una integración, es decir, personalizar reglas para los clientes, suministrar un proceso o ajustar información, permitiendo que el sistema receptor o base de datos CRM comprenda la información y la procese correctamente. Para ello, es necesaria una acción de desarrollo.
Importante
Para que la regla se ejecute en un campo de integración, se debe registrar en la tabla REGLAS con la información relevante.
Con las definiciones de integrador presentadas, consulte las instrucciones paso a paso para crear las integraciones.OBTENER INFORMACIÓN yCOLOCAR.
En los casos de integraciones a través del servicio web, el integrador genera un registro XML de envío y recepción, denominado de la siguiente manera: base_company_requisition.xml y base_company_response.xml, donde base es la base de clientes igual al parámetro base_crm y empresa es el id de la empresa cliente. igual al parámetro company_id o company_branch_id.
Para cada integración realizada con un estado de error, el Integrador intentará enviar un mensaje de correo electrónico al correo electrónico general del cliente con el contenido del registro de errores generado por la integración, el envío y recepción de archivos XML si la integración es por servicio web y el mensajes devueltos por la integración.
Configuración del archivo de conexión
Toda integración tiene como prerrequisito una conexión, que se configura en un archivo para ser cargado por el Integrador. Este archivo se interpreta junto con el código fuente del integrador y es importante prestar atención a caracteres como: paréntesis, comas y comillas dobles.
Para configurar la conexión, el archivo debe estar en el directorio de configuración del integrador con el nombreConexión BASE-NAME.. Este archivo debe contener unformación con los datos de conexión, donde cada índice del formación representa una conexión.
Ejemplo:
En el ejemplo, se hará referencia al índice de conexión, resaltado en rojo, más adelante en la tabla.CONNECTION_INTEGRATION. El índiceDEFECTO es obligatorio y debe existir en cada configuración, representa la conexión con el propio CRM y debe contener los datos de conexión del CRM. Cada nueva conexión configurada debe tener su propio índice.
Hay tres tipos de conexión posibles para el integrador: base de datos, servicio web y API (web, http). Cada una de las conexiones tiene sus propios parámetros y undiseño para configurar los datos de conexión, sin embargo, para la paginación, todas las conexiones utilizan la misma estructura para la configuración. usteddiseños para configurar la conexión de cada tipo de conexión son:
Banco
Se utilizarán diferentes campos para cada conexión, vale la pena investigar para encontrar la mejor manera de conectarse.
- dbname: Nombre del banco;
- usuario: usuario de conexión a la base de datos;
- contraseña: contraseña de conexión;
- anfitrión: servidor de conexión;
- conductor: la herramienta de conexión que utilizará el integrador difiere de un banco a otro y hay un número limitado deconductores para la conexión, a saber: ibm_db2 para IBM-db, pdo_mysql para MySQL, pdo_pgsql para PostgreSQL, pdo_sqlite para SQLite. El integrador utiliza una herramienta para crear las conexiones con elconductoresy, si se requiere una configuración específica, puede acceder al documentación de la herramienta que trae los pasos para la configuración.
- juego de caracteres:codificacion para la conexión, estándar UTF-8;
- dsn: un texto de conexión personalizado;
- pdo: funciona como el controlador, para conexiones personalizadas.
Para obtener más información, vaya adocumentación oficial sobre el método de conexión.
Web service
conexionesservicio web tienen los mismos campos, algunos de los cuales son obligatorios:
- anfitrión: servidor de conexión, obligatorio;
- Puerto: puerto de conexión;
- juego de caracteres:codificacion para la conexión, estándar UTF-8;
- encabezamiento:formación con datos de encabezado para la solicitud, algunosservicios web necesidad de enviar autenticación de encabezado;
- cuerpo: aformación con una plantilla de cuerpo predeterminada para las solicitudes, en la que el índice debe contener un valor "#CUERPO#"que será reemplazado por el cuerpo de requisición generado por el Integrador y funciona como si fuera una cobertura de envío para todas las requisiciones.
API
Las conexiones API se utilizan para cargar valores a través delweb pero sin la necesidad de un protocolo WSDL. Las conexiones de API solo aceptan transacciones de contenido JSON, es decir, si la API consumida por el integrador no devuelve valores JSON, la integración no se ejecutará.
- anfitrión: servidor de conexión, obligatorio;
- Puerto: puerto de conexión;
- método: cuál es el método para enviar el mensaje a la API, el valor predeterminado es GET y los tipos admitidos son: GET, POST, PUT, PATCH y DELETE;
- encabezamiento: aformación con los campos deencabezados estándar para la integración, se puede utilizar para completar campos de autorización, por ejemplo. Este campo se fusiona con el campo establecido en la columna CONSULTA para las integraciones GET e INFO.
Paginación
La estructura de paginación viene dada por un índice de configuración, definido comopaginación, que debe estar junto a la configuración de conexión.
El índice está compuesto por tres parámetros que definen el formato en el que se realiza la paginación, son:
- buscapersonas: define una clave de registro que está presente en el resultado de la integración como un buscapersonas. De esta manera, la integración utilizará este índice para recuperar los valores de la página y pasarlos a la siguiente solicitud. Por ejemplo: si la búsqueda de datos devuelve una clave llamadapágina actual con el número de página, simplemente configure el buscapersonas en página actual que la integración utilizará este valor como buscapersonas para la próxima solicitud;
- punto final: Define cómo la integración reconoce cuándo se agotaron las páginas o cuál fue la última página. Para esta configuración, es posible definir un índice presente en el resultado de la integración como validador para que la integración interprete si las páginas se han agotado o utilizar palabras clave que definan automáticamente este validador. Si se utiliza un índice como validador, la integración validará los valores: OK - OK - S - NULL como finalizado. Cualquier valor distinto a estos se interpretará como no finalizado. Si se utilizan palabras clave, pueden ser:
- ninguno: la integración no se paginará, ya que entiende que solo hay una página;
- vacío : la integración solo entenderá que las páginas se han ido cuando una de las páginas requeridas devuelva un resultado vacío, sin registros.
- escribe: define qué cálculo se utilizará para cargar los números de página. Hay tres tipos de cálculos posibles:
- DESNUDO: cálculo numérico simple con la fórmula: Página = Página + 1;
- QR: cálculo del número de registros con la fórmula: Pagina = cuenta (registros);
- IDENTIFICACIÓN: cálculo de registro específico con la fórmula: Pagina = LastRecord [pager]. Este cálculo utiliza elbuscapersonas obligatoriamente.
Si no se define ninguna configuración de paginación en la configuración de conexión, el integrador utilizará la siguiente configuración de forma predeterminada:
Importante
Bancos aprobados para conexión a través deBanco son:
- Oráculo;
- Servidor SQL;
- MySQL;
- PostgreSQL;
- DB2;
- Caché DB.
English
Español
