Versões dos artefatos de governança

Use o painel lateral Versões na visualização do artefato para acompanhar as alterações históricas dos artefatos, programar novas versões a serem publicadas no futuro e restaurar ou arquivar versões anteriores.

Os seguintes tipos de artefatos podem ser versionados:

  • Termos de negócios
  • Políticas
  • Regras de controle
  • Classificações
  • Classes de dados
  • Conjuntos de dados de referência

Ao editar um artefato e desejar publicar seu rascunho, você pode:

  • Atualizar a versão atual - Como resultado, as atualizações são publicadas como uma revisão do artefato publicado atualmente.
  • Publicar como uma nova versão usando a data e hora atuais - Como resultado, uma nova versão é publicada e a anterior fica inativa.
  • Publicar como uma nova versão programada para o futuro - Ao fornecer a data de início futura, você programa esta versão do artefato para substituir a versão ativa existente na data especificada.

A data de término efetiva não pode ser configurada manualmente. O artefato só se torna inativo na data em que uma nova versão é programada. A nova data de início torna-se a data de término da versão anterior.

Apenas a versão ativa de um artefato pode ser pesquisada na Pesquisa Global e está disponível nas listas ao adicionar relações ou realizar outras operações.

Observação: os artefatos que já estavam inativos antes da introdução do recurso de controle de versões no seu sistema desaparecerão das listas de artefatos publicados assim que o controle de versões estiver disponível. Isso significa que você não poderá criar novas versões desses artefatos. Antes da introdução do controle de versão, os artefatos inativos ainda podiam ser modificados.

Versões futuras

Você pode programar apenas uma versão futura por vez. Se uma versão futura apresentar uma etiqueta Pendente, isso indica um problema ou atraso durante o processo de publicação.

Você não pode visualizar, editar ou excluir uma versão futura diretamente na interface do usuário. Você só pode visualizar suas propriedades na janela de comparação de versões. Você pode excluir uma versão futura usando a API.

Sempre que você adiciona relações e valores de propriedade à versão ativa, eles são automaticamente adicionados à versão futura também.

Controle de versões e fluxo de trabalho

Quando um artefato está sujeito a um fluxo de trabalho, a decisão de criar uma revisão ou uma nova versão é tomada na primeira etapa do fluxo de trabalho. Se sua configuração incluir aprovações, essa decisão será tomada na etapa Enviar para aprovação.

Para visualizar o histórico completo do fluxo de trabalho de uma versão específica:

  1. Abra o artefato e clique no ícone Versões para abrir o painel lateral.
  2. Selecione uma versão específica e clique no menu de overflow.
  3. Clique em Exibir fluxo de trabalho.

O modal do histórico do fluxo de trabalho exibe todas as atividades do fluxo de trabalho para essa versão, incluindo decisões de aprovação e comentários dos usuários.

Visualizando versões e revisões

Ao visualizar um artefato, você pode usar o painel Versões para visualizar todas as versões e revisões em uma linha do tempo:

  • Use a barra de pesquisa para procurar uma versão específica.
  • Use o filtro para filtrar as versões por usuário que as criou ou modificou, ou pela data de modificação.
  • Clique em Ver modificações para ver o que foi modificado em uma revisão específica.
  • Use o menu de overflow para uma versão específica e restaure-a, arquive-a ou compare-a com outra versão.

Restaurando uma versão anterior

Quando você restaura uma versão anterior, o sistema cria um rascunho que pode ser editado posteriormente e deve passar pelo fluxo de trabalho. A versão restaurada é então publicada como uma nova versão (não como uma revisão).

Considerações importantes ao restaurar versões:

  • Restaurar uma versão afeta as propriedades do artefato, mas não as relações. As relações da versão atualmente ativa são refletidas no rascunho. Você pode editá-los se precisar alterá-los.
  • Depois que uma versão é arquivada, ela não pode mais ser restaurada.
  • Você só pode ter um rascunho restaurado por vez. Não é possível criar ramificações a partir de versões diferentes simultaneamente.

Para restaurar uma das versões anteriores:

  1. Abra o artefato e clique no ícone Versões para abrir o painel lateral.
  2. Selecione uma versão específica e clique no menu de overflow.
  3. Clique em Restaurar.
  4. Selecione se deseja restaurar a versão agora ou agendar para o futuro. Opcionalmente, deixe um comentário.
  5. Clique em Restaurar.

Comparando duas versões

  1. Abra o artefato e clique no ícone Versões para abrir o painel lateral.
  2. Selecione uma versão específica e clique no menu de overflow.
  3. Clique em Comparar.
  4. No painel que se abre, selecione a versão com a qual deseja comparar. As versões futuras estão identificadas com uma data.
  5. Use as caixas de seleção para destacar as diferenças entre as versões ou para visualizar apenas as diferenças.

Para conjuntos de dados de referência, está disponível uma guia separada para comparar as listas de valores de dados de referência. Você pode visualizar detalhes dos valores individuais dos dados de referência clicando em Exibir detalhes.

Edições e importações em massa

Ao trabalhar com importações e operações em massa, observe os seguintes comportamentos de controle de versão:

  • CSV importação: Os rascunhos criados pela reimportação de artefatos de arquivos CSV só podem ser publicados como novas revisões, não como novas versões.
  • Importação ZIP: reimportar artefatos existentes de arquivos ZIP cria novas revisões, não novas versões.
  • Edição em massa: os rascunhos criados por meio de operações de edição em massa só podem ser publicados como novas revisões, não como novas versões.