> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/sandbox-management/sandbox-management-us-english-pt-br/sandboxes/criando-uma-sandbox-com-um-template.md).

# Criando uma Sandbox com um Template

## ![](https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2F6B2NEvLIqTPIjxRAb5oF%2FSummary2-Small-Icon.svg?alt=media\&token=b06e08da-3f2a-4100-88aa-8fcc17033b56) Visão geral

Este artigo explica como criar um sandbox do Salesforce a partir de uma organização de origem no Sandbox Management com um modelo e conectá-lo ao seu tenant. Quando o sandbox é conectado, ele é adicionado às Configurações Globais como uma organização e, em seguida, as etapas do modelo são executadas, de modo que cada sandbox que você criar com o modelo será configurado da mesma forma. Este artigo usa um modelo com os **Migração de Dados** e **Conectar à Topologia do Flosum** etapas ativadas.

O Sandbox Management usa o processo padrão de sandbox do Salesforce. Quando você cria um sandbox, o Salesforce o cria com uma das licenças de sandbox da sua organização Salesforce, e o novo sandbox aparece no Setup do Salesforce na **Sandboxes** página, ao lado dos seus outros sandboxes.

Para criar um sandbox sem um modelo, consulte o artigo a seguir.

* [Criando uma Sandbox](/sandbox-management/sandbox-management-us-english-pt-br/sandboxes/criando-uma-sandbox.md)

{% hint style="info" %}

#### Antes de começar

A organização que você copiar precisa estar conectada nas Configurações Globais e ter o aplicativo Sandbox Management atribuído. Apenas as organizações com o aplicativo atribuído aparecem no **Organização de origem** lista.

* [Adicionando organizações ao Gerenciamento de Sandbox](/sandbox-management/sandbox-management-us-english-pt-br/introducao/adicionando-organizacoes-ao-gerenciamento-de-sandbox.md)

Você também precisa de um modelo. Para criar um, consulte o artigo a seguir.

* [Criando um Template](/sandbox-management/sandbox-management-us-english-pt-br/modelos/criando-um-template.md)
  {% endhint %}

## Criando um Novo Sandbox com um Modelo

{% stepper %}
{% step %}

### Abrir o Formulário de Criação de Sandbox

1. Clique em **Sandboxes** no menu da barra lateral esquerda.
2. Clique em **Criar sandbox**.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FAfn56OQbcms7ey2VHMMt%2FCreatingASandboxWithATemplate-01.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Inserir os Detalhes do Sandbox

1. Insira um **Nome** para o sandbox.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2F7bkKtZWolstZ0oAsgHpo%2FCreatingASandboxWithATemplate-02.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="info" %}

#### Nomes de Sandbox

Um nome de sandbox pode conter apenas letras e números, não pode começar com um número e pode ter no máximo 10 caracteres.
{% endhint %}

2. Clique no **Organização de origem** menu suspenso.
3. Selecione a organização a ser copiada.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FdP3bqcDBrGPUq7HZid6f%2FCreatingASandboxWithATemplate-03.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>
4. Clique no **tipo de sandbox** menu suspenso.
5. Selecione **Developer**, **Developer Pro**, **Partial**, ou **Full**.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FkvBA4YoWVIXX6rIwacol%2FCreatingASandboxWithATemplate-04.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="info" %}

#### Licenças de Sandbox

Cada tipo de sandbox usa uma das licenças de sandbox da sua organização Salesforce. Selecione um tipo para o qual sua organização Salesforce tenha uma licença disponível.
{% endhint %}

6. Clique no **Acesso ao sandbox** menu suspenso.
7. Selecione o grupo público cujos membros podem acessar o sandbox. A lista mostra os grupos públicos na organização de origem. Para criar um grupo público para acesso ao sandbox, consulte [Determinar Quem Tem Acesso ao Sandbox](https://help.salesforce.com/s/articleView?id=sf.data_sandbox_selective_access.htm\&type=5) na Ajuda do Salesforce.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2F9unBaqGkkwlgmycO2vPr%2FCreatingASandboxWithATemplate-05.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>
8. (Opcional) Clique no **classe Apex** menu suspenso e selecione uma classe Apex para ser executada após a criação do sandbox. A classe deve implementar a `SandboxPostCopy` interface do Salesforce. A lista mostra todas as classes Apex na organização de origem, e uma classe que não implementa a interface não é executada.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FLa5cBYowKT7ULEnxgxc6%2FCreatingASandboxWithATemplate-06.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>
9. Clique no **Modelo** menu suspenso.
10. Selecione o modelo a ser aplicado.

    <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FLPRzdyfsld1mIm9t9gVB%2FCreatingASandboxWithATemplate-07.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="info" %}

#### Modelos e Topologias

Um modelo está disponível apenas na topologia em que você o cria. Você pode usá-lo com qualquer organização de origem nessa topologia.
{% endhint %}

11. Revise as etapas do modelo no painel de **Pré-visualização** .
12. Clique em **Criar**.

    <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FEysIvbNJNKgxNlsTgGMZ%2FCreatingASandboxWithATemplate-08.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Monitorar a Criação do Sandbox

A **Sandboxes** a lista não se atualiza sozinha, então você precisa atualizá-la para ver o progresso do sandbox.

{% hint style="info" %}

#### Tempo de Criação

Um novo sandbox leva cerca de um minuto para aparecer na **Sandboxes** lista. Criar um sandbox pode levar de vários minutos a vários dias, dependendo do tamanho da sua organização Salesforce e do tipo de sandbox.
{% endhint %}

1. Clique no ícone de atualização à direita da barra de pesquisa para atualizar a lista.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FthqD92RI5BoKdevPG3eu%2FCreatingASandboxWithATemplate-09.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
2. Enquanto o Salesforce está criando o sandbox, seu **Status** mostra **Criando** e o progresso dele.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2F9qaHwjbkqZsEFhNB84fX%2FCreatingASandboxWithATemplate-10.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
3. Quando o **Status** mudar para **Pronto para Conectar**, clique no sandbox.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2F7iL6dulv2u97ouxXJzcc%2FCreatingASandboxWithATemplate-11.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Entrar no Sandbox

{% hint style="info" %}

#### Entre Antes de Conectar

Antes de clicar em **Conectar**, faça login no novo sandbox como o usuário administrador dedicado com o qual você vai se conectar. O Salesforce pode solicitar que você configure uma chave de acesso ou um aplicativo autenticador na primeira vez que esse usuário fizer login. Concluir isso primeiro torna o processo de conexão mais simples. Para saber mais sobre o usuário administrador dedicado, consulte o artigo a seguir.

* [Criando um usuário dedicado do Salesforce](/global-settings/global-settings-docs-pt-br/ambiente/organizacoes/criando-um-usuario-dedicado-do-salesforce.md)
  {% endhint %}

1. Clique no URL de login do sandbox abaixo do nome dele para copiar o link.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FyWV4wwLGW4STxTFuWLMq%2FCreatingASandboxWithATemplate-12.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
2. Abra uma nova aba do navegador e cole o URL de login na barra de endereços.
3. Digite o **Nome de usuário** e **Senha** do usuário administrador.
4. Clique em **Entrar no Sandbox**.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FcvUXMvazLUwWWdxjZQV0%2FCreatingASandboxWithATemplate-13.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>
5. Se o Salesforce pedir que você crie uma chave de acesso, clique em **Criar Chave de Acesso** e siga as instruções.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2Foswhlk77YGPRoO4n9pC4%2FCreatingASandboxWithATemplate-14.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>
6. Volte ao Sandbox Management.
   {% endstep %}

{% step %}

### Conectar o Sandbox

1. Clique em **Conectar**.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FEnL60tTGk1LVOAiKiUwJ%2FCreatingASandboxWithATemplate-15.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
2. Digite o **Nome de usuário** do mesmo usuário administrador.
3. Clique em **Entrar no Sandbox** e conclua o login.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FuOt3b9Ge8Krfn3eiQc3V%2FCreatingASandboxWithATemplate-16.png?alt=media&amp;token=945607e1-f02e-4406-9e5f-580347aed937" alt="" width="375"><figcaption></figcaption></figure></div>
4. Clique em **Permitir**.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FRcrzMUHtBmC6WZ3SytNU%2FCreatingASandboxWithATemplate-17.png?alt=media" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="warning" %}

#### Entre no Sandbox Correto

Faça login com um usuário do sandbox que você está conectando. Se o login falhar, ou se você fizer login em um sandbox diferente, a organização será adicionada às Configurações Globais como **Inativa** e o sandbox não será conectado. Para tentar novamente, exclua a organização em Configurações Globais e, em seguida, clique em **Conectar** no Sandbox Management novamente.

* [Excluindo uma organização](/global-settings/global-settings-docs-pt-br/ambiente/organizacoes/excluindo-uma-organizacao.md)
  {% endhint %}
  {% endstep %}

{% step %}

### Revisar o Sandbox Conectado

Quando a conexão for concluída, o sandbox será adicionado às Configurações Globais como uma organização, com o **Dev** ambiente e o aplicativo Sandbox Management atribuídos. A organização tem o mesmo nome do sandbox. Todo novo sandbox começa com essas configurações, mesmo quando o seu modelo define um ambiente diferente ou outros aplicativos. O modelo aplica suas próprias configurações quando suas etapas são executadas, após o sandbox ser conectado.

1. As Configurações Globais abrem na **Organizações** página, onde você pode visualizar a nova organização.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FqYaJICqYAvZ6MccicEYT%2FCreatingASandboxWithATemplate-18.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

{% endstep %}

{% step %}

### Monitorar as Etapas do Modelo

Quando o sandbox é conectado, as etapas do modelo começam. Elas são executadas uma após a outra, na ordem mostrada no **Pré-visualização** .

1. No Sandbox Management, o **Status** mostra **Criando** enquanto as etapas do modelo são executadas. Clique no sandbox para ver seus detalhes.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FpS7ziaHlcSlmtLbEpSe1%2FCreatingASandboxWithATemplate-19.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
2. A **Execução** guia mostra o status de cada etapa.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2FP30E37K6vpKccv2ggqmJ%2FCreatingASandboxWithATemplate-20.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>
3. Quando cada etapa estiver **Concluída**, o **Status** mudar para **Pronto**.

   <div align="left"><figure><img src="https://1697387973-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F0DT0D4zemyodlhvoU1XB%2Fuploads%2Fx3aQCTgjKcgBuHPgJFQY%2FCreatingASandboxWithATemplate-21.png?alt=media" alt="" width="563"><figcaption></figcaption></figure></div>

{% hint style="info" %}

#### Alterar o Ambiente ou os Aplicativos Depois

Para alterar o ambiente ou os aplicativos da organização depois que as etapas do modelo forem concluídas, atualize a organização nas Configurações Globais.

* [Atualizar um ambiente da organização](/global-settings/global-settings-docs-pt-br/ambiente/organizacoes/atualizar-um-ambiente-da-organizacao.md)
* [Atribuindo um aplicativo a uma organização](/global-settings/global-settings-docs-pt-br/ambiente/organizacoes/atribuindo-um-aplicativo-a-uma-organizacao.md)
  {% endhint %}
  {% endstep %}
  {% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.flosum.com/sandbox-management/sandbox-management-us-english-pt-br/sandboxes/criando-uma-sandbox-com-um-template.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
