Compartilhar via


Controle de versão de fluxos de trabalho de ciclo de vida

Os fluxos de trabalho criados usando fluxos de trabalho do ciclo de vida podem ser atualizados conforme necessário para atender aos requisitos organizacionais em termos de auditoria do ciclo de vida dos usuários em sua organização. Para gerenciar atualizações em fluxos de trabalho, os fluxos de trabalho do ciclo de vida introduzem o conceito de controle de versão de fluxo de trabalho. As versões de fluxo de trabalho são novas versões de fluxos de trabalho existentes, disparadas pela atualização das condições de execução ou de suas tarefas. As versões do fluxo de trabalho podem alterar as ações ou até mesmo o escopo de um fluxo de trabalho existente. Entender como o controle de versão do fluxo de trabalho é tratado durante o processo de atualização do fluxo de trabalho permite que você configure estrategicamente fluxos de trabalho para que tarefas e condições de fluxos de trabalho sejam sempre relevantes para os usuários processados por um fluxo de trabalho.

Benefícios de controle de versão

O controle de versão com fluxos de trabalho do ciclo de vida oferece muitos benefícios sobre a alternativa de criar um novo fluxo de trabalho para cada caso de uso. Esses benefícios aparecem em sua capacidade de melhorar o processo de relatório para recursos de solução de problemas e de manutenção de registros das seguintes maneiras:

  • Retenção de longo prazo– O controle de versão permite uma retenção mais longa de informações de fluxo de trabalho do que usando apenas os logs de auditoria. Embora os logs de auditoria armazenem apenas informações dos 30 dias anteriores, com o controle de versão, você poderá acompanhar os detalhes do fluxo de trabalho da criação.
  • Rastreabilidade – permite o acompanhamento de qual versão específica de um fluxo de trabalho processou um usuário.

Propriedades e versões do fluxo de trabalho

Embora as atualizações nos fluxos de trabalho possam disparar a criação de uma nova versão, nem sempre esse é o caso. Há parâmetros de fluxos de trabalho conhecidos como propriedades básicas, que podem ser alterados sem criar uma nova versão do fluxo de trabalho. A lista desses parâmetros é a seguinte:

  • nome de exibição
  • descrição
  • está ativado
  • IsSchedulingEnabled
  • nome da tarefa
  • descrição da tarefa

Você encontrará esses parâmetros correspondentes no Centro de administração do Microsoft Entra na seção Propriedades do fluxo de trabalho que você está atualizando. Captura de tela do LCW de propriedades básicas atualizadas

Para obter um guia passo a passo sobre como atualizar essas propriedades usando o Centro de administração do Microsoft Entra e a API por meio do Microsoft Graph, consulte: Gerenciar propriedades de fluxo de trabalho.

As propriedades que dispararão a criação de uma nova versão são as seguintes:

  • tasks
  • executionConditions

Embora novas versões desses fluxos de trabalho sejam feitas assim que você fizer as atualizações no Centro de administração do Microsoft Entra, a criação de uma nova versão de um fluxo de trabalho usando a API com o Microsoft Graph requer a execução do método createNewVersion. Para obter um guia passo a passo para atualizar tarefas ou condições de execução, consulte: Gerenciar versões de fluxo de trabalho.

Observação

Se o fluxo de trabalho estiver sob demanda, as informações de configuração associadas às condições de execução não estarão presentes.

Quais detalhes estão contidos no histórico de versões do fluxo de trabalho

Ao contrário da alteração das propriedades básicas de um fluxo de trabalho, as versões de fluxo de trabalho recém-criadas podem ser muito diferentes das versões anteriores. As tarefas podem ser adicionadas ou removidas e para quem o fluxo de trabalho é executado pode ser diferente. Devido às grandes alterações que podem ocorrer em um fluxo de trabalho entre versões, os detalhes da versão também estão lá para fornecer informações detalhadas sobre não apenas a versão atual do fluxo de trabalho, mas também suas iterações anteriores.

Detalhes contidos nas informações de versão, conforme mostrado no Centro de administração do Microsoft Entra:

Captura de tela das informações de controle de versão do fluxo de trabalho.

As informações detalhadas da versão são as seguintes:

parâmetro descrição
Número de Versão Um inteiro que indica para qual versão do fluxo de trabalho as informações servem. Sequencialmente, aumenta a cada nova versão de fluxo de trabalho.
Data da última modificação A última vez que o fluxo de trabalho foi atualizado. Para versões anteriores de fluxos de trabalho, a última data modificada sempre será a hora em que a próxima versão foi criada.
Última modificação por Quem modificou pela última vez essa versão do fluxo de trabalho.
Data da criação A data e a hora de quando uma versão de fluxo de trabalho foi criada.
Criado por Quem criou essa versão específica do fluxo de trabalho.
Nome Nome do fluxo de trabalho nesta versão.
Descrição Descrição do fluxo de trabalho nesta versão.
Categoria Categoria do fluxo de trabalho.
Condições de execução Define para quem e quando o fluxo de trabalho é executado nesta versão.
Tarefas As tarefas presentes nesta versão de fluxo de trabalho. Se estiver exibindo por meio da API, você também poderá ver argumentos de tarefa. Para definições de tarefa específicas, consulte: Tarefas e definições do fluxo de trabalho do ciclo de vida

Próximas etapas