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:

1. Espaços de trabalho na nuvem: o controle de versões é gerenciado por meio de instantâneos no painel Alterar Histórico .
2. Espaços de trabalho locais: o controle de versão é gerenciado via Git no painel Controle de versão .

Controle de versão no Cloud Workspace

O controle de versão para soluções é manipulado dentro do painel Histórico de alterações por meio de snapshots. Você pode pensar nos snapshots como "points de verificação" da solução como vários estágios em seu desenvolvimento. Os Snapshots preservam todo o estado da solução, incluindo seus projetos de automação, recursos e configuração de implantação.

Snapshot types

Há vários tipos de snapshots:

1. Versão atual: a versão atual (mais recente) de uma solução. Ele é exibido na parte superior da lista de snapshots no painel Alterar histórico.
2. Instantâneos manuais: instantâneos criados manualmente por usuários. Elas têm um nome e uma descrição opcional. Selecionar ou passar o mouse sobre um snapshot manual mostra o nome de seu autor e quando ele foi criado. Só pode ser aberto no modo somente leitura.
3. 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").
4. Publicar instantâneos: instantâneos criados automaticamente cada vez que a solução é publicada. Seu nome é a versão da solução publicada. Passar o mouse sobre 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.

Painel de histórico de alteração

O painel Histórico de alterações lista todos os snapshots em ordem cronológica, mostrando seus:

• 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").

Você pode usar o botão Filtrar para controlar quais tipos de snapshots aparecem no painel Alterar Histórico.

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.

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:

1. 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.
2. Limite baseado em tempo: os instantâneos automáticos mais antigos que um período de retenção configurado são removidos automaticamente.

Creating a snapshot

Para criar um novo snapshot manual:

1. Open the Change history panel. Ensure that the Current version snapshot is selected.
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 Studio Web Designer or press the Enter key. The new snapshot is created and is added in the Change history panel.

Restoring from a snapshot

Uma das principais funcionalidades dos snapshots é a capacidade de restaurar a solução para um ponto específico no tempo. Por padrão, a restauração de uma solução a partir de um snapshot cria uma cópia do snapshot mais recente (ou seja, Versão atual) para referência. Isso garante que você não perca nenhum trabalho que você fez na versão mais recente da solução.

To restore a solution from a snapshot:

1. Open the Change History panel.
2. Passe o mouse sobre um instantâneo manual ou um instantâneo de publicação.
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.
7. Alternatively, turn the Create a snapshot of the current version toggle off to discard the latest version of the solution.

Turning the Create a snapshot of the current version toggle off restores the solution without saving the latest snapshot (the Current version snapshot). This means that 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.

Como pré-requisito, certifique-se de trabalhar em uma solução salva localmente:

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. Selecione a pasta em que uma solução existente é salva localmente ou indique uma pasta em que as novas soluções devem ser criadas. Sua nova solução local é aberta.
   Importante:

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

5. Abra no painel de controle da versão .

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.
• Cria uma ramificação local chamada "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.

O controle de versão do Git pode ser habilitado ou desabilitado em uma alternância dedicada no cabeçalho do painel Controle de versões . Você pode ter o controle de versão habilitado para algumas soluções e desabilitado para outras. Se você inicializar um novo repositório, o controle de versão é habilitado automaticamente.

.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:

1. Crie uma nova ramificação a partir do botão Criar nova ramificação . Insira o nome da ramificação e selecione Criar. A ramificação é adicionada à lista de ramificações disponíveis.
2. Alterne as ramificações selecionando um nome de ramificação na lista em Ramificações locais. A solução recarrega ao alternar entre ramificações.

Branches are grouped under local branches and remote branches. When you switch to a tracked remote branch, Studio Web checks whether your local branch has diverged from the remote:

• If your local branch is up to date, or can fast-forward cleanly, the switch happens immediately with no confirmation required.
• If the switch would discard unpushed local commits or uncommitted changes, a confirmation dialog appears before the switch happens.

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.
• O vermelho e o ícone - indicam que algo foi removido de um arquivo do projeto.

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 Confirmar para confirmar suas alterações sem enviá-las. Sua nova confirmação aparece na seção Histórico de confirmação .

4. Selecione Confirmar e forçar Push para confirmar suas alterações e forçar push delas. Essa opção está disponível apenas após você se conectar a um repositório remoto. Suas confirmações são enviadas por push para a ramificação atual no repositório remoto configurado.

   Se você tiver confirmações ainda não enviadas, selecione o ícone Forçar push ao lado do botão Confirmar no painel de controle de Versão .

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.

Selecione uma confirmação da lista e consulte a seção Alterações para essa confirmação específica.

Clique com o botão direito do mouse em 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.