Resumen
Las Hierarchies te permiten organizar registros en un árbol padre-hijo. Defines el padre de un registro; CXF mantiene al día el orden entre hermanos y la ruta del registro en el árbol de forma automática — sin contabilidad manual. Para el modelo mental, consulta Conceptos básicos. Las Hierarchies aplican a Organizations y a los Content Instances — incluidas las Taxonomies, que son content instances.Dónde encontrarlo
Gestionas las hierarchies desde la vista de lista de cualquier objeto que las soporte — Organizations, Content Instances, Taxonomies. Desde ahí organizas el árbol, definiendo el padre de cada registro y su posición entre sus hermanos.Properties
Un registro dentro de una hierarchy lleva estas properties:| Property | Tipo | Requerido | Descripción |
|---|---|---|---|
parent_id | reference | No | El registro padre. Sin valor significa un ítem raíz — para los Content Instances, el Template actúa como raíz. |
sequence | number | No | Posición (base 1) entre sus hermanos. Se asigna al final si no la provees. |
parent_object_type | enum | No | El object type del padre. |
hierarchy | string | Read-only | Ruta calculada en notación de puntos, por ejemplo 1.2.3. |
hierarchy_sort | array | Read-only | Forma en array de la ruta (por ejemplo [1, 2, 3]), usada para ordenar el árbol. |
hierarchy y hierarchy_sort son calculados y de solo lectura — se
mantienen por ti y no se pueden enviar. Solo defines parent_id y
(opcionalmente) sequence.Comportamiento y reglas
- El orden se gestiona solo. Omite
sequencey el registro va al final de sus hermanos; un valor fuera de rango se ajusta a una posición válida. - Mover reordena automáticamente. Cambiar el
parent_ido elsequencede un registro reordena sus hermanos viejos y nuevos y recalcula las rutas de todos sus descendientes. - Eliminar promueve a los hijos. Cuando se elimina un registro, sus hijos suben a su padre (sin subárboles huérfanos) y los hermanos cierran el hueco.
- Los campos calculados están protegidos. Enviar
hierarchyohierarchy_sortse rechaza. - Los ítems archivados se omiten al ordenar hermanos.
Quitar de la hierarchy
Puedes desadjuntar un registro del árbol, limpiando suparent_id, sequence y
ruta. Esto se rechaza si el registro todavía tiene hijos — muévelos o
elimínalos primero.
Seeds
La hierarchy viaja con el registro host en un Seed estructural: define elparent_id (y opcionalmente el sequence) del propio
registro. No incluyas hierarchy / hierarchy_sort — se calculan al importar.
Consulta el ejemplo de seed de Taxonomies para el
patrón padre-hijo.
Gobernanza y permisos
- Solo un super admin o un Master puede construir y reordenar hierarchies (definir el padre de un registro, moverlo o desadjuntarlo del árbol).
Acceso por API
Defineparent_id y sequence mediante las operaciones estándar de creación y
actualización; hierarchy y hierarchy_sort regresan calculados. Una operación
dedicada desadjunta un registro del árbol (ver
Quitar de la hierarchy). Consulta la
API reference.
Relacionado
Organizations
El objeto principal que se organiza en hierarchies.
Taxonomies
Clasificación que también usa hierarchies padre-hijo.