Aggiungere notifiche di stato per il repository GitHub

  • Articolo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

È possibile aggiungere la sintassi Markdown a un file di repository README.md GitHub per visualizzare lo stato della scheda Kanban nel repository. Visualizzare lo stato aggiungendo la sintassi scelta dalle impostazioni della scheda Kanban.

Nota

Richiede Azure DevOps Server 2019 Update 1 o versione successiva.

La sintassi mostrata funziona indipendentemente dal fatto che il progetto sia connesso a un GitHub.com o al repository GitHub Enterprise Server. Per GitHub Enterprise Server, il server deve essere accessibile in rete ad Azure DevOps Services.

Prerequisiti

  • Il progetto di Azure Boards deve essere connesso al repository GitHub in cui esistono i commit e le richieste pull da collegare a/da. Per altre informazioni, vedere Integrazione di Azure Boards-GitHub.
  • È necessario disporre di una bacheca Kanban da configurare. Quando si aggiunge un team, si aggiunge una bacheca Kanban per tale team. Per altre informazioni, vedere Informazioni sui team e sugli strumenti Agile.
  • È necessario essere aggiunti al ruolo di amministratore del team per le impostazioni del team che si desidera modificare oppure essere membri del gruppo di sicurezza Project Amministrazione istrators. Per essere aggiunti, vedere Aggiungere un amministratore del team o modificare le autorizzazioni a livello di progetto.
  • Per aggiungere il badge di stato al repository GitHub.com, è necessario essere un collaboratore del repository.

Aggiungere una notifica di stato

  1. Accedere ad Azure Boards e aprire la scheda Kanban.

  2. Selezionare l'icona a forma di ingranaggio per configurare la lavagna e impostare le impostazioni generali del team.

    Screenshot of opening board settings.

  3. Selezionare Notifica di stato e quindi selezionare o deselezionare la notifica Consenti agli utenti anonimi di accedere al badge di stato. Quando è deselezionata, gli utenti che non hanno eseguito l'accesso possono comunque visualizzare la notifica di stato.

    Screenshot of Kanban Board Settings dialog, Status badge tab.

    Screenshot of Kanban Board Settings dialog, Status badge tab, Azure DevOps Server 2019.

  4. Scegliere il tipo di badge desiderato e scegliere l'icona di copia per copiare la sintassi Markdown per il badge.

    • Mostra colonne "In corso" ignora solo le prime e le ultime colonne.
    • Includere tutte le colonne che includono le prime e le ultime colonne della scheda.
    • È possibile personalizzare il set di colonne specificando 2 per columnOptions e quindi visualizzando un elenco delimitato da virgole delle colonne della scheda. Ad esempio, ?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review, come illustrato nella sintassi seguente. Per le etichette di colonna che includono spazi, è necessario codificare lo spazio con %20. Ad esempio: In%20Progress.
     [![Board Status](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/_apis/work/boardbadge/6fa7b56f-d27c-4e96-957d-f9e7b0f56705?columnOptions=2&columns=Proposed,Committed,In%20Progress,In%20Review)](https://dev.azure.com/fabrikam/677da0fb-b067-4f77-b89b-f32c12bb8617/_boards/board/t/cdf5e823-1179-4503-9fb1-a45e2c1bc6d4/Microsoft.RequirementCategory/)

    Viene visualizzata una notifica simile alla seguente.

    Screenshot showing badge rendered.

  5. Al termine, seleziona Salva.

    L'unica impostazione che è possibile configurare è consentire agli utenti anonimi di accedere alla notifica di stato. Il tipo di badge in Impostazioni cambia solo la sintassi Markdown da copiare dai valori Sample Markdown e Image URL.

  6. Aprire il file README nel repository GitHub e incollare la sintassi copiata per visualizzare la notifica.

    Verrà visualizzata la stessa immagine di anteprima selezionata con i valori corrispondenti alla scheda Kanban.