Comparar e mesclar projetos

O recurso Comparar permite ver exatamente o que difere entre dois projetos e, nas partes que podem ser copiadas com segurança, mesclar alterações selecionadas de um projeto no outro. Ele foi criado para duas situações do dia a dia:

• Promover alterações entre ambientes — revise o que é diferente entre um projeto de QA (desenvolvimento) e seu equivalente de Produção e leve para a Produção apenas as alterações desejadas.
• Revisar em relação a um instantâneo ou cópia anterior — compare um projeto com uma cópia dele mesmo (por exemplo, um clone mês a mês) para ver o que mudou.

Você mantém o controle o tempo todo: nada é gravado até você selecionar itens específicos e aplicá-los, e é possível validar antes com uma simulação.

Associadas item a item (por id para cópias, por nome para projetos independentes), cada diferença é marcada como alterada, adicionada ou igual. Você escolhe quais mesclar — nada chega à Produção até você aplicar.

Como funciona a correspondência

Para comparar dois projetos, o PlaidCloud precisa decidir qual item da esquerda corresponde a qual item da direita. Ele escolhe a estratégia automaticamente:

• Cópias e instantâneos do mesmo projeto são associados pelo id interno (um clone mantém os mesmos ids), de modo que até itens renomeados se alinham com precisão.
• Projetos independentes — como um projeto de QA e um projeto de Produção criado separadamente — não compartilham ids, portanto são associados por nome. Quando isso acontece, os itens recebem a marca (name-matched).

A correspondência por nome é o que torna útil uma comparação de QA com Produção, já que os dois projetos foram criados separadamente. Ela também tem limites: itens com nomes duplicados nem sempre podem ser pareados um a um, e um item sinalizado como ambiguous match significa que mais de um candidato tinha o mesmo nome — revise esses itens manualmente antes de mesclar.

Há uma terceira forma de associar, usada quando um projeto foi criado copiando do outro: o pareamento pela linhagem de cópia registrada, de modo que uma cópia renomeada ainda se alinhe com o original. Ela não é escolhida automaticamente — você a solicita com Ressincronizar em…, descrito em Ressincronizar a partir do projeto que você copiou.

Abrir uma comparação

1. Abra o Analyze
2. Selecione Projetos na barra de menus superior
3. Clique com o botão direito no projeto de que você quer partir (ou use o menu de ações dele) e escolha Comparar com…
4. Na janela Comparar projetos, o projeto de que você partiu já vem preenchido como Origem
5. Escolha o projeto Destino na lista suspensa — o projeto com o qual você quer comparar
6. Clique em Comparar

Nota

Use Trocar para inverter a Origem e o Destino antes de comparar — a direção importa, pois uma mesclagem copia da Origem para o Destino.

Os dois projetos precisam estar no mesmo espaço de trabalho.

Ler a comparação

O lado esquerdo agrupa cada diferença em sua categoria: Fluxos de trabalho (com suas Etapas aninhadas abaixo), Variáveis, Dimensões, Editores, UDFs, Visões e Tabelas.

Cada item recebe um selo com seu status:

• Adicionado — presente na Origem, mas não no Destino (seria criado no Destino)
• Modificado — presente em ambos, mas a configuração é diferente
• Excluído — presente no Destino, mas não na Origem
• Inalterado — idêntico nos dois lados (oculto por padrão)

Selecione um item alterado para ver os detalhes dele à direita: uma tabela Campo / Origem / Destino com o que mudou, e a Diferença de configuração completa logo abaixo. Se a diferença de um item for muito grande, ela é truncada — clique em Expandir diferença completa para carregar a versão completa.

Focar a lista

• Filtrar por nome ou caminho restringe a árvore aos itens correspondentes.
• As caixas de seleção de status mostram ou ocultam os itens Adicionado, Modificado, Excluído e Inalterado.
• Requer atenção manual mostra apenas as alterações que não podem ser mescladas automaticamente (veja abaixo).

O que pode ser mesclado

Nem toda diferença pode ser copiada com segurança entre projetos. A comparação rotula cada item para que você sempre saiba o que é mesclável:

• Fluxos de trabalho, Etapas e Variáveis podem ser mesclados.
• Dimensões, Editores, UDFs, Visões e Tabelas são somente para visualização — aparecem na comparação para que você possa revisá-los, mas você os copia usando as ferramentas próprias deles, não por aqui.

Algumas alterações individuais também são marcadas como manual (com um cadeado) mesmo em uma categoria mesclável, porque aplicá-las automaticamente não seria seguro. O painel de detalhes explica o motivo e o que fazer em vez disso. Os casos mais comuns:

• Etapas em uma comparação com correspondência por nome (QA versus Produção) são somente para revisão — a configuração de uma etapa pode referenciar conexões e agentes específicos do ambiente, portanto ela é copiada manualmente. Use a diferença para ver com precisão o que alterar no Destino.
• A exclusão de variáveis não é aplicada por você — remova a variável no projeto de Destino manualmente.

A linha de resumo mostra a divisão de relance, por exemplo “12 mesclável · 5 somente visualização” e “3 requerem atenção manual.”

Mesclar alterações

1. Selecione os itens que você quer copiar da Origem para o Destino. Use Selecionar tudo para escolher todos os itens mesclíveis exibidos no momento, ou selecione várias linhas individualmente. Itens somente para visualização e manuais não podem ser selecionados.
2. Clique em Simulação para validar a seleção sem gravar nada. O PlaidCloud informa quantas operações seriam aplicadas (novas versus atualizadas) e sinaliza as que falhariam.
3. Quando a simulação estiver correta, clique em Aplicar (no resultado da simulação ou no rodapé).
4. Confirme a operação na caixa de diálogo Confirmar mesclagem.

Os itens mesclados mantêm sua identidade no Destino, de modo que você pode executar a comparação novamente mais tarde e mesclar outras alterações sem criar duplicatas.

Cuidado

Uma mesclagem copia para dentro do projeto de Destino e o altera. Revise a diferença e faça uma simulação primeiro, e confira se a Origem e o Destino estão na direção certa.

Se algo der errado

• Destino alterado — se outra pessoa modificou o Destino depois que você carregou a comparação, a mesclagem para para evitar sobrescrever o trabalho dela. Atualize a comparação e aplique novamente.
• Mesclagem aplicada parcialmente — se uma operação falhar no meio do processo, as demais são informadas como restantes. Corrija a causa e escolha Tentar novamente os restantes, ou cancele e atualize.

Ressincronizar a partir do projeto que você copiou

A comparação funciona entre quaisquer dois projetos de um espaço de trabalho. Mas quando o Destino foi criado copiando da Origem — com Copiar projeto para um projeto existente — o PlaidCloud lembra qual objeto do Destino veio de qual objeto da Origem. Ressincronizar usa essa memória para comparar os dois da forma como eles realmente se relacionam, em vez de deduzir a partir de ids e nomes.

É isso que permite a um único tenant manter Dev, QA e Produção como projetos separados e promover alterações de um para o outro. Você copia o Dev para o QA uma vez; a partir daí, ressincronizar o QA com o Dev mostra apenas o que mudou no Dev desde então e permite levar para o QA as partes que você escolher — e depois do QA para a Produção da mesma forma. Sem exportação, sem arquivo, sem um segundo espaço de trabalho.

Por que isso importa

Uma comparação comum de dois projetos criados de forma independente precisa parear os itens por nome, porque eles não compartilham ids. Isso funciona até a cópia renomear algo. Quando Copiar projeto traz um objeto cujo nome ou id já existia no Destino, ele dá ao objeto recebido uma nova identidade (com copy anexado) — de modo que uma comparação simples vê a cópia renomeada como não relacionada ao original da Origem: o item da Origem aparece como Adicionado e a própria cópia dele no Destino aparece como Excluído, lado a lado. Você veria duas metades do mesmo objeto sem como alinhá-las.

A ressincronização pareia os itens por descendência — a linhagem de cópia registrada — de modo que um objeto renomeado ou renumerado ainda se alinha com aquele de que veio, e apenas as alterações genuínas aparecem como diferenças.

Executar uma ressincronização

1. Abra o Analyze
2. Selecione Projetos
3. Clique com o botão direito no projeto de que você copiou — a Origem, por exemplo o Dev — ou use o menu de ações dele, e escolha Ressincronizar em…
4. Escolha o Destino para o qual você copiou anteriormente — por exemplo, o QA
5. Clique em Ressincronizar

A janela é a mesma janela Comparar projetos, e tudo em Ler a comparação, O que pode ser mesclado e Mesclar alterações se aplica sem mudanças. A única diferença é como os itens são pareados.

Nota

Você parte da Origem e ressincroniza para dentro do Destino, portanto a direção já está correta — uma mesclagem ainda copia da Origem para o Destino, exatamente como em uma comparação comum.

Quando não há linhagem para usar

A ressincronização precisa de uma cópia registrada entre os dois projetos. Se você ressincronizar um par que nunca foi conectado por Copiar projeto — ou foi apenas em parte — o PlaidCloud avisa em vez de fingir:

• Nenhuma linhagem — um banner informa que a comparação voltou ao pareamento comum e não é uma ressincronização. Ela se comporta exatamente como uma comparação normal, incluindo a divisão Adicionado/Excluído para tudo que uma cópia anterior teria renomeado. É isso que você vê se ressincronizar dois projetos sem relação ou um par de projetos conectados por uma importação de arquivo em vez de Copiar projeto.
• Linhagem parcial — se a cópia cobriu apenas algumas categorias, um banner nomeia as que voltaram ao pareamento comum. Essas categorias são então pareadas por nome, o que mescla o mesmo subconjunto seguro de uma comparação de QA versus Produção — alterações de variáveis e de registros de fluxo de trabalho passam, enquanto etapas e fluxos de trabalho recém-adicionados ficam somente para revisão (veja O que pode ser mesclado).

De qualquer forma, o pareamento que você realmente obteve é o que a janela mostra e mescla — uma ressincronização nunca rebaixa silenciosamente para uma correspondência por nome enquanto informa que correspondeu por linhagem.

Relacionados

• Gerenciar projetos — controle de versões e acompanhamento pontual dentro de um único projeto
• Arquivar um projeto — capture um instantâneo de um momento específico com o qual comparar depois
• Fluxos de trabalho — o primitivo de automação que uma comparação mescla entre projetos