Cuando un sandbox funciona como querés, una promoción copia su configuración y los datos maestros que las personas ingresaron en una empresa de producción. Primero la planificás: el plan lista cada elemento que se copiaría y lo que le pasaría. Nada cambia en producción mientras planificás.
Qué es una promoción
Una promoción crea o actualiza una empresa de producción a partir de un sandbox. Copia la configuración y los datos maestros, nunca los registros de práctica. El sandbox queda exactamente como estaba: solo se lee.
Los propietarios y administradores de la organización que recibe la copia planifican las promociones desde Promociones, en el menú de la organización. En el resumen de la organización, en Sandboxes, también podés seleccionar Promover a producción.
Planificá una promoción
- Abrí Promociones en la organización y seleccioná Planificar una promoción.
- En Sandbox, elegí el sandbox del que copiar. Ves los sandboxes que administrás, en cualquiera de tus organizaciones.
- En Empresa de producción, elegí Una empresa de producción existente de esta organización, o Una empresa de producción nueva con su nombre y su identificador de URL. Una empresa nueva se crea solo cuando la promoción se ejecuta.
- En Qué copiar, desmarcá las secciones que quieras dejar afuera. Al principio están todas marcadas.
- Seleccioná Planificar. Se abre el plan.
Qué se copia
La configuración de la empresa, los tipos de trabajo y las etapas, los productos, las contrapartes, los sitios y las parcelas, los miembros y sus roles, la configuración de las integraciones (nunca sus credenciales), los destinos de webhooks y los puntos de entrada, las reglas de lotes, las automatizaciones, las verificaciones, los tableros y las programaciones de informes. En una empresa existente, los elementos se emparejan por referencia externa y después por nombre, así que cada uno muestra Crear, Actualizar o Mantener como está.
Lo que nunca se copia
Lotes, movimientos, procesamiento, lecturas y eventos de campo; certificados; aprobaciones y solicitudes; datos de demostración y todo lo simulado o que viene de una conexión de prueba; el historial del registro; las declaraciones TRACES; informes y exportaciones; el historial de auditoría; claves, llaves de acceso, claves de API y secretos; conversaciones con el asistente. El plan lista los elementos de demostración y simulados como No se copia, para que veas que quedan atrás.
Datos personales entre organizaciones
Dentro de una organización, los datos personales se copian con los elementos. Cuando el sandbox pertenece a otra organización, la copia va a otro responsable del tratamiento de los datos, así que los nombres de las personas, las identificaciones fiscales, los contactos, las direcciones y los correos de los miembros quedan atrás por defecto. Una contraparte que es una persona queda atrás junto con sus fincas y parcelas. Marcá Incluir datos personales solo cuando la organización del sandbox tenga una base legal para compartirlos, como un acuerdo escrito o el consentimiento de las personas. Una solicitud de eliminación en una empresa no llega a la otra: cada una conserva su propia copia.
Corregí los conflictos
Un elemento marcado como Conflicto no se copia. Cada uno dice qué pasó, por qué y cómo corregirlo, por ejemplo dos elementos con la misma referencia pero de distinto tipo, o un ajuste que la organización bloqueó. Corregilo en el sandbox o en producción y después seleccioná Volver a planificar. Volver a planificar usa las mismas opciones y actualiza el plan con el sandbox y la producción tal como están ahora. Cancelar plan cierra un plan sin cambiar nada.
Solicitá la promoción
Un plan no cambia nada hasta que se solicita y se aprueba. Abrí el plan en Promociones, seleccioná Solicitar promoción, agregá si querés una nota para quien aprueba y confirmá con tu segundo factor. El plan queda congelado: lo que ve quien aprueba es exactamente lo que se copiará. Si el sandbox o la producción cambiaron desde que planificaste, la solicitud se rechaza; seleccioná Volver a planificar, revisá el nuevo plan y solicitalo.
Aprobá o rechazá
Un segundo propietario o administrador de la empresa de producción aprueba la solicitud: abre el plan en Promociones, lo lee y selecciona Aprobar, confirmando con su segundo factor. Cuando la empresa de producción tiene otro propietario o administrador, quien solicitó la promoción nunca puede aprobarla: se aplica el control de cuatro ojos y aprueba uno de los demás.
Cuando sos el único propietario o administrador de la empresa de producción (y de su organización), nadie más puede aprobar. El plan ofrece entonces Aprobar como único administrador: aprobás tu propia solicitud con tu segundo factor y queda registrada como autoaprobada por el único administrador. Quien pase a ser propietario o administrador de la organización más adelante recibe un aviso al respecto. Si preferís el control de cuatro ojos, invitá a un segundo administrador en Organización → Personas con el rol Administrador antes de aprobar; desde entonces, aprueba esa persona.
La aprobación se rechaza si el sandbox o producción cambiaron desde la solicitud; entonces hay que volver a planificar. Rechazar cierra una promoción solicitada sin copiar nada.
Las personas involucradas reciben un aviso en su campana, con un enlace a la promoción: los propietarios y administradores que pueden aprobar, cuando una promoción los espera, y quien la solicitó, cuando se aprueba, se rechaza, termina o falla. El plan muestra a todos por su nombre: quién la solicitó, quién la aprobó y quién dio el visto bueno de la otra organización.
También reciben un correo electrónico con el mismo enlace. Cuando la promoción va a otra organización cuya empresa de producción todavía no existe, ninguna campana guarda el aviso: sus propietarios y administradores lo reciben por correo electrónico y el registro de actividad de la organización lo anota.
Un sandbox de otra organización
Cuando el sandbox pertenece a otra organización, sus datos pasan a otro responsable, así que un propietario de esa organización también da su visto bueno. Encuentra la solicitud en su propia página Promociones, en Desde esta organización, y selecciona Aprobar con su segundo factor, o Rechazar. Los propietarios de esa organización reciben un aviso cuando una promoción los espera. Quien solicitó la promoción nunca da este visto bueno si la organización tiene otro propietario. Cuando quien la solicita es el único propietario de esa organización, su solicitud es el visto bueno, registrado igual que una autoaprobación del único administrador. La ejecución empieza cuando están las dos aprobaciones.
La ejecución
Una vez aprobada, la promoción se ejecuta sola, sección por sección: la empresa, los tipos de trabajo y etapas, los productos, los socios, los sitios, los ajustes, los miembros, las integraciones, los endpoints, las reglas de lote y luego los demás borradores. La página muestra el avance.
- Una nueva empresa de producción se crea en la organización elegida. Sos su propietario, y los propietarios y administradores de la organización pasan a ser sus administradores.
- Los productos del catálogo de la organización siguen vinculados a él: dentro de una misma organización, producción usa la misma entrada del catálogo que el sandbox, nunca una segunda copia.
- Los miembros reciben una invitación con el mismo rol. Nadie obtiene una cuenta ni acceso hasta que la acepta y configura su app de autenticación.
- Las integraciones pasan a ser conexiones Live que necesitan credenciales: no se copia nada secreto. Al abrir el formulario de conexión de la integración, los ajustes del sandbox ya están completados, así que solo agregás las credenciales. Dejar de lado quita una que no necesitás. Inicio muestra lo que falta.
- Las reglas de lote quedan marcadas en la configuración de la empresa con las opciones y los ajustes elegidos en el sandbox. Se activan con el inicio propio del ledger de producción y su aprobación, nunca desde el ledger de prueba del sandbox.
- Las automatizaciones, verificaciones, tableros, programaciones de informes y endpoints llegan como borradores o en pausa, como con un archivo de configuración. Si producción ya tiene uno con el mismo nombre, se conserva la versión de producción.
- Un sitio cuyo socio no está en producción no se copia, y el informe dice por qué.
Leé el resultado
Cuando termina la ejecución, cada elemento muestra Creado, Actualizado, Mantenido como está, No se copia o Falló, y un enlace al elemento en producción. Un elemento no copiado o fallido dice qué pasó, por qué y cómo corregirlo. Un elemento fallido detiene solo el resto de su sección; todo lo demás se copia. Las dos empresas guardan una línea de auditoría: el sandbox dice a dónde se promovió y producción de dónde vino. El sandbox en sí nunca cambia.
Reintentá una ejecución fallida
Corregí lo que falló (cada elemento fallido dice cómo) y después seleccioná Reintentar y confirmá con tu segundo factor. La ejecución sigue donde se detuvo: lo que ya se copió se reconoce y nunca se copia dos veces.
Volvé a promover
Después de una ejecución, el sandbox y la producción pueden seguir cambiando. Seleccioná Volver a promover en una promoción completada para planificar una nueva desde el mismo sandbox hacia la misma empresa. Los elementos se emparejan con lo que hizo la última ejecución, así que el plan muestra solo lo que cambió. Se solicita y se aprueba como la primera.
Detené una promoción
Seleccioná Cancelar para cerrar una promoción en cualquier momento antes de que termine su ejecución: planificada, solicitada, aprobada, en ejecución o fallida. Una ejecución en curso se detiene después del elemento que está copiando; lo que ya copió queda en producción.