Configuración
| Campo | Descripción |
|---|---|
operation | create, update, delete o create_or_update. |
template_id | El template del document. |
document_id_or_slug | Un field mapping que localiza el document (requerido para update/delete/upsert). |
contact | El contact dueño — requerido para toda operación (los slugs de document son únicos por contact). |
field_mappings | Los valores de attributes. |
taxonomies / tags | Listas add/remove de referencias a taxonomies o tags — ver Taxonomies, tags y ownership. |
ownership | Listas add/remove de entradas { user, role } — ver Taxonomies, tags y ownership. |
Los attributes requeridos del document solo se exigen en
create y upsert — un
update que solo toca taxonomies, tags u ownership guarda sin llenarlos.Taxonomies, tags y ownership
Además de sus valores de attributes, la acción puede gestionar las Taxonomies, los Tags y el ownership del document. Cada una de las tres secciones recibe una lista add y una lista remove de field mappings, con semántica estricta de add/remove:- Las entradas que ya están en el document y que la acción no nombra se preservan siempre — las listas nunca se reemplazan por completo.
- En
createsolo aplican las listas add; las listas remove están disponibles enupdatey upsert. Quitar una entrada que no está presente no tiene efecto.
- Cada entrada puede resolver a un id o slug, a una lista de ellos, o a objetos copiados del contexto del run — todas las formas se aplanan a identificadores.
- Las entradas de ownership son
{ user, role }, conroleigual aownerofollower(por defectoowner). El user puede referenciarse por id o email. Agregar un user que ya está en la lista actualiza su role en lugar de duplicarlo; los users archivados no se pueden agregar.
Cuando el ownership mode
del document template es Sync with contact, los adds de ownership se omiten en
create — el nuevo document hereda el ownership de su contact — y el detalle del run
marca la sección como omitida. Los cambios de ownership en update aplican
normalmente.relations de lo que se agregó, se quitó
o cambió de role, legible desde nodes posteriores del flujo. El mismo resumen aparece
en el detalle de cada run como Taxonomies, tags & ownership changes, con los ids
resueltos a emails de user y slugs de taxonomy/tag.
Relacionado
Documents
Los registros que gestiona esta acción.
Document creation
El equivalente de cara a contact (create).