Partilhar via


Estratégia de guias de versionamento

Para gerenciar as alterações feitas nos guias, use uma estratégia de controle de versão. Recomendamos que sua organização distinga dois tipos de versões: maior e menor.

Versões principais

Sempre que sua organização precisar de uma nova versão de um guia existente em um ambiente de execução, crie uma nova versão principal. Neste caso, um guia denominado "Guia 1.0" muda seu nome para "Guia 2.0". O “2.0” indica que o guia atualizado substituiu uma versão anterior. O controle de versão principal permite o rastreamento de alterações feitas nos guias afetados. Valide uma nova versão principal de um guia antes de movê-lo para o estágio de execução, assim como você faz com qualquer guia. A versão é registrada no sistema de gestão da qualidade (SGQ) e, portanto, é rastreável.

Ao criar uma nova versão principal de um guia, considere o que deseja fazer com o guia que a nova versão principal substitui:

  • Descontinuação imediata: retire o guia substituído para um ambiente de arquivamento antes que a nova versão principal seja criada.
  • Retirada de substituição: retire o guia substituído para um ambiente de arquivamento quando a nova versão principal for aprovada e estiver pronta para execução.

Se um procedimento mudou e o guia atual não estiver mais em conformidade, considere usar a abordagem de retirada imediata . Caso contrário, a segurança ou a conformidade regulatória poderão estar em risco se um operador abrir o guia atual e seguir as instruções nele contidas. Neste caso, o primeiro passo é retirar o guia movendo-o para arquivo. Em seguida, você cria, valida e abre a nova versão principal do guia.

Diagrama que mostra um exemplo de aposentadoria imediata.

Em outro cenário, Power BI relatórios de dados de uso de um guia mostram que os operadores fazem uma pausa em um cartão de etapa específico. Como essa pausa pode indicar que as instruções não são claras, você decide refiná-las. Como esta atualização envolve otimização e não alterações processuais, não há necessidade de descontinuar a versão atual até que a nova seja aprovada e esteja pronta para execução. Portanto, considere usar a abordagem aposentadoria substitutiva . Nesse caso, o guia não será retirado até ser substituído pela nova versão principal.

Diagrama que mostra um exemplo de aposentadoria substitutiva.

Versões secundárias

Enquanto as versões principais são obrigatórias, as versões secundárias são opcionais. Versões secundárias são todas as alterações de versão feitas antes do guia chegar ao ambiente de execução. Se a sua organização não achar necessário acompanhar o ciclo de vida do conteúdo antes da fase de execução, as versões secundárias poderão ser omitidas.

Somente a versão secundária mais alta é transferida para o ambiente de execução.

Diagrama que mostra um exemplo de versionamento secundário.

Nesse caso, versionamento refere-se ao versionamento dos guias em Microsoft Power Platform. Não é necessariamente o mesmo que versionamento de registros no SGQ. (Nesse caso, o registro no SGQ está vinculado ao guia em Microsoft Power Platform.) Dependendo do sistema e processo implementado, a versão do registro no SGQ pode mudar sempre que forem feitas alterações nos metadados., como o título ou autor.

Recomendamos que você dissocie o controle de versão Microsoft Power Platform e o SGQ, para tornar o processo o mais flexível possível. Pode ser complicado manter o controle de versão sincronizado, porque uma alteração de versão no SGQ requer uma alteração de versão em Microsoft Power Platform. Mesmo que a alteração no registro no SGQ não tenha impacto no guia real, é necessária a reaprovação do guia.

Próximas etapas