Quando um sandbox funciona do jeito que você quer, uma promoção copia a configuração dele e os dados mestres que as pessoas cadastraram para uma empresa de produção. Primeiro você planeja: o plano lista cada item que seria copiado e o que aconteceria com ele. Nada muda em produção enquanto você planeja.
O que é uma promoção
Uma promoção cria ou atualiza uma empresa de produção a partir de um sandbox. Ela copia a configuração e os dados mestres, nunca os registros de prática. O sandbox fica exatamente como estava: ele só é lido.
Proprietários e administradores da organização que recebe a cópia planejam as promoções em Promoções, no menu da organização. Na visão geral da organização, em Sandboxes, você também pode selecionar Promover para produção.
Planeje uma promoção
- Abra Promoções na organização e selecione Planejar uma promoção.
- Em Sandbox, escolha o sandbox de onde copiar. Você vê os sandboxes que administra, em qualquer uma das suas organizações.
- Em Empresa de produção, escolha Uma empresa de produção existente desta organização, ou Uma nova empresa de produção com o nome e o identificador de URL. Uma empresa nova só é criada quando a promoção é executada.
- Em O que copiar, desmarque as seções que você quer deixar de fora. No início, todas estão marcadas.
- Selecione Planejar. O plano abre.
O que é copiado
Configurações da empresa, tipos de trabalho e etapas, produtos, parceiros, locais e talhões, membros e suas funções, configurações das integrações (nunca as credenciais), destinos de webhooks e pontos de entrada, regras de lotes, automações, verificações, painéis e agendamentos de relatórios. Em uma empresa existente, os itens são pareados pela referência externa e depois pelo nome, então cada um mostra Criar, Atualizar ou Manter como está.
O que nunca é copiado
Lotes, movimentações, processamento, leituras e eventos de campo; certificados; aprovações e pedidos; dados de demonstração e tudo o que é simulado ou vem de uma conexão de teste; o histórico do registro; as declarações TRACES; relatórios e exportações; o histórico de auditoria; chaves, passkeys, chaves de API e segredos; conversas com o assistente. O plano lista os itens de demonstração e simulados como Não copiado, para você ver que eles ficam para trás.
Dados pessoais entre organizações
Dentro de uma organização, os dados pessoais são copiados com os itens. Quando o sandbox pertence a outra organização, a cópia vai para outro controlador dos dados, então nomes de pessoas, números de identificação fiscal, contatos, endereços e e-mails dos membros ficam para trás por padrão. Um parceiro que é uma pessoa fica para trás junto com suas propriedades e talhões. Marque Incluir dados pessoais só quando a organização do sandbox tiver base legal para compartilhá-los, como um acordo por escrito ou o consentimento das pessoas. Um pedido de exclusão em uma empresa não chega à outra: cada uma mantém a sua própria cópia.
Corrija os conflitos
Um item marcado como Conflito não é copiado. Cada um diz o que aconteceu, por quê e como corrigir, por exemplo dois itens com a mesma referência mas de tipos diferentes, ou uma configuração que a organização bloqueou. Corrija no sandbox ou em produção e depois selecione Planejar de novo. Planejar de novo usa as mesmas escolhas e atualiza o plano com o sandbox e a produção como estão agora. Cancelar plano fecha um plano sem mudar nada.
Solicite a promoção
Um plano não muda nada até ser solicitado e aprovado. Abra o plano em Promoções, selecione Solicitar promoção, adicione se quiser uma nota para quem aprova e confirme com seu segundo fator. O plano fica congelado: o que quem aprova vê é exatamente o que será copiado. Se o sandbox ou a produção mudaram desde que você planejou, a solicitação é recusada; selecione Planejar de novo, confira o novo plano e solicite.
Aprove ou rejeite
Um segundo proprietário ou administrador da empresa de produção aprova a solicitação: abre o plano em Promoções, lê e seleciona Aprovar, confirmando com o segundo fator. Quando a empresa de produção tem outro proprietário ou administrador, quem solicitou a promoção nunca pode aprová-la: vale o controle de quatro olhos, e um dos outros aprova.
Quando você é o único proprietário ou administrador da empresa de produção (e da sua organização), ninguém mais pode aprovar. O plano oferece então Aprovar como único administrador: você aprova a sua própria solicitação com o segundo fator, e isso fica registrado como autoaprovação pelo único administrador. Quem se tornar proprietário ou administrador da organização depois recebe um aviso sobre isso. Para ter o controle de quatro olhos, convide um segundo administrador em Organização → Pessoas com a função Administrador antes de aprovar; a partir daí, é essa pessoa quem aprova.
A aprovação é recusada se o sandbox ou a produção mudaram desde a solicitação; nesse caso é preciso planejar de novo. Rejeitar fecha uma promoção solicitada sem copiar nada.
As pessoas envolvidas recebem um aviso no sino, com um link para a promoção: os proprietários e administradores que podem aprovar, quando uma promoção os espera, e quem a solicitou, quando ela é aprovada, rejeitada, concluída ou falha. O plano mostra todos pelo nome: quem solicitou, quem aprovou e quem deu o aval da outra organização.
Elas também recebem um e-mail com o mesmo link. Quando a promoção vai para outra organização cuja empresa de produção ainda não existe, nenhum sino guarda o aviso: os proprietários e administradores dela o recebem por e-mail, e o registro de atividades da organização o anota.
Um sandbox de outra organização
Quando o sandbox pertence a outra organização, os dados dele passam para outro controlador, então um proprietário dessa organização também dá o seu aval. Ele encontra a solicitação na própria página Promoções, em Desta organização, e seleciona Aprovar com o segundo fator, ou Rejeitar. Os proprietários dessa organização recebem um aviso quando uma promoção os espera. Quem solicitou a promoção nunca dá esse aval se a organização tem outro proprietário. Quando quem solicita é o único proprietário dessa organização, a solicitação vale como aval, registrado da mesma forma que uma autoaprovação pelo único administrador. A execução começa quando as duas aprovações estão dadas.
A execução
Depois de aprovada, a promoção roda sozinha, seção por seção: a empresa, os tipos de trabalho e etapas, os produtos, os parceiros, os locais, as configurações, os membros, as integrações, os endpoints, as regras de lote e depois os demais rascunhos. A página mostra o andamento.
- Uma nova empresa de produção é criada na organização escolhida. Você é a proprietária ou o proprietário, e os proprietários e administradores da organização passam a ser administradores dela.
- Os produtos do catálogo da organização continuam vinculados a ele: dentro de uma mesma organização, a produção usa a mesma entrada do catálogo que o sandbox, nunca uma segunda cópia.
- Os membros recebem um convite com a mesma função. Ninguém ganha conta nem acesso antes de aceitar e configurar o app autenticador.
- As integrações viram conexões Live que precisam de credenciais: nada secreto é copiado. Ao abrir o formulário de conexão da integração, as configurações do sandbox já vêm preenchidas, então você só adiciona as credenciais. Deixar de lado remove uma de que você não precisa. O Início lista o que falta.
- As regras de lote ficam marcadas na configuração da empresa com as opções e configurações escolhidas no sandbox. Elas são ativadas pelo início do próprio ledger de produção e pela aprovação dele, nunca a partir do ledger de teste do sandbox.
- Automações, verificações, painéis, agendamentos de relatórios e endpoints chegam como rascunhos ou pausados, como com um arquivo de configuração. Se a produção já tem um com o mesmo nome, a versão da produção é mantida.
- Um local cujo parceiro não está na produção não é copiado, e o relatório diz por quê.
Veja o resultado
Quando a execução termina, cada item mostra Criado, Atualizado, Mantido como está, Não copiado ou Falhou, e um link para o item na produção. Um item não copiado ou que falhou diz o que aconteceu, por quê e como corrigir. Um item que falhou interrompe só o restante da sua seção; todo o resto é copiado. As duas empresas guardam uma linha de auditoria: o sandbox diz para onde foi promovido, e a produção de onde veio. O sandbox em si nunca muda.
Tente de novo uma execução que falhou
Corrija o que falhou (cada item que falhou diz como), depois selecione Tentar de novo e confirme com seu segundo fator. A execução continua de onde parou: o que já foi copiado é reconhecido e nunca é copiado duas vezes.
Promova de novo
Depois de uma execução, o sandbox e a produção podem continuar mudando. Selecione Promover de novo em uma promoção concluída para planejar uma nova do mesmo sandbox para a mesma empresa. Os itens são pareados com o que a última execução fez, então o plano mostra só o que mudou. Ela é solicitada e aprovada como a primeira.
Interrompa uma promoção
Selecione Cancelar para fechar uma promoção a qualquer momento antes de a execução terminar: planejada, solicitada, aprovada, em execução ou com falha. Uma execução em andamento para depois do item que está copiando; o que ela já copiou fica na produção.