Integración GET e INFO
La integración de GET e INFO se presentan al mismo tiempo, ya que son similares entre sí en la configuración de integración. Solo en los procesos internos, ejecución de algunas reglas y en la devolución de información existen algunas diferencias:
OBTENER
Devuelve al usuario solo un mensaje de éxito o error y la naturaleza del error que ocurrió, especificando con más detalle en los registros, y una devolución cuantitativa de cuántos registros se insertaron y actualizaron durante la ejecución. Durante la ejecución, la información se transforma enconsulta, según parametrización, para ejecución en la base de datos CRM, insertando y / o actualizando los datos.
INFO
Devuelve al usuario todos los datos procesados durante la ejecución de la integración en formato JSON, además del mensaje de éxito o error, y en este caso, la naturaleza del error, presentando más detalles en los logs.
Consejos de usabilidad
Pedido para la creación de la integración
Sugerencia de pedido para la creación de la integración, registrando información entre tablas según sea necesario, para facilitar la comprensión y organización de los datos. Entonces hay uncírculo entre las tablas CAMPOS_INTEGRACAO, DEPENDENCIAS y RULES, de manera que se verifica cada información registrada en CAMPOS_INTEGRACAO si es necesario crear registros en las otras tablas.
Valores variables
Todos los valores de las variables se escriben en el lenguaje del integrador usando el símbolo # al principio y al final del nombre de la variable. Y, al configurar la consulta, insertar y actualizar SQL, el integrador compila el texto exactamente como si fuera código. De esta forma, el valor puede estar dentro del texto con o sin comillas simples o dobles. Por ejemplo, SELECT * FROM accounts WHERE id = '# id #'.
Orden de integraciones
El orden en el que se disponen las integraciones en la tabla INTEGRACOES marca la diferencia, por lo que deben colocarse en un orden lógico, de acuerdo con la estructura del CRM.
Orden de índice
Orden de índice delcuerda JSON en el campo CAMPO_CRM de la tabla CAMPOS_INTEGRACAO no hace ninguna diferencia, pero se debe mantener la estructura lógica.
Registro de integración
El nivel de personalización en el registro de integraciones es grande, los SQL presentes en la tabla INTEGRACOES, las columnas CONSULTA, SQL_CONSULTA, SQL_INSERT y SQL_UPDATE pueden ser complejos y más de uno, si es necesario.
Nota
Es posible ejecutar integraciones de diferentes tipos en dependencia (GET + SET), pero se recomienda ejecutar solo integraciones del mismo tipo en dependencia. Primero, es necesario configurar la conexión con el sistema a integrar, y luego configurar los módulos y campos.
Tabelas
El Integrador tiene una estructura de tablas de base de datos donde será posible registrar y configurar integraciones.
| Campo | Descripción | Valores posibles |
|---|---|---|
| TYPE_CONNECTION | Clasifica la forma en que se conecta la integración. |
|
| NAME_CONNECTION | Informa el nombre de la conexión guardada en el archivo de conexiones del cliente dentro de los archivos del integrador. Cada tipo de conexión tiene un diseño específico para configurar la conexión en el archivo. |
| Campo | Descripción | Valores posibles |
|---|---|---|
| NOME (NOMBRE) | Descripción de la integración. Información importante en el caso de la integración INFO, ya que es el índice de retorno para llegar a la información integrada. |
|
| TIPO DE SERVICIO | cuerda que representa el tipo de integración a realizar. | |
| COMPANY_ID / COMPANY_FILIAL_ID | Empresa para la que está disponible la integración. | |
| ENLACE | cuerda que informa la dirección para conectar la integración, el complemento para llegar a un servicio en particular, pudiendo ser NULL en algunos casos. |
|
| TABLA | Mesa donde se realizará la integración. | |
| CONSULTA | Texto JSON que representa la consulta de datos realizada en el sistema de terceros, el texto debe contener una clave de 'consulta' para que el integrador encuentre la consulta y el valor puede ser NULL en algunos casos. |
|
| CONNECTION_INTEGRACAO_ID | Identificador que hace referencia a la información de la tabla CONEXAO_INTEGRACAO. | |
| PORT_WS | Se refiere al puerto para ejecutar un servicio en particular. Solo se utiliza en integraciones a través deservicio web. Esta información se puede encontrar en la documentación WSDL del sistema que se va a integrar. | |
| INDEX_ARRAY_RETURN | Representa la clave delformación donde se ubican los datos de la búsqueda de valores a integrar. En el caso de integración víaservicio web este valor aparece en la documentación, ya a través de la base de datos, el valor informado se agregará como el primer índice de laformación devuelto de la consulta. Si la solicitud es a través de un servicio web o API y no tiene un índice predeterminado para devolver valores, puede usar la palabra reservada 'parámetros' como index_array_return. | |
| INDEX_VALUE_RETURN | Índice que se buscará en elformación retorno de envío de valor al tercer sistema (integración SET), para realizar acciones luego de una integración exitosa. Valor no utilizado en la integración GET o INFO, su valor debe ser NULL. | |
| INDEX_ERROR_RETURN | Estos son los índices en los que se buscarán errores en la matriz de retorno de las búsquedas realizadas por el Integrador, es decir, si estos índices se encuentran con un valor, el Integrador interpretará la búsqueda como 'con error'. El campo puede contener varios índices separados por comas (no puede haber espacios entre los índices y la coma). Solo se utilizará como validador general el primer índice de la lista, es decir, si el primer índice no presenta errores, los demás no se contabilizarán. | |
| SQL_QUERY |
SQL que se encargará de buscar el registro en CRM, en el caso de integración INFO, o de validar si existe, para que el Integrador sepa cuál será el siguiente paso, insertando o actualizando el registro, en el caso de integración GET. Para este campo recuerde elconsejo 2. Hay dos variables que se pueden utilizar # company_id # o # company_branch_id #, cuando el CRM del cliente es para varias empresas, además de las variables de Integrador, que contienen todos los campos mapeados en los campos FROM-TO del CRM y de terceros sistema, y está organizado de la siguiente manera: # nombre # |
|
| SQL_INSERT |
SQL que se encargará de insertar un nuevo registro en CRM si la búsqueda realizada por la columna SQL_CONSULTA arroja falso. No olvide el consejo 2. Para ensamblar la consulta de inserción se habilita la inyección de valor, por lo que existen dos variables que se pueden utilizar # company_id # o # company_branch_id #, cuando el CRM del cliente es para múltiples empresas, además de las variables de Integrador, que contienen todos los campos mapeados en DE-PARA de CRM y campos de sistemas de terceros, siempre que tengan el valor verdadero (1) en la columna VALOR_GLOBAL de la tabla CAMPOS_INTEGRACAO, además de los valores mapeados en DE-PARA formateado para INSERT, como sigue: # índices #: representa las columnas; # valores #: son los valores que se van a insertar; Por ejemplo: (# índices #) VALORES (# valores #) |
|
| SQL_UPDATE |
SQL que se encargará de actualizar un registro en CRM si la búsqueda realizada por la columna SQL_CONSULTA devuelvecierto. No olvide el consejo 2. Para montar elconsulta actualización, la inyección de valor está habilitada, por lo que hay dos variables que se pueden usar # company_id # o # company_branch_id #, cuando el CRM del cliente es para varias empresas, además de las variables Integrator, que contienen todos los campos mapeados en el DE - PARA de los campos CRM y del sistema de terceros, siempre que tengan el valor verdadero (1) en la columna VALOR_GLOBAL de la tabla CAMPOS_NTEGRACAO, además de los valores mapeados en DE-PARA formateado para la ACTUALIZACIÓN, de la siguiente manera: # valores #: representa las columnas igualadas a los valores; # id #: devuelve el valor consultado en la columna SQL_QUERY; Por ejemplo: # valores # DONDE id = # id # |
|
| DEPENDIENTE | Informa que la integración actual depende de la integración con el identificador dado y se ejecutará antes. El valor informado es el identificador de la tabla INTEGRATIONS. | Puede contener valores NULL. |
| DEPENDE DE | Informa que el valor registrado es una integración que depende de la integración actual y se ejecutará posteriormente. El valor informado es el identificador de la tabla INTEGRATIONS. | Puede contener valores NULL. |
| PARAMETERS_MANDATORY | Informa qué valores deben estar en la URL de solicitud de integración. Los parámetros deben estar separados por una coma y deben ser exactamente los mismos que los parámetros que pasará la URL. | Puede contener valores NULL. |
- id de campo: 1
- Campo de nombre: GET-WS-ACCOUNTS
- Campo Service_type: GET
- campo company_id / company_branch_id: 1
- Campo de enlace: / g5-senior-services / sapiens_Synccom_senior_g5_co_cad_clientes? Wsdl
- Campo de tabla: cuentas
- Campo de consulta: {"query": {"user": "senior", "password": "senior", "encryption": 0, "parameters": {"EmpCod": "1", "FilCod": "1 "" Systemidentifier ":" CRM "," amountRecords ":" 500 "," IntegrationType ":" # IntegrationType # "}}}
- Campo Connection_integracao_id: 3
- campo ws_port: Exportar
- campo index_array_return: cliente - en integraciones a través del servicio web, el valor de esta columna debe ser idéntico al valor del servicio web
- Campo Return_value_index: no utilizado
- campo index_erro_return: error, messageErro, erroExecucao
- campo sql_query: SELECCIONAR ID DE cuentas DONDE id_erp = '# id_erp #' INSERTAR EN cuentas (company_id, # índices #) VALORES (1, # valores #)
- campo sql_insert: INSERT INTO accounts (company_id, # indices #) VALUES (1, # values #) - esta columna no se usa en integraciones INF
- campo sql_update: ACTUALIZAR cuentas SET # valores # WHERE id = '# id #' - esta columna no se usa en integraciones INF
- Campo dependiente: 1 - la columna "dependiente" debe ser el id de una integración válida, es decir, el id de un registro válido en la tabla INTEGRATIONS
- Depende del campo: 1: la columna "depende de" debe ser el ID de una integración válida, es decir, el ID de un registro válido en la tabla INTEGRATIONS.
- Campo Mandatory_parameters: codEmp, codFil, TypeIntegration - en caso de múltiples parámetros, deben estar separados por comas sin espacios
| Campo | Descripción | Valores posibles |
|---|---|---|
| INTEGRATION_ID | Identificador que hace referencia a información de la tabla INTEGRATIONS. | |
| FIELD_CRM |
Representación del campo CRM interno, solo se puede llenar en formato JSON, debe contener la referencia a la tabla (INDICE) y la columna (ATRIBUTO) en estos casos dice que solo hay un nivel de profundidad, ej: ' {“Índice”: "cuentas", "atributo": "nombre_corporativo"} '. También existen casos donde se necesitan más niveles para alcanzar un cierto valor, presenta uniones de tablas (JOIN), donde el valor se origina en otra tabla, referencia a la tabla (INDEX) y la columna (ALIAS) donde se busca la información. y la tabla (INDICE) y la columna (ATTRIBUTE) originales, y pueden contener N niveles, por ejemplo: '{"índice": "cuentas", "atributo": {"alias": "term_payment_id", "índice": " pago_deadline ”,” atributo ”:” id ”}} '. En casos como este, donde existen dos niveles, se entiende que existe una dependencia para ser informado, es decir, es necesario vincular la regla CONSULTAR DEPENDENCIA en la columna REGRA_ID y registrar una dependencia en la tabla DEPENDENCIA. En los casos donde solo hay un nivel, se pueden registrar registros donde el ATRIBUTO sea una palabra clave o variables de palabras reservadas o información registrada como valores globales en la columna VALOR_GLOBAL de la tabla CAMPOS_INTEGRACAO, de la siguiente manera: IGNORAR: ignore este campo cuando realice la acción de guardar o exportar; COMPONENT: carga un componente de integración, siempre que tenga el mismo no utilizado en la columna COMPONENT_NAME; Ej .: {"índice": "cuenta", "atributo": "ignorar: razón_social"}; Ej. 2 .: {"índice": "cuenta", "atributo": "componente: definiciones_cuenta"}; |
|
| CAMPO_ERP |
Representación del campo externo del CRM (sistema de terceros), solo se puede llenar en formato JSON, debe contener la referencia a la tabla (INDICE) y la columna (ATRIBUTO) en estos casos dice que solo hay una nivel de profundidad, por ejemplo: '{"índice": "cliente", "atributo": "Cliname"}'. También hay casos donde se necesitan más niveles para alcanzar un cierto valor, presenta uniones de tablas / información (JOIN), donde el valor se origina en otra tabla / nivel de la matriz, hace referencia a la tabla / índice (INDICE) y la otra nivel de matriz (INDICE) y el valor buscado (ATRIBUTO), y puede contener N niveles, por ejemplo: '{"índice": "cuentas", "atributo": {"índice": "histórico", "atributo": "codCpg ”}} '. En los casos donde solo existe un nivel, se pueden registrar registros donde el ATRIBUTO sea una palabra clave o variables de palabras reservadas o información registrada como valores globales en la columna VALOR_GLOBAL de la tabla CAMPOS_INTEGRACAO, de la siguiente manera: VALOR: informa que la siguiente cadena es un valor fijo. En este caso, es necesario informar a la regla ADD FIXED VALUE en la columna RULE_ID. En el caso de agregar un valor fijo, es posible agregar variables para ser reemplazadas por sus respectivos valores durante el procesamiento de campo. Las palabras reservadas (CurrentDate, CurrentDate, etc) y los valores de integración que se informan como valores globales están disponibles, para eso la variable debe estar entre # (# CurrentDate #, # CurrentDate #, # etc #). Por ejemplo: {"índice": "cliente", "atributo": "valor: oportunidad generada en # CurrentDate #"} |
|
| RULE_ID | Identificador que hace referencia a información de la tabla REGLAS. | |
| GLOBAL_VALUE | Booleano que permite que el campo, si se ingresa como verdadero / 1¸, guarde el valor y el nombre del campo en un alcance global para que se pueda acceder a él desde cualquier otra integración, campo o regla. | |
| USE_INSERT | Booleano que permite que el campo, si se ingresa como verdadero / 1, se use en una operación de inserción en la base de datos de CRM. El campo solo se utiliza en la integración GET. | |
| USE_UPDATE | Booleano que permite que el campo, si se ingresa como verdadero / 1, se use en una operación de actualización en la base de datos de CRM. El campo solo se utiliza en la integración GET. | |
| PARÁMETROS ADICIONALES |
Se utiliza para pasar varios parámetros a una regla determinada durante el procesamiento de campo. Solo se deben registrar las cadenas en formato JSON. Puede contener valores NULL. Ej .: {"data_format_erp": "Ymd"}; |
- Id de campo: 897
- Campo de Integration_id: 10
- Field_crm campo: {"index": "account_definitions", "atributo": {"index": "payment_term", "alias": 'payment_term_id "," atributo ":" id "}}
- Field_erp campo: {"índice": "cliente", "atributo": {"índice": "histórico", "atributo": "Cpgcod"}}
- campo rule_id: 5
- campo global_value: 0
- campo use_insert: 1
- campo use_update: 1
- Campo de parámetros_adicionales: nulo
| Campo | Descripción | Valores posibles |
|---|---|---|
| INTEGRATION_ID | Identificador que hace referencia a información de la tabla INTEGRATIONS. | |
| TABLA | Tabla / vista donde se obtendrá la información para que los registros se comparen al consultar las dependencias durante el procesamiento de campo. | |
| COLUMNS_SEARCH | Nombre de columna de la tabla ingresada arriba que contiene el valor deseado. Se puede ingresar más de un campo, solo separado por una coma. |
|
| COLUMN_COMPARE | Columna que contiene el valor que se comparará con el retorno de la consulta al tercer sistema. Su funcionamiento es similar a la cláusula ON presente en el JOIN de una consulta. | |
| VALOR POR DEFECTO | Valor que se informa, de manera que en los casos en que no se encuentre un registro con el valor informado en la columna COLUNA_COMPARAR, se inserta, para que el campo no quede vacío. El valor informado tiene que ser necesariamente un identificador válido en la tabla informada en la columna TABLA. Puede contener valores NULL. | |
| COMPANY_BRANCH_ID | Identificador que hace referencia a información de la tabla EMPRESA_FILIAL. Separa las dependencias por empresa y sucursal, permitiendo diferentes valores según las necesidades de la sucursal. Esta información solo se utiliza cuando la base de clientes es de varias empresas. |
- Identificación de campo: 75
- Campo de Integration_id: 8
- Campo de tabla: usuarios
- Columns_search campo: user_id, nombre
- Campo de comparación_columna: user_id_erp
- Campo valor_predeterminado: 383
- campo company_branch_id: 1
| Campo | Descripción | Valores posibles |
|---|---|---|
| NOME (NOMBRE) | Informa una descripción de la regla, el nombre para identificar la regla. | |
| TYPE_METHOD | Responsable de informar al Integrador cómo se ejecuta la regla. |
0: ejecuta una función, solo llama al método pasado por parámetro en la columna METHOD; 1: realiza la consulta de una dependencia, el método fijo, devolviendo el valor configurado para. Si se informó un método en la columna METHOD, se ejecuta después de consultar la dependencia; 2: agrega un valor fijo, la regla interpreta el valor informado de la columna CAMPO_ERP, de la tabla CAMPOS_INTEGRACAO, como un valor de hecho, no como una clave de consulta. Si se informó un método en la columna MÉTODO, se ejecuta después de la devolución del valor fijo; 4: carga un componente, agrega los valores a la variable interna de un integrador para que el integrador interprete el componente como una integración, con sus particulares, y cuando el componente finalice su ejecución, devuelva los valores formateados para la integración principal; |
| MÉTODO | Método o función que se ejecutará cuando se produzca una llamada a una regla. |
SQL: una consulta con alguna condición que devuelve el valor deseado; FIRMA DEL MÉTODO: una clave que representa un método presente en los archivos de reglas del Integrador, reglas generales o específicas del cliente; NULL: puede contener valores NULL. |
- Identificación de campo: 26
- Campo de nombre: Cargar / Preparar componente
- Campo Method_type: 4
- Campo de método: nulo
English
Español


