Saltar al contenido principal

​
Resumen

Los Tags son etiquetas flexibles y ligeras que asignas a los objetos de CXF para organizarlos y encontrarlos. A diferencia de las Taxonomies, los tags son globales — se comparten entre todos los objetos y no están restringidos por Template ni object type. Los tags pueden ser jerárquicos (padre-hijo, con un full path como Technology/AI/Machine Learning) y pueden crearse al vuelo mientras escribes. Para el modelo mental, consulta Conceptos básicos.

​
Dónde encontrarlo

Los tags se gestionan por completo desde el selector de tags — no hay una pantalla de administración aparte, y creas, organizas y asignas tags ahí mismo mientras escribes. El selector aparece en dos lugares:
  • en un registro, en el tab de Authoring, y
  • en un Template o Profile, bajo Default tags.

​
Properties

Un tag tiene las siguientes properties:
PropertyTipoRequeridoDescripción
titlestringSíNombre visible. No puede contener /.
slugstringSíIdentificador único — solo letras, números y guiones.
descriptionstringNoDescripción opcional.
parent_idreferenceNoTag padre, para jerarquías.
visiblebooleanNoSi el tag se muestra a los usuarios (default true).
is_systembooleanNoMarca un tag integrado, protegido de edición y borrado (default false).
created_atdatetimeAutoCuándo se creó el tag.
updated_atdatetimeAutoCuándo se actualizó por última vez.
Como cualquier objeto, un tag también se puede extender con Attributes custom sobre estas properties.

​
Jerarquías

Un tag puede tener un parent_id, formando un árbol padre-hijo. Cada tag expone un full path calculado — los títulos de sus ancestros unidos con /, por ejemplo Technology/AI/Machine Learning.
Tag chains. En el selector de tags, escribir una ruta que aún no existe —como Technology/AI/Machine Learning— crea toda la cadena de una vez, cada tag como padre del siguiente.

​
Asignar tags

Establece el campo tags de un objeto con una lista de ids o slugs de tag. Un objeto puede tener muchos tags a la vez.
Los tags desconocidos se ignoran, no se rechazan. Si asignas un id o slug de tag que no existe, se omite en silencio — no hay error de validación. (Es lo contrario a las Taxonomies, que rechazan lo que no está permitido.)

​
Tags vs Taxonomies

TagsTaxonomies
AlcanceGlobal — disponibles en todas partesRestringidas por Template u object type
LocalizaciónNoSí (versions)
Crear al vueloSí (escribe un tag o ruta nueva)No (se crean explícitamente)
Desconocido al asignarSe ignora en silencioSe rechaza
Mejor paraEtiquetas flexibles, generadas por el usuarioClasificación controlada

​
Comportamiento y reglas

  • Varios por objeto. Un objeto puede tener muchos tags a la vez.
  • title es requerido, hasta 255 caracteres, y no puede contener /.
  • slug es requerido y único, usando solo letras, números y guiones (sin espacios, barras ni guiones bajos).
  • parent_id debe referenciar un tag existente, y un tag no puede ser su propio padre.
  • Inmutable mientras está en uso. Una vez que un tag se asigna a algún objeto, su slug y parent_id no se pueden cambiar — title, description y visible sí.
  • Los system tags (is_system) no se pueden actualizar ni eliminar.

​
Seeds

Los Tags viajan entre entornos con Seeds como seeds estructurales (no son instancias de template, así que los instance seeds no aplican). Cada tag es un ítem tags; las jerarquías usan parent_id, resuelto con un reference helper: 
[
  {
    "object_type": "tags",
    "data": { "title": "Technology", "slug": "technology", "visible": true }
  },
  {
    "object_type": "tags",
    "data": {
      "title": "Artificial Intelligence",
      "slug": "artificial-intelligence",
      "visible": true,
      "parent_id": "{{getRecordAttribute('tags', 'slug', 'technology')}}"
    }
  }
]

​
Gobernanza y permisos

  • Solo un super admin o un Master puede crear, editar y eliminar tags.
  • Los system tags (is_system) están protegidos de edición y borrado.
  • Un tag que está en uso no se puede eliminar.

​
Acceso por API

Asigna tags estableciendo el campo tags de un objeto con una lista de ids o slugs a través de la API reference. Los tags en sí se crean, actualizan y eliminan por la API, que también permite crear una cadena jerárquica a partir de una ruta.

​
Relacionado

Taxonomies

Clasificación estructurada y restringida — frente a los Tags flexibles.

Object types

Qué object types soportan Tags.