¿Cómo crear tópicos asociados a entidades sin persistencia?

¿Cómo crear tópicos asociados a entidades sin persistencia?

Introducción

Para poder hacer uso de la integración de tópicos Kafka como bus del Digital Broker, hay que hacerlo mediante la creación de una entidad y un cliente digital.

Esto a veces no es lo ideal, ya que solamente queremos usar el tópico como parte de otra integración, manteniendo la gestión de permisos que nos ofrece la Plataforma.

En estos casos, no es necesario almacenar los datos directamente en la entidad, sino que queremos poder hacer uso de los tópicos de entrada y notificación sin persistencia intermedia.

Para ello haremos uso de las entidades sin persistencia.

Cómo crear una entidad sin persistencia

Cuando vayamos a crear una entidad paso a paso, en la sección de “opciones avanzadas”, cuando tengamos que seleccionar la “Instancia de Base de Datos”, seleccionaremos la opción “NO PERSISTANCE“:

image-20250319-142239.png

Cómo crear tópicos asociados a una entidad sin persistencia

Al igual que para cualquier otro tipo de entidad, tendremos que activar al menos una de las opciones de creación de tópicos Kafka. ¿Qué usos podrían tener estas opciones si no se persiste la entidad?

  • Permite crear Tópico Kafka de ingesta para la Entidad: Nos permite crear el tópico y usarlo, generándose ACLs específicas para los digital clients (usuarios Kafka) que tengan al menos acceso de escritura.

  • Permite crear Topic Kafka de notificaciones: Nos permite que integrar el Digital Broker con Kafka, de tal manera que si una aplicación escribiese a la entidad, la notificación del dato estaría accesible en un tópico de notificación

image-20250319-142917.png

Una vez tengamos la entidad con uno de estos (o ambos) checks marcados, tendremos que crear un cliente digital para que tanto los tópicos como las ACLs se generen.

Para ello, iremos al menú “CONCEPTOS PRINCIPALES“ en la opción “Mis Clientes“:

image-20250319-143156.png

 

Veremos un listado de los clientes digitales que hayamos dado de alta y pulsando en el botón “+” podemos crear uno nuevo.

image-20250319-143352.png

Seleccionamos la entidad sin persistencia creada y le damos permisos ALL o INSERT:

image-20250319-143746.png

Pulsamos en el botón “añadir entidad” y guardamos los cambios:

image-20250319-143852.png

Esto nos habrá creado un tópico con la nomenclatura:

  • Si seleccionamos tópico de ingesta: ONTOLOGY_<NOMBRE_ENTIDAD_MAYUSC>

  • Si seleccionamos tópico de notificación: ONTOLOGY_OUTPUT_<NOMBRE_ENTIDAD_MAYUSC>

NOTA: las nomenclaturas indicadas en este post son para elementos creados en los verticales y tenant por defecto. En el caso de estar usando multitenancy y estar en otro vertical/tenant, hay que seguir esta guía de nomenclaturas.

Con esto tendríamos disponible el tópico junto con sus ACLs:

image-20250319-145002.png