Saltar al contenido principal

​
Resumen

Un Content Instance es un registro concreto creado desde un Content Template. Hereda el tipo y el esquema de attributes del template, y se redacta como una o más Content Versions en distintos idiomas, entornos y estados draft / published. Las instances soportan jerarquía, taxonomies, tags, relationships, workflows, ownership y archive — y, para los products, inventario, variaciones y precios. Para el panorama completo, consulta el overview de Content.

​
Dónde encontrarlo

Las instances de cada template se listan bajo Content, en la lista propia de ese template.

​
Tipos de instance

El tipo de una instance viene de su template. El mismo motor de contenido impulsa cinco clases de objeto:
TipoQué esComportamiento notable
StoriesContenido editorial / artículosContenido + versions; sin commerce.
ProductsBienes y servicios vendiblesItem codes, SKU, precios, inventario, variaciones — impulsa Commerce.
LocationsLugares físicos o virtualesSe usan como locations de inventory en Commerce.
BlocksFragmentos de contenido reutilizablesSe componen en otro contenido.
TaxonomiesÁrboles de categorizaciónUna taxonomy acotada a un object type.
Commerce se construye sobre content instances. Un Product vendible es una instance products, y una Location (bodega, tienda) es una instance locations — así que el inventario y las orders de Commerce corren sobre los mismos registros que redactas aquí.

​
Properties

PropertyTipoRequeridoDescripción
titlestringSíNombre visible.
slugstringSíIdentificador — único dentro del tipo (a–z, 0–9, -).
typeenumAutoHeredado del template.
template_idreferenceSíEl template del que se construye esta instance.
parent_idreferenceNoRegistro padre, para la jerarquía.
taxonomy_object_typestringCondicionalSolo taxonomies — el object type que categoriza la taxonomy.
versionsarrayAutoLas content versions de la instance.
Los campos de contenido de una instance (sus valores de attributes) no viven en el nivel superior — viven en cada version, así que distintos idiomas y entornos pueden tener contenido distinto.

​
Versions

Toda instance se redacta a través de versions — una rendición por idioma × entorno × status. Ahí es donde el contenido se redacta, publica, despublica, restaura y propaga entre idiomas. Consulta Content Versions para el modelo completo y sus operaciones.

​
Products

Cuando el template es un product, sus instances llevan los datos de commerce sobre los que corre el módulo Commerce: item codes (SKUs), precios, inventario y variaciones. Publicar un producto mantiene su registro vendible en sincronía para que esté disponible en las orders. Las opciones de producto que habilitan todo esto se definen en el template.

​
Relationships

Una instance puede conectarse con otras mediante:

​
Comportamiento y reglas

  • La unicidad del slug es por tipo — el slug de una instance debe ser único dentro de su tipo, no globalmente.
  • Archiva, no elimines en duro — las instances usan Archive (soft delete) y se pueden restaurar.
  • Publicar dispara eventos — publicar o despublicar una version dispara eventos de sistema para Events & Automation.
  • Programación — la publicación/despublicación de una version se puede programar, manualmente o con una Publishing Window.

​
Seeds

Los content instances viajan entre entornos con Seeds, de las dos formas:
Tipo de seedSoportadoNotas
StructuralSíExport/import de fidelidad completa, uno por uno.
InstanceSíInserción masiva en las instances de un solo template — el camino de alto volumen.
Un instance seed es un array plano de registros que apunta a un template; el contenido de cada registro vive dentro de sus versions, con los valores de attributes agrupados bajo el slug de su grupo de attributes (por ejemplo default): 
[
  {
    "slug": "sample-content-1",
    "title": "Sample Content 1",
    "versions": [
      {
        "language": "en",
        "environment": "production",
        "status": "draft",
        "title": "English Production Version",
        "slug": "en-production",
        "default": {
          "description": "<p>Sample <strong>formatted</strong> text</p>"
        }
      }
    ]
  }
]
Los instance seeds están reservados para instances de templates y no llevan jerarquía — para enlaces padre-hijo, usa un structural seed o defínelos en la UI. Consulta Seeds para el formato completo.

​
Gobernanza y permisos

Un Super admin o un Master puede gestionar cualquier instance. Las instances llevan Ownership, así que un Journey Manager gestiona las instances que posee.

​
Acceso por API

Los content instances tienen CRUD completo (acotado por template), más operaciones para crear, actualizar, publicar, despublicar, restaurar, propagar y programar versions, y — para los products — construir variaciones y gestionar item codes. Consulta la API reference.

​
Relacionado

Content Templates

El blueprint del que se crea una instance.

Content Versions

Renditiones por idioma × entorno × status.

Publishing Windows

Programa cuándo se publica una version.

Commerce

Cómo las instances de product y location impulsan Commerce.