Controle de versão dos fluxos de trabalho do ciclo de vida
Os fluxos de trabalho criados usando os 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 na organização. Para gerenciar atualizações nos fluxos de trabalho, os fluxos de trabalho do ciclo de vida apresentam o conceito de controle de versão do fluxo de trabalho. As versões do fluxo de trabalho são novas versões dos 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. Reconhecer 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 os fluxos de trabalho de maneira estratégica para que as tarefas e as condições dos fluxos de trabalho sejam sempre relevantes aos usuários processados por um fluxo de trabalho.
Benefícios do controle de versão
O controle de versão com fluxos de trabalho do ciclo de vida fornece muitos benefícios em relação à alternativa de criar um novo fluxo de trabalho para cada caso de uso. Esses benefícios estão na capacidade de melhorar o processo de geração de relatórios para recursos de solução de problemas e manutenção de registros das seguintes maneiras:
- Retenção de longo prazo: o controle de versão permite uma retenção mais longa das informações do fluxo de trabalho do que usando apenas os logs de auditoria. Enquanto os logs de auditoria armazenam apenas as informações dos 30 dias anteriores, com o controle de versão é possível acompanhar os detalhes do fluxo de trabalho desde a criação.
- Rastreabilidade: permite rastrear 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, isso nem sempre acontecerá. Há parâmetros de fluxos de trabalho, conhecidos como propriedades básicas, que podem ser atualizados sem que uma nova versão do fluxo de trabalho seja criada. A lista desses parâmetros é a seguinte:
- displayName
- descrição
- isEnabled
- 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 está atualizando.
Para obter um guia passo a passo sobre como atualizar essas propriedades usando o centro de administração do Microsoft Entra e a API do Microsoft Graph, consulte: Gerenciar propriedades do fluxo de trabalho.
As propriedades que dispararão a criação de uma nova versão são as seguintes:
- tarefas
- executionConditions
Embora novas versões desses fluxos de trabalho sejam feitas assim que as atualizações são feitas no centro de administração do Microsoft Entra, criar uma versão de um fluxo de trabalho usando a API do Microsoft Graph exigirá executar o método createNewVersion. Para obter um guia passo a passo para atualizar as tarefas ou as condições de execução, consulte: Gerenciar versões do fluxo de trabalho.
Observação
Se o fluxo de trabalho for 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 poderão ser muito diferentes das versões anteriores. Tarefas podem ser adicionadas ou removidas e dependendo de para quem o fluxo de trabalho é executado, isso pode ser diferente. Devido às grandes alterações que poderão ocorrer em um fluxo de trabalho entre versões, os detalhes da versão também estarão incluídos para fornecer informações detalhadas não apenas sobre a versão atual do fluxo de trabalho, mas também sobre as iterações anteriores.
Detalhes contidos nas informações de versão, conforme mostrado no centro de administração do Microsoft Entra:
As Informações da versão detalhadas são as seguintes:
| parâmetro | descrição |
|---|---|
| Número da versão | Um número inteiro que indica para qual versão do fluxo de trabalho as informações se aplicam. Aumenta cada nova versão do fluxo de trabalho em sequência. |
| Data da última modificação | A última vez que o fluxo de trabalho foi atualizado. Para versões anteriores dos fluxos de trabalho, a data da última modificação será sempre a hora em que a próxima versão foi criada. |
| Última modificação feita por | Quem modificou essa versão do fluxo de trabalho pela última vez. |
| Data da criação | A data e hora de quando uma versão do fluxo de trabalho foi criada. |
| Criado por | Quem criou essa versão do fluxo de trabalho específica. |
| Nome | Nome do fluxo de trabalho nessa versão. |
| Descrição | Descrição do fluxo de trabalho nessa versão. |
| Categoria | Categoria do fluxo de trabalho. |
| Condições de execução | Define para quem e quando o fluxo de trabalho executa nessa versão. |
| Tarefas | As tarefas presentes nessa versão do fluxo de trabalho. Se estiver exibindo por meio da API, também será possível visualizar os argumentos da tarefa. Para definições de tarefas específicas, consulte: Tarefas e definições do fluxo de trabalho do ciclo de vida |