Azure DevOps integração

Introdução à Azure DevOps integração

O Viva Goals integra-se ao Microsoft Azure DevOps do Azure para atualizar automaticamente os principais resultados e projetos no Viva Goals. O Resultado Chave e o progresso do Projeto são atualizados automaticamente com base nos itens de trabalho do DevOps do Azure conectados. Você pode usar a integração do DevOps do Azure para

• Acompanhar automaticamente o progresso de um resultado importante
• Acompanhar automaticamente o progresso de um KPI de iniciativa
• Acompanhe automaticamente o progresso e as tarefas de uma iniciativa.
  • Essa abordagem atualiza o progresso da iniciativa, sincroniza os detalhes do item de trabalho do Azure DevOps com as tarefas da iniciativa Viva Goals e, quando usada com a extensão do Viva Goals Azure DevOps, Viva Goals detalhes do alinhamento do OKR são exibidos diretamente nos itens de trabalho vinculados Azure DevOps.

Resultados (OKRs) vs Resultados (Iniciativas)

Um dos benefícios fundamentais dos OKRs (objetivos e resultados-chave) é distinguir entre resultados e saídas. Os OKRs e os principais resultados estão focados em gerar impacto (resultados), enquanto as iniciativas do Viva Goals estão focadas nos resultados, o trabalho planejado para alcançar os principais resultados. Ambas são métricas importantes para acompanhar, mas medem coisas diferentes.

Embora você possa integrar os principais resultados e iniciativas do Viva Goals com seus itens de trabalho do Azure DevOps, é importante entender a diferença. O DevOps do Azure se concentra principalmente no acompanhamento do trabalho, por isso é mais comum integrar iniciativas do Viva Goals ao DevOps do Azure. Há determinados exemplos em que pode fazer sentido acompanhar o progresso dos principais resultados com base nos itens de trabalho do Azure DevOps.

Quando usar a integração do DevOps do Azure

Há três maneiras de usar a integração do DevOps do Azure com fluxos de trabalho do Viva Goals.

1. Acompanhar o progresso de uma iniciativa com tarefas: Além de acompanhar o progresso da iniciativa com base nos itens de trabalho do DevOps do Azure, essa abordagem permite uma experiência do usuário multiplataforma. Os detalhes do item de trabalho do Azure DevOps são sincronizados com as exibições da iniciativa Viva Goals. O alinhamento do trabalho do Azure DevOps com os OKRs do Viva Goals pode ser exibido diretamente nos itens de trabalho do Azure DevOps vinculados por meio da Extensão do Azure DevOps.
2. Acompanhar o progresso de uma iniciativa com KPIs: Essa abordagem permite que você acompanhe o progresso da iniciativa com base no status dos itens de trabalho do DevOps do Azure. Um único valor numérico é sincronizado com os Viva Goals.
3. Acompanhar o progresso para obter um resultado-chave: Essa abordagem permite que você acompanhe o progresso do KR com base no status dos itens de trabalho do DevOps do Azure. Um único valor numérico é sincronizado com os Viva Goals.

Como configurar a integração do DevOps do Azure

A integração do DevOps do Azure precisa ser habilitada por um administrador do Viva Goals. Os administradores do Viva Goals devem primeiro habilitar a integração do DevOps do Azure para seu locatário (Habilitar integrações no Viva Goals | Microsoft Learn). Depois de habilitado no nível do locatário, um administrador da organização do Viva Goals deve habilitá-lo para sua organização (Visão geral da administração de integrações do Viva Goals.)

Como habilitar a integração do DevOps do Azure com iniciativas

Esse método é a abordagem recomendada para alinhar o trabalho no DevOps do Azure aos OKRs no Viva Goals. Além de acompanhar o progresso da iniciativa com base nos itens de trabalho do DevOps do Azure, essa abordagem permite uma experiência do usuário multiplataforma. Os detalhes do item de trabalho Azure DevOps são sincronizados com as exibições da iniciativa Viva Goals e, quando usado com a extensão Viva Goals Azure DevOps, o alinhamento do trabalho do Azure DevOps com Viva Goals OKRs é exibido diretamente nos itens de trabalho Azure DevOps vinculados.

1. Selecione Adicionar Iniciativa no Viva Goals ou edite uma iniciativa existente.

2. Selecione Resultado.

3. Selecione Adicionar tarefas.

4. Selecione Automaticamente de uma fonte de dados.

5. Selecione Azure DevOps na lista de integrações disponíveis.

6. Selecione a conexão apropriada do Azure DevOps. Se você precisar criar uma nova conexão do Azure DevOps, precisará entrar no Azure DevOps para criar uma conexão de dados. Uma nova conexão é necessária para cada projeto do Azure DevOps. Depois de entrar:

   • Forneça um nome de conexão: você pode incluir a Organização e o Projeto do Azure DevOps no nome para referência futura.
   • Selecione a organização DevOps do Azure.
   • Selecione o projeto DevOps do Azure.
   • Selecione Avançar.

7. Selecione o método de conexão:

   • Consulta Compartilhada: permite que você se conecte a uma consulta existente salva no Azure DevOps.
   • Itens de trabalho: permite que você se conecte a um ou mais itens de trabalho de um tipo de item de trabalho específico. Essa abordagem permite que você se conecte diretamente aos itens de trabalho pai que contêm o trabalho de suporte; Os itens de trabalho filho são incluídos automaticamente.

Se estiver usando o método conectar-se a Consulta Compartilhada

1. Selecione o método de consulta compartilhada .
2. Pesquise e selecione a consulta compartilhada que contém os itens de trabalho do Azure DevOps.
3. Selecione o tipo de item de trabalho a ser usado para calcular o progresso de sua iniciativa. Você pode escolher entre qualquer tipo de item de trabalho na consulta ou todos os itens de trabalho na consulta compartilhada.
4. Selecione o campo do Azure DevOps que você deseja usar para acompanhar o progresso da iniciativa. O progresso da iniciativa Viva Goals é calculado como a % concluída do tipo de item de trabalho escolhido.
5. Selecione Avançar..
6. Selecione Salvar..

O ícone do Azure DevOps agora aparece ao lado da sua iniciativa. Os detalhes do item de trabalho do DevOps do Azure agora também aparecem nas exibições da iniciativa do Viva Goals. O Viva Goals sincroniza automaticamente os detalhes do item de trabalho e atualiza o progresso da iniciativa uma vez por hora com base no campo ADO para os tipos de item de trabalho selecionados em sua consulta compartilhada.

Se estiver usando o método Conectar aos Itens de Trabalho

1. Selecione o método de itens de trabalho .
2. Selecione o tipo de item de trabalho ao qual se conectar – é recomendável escolher o tipo de item de trabalho pai na hierarquia do DevOps do Azure que contém o trabalho que está sendo feito. A integração incluirá automaticamente os itens de trabalho filho.
3. Pesquise e selecione os itens de trabalho específicos do tipo escolhido.
4. Selecione o tipo de item de trabalho a ser usado para calcular o progresso de sua iniciativa. Você pode optar por medir o progresso por um tipo de item de trabalho específico (o tipo ao qual você se conecta diretamente ou qualquer um de seus tipos filhos) ou todos os itens de trabalho (conectados e filhos).
5. Selecione o campo do ADO que você deseja usar para acompanhar o progresso da iniciativa.
6. Selecione Avançar.
7. Selecione Salvar.

O ícone do Azure DevOps agora aparece ao lado da sua iniciativa. Os detalhes do item de trabalho do DevOps do Azure agora também aparecem nas exibições da iniciativa do Viva Goals. O Viva Goals sincroniza automaticamente os detalhes do item de trabalho e atualiza o progresso dessa iniciativa uma vez por hora com base no campo do Azure DevOps para os tipos de item de trabalho selecionados.

Depois de concluir essas etapas, o progresso da iniciativa Viva Goals é atualizado automaticamente regularmente. Além disso, os detalhes do item de trabalho do Azure DevOps são mostrados nas exibições da iniciativa Viva Goals, juntamente com hiperlinks para os detalhes do item de trabalho do Azure DevOps. Se você habilitou a extensão Viva Goals Azure DevOps, o alinhamento completo entre OKRs e os itens de trabalho Azure DevOps pode ser acessado em uma guia Viva Goals dentro dos itens de trabalho Azure DevOps vinculados.

Como usar a integração do DevOps do Azure com KPIs de iniciativa

Use esse método quando quiser atualizar o progresso da iniciativa Viva Goals com um único valor numérico. Essa abordagem não mostra os itens de trabalho do DevOps do Azure nas exibições de iniciativa do Viva Goals. Esse método não pode inserir o Viva Goals nos itens de trabalho do DevOps do Azure.

1. Selecione Adicionar Iniciativa no Viva Goals ou edite uma iniciativa existente.

2. Selecione Resultado.

3. Selecione Adicionar métrica e preencha os detalhes necessários (nome, tipo, unidades, inicial, valores-alvo).

   • Para métricas baseadas em porcentagem, o progresso da iniciativa é calculado com base na % do valor do campo ADO selecionado para itens de trabalho concluídos versus itens de trabalho totais.
   • Para métricas não baseadas em porcentagem (numérico, moeda), o progresso da iniciativa é uma contagem do valor do campo ADO selecionado para itens de trabalho concluídos ou, opcionalmente, totais.

4. Selecione Progresso.

5. Selecione Automaticamente de uma fonte de dados.

6. Selecione Azure DevOps na lista de integrações disponíveis.

7. Selecione a conexão apropriada do Azure DevOps. Se você precisar criar uma nova conexão do Azure DevOps, precisará entrar no Azure DevOps para criar uma conexão de dados. Uma nova conexão é necessária para cada projeto do Azure DevOps. Depois de entrar:

   • Forneça um nome de conexão: você pode incluir a organização e as iniciativas do Azure DevOps no nome para facilitar a referência futura.
   • Selecione a organização DevOps do Azure.
   • Selecione o projeto DevOps do Azure.
   • Selecione Avançar.

8. Selecione o método de conexão:

   • Consulta Compartilhada: permite que você se conecte a uma consulta existente armazenada no Azure DevOps
   • Itens de trabalho: permite que você se conecte a um ou mais itens de trabalho de um tipo de item de trabalho específico. Essa abordagem permite que você se conecte diretamente aos itens de trabalho pai que contêm o trabalho de suporte; Os itens de trabalho filho são considerados automaticamente.

Se estiver usando o método conectar-se a Consulta Compartilhada

1. Selecione o método de consulta compartilhada .
2. Pesquise e selecione a consulta compartilhada que contém os itens de trabalho do Azure DevOps.
3. Selecione o tipo de item de trabalho a ser usado para calcular o progresso de sua iniciativa. Você pode escolher entre qualquer tipo de item de trabalho na consulta ou todos os itens de trabalho na consulta.
4. Selecione o campo do Azure DevOps que você deseja usar para acompanhar o progresso da iniciativa.
5. Selecione Avançar.
6. Selecione Salvar.

Agora você deve ver o ícone do Azure DevOps ao lado de sua iniciativa. O Viva Goals atualiza automaticamente o progresso uma vez por hora.

Se estiver usando o método Conectar aos Itens de Trabalho

1. Selecione o método de itens de trabalho .
2. Selecione o 'tipo de item de trabalho' para se conectar – recomendamos escolher o tipo de item de trabalho "pai" em sua hierarquia do Azure DevOps que contém o trabalho que está sendo feito. A integração inclui automaticamente os itens de trabalho filho. Por exemplo, conecte-se a um recurso que é o pai das tarefas em vez de conectar-se a cada tarefa individual.
3. Pesquise e selecione os itens de trabalho específicos do tipo escolhido.
4. Selecione o tipo de item de trabalho a ser usado para calcular o progresso de sua iniciativa. Você pode optar por medir o progresso por um tipo de item de trabalho específico (o tipo ao qual você se conecta diretamente ou qualquer um de seus tipos filhos) ou todos os itens de trabalho (conectados e filhos).
5. Selecione o campo do ADO que você deseja usar para acompanhar o progresso da iniciativa.
6. Selecione Avançar.
7. Selecione Salvar.

Agora você deve ver o ícone do Azure DevOps ao lado de sua iniciativa. O Viva Goals atualiza automaticamente essa iniciativa uma vez por hora.

Como usar a integração do DevOps do Azure com um resultado chave

Use esse método quando quiser atualizar o progresso do Resultado Principal do Viva Goals com um único valor numérico. Essa abordagem não revela os itens de trabalho do DevOps do Azure no Viva Goals; nem esse método tem a capacidade de inserir o Viva Goals nos itens de trabalho do DevOps do Azure.

1. Selecione Adicionar Resultado-chave no Viva Goals ou edite um Resultado-chave existente.

2. Selecione Adicionar métrica e preencha os detalhes necessários (nome, tipo, unidades, inicial, valores-alvo).

   • Para métricas baseadas em porcentagem, o progresso do resultado principal é calculado com base na % do valor do campo ADO selecionado para itens de trabalho concluídos versus itens de trabalho totais.
   • Para métricas não baseadas em porcentagem (numérico, moeda), o progresso do resultado da chave é uma contagem do valor do campo do ADO selecionado para itens de trabalho concluídos ou, opcionalmente, totais.

3. Selecione Progresso.

4. Selecione Automaticamente de uma fonte de dados.

5. Selecione Azure DevOps na lista de integrações disponíveis.

6. Selecione a conexão apropriada do Azure DevOps. Se você precisar criar uma nova conexão do Azure DevOps, precisará entrar no Azure DevOps para criar uma conexão de dados. Uma nova conexão é necessária para cada projeto do Azure DevOps. Depois de entrar:

   • Forneça um Nome da Conexão: é recomendável incluir a organização e a iniciativa do Azure DevOps no nome para facilitar a referência futura.
   • Selecione a organização DevOps do Azure.
   • Selecione o projeto DevOps do Azure.
   • Selecione Avançar.

7. Selecione o método de conexão:

   • Consulta Compartilhada: permite que você se conecte a uma consulta existente armazenada no Azure DevOps
   • Itens de trabalho: permite que você se conecte a um ou mais itens de trabalho de um tipo de item de trabalho específico. Essa abordagem permite que você se conecte diretamente aos itens de trabalho "pai" que contêm o trabalho de apoio; Os itens de trabalho filho são considerados automaticamente.

Se estiver usando o método conectar-se a Consulta Compartilhada

1. Selecione o método de consulta compartilhada .
2. Pesquise e selecione a consulta compartilhada que contém os itens de trabalho do Azure DevOps.
3. Selecione o tipo de item de trabalho que deseja usar para calcular o progresso do resultado principal. Você pode escolher entre qualquer tipo de item de trabalho na consulta ou todos os itens de trabalho na consulta compartilhada.
4. Selecione o campo do ADO que você deseja usar para acompanhar o progresso do resultado da chave.
5. Selecione Avançar.
6. Selecione Salvar.

Agora você deve ver o ícone do Azure DevOps ao lado do resultado da chave. O Viva Goals atualiza automaticamente o progresso uma vez por hora.

Se estiver usando o método Conectar aos Itens de Trabalho

1. Selecione o método de itens de trabalho .
2. Selecione o 'tipo de item de trabalho' para se conectar – recomendamos escolher o tipo de item de trabalho "pai" em sua hierarquia do Azure DevOps que contém o trabalho que está sendo feito. A integração incluirá automaticamente os itens de trabalho filho. Por exemplo, conecte-se a um recurso que é o pai das tarefas em vez de conectar-se a cada tarefa individual.
3. Pesquise e selecione os itens de trabalho específicos do tipo escolhido.
4. Selecione o tipo de item de trabalho que deseja usar para calcular o progresso do resultado principal. Você pode optar por medir o progresso por um tipo de item de trabalho específico (o tipo ao qual você se conecta diretamente ou qualquer um de seus tipos filhos) ou todos os itens de trabalho (conectados e filhos).
5. Selecione o campo do ADO que você deseja usar para acompanhar o progresso do resultado da chave.
6. Selecione Avançar.
7. Selecione Salvar.

Agora você deve ver o ícone do DevOps do Azure ao lado do resultado principal. O Viva Goals atualiza automaticamente essa iniciativa uma vez por hora com base no campo ADO dos tipos de item de trabalho selecionados.

Cálculo de progresso para campos ADO no Viva Goals

Solução de problemas de conexão

Para se integrar ao DevOps do Azure, o Serviço Viva Goals precisa ser capaz de acessar os itens de trabalho na Organização DevOps do Azure e na iniciativa que você configura ao criar a conexão no Viva Goals. Dependendo de como sua organização gerencia as políticas de Acesso Condicional do Microsoft Entra e as permissões do DevOps do Azure, o Viva Goals pode não conseguir acessar informações.

Erros Proibidos

Se você encontrar mensagens de erro proibidas ao criar uma conexão DevOps do Azure, provavelmente encontrará restrições de endereço IP ou outras Políticas de Acesso Condicional. Nesse caso, você precisa verificar se a política de validação CAP Habilitar o Microsoft Entra ID está habilitada na organização do Azure DevOps. Para obter mais detalhes, consulte a documentação do Azure DevOps.

Soluções

Você tem duas opções. Você pode desativar a política de validação CAP para Habilitar o Microsoft Entra ID na organização do Azure DevOps. O que exigiria um Administrador do DevOps do Azure ou você precisa adicionar os endereços IP de saída do serviço Viva Goals às Políticas de Acesso Condicional para seus locatários do Microsoft Entra ID.

FAQ (Perguntas frequentes)

1. Ao conectar minhas tarefas da iniciativa Viva Goals ao DevOps do Azure, por que não vejo todos os itens de trabalho em minha consulta compartilhada e/ou todos os itens de trabalho filho ao usar o método "conectar ao item de trabalho"?

   Se estiver conectando sua iniciativa do Viva Goals ao DevOps do Azure, o Viva Goals não expõe todos os itens de trabalho. O que o Viva Goals mostra depende de como você escolhe calcular o progresso geral da iniciativa Viva Goals durante o processo de configuração. Se você optar por calcular o progresso da iniciativa por qualquer item de trabalho, o Viva Goals realmente exporá todos os itens de trabalho de consulta compartilhada ou todos os itens filho, se você tiver se conectado diretamente aos itens de trabalho.

   No entanto, acreditamos que escolher "qualquer" tipo de item de trabalho é a exceção, pois essa abordagem exporia uma quantidade excessiva de detalhes de item de trabalho não necessários na experiência do usuário do Viva Goals. Presumimos que a maioria dos usuários opte por calcular o progresso por um tipo de item de trabalho específico dentro da consulta compartilhada ou um filho dos itens de trabalho conectados. O Viva Goals usará essa decisão para limitar o que expomos na experiência do usuário do Viva Goals.

   Por exemplo, suponha que seu trabalho de DevOps do Azure esteja acompanhando Recursos, Histórias de Usuário e Tarefas. Suponha ainda que você opte por acompanhar o progresso da iniciativa Viva Goals com base na conclusão da História do Usuário. O Viva Goals mostrará apenas os Recursos e Histórias de Usuário nos modos de exibição da iniciativa Viva Goals. Os usuários podem rapidamente "clicar duas vezes" no Azure DevOps para obter mais detalhes, conforme necessário.