Usare l'app Azure Boards in Microsoft Teams

Servizi di Azure DevOps

Se si usa Microsoft Teams, è possibile creare elementi di lavoro e monitorare l'attività degli elementi di lavoro nel progetto di Azure Boards dal canale Teams. A questo scopo, aggiungere l'app Azure Boards per Microsoft Teams al canale Teams.

L'app Azure Boards per Microsoft Teams consente agli utenti di completare le attività seguenti:

• Configurare e gestire le sottoscrizioni per la creazione e l'aggiornamento degli elementi di lavoro
• Gestire altri eventi dell'elemento di lavoro
• Ricevere e gestire le notifiche per gli eventi dell'elemento di lavoro nel canale Teams
• Creare elementi di lavoro dalle conversazioni nel canale
• Cercare e condividere elementi di lavoro con altri membri nel canale usando l'estensione di messaggistica
• Visualizzare le anteprime degli elementi di lavoro dagli URL per avviare discussioni e mantenere contestuali le conversazioni.

Leggere questo articolo per informazioni su come:

• Aggiungere l'app Azure Boards al team in Microsoft Teams
• Collegare e scollegare il progetto di Azure Boards all'app Azure Boards
• Configurare le sottoscrizioni per gli eventi correlati agli elementi di lavoro nel canale di Teams
• Creare elementi di lavoro dal canale di Teams
• Monitorare l'attività degli elementi di lavoro nel canale di Teams

Nota

L'integrazione di Azure Boards e Microsoft Teams è supportata solo per Azure DevOps Services.

Inoltre, l'integrazione di Azure Boards e Microsoft Teams non è supportata se si è un cliente O365 Government Community Cloud (GCC) che usa una sottoscrizione di Azure Commercial in combinazione con il tenant GCC.

Prerequisiti

• Per creare un elemento di lavoro, è necessario essere un collaboratore al progetto di Azure Boards. Se non si ha ancora un progetto, è possibile iscriversi e creare un progetto. Per altre informazioni, vedere Iniziare a usare Azure Boards.
• Per creare sottoscrizioni in un canale di Teams per gli eventi degli elementi di lavoro, è necessario essere membri del gruppo di Amministrazione istrators di Azure Boards o aggiunto al ruolo di amministratore del team per il team. Per essere aggiunti, vedere Modificare le autorizzazioni a livello di progetto o Aggiungere l'amministratore del team.
• Per ricevere notifiche, è necessario abilitare l'accesso all'applicazione di terze parti tramite l'impostazione OAuth per l'organizzazione Azure DevOps. Vedere Modificare i criteri di accesso alle applicazioni per l'organizzazione.

Nota

• È possibile collegare l'app Azure Boards per Microsoft Teams solo a un progetto ospitato in Azure DevOps Services in questo momento.
• Le notifiche non sono attualmente supportate all'interno di messaggi diretti.
• Sono supportati solo i canali pubblici.

Aggiungere l'app Azure Boards a Microsoft Teams

Aggiungere l'app al canale teams in Microsoft Teams.

1. Visitare l'App Store in Microsoft Teams e cercare l'app Azure Boards. Al momento dell'installazione, viene visualizzato un messaggio di benvenuto dall'app, come illustrato nell'immagine seguente.

   

2. Usare l'handle @azure boards per interagire con l'app. Per un elenco dei comandi, vedere Informazioni di riferimento sul comando fornite più avanti in questo articolo.

Collegare il progetto di Azure Boards all'app Azure Boards

Per usare l'app, è prima necessario collegare il progetto di Azure Boards al canale di Teams.

1. Dopo aver installato l'app nel team, connettersi ed eseguire l'autenticazione ad Azure Boards. Usare Accedi con un messaggio di posta elettronica diverso se Microsoft Teams e Azure Boards si trovano in tenant diversi.

   

   

2. Dopo l'accesso, usare il comando seguente all'interno di un canale di Teams per collegarsi al progetto di Azure Boards specificato con l'URL:

    @azure boards link [project url]
   

   Ad esempio:

    @azure boards link https://dev.azure.com/myorg/myproject
   

Dopo aver collegato il progetto, è possibile creare elementi di lavoro usando @azure boards create il comando o usare le azioni dei messaggi.

Configurare le sottoscrizioni

È possibile creare sottoscrizioni per monitorare gli elementi di lavoro in qualsiasi momento usando il @azure boards subscriptions comando .

1. Selezionare il percorso dell'area desiderato e l'evento a cui si è interessati. Usare i filtri associati per personalizzare ciò che si riceve una notifica nel canale di Teams. Per facilitare la configurazione delle sottoscrizioni, i percorsi di area a cui si accede di recente vengono visualizzati nell'elenco a discesa percorso area.

   

Se il percorso dell'area desiderato non viene visualizzato nel menu a discesa Percorso area, seguire le istruzioni indicate nella sezione successiva Aggiungi percorsi di area. I percorsi di area aggiunti usando il @azure boards addAreapath comando e i percorsi di area per i quali le sottoscrizioni vengono create nel canale vengono sempre visualizzati nell'elenco a discesa Percorso area insieme ai percorsi di area a cui si accede di recente.

Aggiungere percorsi di area

È possibile aggiungere aree che il team lavora al canale in modo che siano sempre disponibili per la creazione di elementi di lavoro e sottoscrizioni. Questa funzionalità è utile per i team con più di 100 percorsi di area nel progetto.

• Usare il comando seguente per aggiungere percorsi di area dal progetto al canale di Teams.

    @azure boards addAreapath [area path] 
  

  Ad esempio:

    @azure boards addAreapath myproject\fabrikam
  

  

• Se si sceglie il nome del progetto come percorso dell'area, si riceveranno notifiche per tutti i percorsi dell'area nel progetto.

Creare un elemento di lavoro con un comando

Con l'app Azure Boards è possibile creare elementi di lavoro dal canale. L'app supporta anche elementi di lavoro personalizzati.

• Per creare un elemento di lavoro, usare @azure boards create.

  

Creare un elemento di lavoro dalle azioni del messaggio

Spesso, le discussioni in un canale richiedono la creazione di elementi di lavoro. È possibile usare azioni di messaggio per creare un elemento di lavoro. Il messaggio selezionato viene precompilato nella sezione descrizione dell'elemento di lavoro. La sezione Discussione dell'elemento di lavoro appena aggiunto archivia un collegamento alla conversazione nel canale.

• Per creare elementi di lavoro usando azioni di messaggio

  

  

Gestire le sottoscrizioni di Azure Boards

1. Per visualizzare, aggiungere e rimuovere sottoscrizioni per un canale, usare il @azure boards subscriptions comando :

    @azure boards subscriptions
   

Questo comando elenca tutte le sottoscrizioni correnti per il canale e consente di aggiungere nuove sottoscrizioni e rimuovere quelle esistenti. Come parte dell'aggiunta di sottoscrizioni, è anche possibile personalizzare ciò che si riceve una notifica usando vari filtri.

Nota

Gli amministratori del team non sono in grado di rimuovere o modificare le sottoscrizioni create dagli amministratori di Project.

Cercare e condividere elementi di lavoro usando l'estensione compose

Per consentire agli utenti di cercare e condividere elementi di lavoro, l'app Azure Boards per Microsoft Teams supporta l'estensione compose. È possibile cercare gli elementi di lavoro in base all'ID dell'elemento di lavoro, al titolo o al comando funzionale supportato. Per un elenco dei comandi, vedere Ricerca di elementi di lavoro funzionali. Per usare l'estensione compose, gli utenti devono accedere all'app Azure Boards eseguendo @azure boards signin il comando o accedendo direttamente all'estensione compose.

Anteprima degli URL degli elementi di lavoro

Per supportare la collaborazione sugli elementi di lavoro descritti all'interno di un canale, il canale visualizza un'anteprima degli elementi di lavoro a cui si fa riferimento. Quando un utente incolla l'URL dell'elemento di lavoro, viene visualizzata un'anteprima simile all'immagine seguente. Questa anteprima consente di mantenere pertinenti e corrette le conversazioni correlate agli elementi di lavoro.

Per il funzionamento di questa funzionalità, è necessario che gli utenti siano connessi. Dopo l'accesso, questa funzionalità funziona per tutti i canali di un team in Microsoft Teams.

Scollegare un progetto da un canale

Un canale di Teams può collegarsi a un solo progetto di Azure Boards alla volta. Per collegarsi a un progetto diverso, è necessario prima scollegare il progetto corrente usando @azure boards unlink il comando .

Scollegando un progetto vengono eliminate tutte le sottoscrizioni insieme ai percorsi di area aggiunti dal canale. Se il canale non ha sottoscrizioni, qualsiasi utente può scollegare un progetto. Tuttavia, se un canale ha sottoscrizioni, solo gli amministratori del progetto possono scollegare un progetto da un canale.

Notifiche in thread per collegare e ridurre le notifiche

Le notifiche dei canali di Teams consentono di collegare in modo logico e ridurre le notifiche correlate nel canale. Tutte le notifiche collegate a un particolare elemento di lavoro vengono collegate tra loro.

Visualizzazione compatta delle notifiche in thread

Visualizzazione espansa delle notifiche in thread

Informazioni di riferimento sul comando di Azure Boards

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

Comando	Funzionalità
collegamento @azure bacheche [URL progetto]	Collegare un progetto a questo canale per creare elementi di lavoro e ricevere notifiche
sottoscrizioni @azure bacheche	Aggiungere o rimuovere sottoscrizioni per questo canale
creazione di bacheche @azure	Creare un elemento di lavoro
@azure bacheche addAreapath [percorso area]	Aggiungere un percorso di area dal progetto a questo canale
accesso alle bacheche @azure	Accedere all'organizzazione di Azure Boards
@azure bacheche disconnettersi	Disconnettersi dall'organizzazione di Azure Boards
@azure bacheche scollegate	Scollegare un progetto da questo canale
feedback @azure bacheche	Segnalare un problema o suggerire una funzionalità

Configurare le schede di Azure DevOps Services in Microsoft Teams

1. Per portare la bacheca Kanban o il dashboard in Microsoft Teams, selezionare il pulsante "+" ('aggiungi nuova scheda') nella parte superiore del canale del team.

   Viene visualizzata la finestra di dialogo Aggiungi scheda . Le icone vengono in genere disposte in base all'accesso più recente. È possibile selezionare A-Z per un elenco alfabetico.

   

2. Scegliere l'icona di Azure DevOps e autenticare l'identità. Facoltativamente, è possibile scegliere l'icona sito Web e aggiungere l'URL della scheda Kanban o del dashboard al canale.

3. Scegliere l'organizzazione la cui scheda o dashboard si vuole aggiungere.

4. Completare il modulo presentato. Ad esempio, qui viene aggiunto un dashboard per il team di Azure DevOps per il progetto TechnicalContent.

   

5. Viene visualizzata la scheda Kanban o il dashboard selezionato.

Supporto multi-tenant

Nell'organizzazione se si usa un altro tenant o posta elettronica per Microsoft Teams e Azure DevOps, completare i passaggi seguenti per accedere e connettersi in base al caso d'uso.

Caso

ID e tenant di posta elettronica in Microsoft Teams

ID e tenant di posta elettronica in Azure DevOps

Passaggi da eseguire

1

email1@abc.com
(tenant 1)

email1@abc.com
(tenant 1)

Accedere con il pulsante Accedi .

2

email1@abc.com
(tenant 1)

email1@abc.com
(tenant 2)

• Accedere all'account Azure DevOps
• Nello stesso browser avviare una nuova scheda, passare a https://teams.microsoft.com
• Eseguire il signin comando e scegliere il pulsante Accedi .

3

email1@abc.com
(tenant 1)

email2@pqr.com
(tenant 2)

Accedere usando Accedi con un indirizzo di posta elettronica diverso, nella selezione ID di posta elettronica usare email2 per accedere ad Azure DevOps.

4

email1@abc.com
(tenant 1)

email2@pqr.com
(tenant non predefinito 3)

Questo scenario non è attualmente supportato

Risolvere gli errori

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

• Si è verificato un errore. Riprova.
• Configurazione non riuscita. Assicurarsi che l'organizzazione '{nome organizzazione}' esista e che si disponga di autorizzazioni sufficienti.

Si è verificato un errore. Riprova.

L'app Azure Boards usa il protocollo di autenticazione OAuth e richiede l'accesso dell'applicazione di terze parti tramite OAuth per l'abilitazione dell'organizzazione . Per abilitare questa impostazione, passare a Impostazioni>organizzazione Criteri di sicurezza>e impostare l'accesso dell'applicazione di terze parti tramite OAuth per l'organizzazione su Sì.

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

Disconnettersi da Azure DevOps usando https://aka.ms/VsSignout il browser.

Aprire una finestra del browser In privato o 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 progetto da collegare.

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

Selezionare il Sign in pulsante e si verrà 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

• Definire i percorsi area e assegnarli a un team
• Azure Pipelines con Microsoft Teams
• Azure Repos con Microsoft Teams