Crear un Conector Personalizado

Si los conectores predeterminados no se ajustan a tus necesidades, podés crear un conector personalizado.

Para los conectores personalizados, Syncloud permite conectarte a dispositivos y aplicaciones externas de dos formas:

• MQTT: Utilizando el broker de Syncloud o cualquier broker MQTT externo.
• REST: Utilizando la API de Syncloud mediante HTTP.

Para que Syncloud procese correctamente los mensajes de un conector personalizado, cada evento enviado debe incluir como mínimo los siguientes campos:

• Id del Conector: Identifica al conector dentro de Syncloud. Permite asociar uno o más conectores a distintas máquinas. El Id puede coincidir o no con el Id de la máquina.
• Eventos: El mensaje puede contener uno o varios eventos. Syncloud analizará el contenido del mensaje y, usando el Id de evento configurado en cada máquina, separará los distintos eventos para su procesamiento independiente.

Además, de forma opcional, el mensaje puede incluir:

• Fecha: Campo que indique la fecha y hora de generación del mensaje.

Para crear un conector personalizado:

• Navegá a la página de "Aplicaciones". Luego dirigite a la sección de "Conectores"

• Verás todos los conectores añadidos hasta el momento. Apretá el botón "Nuevo Conector" en la esquina superior derecha.

• Apretá en el ícono "+", al final de todo. Te aparecerá un formulario.

• Completá los campos obligatorios:

  • Nombre.

  • Modo: Seleccioná entre Conector de Origen o Conector de Destino.

  • Método:

    • MQTT:
      • Topic: Topic que usará el conector para comunicarse con Syncloud.
      • Tipo:
        • Interno: Syncloud provee un broker MQTT interno para tus aplicaciones.
        • Externo: Deberás añadir las credenciales del MQTT externo, incluyendo los parámetros de autenticación: URL, puerto, usuario, contraseña.
    • REST:
      • Endpoint: Endpoint de la API interna de Syncloud donde se transmitirán los mensajes.

  • Campo Id Conector: Indicá dónde se ubicará el id del conector en el mensaje. Suele representar el id del dispositivo en el caso de un adquisidor de datos o PLC.

  • Campo Timestamp: Si los mensajes incluyen una fecha u hora generada por el dispositivo, especificá en qué campo del mensaje se encuentra esa información y el formato en el que viene (por ejemplo, Unix epoch, o una cadena tipo YYYY-MM-DD hh:mm:ss). Esto permite que Syncloud registre correctamente la hora real a la que ocurrió el evento.

• Decodificador: Definí el método de decodificación especificando el campo de formato de evento. Se soportan los siguientes formatos:

  • JSON
  • Binario
  • Protobuf
  • Podés construir un decodificador personalizado seleccionando la opción Personalizado.

• Apretá el botón "Guardar". El conector quedará creado y podrás usarlo en tus aplicaciones siguiendo el tutorial.