Controle de versão para soluções

O controle de versões melhora a colaboração da 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 umas das outras.

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 em nuvem é 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.

Há três tipos de snapshots:

1. Instantâneo automático: a versão atual (mais recente) de uma solução. Ela aparece como Versão atual na parte superior da lista de instantâneos 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. 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.

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

Ao selecionar um snapshot no painel Histórico de alterações, 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.

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. Clique em qualquer lugar no Studio Web Designer ou pressione a tecla Enter . O novo snapshot é criado e adicionado no painel Alterar Histórico.

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.

Para acessar a funcionalidade de restauração:

1. Abra o painel Histórico de alterações.
2. Selecione um instantâneo manual ou um instantâneo de publicação.
3. Clique com o botão direito no snapshot.
4. Selecione Restaurar solução inteira. A janela Restaurar instantâneo é exibida.
5. No campo Título , insira um nome obrigatório para a cópia do instantâneo mais recente.
6. Opcionalmente, insira uma descrição das atualizações feitas na solução.
7. 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.
8. Como alternativa, selecione Restaurar sem salvar para descartar a versão mais recente da solução.

Selecionar Restaurar sem salvar restaura a solução sem salvar o instantâneo mais recente (o instantâneo da versão atual ). Isso significa que a versão mais recente da sua solução foi excluída.

Observação: atualmente, você não pode restaurar uma solução compartilhada.

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 seu 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 "mestre".

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.

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. Sua nova confirmação aparece na seção Histórico de confirmações .

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.
• Redefinir ramificação local para esta confirmação para restaurar a ramificação atual para o estado que tinha quando a confirmação foi criada. Confirmações que são mais recentes que essa são excluídas automaticamente do Histórico de confirmações.