Azure DevOps integração

Introdução à Azure DevOps integração

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

• Acompanhar automaticamente o progresso de um resultado chave
• Acompanhar automaticamente o progresso de uma 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 Viva Goals iniciativa "tarefas" e, quando usada com a extensão Viva Goals Azure DevOps, Viva Goals detalhes de alinhamento OKR são exibidos diretamente nos itens de trabalho vinculados do Azure DevOps.

Confira abaixo mais detalhes sobre como funciona a integração do Azure DevOps ao se conectar a resultados importantes, métricas de iniciativas e tarefas de iniciativa.

Resultados (OKRs) vs Saídas (Iniciativas)

Um dos princípios fundamentais de OKRs é distinguir entre resultados versus saídas. Os OKRs e os principais resultados são focados na condução do impacto (ou seja, resultados), enquanto as iniciativas de Viva Goals estão focadas nas saídas – 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 Viva Goals principais resultados e iniciativas com seus itens de trabalho do Azure DevOps, é importante entender a diferença. O Azure DevOps se concentra principalmente no trabalho de acompanhamento, portanto, é mais comum integrar iniciativas Viva Goals ao Azure DevOps. Há certos exemplos em que pode fazer sentido acompanhar o progresso dos resultados chave com base em itens de trabalho do Azure DevOps.

Quando usar a Integração do Azure DevOps

Há três maneiras de usar a integração do Azure DevOps com fluxos de trabalho Viva Goals. Os detalhes sobre cada um desses recursos são descritos abaixo:

1. Acompanhe o progresso de uma iniciativa com tarefas: Além de acompanhar o progresso da iniciativa com base em itens de trabalho do Azure DevOps, essa abordagem permite uma experiência de usuário entre plataformas. Os detalhes do item de trabalho do Azure DevOps são sincronizados com as exibições da iniciativa Viva Goals e o alinhamento do trabalho do Azure DevOps para Viva Goals OS OKRs podem ser exibidos diretamente nos itens de trabalho vinculados do Azure DevOps por meio da Extensão do Azure DevOps (em breve)
2. Acompanhe o progresso de uma iniciativa com KPIs: Essa abordagem permite acompanhar o progresso da iniciativa com base nos itens de trabalho do Azure DevOps status. Um único valor numérico é sincronizado com Viva Goals.
3. Acompanhe o progresso de um resultado chave: Essa abordagem permite que você acompanhe o progresso do KR com base nos itens de trabalho do Azure DevOps status. Um único valor numérico é sincronizado com Viva Goals.

Como configurar a Integração do Azure DevOps

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

Observação

Depois de habilitado, qualquer usuário da organização que tenha permissões para criar/editar um OKR e/ou iniciativa pode configurar a integração entre Viva Goals e o Azure DevOps!

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

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

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

2. Selecione Resultado.

3. Selecione Adicionar tarefas.

4. Selecione Automaticamente em 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: recomendamos incluir a Organização do Azure DevOps e o Project no nome para referência futura.
   • Selecione a Organização do Azure DevOps
   • Selecione o Projeto do Azure DevOps
   • 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 a conexão com o método '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 você deseja usar para calcular o progresso de sua iniciativa. Você pode escolher entre qualquer tipo de item de trabalho na consulta ou em todos os itens de trabalho na consulta compartilhada.
4. Selecione o campo Azure DevOps que você deseja usar para acompanhar o progresso da iniciativa. Viva Goals progresso da iniciativa é calculado como o % completo do tipo de item de trabalho escolhido.
5. Selecione Avançar.
6. Selecione Salvar.

Agora você deve ver o ícone do Azure DevOps ao lado de sua iniciativa. Você também deve ver os detalhes do item de trabalho do Azure DevOps nas exibições da iniciativa Viva Goals. Viva Goals agora sincronizará automaticamente os detalhes do item de trabalho e atualizará 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-se a Itens de Trabalho:

1. Selecione método de itens de trabalho .
2. Selecione o tipo de item de trabalho ao qual se conectar – recomendamos escolher o tipo de item de trabalho "pai" na 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 para as tarefas versus 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 você deseja usar para calcular o progresso de sua iniciativa. Você pode optar por medir o progresso por um tipo de item de trabalho específico (ou seja, o tipo ao qual você se conecta diretamente ou qualquer um de seus tipos filhos) ou todos os itens de trabalho (ou seja, conectados e crianças).
5. Selecione o campo 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. Você também deve ver os detalhes do item de trabalho do Azure DevOps nas exibições da iniciativa Viva Goals. Viva Goals agora sincronizará automaticamente os detalhes do item de trabalho e atualizará esse progresso da iniciativa uma vez por hora com base no campo Azure DevOps para os tipos de item de trabalho selecionados.

Após a conclusão das etapas acima, não só o progresso da iniciativa Viva Goals será atualizado automaticamente regularmente, mas os seguintes recursos serão habilitados:

• 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 do Azure DevOps estará acessível a partir de uma guia Viva Goals nos itens de trabalho vinculados do Azure DevOps.

Como usar a Integração do Azure DevOps 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 mostrará os itens de trabalho do Azure DevOps em Viva Goals exibições de iniciativa; nem esse método tem a capacidade de inserir Viva Goals nos itens de trabalho do Azure DevOps.

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

2. Selecione Resultado.

3. Selecione Adicionar Métrica e preencha os detalhes necessários (ou seja, nome, tipo, unidades, inicialização, valores de destino)

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

4. Selecione Progresso.

5. Selecione Automaticamente em 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: é recomendável incluir a Organização do Azure DevOps e iniciativas no nome para uma referência futura fácil.
   • Selecione a Organização do Azure DevOps
   • Selecione o Projeto do Azure DevOps
   • 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 automaticamente considerados.

Se estiver usando a conexão com o método '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 você deseja usar para calcular o progresso de sua iniciativa. Você pode escolher entre qualquer tipo de item de trabalho na consulta ou em todos os itens de trabalho na consulta.
4. Selecione o campo 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. Viva Goals agora atualizará automaticamente o progresso uma vez por hora.

Se estiver usando o método Conectar-se a Itens de Trabalho:

1. Selecione 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" na 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 para as tarefas versus 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 você deseja usar para calcular o progresso de sua iniciativa. Você pode optar por medir o progresso por um tipo de item de trabalho específico (ou seja, o tipo ao qual você se conecta diretamente ou qualquer um de seus tipos filhos) ou todos os itens de trabalho (ou seja, conectados e crianças).
5. Selecione o campo 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. Viva Goals agora atualizará automaticamente essa iniciativa uma vez por hora.

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

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

1. Selecione Adicionar resultado de chave em Viva Goals ou editar um resultado de chave existente

2. Selecione Adicionar Métrica e preencha os detalhes necessários (ou seja, nome, tipo, unidades, inicialização, valores de destino)

   • Para métricas baseadas em porcentagem, o progresso do resultado chave é calculado com base no % do valor de campo do 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 chave é uma contagem do valor de campo do ADO selecionado para itens de trabalho concluídos ou, opcionalmente, totais.

3. Selecione Progresso.

4. Selecione Automaticamente em 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: é recomendável incluir a Organização do Azure DevOps e a iniciativa no nome para uma referência futura fácil.
   • Selecione a Organização do Azure DevOps.
   • Selecione o Projeto Azure DevOps.
   • 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 suporte; os itens de trabalho filho são automaticamente considerados.

Se estiver usando a conexão com o método '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 você deseja usar para calcular o progresso do resultado da chave. Você pode escolher entre qualquer tipo de item de trabalho na consulta ou em todos os itens de trabalho na consulta compartilhada.
4. Selecione o campo 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. Viva Goals agora atualizará automaticamente o progresso uma vez por hora.

Se estiver usando o método Conectar-se a Itens de Trabalho:

1. Selecione 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" na 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 para as tarefas versus 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 você deseja usar para calcular o progresso do resultado da chave. Você pode optar por medir o progresso por um tipo de item de trabalho específico (ou seja, o tipo ao qual você se conecta diretamente ou qualquer um de seus tipos filhos) ou todos os itens de trabalho (ou seja, conectados e crianças).
5. Selecione o campo 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 Azure DevOps ao lado do resultado da chave. Viva Goals agora atualizará automaticamente essa iniciativa uma vez por hora com base no campo ADO para os tipos de item de trabalho selecionados.

Cálculo de progresso para campos ADO em Viva Goals:

Acompanhar o progresso por	Métrica percentual	Métrica numérica
Contagem de itens de trabalho	Percentual dos itens de trabalho concluídos fora do total de itens de trabalho para a consulta ou tipo de item de trabalho fornecido.	Número de itens de trabalho para a consulta determinada ou tipo de item de trabalho.
Pontos de História	Percentual de pontos de história para os itens de trabalho concluídos fora do total de pontos de história para os itens de trabalho para determinada consulta ou tipo de item de trabalho.	Soma de pontos de história para os itens de trabalho para determinada consulta ou tipo de item de trabalho.
Esforço	Percentual de esforço para os itens de trabalho concluídos fora do esforço total para os itens de trabalho para determinada consulta ou tipo de item de trabalho.	Soma de esforço para os itens de trabalho para determinada consulta ou tipo de item de trabalho.
Estimativa Original	Percentual do total de horas de estimativa originais para os itens de trabalho concluídos fora do total de horas de estimativa originais para todos os itens de trabalho para determinada consulta ou tipo de item de trabalho.	Soma das horas de estimativa originais para os itens de trabalho para determinada consulta ou tipo de item de trabalho.
Trabalho restante	N/D	Total de horas de trabalho restantes para os itens de trabalho para determinada consulta ou tipo de item de trabalho.
Trabalho concluído	Percentual do total de horas de trabalho concluídas para os itens de trabalho concluídos fora do total de horas de trabalho concluídas para todos os itens de trabalho para a consulta ou tipo de item de trabalho fornecido.	Total de horas de trabalho concluídas para os itens de trabalho para determinada consulta ou tipo de item de trabalho.
Campos Personalizados	Percentual de conclusão do campo personalizado numérico associado no ADO para o tipo de item de trabalho ou consulta fornecido.	Soma total do campo personalizado numérico associado no ADO para o tipo de item de trabalho ou consulta fornecido.

Solução de problemas de conexão

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

Erros proibidos

Se você encontrar mensagens de erro proibidas ao criar uma conexão do Azure DevOps, é provável que restrições de endereço IP ou outras políticas de acesso condicional blame. Nesse caso, você precisa verificar se a política de validação habilitar Microsoft Entra ID CAP 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, pode desativar a política de validação habilitar Microsoft Entra ID CAP na organização do Azure DevOps. O que exigiria e o Administrador do Azure DevOps 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 Microsoft Entra ID.

Perguntas frequentes (perguntas frequentes)

1. Ao conectar minhas tarefas de iniciativa Viva Goals com o Azure DevOps, 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-se ao item de trabalho"?
   1. Se conectar sua iniciativa Viva Goals ao Azure DevOps, Viva Goals não expõe todos os itens de trabalho. O que Viva Goals mostra depende de como você escolhe calcular o progresso geral da iniciativa Viva Goals durante o processo de instalação. Se você optar por calcular o progresso da iniciativa por qualquer item de trabalho, Viva Goals de fato exporá todos os itens de trabalho de consulta compartilhada ou todos os itens filho, se você se conectou diretamente a 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 do item de trabalho não necessários no UX Viva Goals. Supomos 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. Viva Goals usará essa decisão para limitar o que expõemos no UX Viva Goals.
      
      Por exemplo, suponha que o trabalho do Azure DevOps esteja acompanhando recursos, histórias de usuário e tarefas. Suponha ainda que você opte por acompanhar Viva Goals progresso da iniciativa com base na conclusão da História do Usuário. Viva Goals mostrará apenas os Recursos e Histórias de Usuário nas exibições da iniciativa Viva Goals. Os usuários podem rapidamente "clicar duas vezes" no Azure DevOps para obter mais detalhes conforme necessário.