Usare Azure Repos con Microsoft Teams

Azure DevOps Services

Se si utilizzano Microsoft Teams e Azure Repos, è possibile utilizzare l'app Azure Repos per Teams per monitorare i repository. L'app supporta il monitoraggio dei repository Git e Team Foundation Version Control (TFVC), ma non supporta l'integrazione con i repository GitHub.

Questo articolo illustra come eseguire le attività seguenti:

Prerequisiti

• Gestisci la tua sottoscrizione, in modo da ricevere notifiche nel tuo canale ogni volta che viene eseguito il push o la registrazione del codice oppure quando viene creata, aggiornata o effettuata l'unione di una pull request (PR). Per creare sottoscrizioni per gli eventi correlati ai repository, è necessario essere membri del gruppo Amministratori del Progetto o amministratori del team del. Per essere aggiunti, vedere Modificare le autorizzazioni a livello di progetto o Aggiungere un amministratore del team.
• Per ricevere le notifiche, abilita l'impostazione di accesso alle applicazioni di terze parti tramite OAuth per l'organizzazione Azure DevOps . Consulta Modificare i criteri di accesso alle applicazioni della tua organizzazione.

Aggiungere l'app Azure Repos a un team in Microsoft Teams

1. Passare all'app Azure Repos in Microsoft Teams Microsoft Teams > Azure Repos.

2. Selezionare Aggiungi o, se l'app è già stata scaricata, selezionare il menu a discesa accanto a Aprie quindi selezionare Aggiungi a un team.

3. Immettere un nome di team o canale e quindi selezionare Configurare un bot.

   

Connetti l'app Azure Repos ai repository

1. Dopo aver installato l'app nel team, immettere il testo seguente nel campo di risposta: @azure repos signin

   Se Microsoft Teams e Azure Boards si trovano in tenant diversi, selezionare Accedi con un messaggio di posta elettronica diverso.

   

   

2. Per monitorare tutti i repository Git in un progetto, inserire @azure repos subscribe [project url] nel canale. Assicurarsi di aggiungere l'URL del progetto. L'URL del progetto può essere a qualsiasi pagina all'interno del progetto, ad eccezione degli URL verso i repository.

   È anche possibile monitorare un repository specifico usando: @azure repos subscribe [repo url].

   L'URL del repository può essere in qualsiasi pagina all'interno del repository con il nome del repository, ad esempio @azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepoo per i repository TFVC: @azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.

3. Il comando subscribe consente di iniziare a usare una sottoscrizione predefinita. Per i repository Git, il canale viene sottoscritto al richiesta pull creata evento (con ramo di destinazione = main). Per i repository TFVC, il canale è iscritto all'evento Codice registrato.

   

Gestire le sottoscrizioni

Per visualizzare, aggiungere e rimuovere sottoscrizioni per un canale, immettere il testo seguente: @azure repos subscriptions.

Viene visualizzato un elenco di tutte le sottoscrizioni correnti per il canale ed è possibile aggiungere nuove sottoscrizioni o rimuovere quelle esistenti. Personalizzare le notifiche con vari filtri, come descritto nella sezione seguente.

Usare i filtri per ottenere solo le notifiche desiderate

Quando si sottoscrive un repository con @azure repos subscribe, viene creata una sottoscrizione predefinita senza filtri applicati. Spesso, gli utenti devono personalizzare queste sottoscrizioni per ricevere una notifica solo quando vengono soddisfatte determinate condizioni. Gli screenshot seguenti mostrano un esempio di configurazione delle notifiche solo quando il nostro team è nell'elenco dei revisori per una pull request.

1. Immettere il testo seguente nel canale: @azure repos subscriptions.

2. Nell'elenco delle sottoscrizioni, se è presente una sottoscrizione che non si vuole o che deve essere modificata, selezionare Rimuovi per eliminarla.

3. Selezionare il pulsante Aggiungi sottoscrizione.

4. Scegliere un tipo di evento e quindi selezionare Avanti.

   

5. Scegliere un repository e quindi selezionare Avanti.

   

6. Selezionare i filtri appropriati per personalizzare l'abbonamento e quindi selezionare Invia.

   

Cercare e condividere le informazioni sulle richieste pull usando l'estensione compose

Per consentire agli utenti di cercare e condividere informazioni sulle richieste pull, l'app Azure Repos per Microsoft Teams supporta un'estensione compose. È possibile cercare le richieste pull in base all'ID o al nome. Per il corretto funzionamento dell'estensione, accedere al progetto Azure Repos immettendo @azure repos signin o accedendo direttamente all'estensione compose.

Anteprima degli URL delle richieste pull

Quando incolli l'URL di un PR, viene visualizzata un'anteprima come quella nell'immagine seguente, che aiuta a mantenere le conversazioni legate al PR contestuali e accurate. Effettua l'accesso, e poi puoi visualizzare in anteprima le richieste pull (PR) per gli URL in tutti i canali di un Team.

Rimuovere sottoscrizioni e repository da un canale

Per eliminare tutte le iscrizioni relative a un repository nel progetto e rimuovere i repository dal canale, inserisci il seguente testo in Teams: @azure repos unsubscribe all [project url]. Assicurarsi di immettere l'URL del progetto. Questa attività può essere eseguita solo dagli amministratori del progetto.

Notifiche in thread

Per collegare un set di notifiche correlate e anche per ridurre lo spazio occupato dalle notifiche in un canale, le notifiche vengono threadate. Tutte le notifiche collegate a una determinata richiesta pull vengono collegate insieme.

visualizzazione compatta delle notifiche in thread

visualizzazione espansa delle notifiche threadate

Informazioni di riferimento sul comando

La tabella seguente elenca tutti i comandi azure repos che è possibile usare nel canale di Teams.

Supporto multi-tenant

Se si usa un altro tenant o posta elettronica per Microsoft Teams e Azure DevOps, seguire questa procedura per accedere in base al caso d'uso.

Risolvere

Se si verificano gli errori seguenti quando si usa l'app Azure Repos, seguire le procedure descritte in questa sezione.

• Mi dispiace, qualcosa è andato storto. Riprovare.
• Configurazione non riuscita. Assicurarsi che l'organizzazione '{nome organizzazione}' esista e che si disponga di autorizzazioni sufficienti.

Mi dispiace, qualcosa è andato storto. Riprovare.

L'app Azure Repos usa il protocollo di autenticazione OAuth e richiede l'accesso alle applicazioni di terze parti tramite OAuth per l'organizzazione essere abilitato. Per abilitare questa impostazione, passare a Impostazioni organizzazione>Criteri di sicurezza>e impostare l'accesso all'applicazione di terze parti tramite OAuth per l'organizzazione su On.

Configurazione non riuscita. Assicurarsi che l'organizzazione '{nome organizzazione}' esista e che si disponga di autorizzazioni sufficienti.

Disconnettiti da Azure DevOps navigando su https://aka.ms/VsSignout con il tuo browser.

Aprire un In privato o finestra del browser in incognito e passare a https://aex.dev.azure.com/me e accedere. Nell'elenco a discesa sotto l'icona del profilo a sinistra selezionare la directory che contiene l'organizzazione contenente il repository a cui si vuole eseguire la sottoscrizione.

Nello stesso browser , avviare una nuova scheda e accedere a https://teams.microsoft.com/. Eseguire il comando @Azure Repos signout e quindi eseguire il comando @Azure Repos signin nel canale in cui è installata l'app Azure Repos per Microsoft Teams.

Selezionare il pulsante Sign in e si viene reindirizzati a una pagina di consenso come quella nell'esempio seguente. Assicurarsi che la directory visualizzata accanto al messaggio di posta elettronica corrisponda a quella scelta nel passaggio precedente. Accettare e completare il processo di accesso.

Se questi passaggi non risolvono il problema di autenticazione, contattare Microsoft all'indirizzo Developer Community.

Articoli correlati

• Azure Boards con Teams
• Azure Pipelines con Teams