Integración GET y INFO

1. Conexión vía web service;
2. Conexión vía base de datos;
3. Conexión vía API.

• GET: consulta de los valores
• GET: consulta de los valores

• NULL: solo en los casos en los que la integración es vía base de datos;
• LINK WEB: complemento de la dirección de conexión para un determinado servicio;
• SQL: consulta de determinados valores a través de una string SQL;
• PALABRA CLAVE: ': componente' es actualmente la palabra clave disponible e informa que la integración es un componente o un campo de otra integración.

• NULL: solo en los casos en los que la integración es desde un componente o vía API cuando no hay valores para enviar en el header de la solicitud;
• JSON-COMPOSTO: cuando sea necesario dentro de la clave "consulta", se puede configurar otro JSON como si fuera un array, que contendrá todos los parámetros de búsqueda;
• JSON-SQL: dentro de la clave "consulta" se puede escribir un texto SQL completo que será ejecutado para la búsqueda.

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 la sugerencia 2. Hay dos variables que se pueden utilizar, #empresa_id# o #empresa_filial_id#. Cuando el CRM del cliente es para varias empresas, además de las variables del Integrador, que contienen todos los campos mapeados en los campos DE-PARA del CRM y de terceros sistema, y está organizado de la siguiente manera: #nome#

SQL que se encargará de insertar un nuevo registro en el CRM, caso la búsqueda realizada por la columna SQL_CONSULTA vuelva falso. No olvide la sugerencia 2. Para ensablar la query de inserción, se habilita la entrada de valores que posibilita el uso de las variables #empresa_id# o #empresa_filial_id#, además de las variables del Integrador - que contienen todos los campos identificados en el DE-PARA del CRM y del sistema tercero, desde que estén con el valor true (1) en la columna VALOR_GLOBAL de la tabla CAMPOS_INTEGRACAO -, caso el CRM del cliente sea para múltiples empresas. Se puede también utilizar los valores trazados en el DE-PARA formateados para el INSERT:

#indices#: representa las columnas;

#valores#: son los valores que se van a insertar;

Por ejemplo: (#indices#) VALUES (#valores#)

SQL que se encargará de actualizar un registro en el CRM si la búsqueda realizada por la columna SQL_CONSULTA devuelve true. No olvide la sugerencia 2. Para ensablar la query de actualización, se habilita la entrada de valores que posibilita el uso de las variables #empresa_id# o #empresa_filial_id#, además de las variables del Integrador - que contienen todos los campos identificados en el DE-PARA del CRM y del sistema tercero, desde que estén con el valor true (1) en la columna VALOR_GLOBAL de la tabla CAMPOS_INTEGRACAO -, caso el CRM del cliente sea para múltiples empresas. Se puedetambién utilizar los valores trazados en el DE-PARA formateados para UPDATE:

#valores#: representa las columnas igualadas a los valores;

#id#: retorna el valor consultado en la columna SQL_CONSULTA;

Por ejemplo: #valore # WHERE id = #id#

Representación del campo interno del CRM que solo se puede llenar en formato JSON, debe contener la referencia a la tabla (INDICE) y a la columna (ATRIBUTO) en estos casos dice que solo hay un nivel de profundidad, ej: ' {“indice”: "contas", "atributo": "razao_social"}'. También existen casos donde es necesario 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 a la columna (ALIAS) donde se busca la información, y la tabla (INDICE) y la columna (ATTRIBUTE) originales, pudiendo contener N niveles, por ejemplo:‘{“indice”:”contas”,”atributo”:{ ”alias”:”prazo_pagamento_id”,“indice”:”prazo_pagamento”,”atributo”:”id”}}’. En casos como este donde existen dos niveles, se entiende que existe una dependencia a ser informada, 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 tener registros donde el ATRIBUTO sea una palabra clave, variables de palabras reservadas o de las informaciones guardadas como valores globales en la columna VALOR_GLOBAL de la tabla CAMPOS_INTEGRACAO, de la siguiente manera:

IGNORE: ignorar este campo cuando realizar la acción de grabar o exportar;

COMPONENTE: carga un componente de integración, desde que tenga el mismo no utilizado en la columna NOME_COMPONENTE;

Ej 1.:{“indice”:”conta”,”atributo”:”ignore:razao_social”};

Ej. 2.: {“indice”:”conta”,”atributo”:”componente:definicoes_conta”};

Representación del campo externo del CRM (sistema tercero), 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: ‘{“indice”:”cliente”,”atributo”:”nomCli”}’. También hay casos donde son necesarios más niveles para alcanzar un cierto valor. Presenta uniones de tablas/informacións (JOIN), donde el valor es originado en otra tabla/nivel del array, referencia a la tabla/índice (INDICE) y el otro nivel del array (INDICE) y el valor buscado (ATRIBUTO). Puede contener N niveles, por ejemplo: ‘{“indice”:”contas”,”atributo”:{“indice”:”historico”,”atributo”:”codCpg”}}’. En los casos donde solo hay un nivel, se pueden tener registros donde el ATRIBUTO sea una palabra clave, variables de palabras reservadas o de las informaciones guardadas 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 la regla ADICIONAR VALOR FIXO en la columna REGRA_ID. En el caso de agregar un valor fijo, es posible agregar variables que serán reemplazadas por sus respectivos valores durante el procesamiento del campo. Las palabras reservadas (dataAtual, dataHoraAtual, etc) y los valores de la integración que estuvieren informados como valores globales están disponibles, para eso la variable debe estar entre # (#dataAtual#, #dataHoraAtual#, #etc#).

Por ejemplo: {"indice":"cliente","atributo":"valor:oportunidade gerada em #dataHoraAtual#"}

Utilizado para pasar varios parámetros a una determinada regla durante el procesamiento del campo. Deben ser registradas solamente strings en formato JSON. Puede contener valores NULOS.

Ej .: {"data_format_erp":"Y-m-d"};

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;

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 NULOS.