Resumen
Una Content Version es una rendición individual de un Content Instance, identificada por idioma × entorno × status. Las versions son lo que hace que el contenido sea multi-idioma y multi-entorno: la misma instance puede tener una version en inglés y otra en español, un entorno production y uno development, y un draft junto a lo que está published — cada uno una version separada. El contenido real de una instance (sus valores de attributes) vive en sus versions, no en la instance misma. Para el panorama completo, consulta el overview de Content.Dónde encontrarlo
Las versions se redactan desde un Content Instance: el editor de la instance tiene un encabezado de version para elegir el idioma y el entorno y ver el status de publicación, y los campos de contenido que editas pertenecen a la version draft activa.Properties
| Property | Tipo | Requerido | Descripción |
|---|---|---|---|
language | string | Sí | El idioma de la version, p. ej. en, es. |
environment | string | Sí | El entorno de la version, p. ej. production, development. |
status | enum | Sí | draft o published. |
title | string | No | Por defecto, el título de la instance. |
slug | string | No | Por defecto, el slug de la instance. |
scheduled_to_publish_at | datetime | No | Cuándo se programa publicar la version. |
scheduled_to_unpublish_at | datetime | No | Cuándo se programa despublicar la version. |
| (valores de attributes) | mixed | — | Los campos de contenido de la instance para este idioma/entorno, validados contra los attributes del template. |
Una version se identifica de forma única por la combinación de idioma,
entorno y status — no puedes tener dos versions
draft para el mismo par
en / production, pero sí una draft y una published.Ciclo de vida
El contenido se redacta como draft y luego se promueve a published:| Operación | Qué hace |
|---|---|
| Create / update | Redacta o edita una version draft para un idioma y entorno. |
| Publish | Copia el draft en la version published, reemplazando lo que estaba en vivo. |
| Unpublish | Quita la version published; el draft permanece. |
| Restore draft | Copia la version published de vuelta sobre el draft, descartando los cambios del draft. |
| Propagate | Copia el contenido de una version a otros idiomas o entornos como punto de partida. |
Programación
La publicación y despublicación de una version se pueden programar en lugar de hacerse a mano — con fechas manuales o apuntando la programación a una Publishing Window (un rango start/end reutilizable). La version entonces se publica y se retira automáticamente.Attributes
Los campos personalizados de una familia de contenido se definen contra el object type Content Version y se acotan al Content Template. Por eso el contenido vive en las versions: cada version lleva sus propios valores de attributes, así que el draft en inglés y la version published en español pueden diferir campo por campo.Seeds
Las versions no se siembran por sí solas — viajan con su instance. En un Seed de instance, el arrayversions de cada registro
lleva el contenido por idioma/entorno (ver
Content Instances). Los attributes de la
version se definen de forma estructural, contra el object type content_versions
y acotados al template — ver el
ejemplo de structural seed.
Gobernanza y permisos
Las versions siguen las mismas reglas que su Content Instance: un super admin o un Master puede gestionar cualquier version, y un Journey Manager puede redactar, publicar y despublicar versions de las instances que posee.Acceso por API
Las versions se gestionan a través de las operaciones de version de la instance — create/update, publish, unpublish, restore draft, propagate, listar versions disponibles, y programar publish/unpublish. Consulta la API reference.Relacionado
Content Instances
El registro al que pertenece una version.
Publishing Windows
Programa cuándo se publica una version.
Attributes
Los campos que lleva una version.
Events & Automation
Reacciona a eventos de publish / unpublish.