Resumen
El DAM (Digital Asset Management) es la librería de archivos de CXF: imágenes, video, documentos y enlaces externos, organizados en un árbol de carpetas. Cada asset puede tener variations responsivas (renditiones por tamaño) y sources alternativas, trackea dónde se usa, y se puede hacer público para la web. El contenido referencia assets a través de sus attributes de tipo media. Para el panorama completo, consulta el overview de Content.Dónde encontrarlo
El DAM está en Content → DAM. También se abre como picker cuando eliges un archivo para un attribute de tipo media en otra parte de la app.Tipos de asset
La librería contiene cuatro clases de registro, cada una con un rol distinto:| Tipo | Rol |
|---|---|
| Asset | Un archivo principal (imagen, video, documento) — o un enlace externo. |
| Folder | Un contenedor organizativo; los assets se anidan en carpetas. |
| Variation | Una rendición por tamaño/derivada de un asset padre (p. ej. thumbnail, optimizada para web). |
| Source | Un original alternativo de un asset (p. ej. una versión recortada o editada). |
Properties
| Property | Tipo | Requerido | Descripción |
|---|---|---|---|
title | string | Sí | Nombre visible. |
slug | string | Sí | Identificador, único dentro del DAM. |
type | enum | Sí | asset, folder, variation o source. |
parent_id | reference | No | La carpeta contenedora (o el asset padre). |
folder_path | string | Auto | La ruta del asset en el árbol de carpetas (p. ej. home/images/products). |
is_link | boolean | No | Si el asset es un enlace externo en lugar de un archivo almacenado. |
link | string | Condicional | La URL externa, para assets de tipo enlace. |
mime_type | string | Auto | El MIME type del archivo. |
size | number | Auto | El tamaño del archivo. |
variations | array | Auto | Renditiones por tamaño/derivadas. |
sources | array | Auto | Originales alternativos. |
metadata | object | No | Metadatos arbitrarios. |
usage | array | Auto | Dónde se referencia el asset en CXF. |
is_public | boolean | No | Si el asset es accesible públicamente (por defecto false). |
is_trash | boolean | Auto | Si el asset está en la papelera. |
Variations y sources
- Las variations son renditiones por tamaño o responsivas generadas desde un asset (thumbnail, optimizada para web, etc.). Los presets de variation con nombre definen los tamaños que reciben los assets de un template.
- Las sources son originales alternativos del mismo asset — por ejemplo una versión recortada o re-editada guardada junto al original.
Comportamiento y reglas
- Árbol de carpetas — los assets viven en carpetas; el
folder_pathse mantiene automáticamente a medida que los creas y mueves. Mueve desde el DAM, no editando las rutas directamente. - Público vs privado — los assets son privados por defecto; ver Visibilidad más abajo.
- Papelera y restaurar — eliminar un asset lo envía a la papelera; restaurarlo lo devuelve a su carpeta original.
- Enlaces externos — un asset de tipo enlace referencia una URL externa, con metadatos obtenidos de ella.
- Tracking de uso — el DAM registra dónde se referencia cada asset, así puedes ver el uso de un asset antes de cambiarlo o quitarlo.
Visibilidad
Cada asset es público o privado (privado por defecto):- Público — accesible por cualquiera en su URL, y cacheable en el CDN.
- Privado — no público. Un asset privado solo se sirve a un usuario admin, o a un contact que tenga ese asset asignado — a través de sus propios documents, organization, conversations u orders. Cualquier otro recibe una respuesta de no autorizado/prohibido.
La visibilidad se propaga hacia abajo en el árbol de carpetas. Cambiar el ajuste
público/privado de una carpeta aplica el mismo ajuste a todos sus descendientes
— subcarpetas, assets, variations y sources.
Seeds
Los assets no se soportan en Seeds.Gobernanza y permisos
Un super admin o un Master tiene control total del DAM — subir, organizar, publicar (hacer público) y eliminar. Los usuarios Journey Manager ven solo los assets a los que la configuración del Journey Manager les da acceso.Acceso por API
Los assets tienen CRUD completo más operaciones para pegar (mover/copiar) items entre carpetas, enviar a la papelera y restaurar, obtener metadatos de un enlace externo, listar los tipos de archivo soportados y leer el uso de un asset. Consulta la API reference.Relacionado
Content Instances
El contenido referencia assets a través de sus attributes de tipo media.
Attributes
Los attributes de tipo media apuntan a assets del DAM.
Hierarchies
La mecánica del árbol de carpetas.