Int. Man. 1 Configura tu servicio

En "configura tu servicio" ingresas los aspectos fundamentales de tu integración. Como “Detalles”, “Parámetros de entrada” y “Configuración”.

Detalles

En la sección de “Detalles” primero tienes que elegir, el tipo de Integración en “Tipo de servicio”. Existen dos opciones. Sólo tienes que seleccionar el “Checkbox” del tipo de integración. Para elegir el tipo de integración, considera el tipo de respuesta que vas a recibir de la petición. 

• Si la respuesta tiene formato JSON, elige REST.

• Si la respuesta tiene formato XML, elija SOAP.

En “Nombre de la integración”, escribe el nombre que le vas a dar a tu integración. Considera que con este nombre vas a identificarla en los nodos de Business Logic para usarla en tus flujos.

En “Descripción de la integración”, opcionalmente, puedes agregar una pequeña descripción del servicio o la petición que vas a realizar.

Integraciones manuales en Vista previa y producción

Kosmos te da la facilidad de realizar dos configuraciones en una misma Integración. Cada una de estas configuraciones puede ser para cada ambiente Vista Previa (QA) o Producción. Esta función es útil cuando tienes dos Endpoints para tu integración, uno para realizar pruebas o vistas previas, y otro para flujos publicados en producción.

Para activar esta función, activa el checkbox de “Usar distintas configuraciones para vista previa y publicar”.

Importante: Si no activas la función “Usar distintas configuraciones para vista previa y publicar”, la plataforma usará el mismo Endpoint y la misma configuración que realices para Vista Previa y para Producción.

Parámetros de entrada

Opcionalmente, puedes agregar parámetros de entrada a tu Integración Manual. Los parámetros te permiten realizar peticiones al servicio web, en función de los valores de las variables de tu flujo. 

Para agregar un parámetro haz clic en “+Agregar nuevo parámetro”. En “Parámetro” escribe el nombre de tu parámetro.  Y en tipo de parámetro, elige entre las diferentes opciones, dependiendo del valor, o valores de tu flujo con los que vas a realizar la petición.

• Cadena de caracteres

• Número

• Objeto

• Arreglo

• Booleano

• Documento

Ejemplo de uso

Por ejemplo, si realizas una integración manual con tu propia base donde están todos tus clientes con su respectivo número de cliente, puedes crear un parámetro de entrada de “Número de cliente”, para que cuando uno de tus clientes capture su número de cliente, la petición se realice sólo para obtener como respuesta los datos de ese cliente y no todos los datos de tu base.

Configuración

En esta sección configuras los aspectos básicos técnicos de tu integración. La configuración puede variar dependiendo el tipo de integración. 

Si activaste la función “Usar distintas configuraciones para vista previa y publicar”, verás dos pestañas “Vista Previa” y “Publicar”. En cada una de estas pestañas, puedes realizar la configuración correspondiente a cada uno de tus ambientes, simplemente selecciona la pestaña y configura de acuerdo al tipo de configuración REST o SOAP.