Controle de versão para soluções

Habilite e use o controle de versão para soluções no Studio Web para rastrear, restaurar e colaborar em versões de soluções sem substituir o trabalho dos membros da equipe.

O controle de versão melhora a colaboração na equipe, permitindo que vários usuários visualizem, rastreem e restaure diferentes versões de uma solução a qualquer momento. Isso permite que os desenvolvedores criem e testem automações sem substituir o trabalho um do outro.

O controle de versão no Studio Web funciona de forma diferente, dependendo do tipo de espaço de trabalho:

• Cloud Workspace: version control is managed via snapshots in the Change history panel.
• Local Workspace: version control is managed via Git in the Version control panel.

Controle de versão no Cloud Workspace

Version control for solutions is handled within the Change history panel through snapshots. You can think of snapshots as "checkpoints" of the solution at various stages in its development. Snapshots preserve the entire solution state, including its automation projects, resources, and deployment configuration.

Tipos de instantâneo

Há vários tipos de snapshots:

• Current version: The current (latest) version of a solution. It appears at the top of the list of snapshots in the Change history panel.
• Instantâneos manuais: instantâneos criados manualmente pelos usuários. Eles têm um nome e uma descrição opcional. Selecionar ou apontar para um instantâneo manual mostra o nome de seu autor e quando ele foi criado. Só pode ser aberto no modo somente leitura.
• Instantâneos automáticos: instantâneos criados automaticamente quando você fecha a solução e a cada 40 minutos, enquanto a solução é aberta. Os instantâneos automáticos têm nomes baseados em carimbo de data/hora (por exemplo, "Snapshot automático - 2026-03-14 10:40 UTC").
• Publicar instantâneos: instantâneos criados automaticamente cada vez que a solução é publicada. Seu nome é a versão da solução publicada. Apontar para um instantâneo de publicação mostra o nome de seu autor e quando ele foi criado. Só pode ser aberto no modo somente leitura.
  Observação:

  Todos os snapshots, incluindo os manuais, estão disponíveis para qualquer pessoa que tenha acesso à solução.

Os instantâneos automáticos têm limites de retenção baseados nos direitos da sua organização e podem variar dependendo do plano de licenciamento:

• Limite por solução: cada solução retém um número máximo de instantâneos automáticos. Quando esse limite for alcançado, os snapshots mais antigos serão removidos automaticamente à medida que novos forem adicionados.
• Limite baseado em tempo: os instantâneos automáticos mais antigos que um período de retenção configurado são removidos automaticamente.

Painel de histórico de alteração

The Change history panel lists all snapshots chronologically, showing their:

• Número e descrição da versão (por exemplo, "v1.1.0 - Formulário de feedback incluído").
• Autor e carimbo de data/hora (por exemplo, "2 meses atrás por João Silva").
• Título (por exemplo, "Compilação estável antes de testar a integração do NetSuite").

You can use the Filter button to control which types of snapshots appear in the Change history panel.

Ao selecionar um snapshot no painel, você está visualizando a solução como ela era naquele momento específico. Uma mensagem de banner temporário aparece ao navegar em um instantâneo anterior, informando que você está visualizando uma versão anterior da solução no modo somente leitura.

Criando um Snapshot

Para criar um novo snapshot manual:

1. Abra o painel Histórico de alterações . Certifique-se de que o instantâneo da versão atual esteja selecionado.
2. Selecione o botão Criar snapshot no canto superior direito do painel.
3. Insira um nome para seu snapshot.
4. Opcionalmente, pressione a tecla Tab ou selecione o campo Adicionar descrição para inserir uma descrição.
5. Select anywhere in the designer or press the Enter key. The new snapshot is created and is added in the Change history panel.

Restaurando a partir de um Snapshot

One of the main features of snapshots is the ability to restore the solution to a particular point in time. By default, restoring a solution from a snapshot creates a copy of the latest snapshot (that is, Current version) for reference. This ensures that you do not lose any work that you did on the latest version of the solution. You can't restore a snapshot while other people are editing the solution.

Para restaurar uma solução a partir de um instantâneo:

1. Abra o painel Histórico de alterações .
2. Point to a manual, auto, or publish snapshot.
3. Selecione o botão Restaurar . A janela Restaurar instantâneo é exibida.
4. No campo Título , insira um nome obrigatório para a cópia do instantâneo mais recente.
5. Opcionalmente, insira uma descrição das atualizações feitas na solução.
6. Selecione o botão Restaurar . Uma mensagem de banner é exibida, informando que a solução foi restaurada com sucesso para aquele ponto específico no tempo.

To restore without saving the latest snapshot (the Current version snapshot), turn off the Create a snapshot of the current version toggle in the Restore snapshot window, and then select Restore. In the Discard current snapshot window, select Discard and restore to confirm. The latest version of your solution is deleted.

Perguntas frequentes

Os snapshots automáticos afetam o desempenho?

Não. Os instantâneos automáticos são criados em segundo plano e não bloqueiam ou retardam seu trabalho no designer.

Posso excluir instantâneos automáticos individuais?

Não. Os instantâneos automáticos são gerenciados automaticamente pelo Studio Web e não podem ser excluídos individualmente. Os snapshots de automação antigos são removidos automaticamente com base na política de retenção.

Os snapshots automáticos contam para o meu armazenamento?

Sim. Os instantâneos automáticos usam o armazenamento em nuvem. Os limites de retenção garantem que o uso de armazenamento permaneça limitado.

Os instantâneos automáticos são visíveis para todos que têm acesso à solução?

Sim. Como todos os snapshots, os snapshots automáticos estão disponíveis para qualquer pessoa que tenha acesso à solução.

O que acontece com instantâneos automáticos em soluções compartilhadas?

As soluções compartilhadas seguem a mesma política de instantâneo automático que as soluções proprietárias. Os instantâneos automáticos são criados para qualquer usuário que abra e trabalhe na solução, e todos os instantâneos são visíveis para qualquer pessoa com acesso.

Posso criar instantâneos automáticos para soluções locais?

Não. Os snapshots do Auto estão disponíveis apenas para soluções em nuvem.

Controle de versão no espaço de trabalho local

O Studio Web integra-se ao Git para habilitar o controle de versão eficiente para soluções salvas localmente em sua máquina.

As a prerequisite, make sure you are working on a locally saved solution:

1. Abra o Studio Web.
2. Navegue até a página Espaço de trabalho local .
3. Abra uma solução local existente por meio do botão Abrir solução ou crie uma nova usando o botão Criar novo . Você também pode selecionar uma solução existente da lista de soluções abertas anteriormente.
4. Select the folder where an existing solution is saved locally or indicate a folder where the new solution is created. Your new local solution opens.
   Importante:

   Quando solicitado pelo navegador, permita que o Studio Web edite arquivos.

5. Open the Version control panel.

A primeira vez que você abre o painel, você é instruído a inicializar um repositório Git local. Essa etapa é obrigatória e é executada automaticamente selecionando o botão Inicializar repositório . Ao inicializar um repositório Git local, o Studio Web:

• Cria um arquivo .gitignore .
• Faz uma confirmação inicial com os arquivos atuais na solução.
• Creates a local branch named main.

Observação:

O nome da ramificação main aplica-se apenas aos repositórios inicializados pelo Studio Web. Se você se conectar a um repositório existente (criado manualmente ou clonado a partir de um remoto), o Studio Web usará a ramificação padrão existente desse repositório. Você pode renomear qualquer ramificação local manualmente a qualquer momento.

Git version control can be enabled or disabled from a dedicated toggle in the Version control panel header. You can have version control enabled for some solutions and disabled for others. If you initialize a new repository, version control is enabled automatically.

.gitignore

Quando você inicializa um repositório Git local, o Studio Web cria automaticamente um arquivo .gitignore com as seguintes entradas:

de transações	Description
.agent-builder	Artefato de agente temporário incluído.
.DS_Store	arquivo de metadados do macOS Finder; não faz parte do código-fonte.
*_UiCache.zip	Arquivos de cache de interface gráfica gerados; saída temporária.
**/.local	Cache local e diretórios de dados temporários em qualquer profundidade.
*.crswap	Arquivos de troca temporários criados durante a recuperação de falhas.
**/.entities/EntitiesBundle.*.zip	Arquivos de pacotes de entidades gerados.
remote-repository.config.json	Configuração local do Studio Web para conexões de repositório remotos.
.sw-path-marker	Arquivo marcador do Studio Web para rastreamento do caminho do espaço de trabalho.
venv/	Diretório de ambiente virtual do Python.
.venv/	Diretório de ambiente virtual Python alternativo.
__pycache__/	Diretório de cache de bytes do Python.

Criar e Gerenciar Ramificações

Selecione o nome da ramificação no canto superior esquerdo do painel de controle da Versão para:

• Crie uma nova ramificação usando o botão Criar nova ramificação . Digite o nome da ramificação e, em seguida, selecione Criar. A ramificação será adicionada à lista de ramificações disponíveis. Se o nome corresponder a uma ramificação existente, um erro em linha aparece no campo e a ramificação não é criada.
• Alterne as ramificações selecionando um nome de ramificação na lista em Ramificações locais ou Ramificações remotas.

As ramificações são agrupadas em ramificações locais e ramificações remotas.

Alternância de ramificações locais: o Studio Web mantém quaisquer alterações não confirmadas que não são afetadas pela alternância.

Se um arquivo tiver alterações não confirmadas que entram em conflito com a ramificação de destino, uma caixa de diálogo de confirmação aparecerá, perguntando se essas alterações devem ser descartadas e continuar. Recusar a caixa de diálogo cancela a alternância e suas alterações permanecem intactas.

Um arquivo que você excluiu localmente permanece excluído após a troca e ainda aparece em Alterações como uma exclusão que você pode descartar. A solução recarrega para refletir a nova ramificação.

Mudando para uma ramificação remota: quando você muda para uma ramificação remota rastreada, o Studio Web verifica se sua ramificação local se se se estiver aplicativo assim excluir da remota:

• Se sua ramificação local estiver atualizada ou puder avançar de forma limpa, a mudança acontecerá imediatamente sem necessidade de confirmação.
• Se a mudança descartar confirmações locais não enviadas ou alterações não confirmadas, uma caixa de diálogo de confirmação aparecerá antes que a mudança aconteça.

Enquanto uma alternância ou reversão da ramificação estiver em andamento, o painel de controle Versão é temporariamente desabilitado e exibe o nome da ramificação para a qual está sendo alterado. Isso impede que outras ações, como confirmação ou envio por push, sejam executadas até que a alternância seja concluída.

Conexão a um repositório remoto

Para conectar seu repositório local existente a um repositório remoto:

1. Selecione o ícone de opções no canto superior direito do painel de controle de Versão .
2. Selecione o botão Conectar ao GitHub . A janela de autenticação do GitHub é exibida.
3. Autentique-se no GitHub usando o conector do GitHub Integration Service.
4. Após a autenticação com sucesso, insira o URL para seu repositório remoto no campo URL do repositório .
5. Selecione o botão Salvar configuração .
6. Ou então, selecione Voltar para retornar ao painel de controle da versão .

Confirmação e envio de alterações

Ao trabalhar em uma solução, as alterações que você faz são gravadas em Alterações no painel de controle Versão . Selecione cada alteração na lista para ter uma visualização lado a lado do que foi alterado. As alterações são destacadas da seguinte forma:

• Verde e o ícone + indicam que algo foi adicionado a um arquivo de projeto.
• Laranja e o ícone / indicam que o arquivo foi modificado.
• Red and the - icon indicate that something has been removed from a project file.

Para confirmar as alterações feitas em sua solução e enviá-las para a ramificação em que você está atualmente:

1. Selecione o botão Confirmar no painel de controle Versão .
2. Insira uma mensagem de confirmação. As alterações incluídas na confirmação são exibidas na seção Alterações .
3. Selecione uma das seguintes opções:
   • Commit to commit your changes without pushing them. Your new commit appears in the Commit history section.
   • Commit & Push to commit your changes and push them to the current branch in the configured remote repository. This option is available only after you connect to a remote repository.

To push commits that you made earlier, select the Push button next to the Commit button in the Version control panel.

If the remote branch has commits that you don't have locally, the push is rejected and the Push rejected window appears. Select Force push to push your local commits anyway.

Importante:

Forçar substitui o histórico de confirmação do repositório remoto com seu histórico local, ignorando as verificações normais de segurança do Git:

• Regrava o histórico remoto: substitui confirmações na ramificação remota por suas confirmações locais.
• Descartar confirmações: quaisquer confirmações no remoto que não estão em sua ramificação local são excluídas do remoto.
• Atualiza o ponteiro da ramificação: em vez disso, aponta a ramificação remota para sua confirmação local.

Exibir o histórico de commits

A seção Histórico de confirmações contém todas as suas confirmações em ordem cronológica a partir da confirmação inicial. Cada confirmação mostra informações sobre seu autor e quando foi criada.

Select a commit from the list to see the Changes section for that particular commit.

Abra o menu de contexto para uma confirmação e selecione:

• Criar ramificação a partir dessa confirmação para criar uma nova ramificação local a partir desta confirmação. Dê um nome à nova ramificação e selecione Criar. A nova ramificação agora está ativa e aparece na lista de ramificações disponíveis.
• Redefina a ramificação local para esta confirmação para restaurar a ramificação atual para o estado em que estava quando a confirmação foi criada. As confirmações que são mais recentes que esta confirmação são excluídas automaticamente do histórico de Confirmações.