Integração com o GitHub

Introdução à integração do GitHub

Viva Goal A integração do GitHub permite que você atualize automaticamente o progresso do objetivo e do resultado-chave (OKR) com base no progresso dos problemas nos repositórios do GitHub.

Vamos usar este exemplo: você usa o GitHub para acompanhar o status dos problemas e tem um objetivo no Viva Goals de resolver 30 problemas a cada trimestre. Quando você vincula esse objetivo ao repositório correspondente no GitHub, o status do OKR será atualizado à medida que os problemas no repositório associado forem resolvidos. Você também pode acompanhar o progresso dos problemas que estão sendo tratados por um usuário específico para objetivos centrados no usuário. O Viva Goals sincronizará automaticamente os valores para você e traçará seu progresso em direção à meta, economizando tempo e mantendo seus OKRs atualizados.

Como habilitar a integração do GitHub

Os administradores podem seguir estas etapas para habilitar a integração:

  1. Na barra lateral, vá para Administrador e selecione a guia Integrações.

    Captura de tela da página de integrações no Viva Goals.

  2. Para o GitHub, você terá a opção de Habilitar a integração. Se uma conexão foi feita anteriormente ou se a integração já estava habilitada, você terá a opção de Gerenciar a integração habilitada.

    A captura de tela mostra a opção ativar destacada na página de integrações.

    Você também pode desativar a integração na mesma seção: Vá para Alterar e selecione Desabilitar integração no menu suspenso.

    A captura de tela mostra onde você desabilita o GitHub no Viva Goals.

Como configurar a conexão do GitHub

Depois de habilitar a integração, a próxima etapa é configurar uma conexão do GitHub.

  1. Selecione Nova Conexão e entre em sua conta do GitHub.

    A captura de tela mostra onde você adiciona uma nova conexão do GitHub no Viva Goals.

  2. Forneça um nome para a conexão.

    A captura de tela mostra onde você insere um nome para sua nova conexão do GitHub no Viva Goals.

  3. Você tem a opção de compartilhar a conexão com outros usuários na organização.

  4. Selecione Avançar para começar a usar essa integração. Você pode editar a conexão salva a qualquer momento.

Observação

O Viva Goals permite que você se conecte a vários repositórios. Selecione Nova Conexão para buscar dados de outro repositório. Você diferencia essas conexões por nome. Os nomes serão exibidos para outros usuários quando eles vincularem seus OKRs aos dados do GitHub.

Como conectar a conexão do GitHub a um OKR

Depois de configurar a conexão, a próxima etapa é vincular OKRs aos repositórios do GitHub.

  1. Ao criar ou editar um OKR, selecione Conectar fonte de dados para atualizar automaticamente o progresso. No menu suspenso, selecione GitHub.

    A captura de tela mostra onde você seleciona o GitHub como a fonte de dados.

  2. Se você já criou uma conexão ou se o administrador compartilhou uma conexão com você, essa conexão será selecionada automaticamente. O Viva Goals solicitará que você crie uma nova conexão somente se não houver conexões já criadas ou compartilhadas.

  3. Selecione o método que você deseja usar para medir o progresso, a porcentagem concluída ou o KPI (métrica de sucesso). Se você escolher KPI, forneça uma métrica, um valor inicial e um valor de destino.

  4. Selecione uma conexão e todos os repositórios associados estarão disponíveis no menu suspenso. Selecione um repositório e um marco.

    A captura de tela mostra onde você adiciona detalhes de conexão do GitHub.

  5. Selecione um destinatário para problemas que estão sendo tratados por um usuário específico. Selecione os rótulos personalizados conforme aplicável.

  6. Você pode acompanhar o status dos problemas que estão fechados e abertos. Selecione um status apropriado.

    O progresso será calculado com base na contagem de problemas, se você escolheu a métrica KPI para acompanhar o progresso, ou com base na porcentagem de problemas fechados, se você escolheu a porcentagem concluída para acompanhar o progresso.

    Observação

    Se você escolher a porcentagem concluída para acompanhar o progresso, o progresso será computado somente com base na porcentagem de problemas resolvidos. Por outro lado, se você quiser acompanhar os problemas que estão em aberto também, terá que escolher uma métrica de KPI para acompanhar o progresso.

  7. Vá para Avançar e selecione Salvar.

Agora você vinculou seu objetivo a um repositório no GitHub para acompanhar o progresso de seus problemas e atualizar automaticamente o status do OKR correspondente.

As seguintes cores da barra de progresso indicam o status do objetivo:

  • Se o progresso for de 0 a 25% menor do que o progresso esperado a qualquer momento, o status do OKR ficará atrasado e a barra de progresso ficará laranja.

  • Se o progresso for mais de 25% menor do que o esperado a qualquer momento, o status do OKR estará em risco e a barra de progresso ficará vermelha.

  • Last updated on