Azure DevOps integração

Introdução à Azure DevOps integração

Viva Goals integra-se com o Microsoft Azure DevOps 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 Azure DevOps ligados. Pode utilizar a integração do Azure DevOps para

• Controlar automaticamente o progresso de um resultado chave
• Controlar automaticamente o progresso de um KPI de iniciativa
• Controlar automaticamente o progresso e as tarefas de uma iniciativa.
  • Esta abordagem atualiza o progresso da iniciativa, sincroniza os detalhes do item de trabalho do Azure DevOps com Viva Goals iniciativa "tarefas" e, quando utilizada com a extensão do Azure DevOps Viva Goals, Viva Goals detalhes de alinhamento OKR são apresentados diretamente nos itens de trabalho ligados do Azure DevOps.

Veja abaixo para obter mais detalhes sobre como funciona a integração do Azure DevOps ao ligar-se a resultados chave, métricas de iniciativas e tarefas de iniciativa.

Resultados (OKRs) vs. Saídas (Iniciativas)

Um dos princípios fundamentais dos OKRs é distinguir entre resultados versus saídas. Os OKRs e os principais resultados concentram-se no impacto na condução (ou seja, nos resultados), enquanto Viva Goals iniciativas estão focadas em saídas – o trabalho planeado para alcançar os principais resultados. Ambas são métricas importantes a controlar, mas medem coisas diferentes.

Embora possa integrar Viva Goals principais resultados e iniciativas com os seus itens de trabalho do Azure DevOps, é importante compreender a diferença. O Azure DevOps concentra-se principalmente no controlo do trabalho, pelo que é mais comum integrar iniciativas Viva Goals com o Azure DevOps. Existem determinados exemplos em que pode fazer sentido controlar o progresso dos resultados principais com base nos itens de trabalho do Azure DevOps.

Quando utilizar a Integração do Azure DevOps

Existem três formas de utilizar a integração do Azure DevOps com Viva Goals fluxos de trabalho. Os detalhes sobre cada uma destas capacidades estão descritos abaixo:

1. Controle o progresso de uma iniciativa com tarefas: Além de controlar o progresso da iniciativa com base nos itens de trabalho do Azure DevOps, esta abordagem permite uma experiência de utilizador em várias plataformas. Os detalhes do item de trabalho do Azure DevOps são sincronizados com as vistas de iniciativa Viva Goals e o alinhamento do trabalho do Azure DevOps para Viva Goals OS OKRs podem ser visualizados diretamente nos itens de trabalho do Azure DevOps ligados através da Extensão de DevOps do Azure (brevemente)
2. Acompanhe o progresso de uma iniciativa com KPIs: Esta abordagem permite-lhe controlar o progresso da iniciativa com base nos itens de trabalho do Azure DevOps status. Um único valor numérico é sincronizado com Viva Goals.
3. Controlar o progresso de um Resultado Chave: Esta abordagem permite-lhe controlar 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 tem de ser ativada por um Administrador de Inquilinos e Organizações do Viva Goals. Viva Goals administradores têm primeiro de ativar a integração do Azure DevOps para o respetivo inquilino (Ativar Integrações no Viva Goals | Microsoft Learn). Depois de ativado ao nível do inquilino, um administrador da Organização Viva Goals tem de a ativar para a sua organização (Descrição Geral da Administração de Integrações do Viva Goals.)

Observação

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

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

Este método é a abordagem recomendada para alinhar o trabalho no Azure DevOps com o OKRsin Viva Goals. Além de controlar o progresso da iniciativa com base nos itens de trabalho do Azure DevOps, esta abordagem permite uma experiência de utilizador em várias plataformas. Os detalhes do item de trabalho do Azure DevOps são sincronizados com as vistas de iniciativa Viva Goals e, quando utilizados com o Viva Goals extensão de DevOps do Azure, o alinhamento do Azure DevOps funciona para Viva Goals OS OKRs são apresentados diretamente nos itens de trabalho do Azure DevOps ligados.

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

2. Selecione Resultado.

3. Selecione Adicionar tarefas.

4. Selecione Automaticamente a partir de uma origem de dados.

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

6. Selecione a ligação adequada ao Azure DevOps. Se precisar de criar uma nova ligação do Azure DevOps, terá de iniciar sessão no Azure DevOps para criar uma ligação de dados. É necessária uma nova ligação para cada projeto do Azure DevOps. Depois de iniciar sessão:

   • Indique um nome de ligação: recomendamos incluir a Organização e o Projeto do Azure DevOps no nome para referência futura.
   • Selecione a Organização do Azure DevOps
   • Selecione o Projeto de DevOps do Azure
   • Selecione Avançar

7. Selecione o método de ligação:

   • Consulta Partilhada: permite-lhe ligar a uma consulta existente guardada no Azure DevOps.
   • Itens de trabalho: permite-lhe ligar a um ou mais itens de trabalho de um tipo de item de trabalho específico. Esta abordagem permite-lhe ligar-se diretamente aos itens de trabalho "principais" que contêm o trabalho de suporte; os itens de trabalho subordinados são incluídos automaticamente.

Se estiver a utilizar a ligação ao método "Consulta Partilhada":

1. Selecione o método de consulta partilhada .
2. Procure e selecione a consulta partilhada que contém os itens de trabalho do Azure DevOps.
3. Selecione o tipo de item de trabalho que pretende utilizar para calcular o progresso da sua iniciativa. Pode escolher entre qualquer tipo de item de trabalho na consulta ou todos os itens de trabalho na consulta partilhada.
4. Selecione o campo Azure DevOps que pretende utilizar para controlar o progresso da iniciativa. Viva Goals progresso da iniciativa é calculado como a % concluída do tipo de item de trabalho escolhido.
5. Selecione Avançar.
6. Selecione Salvar.

Agora, deverá ver o ícone do Azure DevOps junto à sua iniciativa. Também deverá ver os detalhes do item de trabalho do Azure DevOps nas vistas de 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 itens de trabalho selecionados na sua consulta partilhada.

Se estiver a utilizar o método Ligar a Itens de Trabalho:

1. Selecione o método de itens de trabalho .
2. Selecione o tipo de item de trabalho ao qual ligar – recomendamos que escolha o tipo de item de trabalho "principal" na hierarquia do Azure DevOps que contém o trabalho que está a ser feito. A integração incluirá automaticamente os itens de trabalho subordinados. Por exemplo, ligue a uma funcionalidade que seja o principal às tarefas versus ligar a cada tarefa individual.
3. Procure e selecione os itens de trabalho específicos do tipo escolhido.
4. Selecione o tipo de item de trabalho que pretende utilizar para calcular o progresso da sua iniciativa. Pode optar por medir o progresso por um tipo de item de trabalho específico (ou seja, o tipo a que se liga diretamente ou qualquer um dos respetivos tipos de subordinados) ou todos os itens de trabalho (ou seja, ligados e subordinados).
5. Selecione o campo ADO que pretende utilizar para controlar o progresso da iniciativa.
6. Selecione Avançar.
7. Selecione Salvar.

Agora, deverá ver o ícone do Azure DevOps junto à sua iniciativa. Também deverá ver os detalhes do item de trabalho do Azure DevOps nas vistas de iniciativa Viva Goals. Viva Goals agora sincronizará automaticamente os detalhes do item de trabalho e atualizará o progresso desta iniciativa uma vez por hora com base no campo de DevOps do Azure para os tipos de itens de trabalho selecionados.

Após a conclusão dos passos acima, não só o progresso da iniciativa Viva Goals será atualizado automaticamente, como também as seguintes capacidades serão ativadas:

• Os detalhes do item de trabalho do Azure DevOps são apresentados nas vistas de iniciativa Viva Goals, juntamente com hiperligações para os detalhes do item de trabalho do Azure DevOps
• Se tiver ativado o Viva Goals extensão de DevOps do Azure, o alinhamento total entre os OKRs e os itens de trabalho do Azure DevOps estará acessível a partir de um separador Viva Goals nos itens de trabalho do Azure DevOps ligados.

Como utilizar a Integração do Azure DevOps com KPIs de iniciativa

Utilize este método quando quiser atualizar o progresso da iniciativa Viva Goals com um único valor numérico. Esta abordagem não irá apresentar os itens de trabalho do Azure DevOps dentro Viva Goals vistas de iniciativa; nem este método tem a capacidade de incorporar Viva Goals nos itens de trabalho do Azure DevOps.

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 (ou seja, nome, tipo, unidades, início, valores de destino)

   • Para métricas baseadas em percentagem, o progresso da iniciativa é calculado com base na % do valor do campo ADO selecionado para itens de trabalho concluídos vs. itens de trabalho totais.
   • Para métricas não baseadas em percentagem (numérica, 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 a partir de uma origem de dados.

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

7. Selecione a ligação adequada ao Azure DevOps. Se precisar de criar uma nova ligação do Azure DevOps, tem de iniciar sessão no Azure DevOps para criar uma ligação de dados. É necessária uma nova ligação para cada projeto do Azure DevOps. Depois de iniciar sessão:

   • Indique um Nome da Ligação: recomendamos que inclui 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 de DevOps do Azure
   • Selecione Avançar

8. Selecione o método de ligação:

   • Consulta Partilhada: permite-lhe ligar a uma consulta existente armazenada no Azure DevOps
   • Itens de trabalho: permite-lhe ligar a um ou mais itens de trabalho de um tipo de item de trabalho específico. Esta abordagem permite-lhe ligar-se diretamente aos itens de trabalho "principais" que contêm o trabalho de suporte; os itens de trabalho subordinados são automaticamente considerados.

Se estiver a utilizar a ligação ao método "Consulta Partilhada":

1. Selecione o método de consulta partilhada .
2. Procure e selecione a consulta partilhada que contém os itens de trabalho do Azure DevOps.
3. Selecione o tipo de item de trabalho que pretende utilizar para calcular o progresso da sua iniciativa. Pode escolher entre qualquer tipo de item de trabalho na consulta ou todos os itens de trabalho na consulta.
4. Selecione o campo Azure DevOps que pretende utilizar para controlar o progresso da iniciativa.
5. Selecione Avançar.
6. Selecione Salvar.

Agora, deverá ver o ícone do Azure DevOps junto à sua iniciativa. Viva Goals atualizará automaticamente o progresso uma vez por hora.

Se estiver a utilizar o método Ligar a Itens de Trabalho:

1. Selecione o método de itens de trabalho .
2. Selecione o "tipo de item de trabalho" ao qual ligar – recomendamos que escolha o tipo de item de trabalho "principal" na hierarquia do Azure DevOps que contém o trabalho que está a ser feito. A integração incluirá automaticamente os itens de trabalho subordinados. Por exemplo, ligue a uma funcionalidade que seja o principal às tarefas versus ligar a cada tarefa individual.
3. Procure e selecione os itens de trabalho específicos do tipo escolhido.
4. Selecione o tipo de item de trabalho que pretende utilizar para calcular o progresso da sua iniciativa. Pode optar por medir o progresso por um tipo de item de trabalho específico (ou seja, o tipo a que se liga diretamente ou qualquer um dos respetivos tipos de subordinados) ou todos os itens de trabalho (ou seja, ligados e subordinados).
5. Selecione o campo ADO que pretende utilizar para controlar o progresso da iniciativa.
6. Selecione Avançar.
7. Selecione Salvar.

Agora, deverá ver o ícone do Azure DevOps junto à sua iniciativa. Viva Goals atualizará automaticamente esta iniciativa uma vez por hora.

Como utilizar a Integração do Azure DevOps com um Resultado Chave

Utilize este método quando quiser atualizar o progresso do Resultado da Chave de Viva Goals com um único valor numérico. Esta abordagem não irá apresentar os itens de trabalho do Azure DevOps no Viva Goals; nem este método tem a capacidade de incorporar Viva Goals nos itens de trabalho do Azure DevOps.

1. Selecione Adicionar Resultado da Chave no Viva Goals ou edite um Resultado de Chave existente

2. Selecione Adicionar Métrica e preencha os detalhes necessários (ou seja, nome, tipo, unidades, início, valores de destino)

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

3. Selecione Progresso.

4. Selecione Automaticamente a partir de uma origem de dados.

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

6. Selecione a ligação adequada ao Azure DevOps. Se precisar de criar uma nova ligação do Azure DevOps, tem de iniciar sessão no Azure DevOps para criar uma ligação de dados. É necessária uma nova ligação para cada projeto do Azure DevOps. Depois de iniciar sessão:

   • Indique um Nome da Ligação: recomendamos que inclui a Organização do Azure DevOps e a iniciativa no nome para referência futura fácil.
   • Selecione a Organização do Azure DevOps.
   • Selecione o Projeto de DevOps do Azure.
   • Selecione Avançar.

7. Selecione o método de ligação:

   • Consulta Partilhada: permite-lhe ligar a uma consulta existente armazenada no Azure DevOps
   • Itens de trabalho: permite-lhe ligar a um ou mais itens de trabalho de um tipo de item de trabalho específico. Esta abordagem permite-lhe ligar-se diretamente aos itens de trabalho "principais" que contêm o trabalho de suporte; os itens de trabalho subordinados são automaticamente considerados.

Se estiver a utilizar a ligação ao método "Consulta Partilhada":

1. Selecione o método de consulta partilhada .
2. Procure e selecione a consulta partilhada que contém os itens de trabalho do Azure DevOps.
3. Selecione o tipo de item de trabalho que pretende utilizar para calcular o progresso do resultado da chave. Pode escolher entre qualquer tipo de item de trabalho na consulta ou todos os itens de trabalho na consulta partilhada.
4. Selecione o campo ADO que pretende utilizar para controlar o progresso dos resultados da chave.
5. Selecione Avançar.
6. Selecione Salvar.

Deverá agora ver o ícone do Azure DevOps junto ao resultado da chave. Viva Goals atualizará automaticamente o progresso uma vez por hora.

Se estiver a utilizar o método Ligar a Itens de Trabalho:

1. Selecione o método de itens de trabalho .
2. Selecione o "tipo de item de trabalho" ao qual ligar – recomendamos que escolha o tipo de item de trabalho "principal" na hierarquia do Azure DevOps que contém o trabalho que está a ser feito. A integração incluirá automaticamente os itens de trabalho subordinados. Por exemplo, ligue a uma funcionalidade que seja o principal às tarefas versus ligar a cada tarefa individual.
3. Procure e selecione os itens de trabalho específicos do tipo escolhido.
4. Selecione o tipo de item de trabalho que pretende utilizar para calcular o progresso do resultado da chave. Pode optar por medir o progresso por um tipo de item de trabalho específico (ou seja, o tipo a que se liga diretamente ou qualquer um dos respetivos tipos de subordinados) ou todos os itens de trabalho (ou seja, ligados e subordinados).
5. Selecione o campo ADO que pretende utilizar para controlar o progresso dos resultados da chave.
6. Selecione Avançar.
7. Selecione Salvar.

Deverá agora ver o ícone do Azure DevOps junto ao Resultado da Chave. Viva Goals atualizará automaticamente esta iniciativa uma vez por hora com base no campo ADO para os tipos de itens de trabalho selecionados.

Cálculo de Progresso para campos ADO no Viva Goals:

Controlar o Progresso Por	Percentagem de métrica	Métrica de número
Contagem de Itens de Trabalho	Percentagem de itens de trabalho concluídos do total de itens de trabalho para o tipo de item de trabalho ou consulta especificado.	Número de itens de trabalho para o tipo de item de trabalho ou consulta especificado.
Pontos de História	Percentagem de pontos de história para os itens de trabalho concluídos do total de pontos de história para os itens de trabalho para uma determinada consulta ou tipo de item de trabalho.	Soma de pontos de história para os itens de trabalho para uma determinada consulta ou tipo de item de trabalho.
Esforço	Percentagem de esforço para os itens de trabalho concluídos do esforço total para os itens de trabalho para uma determinada consulta ou tipo de item de trabalho.	Soma do esforço dos itens de trabalho para uma determinada consulta ou tipo de item de trabalho.
Estimativa Original	Percentagem do total de horas de estimativa original para os itens de trabalho concluídos do total de horas de estimativa original para todos os itens de trabalho para uma determinada consulta ou tipo de item de trabalho.	Soma das horas de estimativa originais para os itens de trabalho para uma determinada consulta ou tipo de item de trabalho.
Trabalho Restante	N/D	Total de horas de trabalho restantes para os itens de trabalho para uma determinada consulta ou tipo de item de trabalho.
Trabalho Concluído	Percentagem do total de horas de trabalho concluídas para os itens de trabalho concluídos do total de horas de trabalho concluídas para todos os itens de trabalho para o tipo de item de consulta ou trabalho especificado.	Total de horas de trabalho concluídas para os itens de trabalho para uma determinada consulta ou tipo de item de trabalho.
Campos Personalizados	Percentagem concluída do campo personalizado numérico associado no ADO para o tipo de item de consulta ou trabalho especificado.	Soma total do campo personalizado numérico associado no ADO para o tipo de item de consulta ou trabalho especificado.

Resolver problemas de ligação

Para integrar com o Azure DevOps, o Serviço Viva Goals tem de conseguir aceder aos itens de trabalho na Organização do Azure DevOps e iniciativa que configura ao criar a ligação no Viva Goals. Consoante a forma como a sua organização gere as políticas de Acesso Condicional Microsoft Entra e as permissões do Azure DevOps, Viva Goals poderá não conseguir aceder às informações.

Erros Proibidos

Se encontrar mensagens de erro proibidas ao criar uma ligação do Azure DevOps, é provável que as restrições de endereços IP ou outras Políticas de Acesso Condicional sejam blame. Neste caso, tem de verificar se a política de validação Ativar Microsoft Entra ID CAP está ativada na Organização do Azure DevOps. Para obter mais detalhes, veja a documentação do Azure DevOps.

Soluções

Tem duas opções: pode desativar a política de validação Ativar Microsoft Entra ID CAP na organização do Azure DevOps. O que exigiria e o Administrador do Azure DevOps ou teria de adicionar os endereços IP de Saída do Serviço Viva Goals às Políticas de Acesso Condicional para os seus inquilinos Microsoft Entra ID.

FAQ (Perguntas Mais Frequentes)

1. Ao ligar as minhas Viva Goals tarefas de iniciativa ao Azure DevOps, por que motivo não vejo todos os itens de trabalho na minha consulta partilhada e/ou em todos os itens de trabalho subordinados ao utilizar o método "ligar ao item de trabalho"?
   1. Quer esteja a ligar a sua iniciativa Viva Goals ao Azure DevOps, Viva Goals não expõe todos os itens de trabalho. O que Viva Goals mostra depende da forma como opta por calcular o progresso geral da iniciativa Viva Goals durante o processo de configuração. Se optar por calcular o progresso da iniciativa por qualquer item de trabalho, Viva Goals exporá de facto todos os itens de trabalho da consulta partilhada ou todos os itens subordinados, se tiver ligado diretamente aos itens de trabalho.
      
      No entanto, acreditamos que escolher "qualquer" tipo de item de trabalho é a exceção, uma vez que esta abordagem exporia uma quantidade excessiva de detalhes do item de trabalho não necessários dentro Viva Goals UX. Partimos do princípio de que a maioria dos utilizadores opta por calcular o progresso por um tipo de item de trabalho específico na consulta partilhada ou por um subordinado dos itens de trabalho ligados. Viva Goals utilizará essa decisão para limitar o que expõemos na Viva Goals UX.
      
      Por exemplo, suponha que o trabalho do Azure DevOps está a controlar Funcionalidades, Histórias de Utilizador e Tarefas. Imagine ainda que opta por controlar Viva Goals progresso da iniciativa com base na conclusão do User Story. Viva Goals mostrará apenas as Funcionalidades e Histórias de Utilizador nas vistas de iniciativa Viva Goals. Os utilizadores podem rapidamente "fazer duplo clique" no Azure DevOps para obter mais detalhes, conforme necessário.