Saltar al contenido principal

Resumen

Un Document es un registro concreto creado desde un Document Template — un acuerdo, una solicitud o un certificado. Todo document pertenece a un contact y hereda el esquema de attributes del template. A diferencia de los Content Instances, los documents no tienen versions — los valores de attributes se guardan directamente en el registro. Para el panorama completo, consulta el overview de Customer Data.

Dónde encontrarlo

Los documents se listan bajo la lista de Documents de cada template, en Customer Data → Document Templates. Los contacts leen sus propios documents por el flujo “my documents” de cara al contacto.

Properties

PropertyTipoRequeridoDescripción
titlestringNombre visible del document.
slugstringIdentificador.
template_idreferenceEl template del que se construye este document.
contact_idreferenceEl contact dueño — todo document pertenece a uno.
parent_idreferenceNoUn document padre opcional.
(valores de attributes)mixedEl contenido del document, validado contra los attributes del template.
Los documents también soportan taxonomies, tags, relationships, workflows y archive.

Ownership

El owner de un document sigue el modo de ownership de su template:
  • Independent — define el owner en el document.
  • Sync with contact — el owner es de solo lectura y sigue al contact del document.

Comportamiento y reglas

  • Todo document pertenece a un contactcontact_id es obligatorio y ata el document a un contact.
  • Sin versions — los valores de attributes viven directamente en el document (más simple que los content instances).
  • Archiva, no elimines en duro — los documents usan Archive y se pueden restaurar.

Seeds

Los documents se cargan en bulk como Seeds de instance en los documents de un solo template — un import directo para lotes pequeños, o una subida asíncrona para grandes volúmenes. El template en sí viaja como seed estructural.

Gobernanza y permisos

Un super admin o un Master puede gestionar cualquier document. Los documents llevan Ownership — directo o sincronizado desde el contact — así que un Journey Manager gestiona los documents que posee.

Acceso por API

Los documents tienen CRUD completo (acotado por template) más restore y relationships. Los contacts leen sus propios documents por la Contact API. Consulta la API reference.

Relacionado

Document Templates

El blueprint del que se crea un document.

Contacts

El contact al que pertenece todo document.

Ownership

Ownership independiente vs sincronizado.