Comparar conteúdo em diferentes estágios de implantação

Antes de implantar o conteúdo em um estágio diferente, pode ser útil ver as diferenças entre os dois estágios. A página inicial da implantação de pipelines compara fases consecutivas de implantação e indica se existe alguma diferença entre elas. Use os botões Comparar e Alterar revisão para exibir o conteúdo de cada pipeline e ver exatamente quais itens são diferentes e onde estão essas diferenças.

Os pipelines de implantação emparelham itens de dois estágios vizinhos, combinando tipo de item e nome de item, para saber quais itens comparar e substituir. Itens do mesmo nome e tipo são emparelhados. Se houver mais de um item com o mesmo nome e tipo em um espaço de trabalho, os itens serão emparelhados se seus caminhos forem os mesmos. Se o caminho não for o mesmo, os itens não serão emparelhados. O emparelhamento é criado apenas uma vez, durante a primeira implantação de um estágio em outro ou durante a atribuição de um espaço de trabalho. Em implantações subsequentes, cada item implantado substitui seus metadados de item emparelhados, incluindo o nome, se tiver sido alterado.

Comparar estágios

Um indicador de ícone de comparação aparece entre dois estágios sequenciais para dar uma indicação rápida das diferenças entre eles. O indicador de comparação tem dois estados:

• Indicador verde – os metadados de cada item de conteúdo em ambos os estágios são os mesmos.

• Indicador laranja – Aparecerá se uma destas condições for verdadeira:

  • Alguns dos itens de conteúdo em cada estágio foram alterados ou atualizados (têm metadados diferentes).
  • Há uma diferença no número de itens em cada fase.

Quando dois estágios sequenciais são diferentes, um link Comparar aparece abaixo do ícone de comparação laranja. Selecione Comparar para abrir a lista de itens de conteúdo em ambos os estágios. Essa Exibição de comparação ajuda a controlar alterações ou diferenças entre itens, em cada estágio do pipeline.

Na exibição de comparação, os itens emparelhados estão próximos uns dos outros, mesmo quando seus nomes são diferentes. Todos os itens no espaço de trabalho são listados em uma lista plana, independentemente de sua estrutura de pastas. Passe o mouse sobre um item para ver seu caminho e nome.

Os itens que não estão emparelhados ou que foram alterados recebem um dos seguintes rótulos:

• Novo – um novo item no estágio de origem. Esse item não existe no estágio de destino. Após a implantação, esse item será clonado para o estágio de destino.

• Diferente – Um item que existe tanto no estágio de origem quanto no de destino, em que uma das versões foi alterada após a última implantação. Após a implantação, o item no estágio de origem substituirá o item no estágio de destino, independentemente de onde a alteração foi feita.

  Modelos semânticos com regras de implantação configuradas que não foram implantadas também são marcados como diferentes, pois as regras de implantação não são aplicadas até que os modelos semânticos sejam implantados do a fase origem para a fase de destino.

• Ausente de – Este item aparece no estágio de destino, mas não no estágio de origem. A implantação não afeta esses itens.

Observação

Se você fizer alterações em uma pasta, como mover seu local ou renomeá-la, mesmo que não tenha alterado os itens nela contidos, os itens ainda serão tratados como se você os renomeasse. Portanto, ao comparar pipelines, os itens são rotulados como Diferentes.

Examinar as alterações em itens emparelhados

Se um item de texto, como um modelo semântico, for diferente, passe o mouse sobre ele para ver o botão Alterar revisão.

Se não houver nada a ser comparado, o botão será desabilitado. Se houver alterações no esquema, você poderá selecionar o botão para ver uma comparação detalhada linha por linha dos dois itens.

Quando você seleciona o botão Alterar revisão, uma janela pop-up é aberta com uma comparação linha por linha do conteúdo do item como ele parece atualmente nos dois estágios que estão sendo comparados.

A parte superior da tela tem as seguintes informações:

1. O nome do workspace seguido pelo nome do item como ele aparece no estágio de origem (a ser implantado).
2. O número total de alterações feitas no arquivo no estágio a ser modificado (verde) e o estágio a ser implantado (vermelho).
3. Setas para cima e para baixo que levam você para a diferença anterior ou próxima no arquivo.
4. Uma barra de navegação no lado direito com barras vermelhas ou verdes realçando onde as alterações estão no arquivo.
5. Botões que alternam entre uma exibição lado a lado e uma exibição embutida das alterações.
6. A janela de revisão de alteração com uma comparação linha por linha dos itens.

Visão lado a lado

Exibição embutida

Comparar alterações

Na exibição de comparação lado a lado dos itens, a área de código é dividida em dois:

• À esquerda está o conteúdo do item no estágio de destino da implantação. Esse estágio será modificado na próxima implantação. Seu conteúdo será substituído.
• À direita está o conteúdo do item no estágio de origem da implantação. Esse estágio será implantado. Seu conteúdo será aplicado.
• As linhas de cada lado aparecem na mesma ordem, portanto, cada linha está ao lado de seu equivalente no estágio comparado.

A exibição de comparação embutida, em oposição à exibição lado a lado, mostra cada linha no estágio de destino (a ser modificado) abaixo de seu equivalente no estágio de origem (a ser implantado).

Em ambas as exibições de comparação, seja embutidas ou lado a lado, as diferenças são realçadas da seguinte maneira:

• As linhas de conteúdo do arquivo são numeradas e as linhas que foram alteradas são marcadas da seguinte maneira:

  • As alterações mostradas no estágio A ser modificado serão removidas ou substituídas durante a próxima implantação. Elas são realçadas em vermelho com um sinal "-" ao lado do número.
  • As alterações mostradas no estágio A ser implantado são os novos valores que serão aplicados durante a próxima implantação. Elas são realçadas em verde com um sinal "+" ao lado do número.

• Nas linhas modificadas, os caracteres específicos que foram adicionados ou excluídos são realçados em um tom mais escuro.

Modificações de arquivo antes da comparação

As duas versões do conteúdo mostradas na janela de revisão de alteração são modificadas das seguintes maneiras para facilitar a comparação:

• As regras de fonte de dados e parâmetro são aplicadas ao item de origem para que a fonte de dados que você vê seja aquela que é implantada.
• Alguns campos que não indicam diferenças (por exemplo, carimbos de data/hora e associação de função) são removidos de ambos os itens.
• As tabelas gerenciadas pelo sistema, como a agregação automática, são removidas.
• Os itens são classificados para que campos e tabelas apareçam na mesma ordem.

Feche a janela quando terminar de examinar as diferenças e implantar no próximo estágio quando estiver pronto.

Considerações e limitações

• O recurso de revisão de alteração dá suporte apenas a alterações de esquema para tipos de item textuais. Atualmente, ele dá suporte a modelos semânticos, excluindo o formato de modelagem de dados v1 e fluxos de dados.

• Um item pode ser marcado como Diferente, mas ainda não se qualifica para revisão de alterações. Nesses casos, o botão Alterar revisão está desabilitado. Por exemplo:

  • As configurações são alteradas, como alteração de nome.
  • Ainda não há suporte para o tipo de item.
  • O item tem um status desconhecido porque o processo de comparação não foi concluído.

• O conteúdo na janela de revisão de alteração pode parecer um pouco diferente da versão original, pois foi modificado antes de executar a comparação.

Conteúdo relacionado

Implantar conteúdo na próxima fase