Usare l'app Azure Boards con Slack per gestire gli elementi di lavoro
Servizi di Azure DevOps
Se si usa Slack, è possibile usare l'app Azure Boards per Slack per creare elementi di lavoro e monitorare l'attività degli elementi di lavoro nel progetto di Azure Boards dal canale Slack.
L'app Azure Boards per Slack consente agli utenti di configurare e gestire le sottoscrizioni nel canale Slack. Possono gestire le sottoscrizioni per creare e aggiornare e per altri eventi dell'elemento di lavoro. Gli utenti possono anche ricevere notifiche per questi eventi nel canale Slack. Le conversazioni nel canale Slack possono essere usate per creare elementi di lavoro. Le anteprime per gli URL dell'elemento di lavoro consentono agli utenti di avviare discussioni sul lavoro.
Nota
- L'integrazione di Azure Boards e Slack è supportata solo per Azure DevOps Services.
- Le notifiche non sono attualmente supportate all'interno di messaggi diretti.
Prerequisiti
- Livelli di accesso: per creare un elemento di lavoro, essere un collaboratore per il progetto.
- Autorizzazioni: per creare sottoscrizioni in un canale Slack per gli eventi degli elementi di lavoro, essere membri del gruppo Project Administrators o del gruppo Team Administrators .
- Criteri: per ricevere notifiche, abilitare l'accesso dell'applicazione di terze parti tramite i criteri OAuth per l'organizzazione.
Aggiungere l'app Azure Boards all'area di lavoro slack
Per installare l'app Azure Boards nell'area di lavoro slack, aprire un Web browser, accedere a Slack e aprire l'app Azure Boards.
Dopo l'aggiunta, viene visualizzato un messaggio di benvenuto dall'app, come illustrato nell'immagine seguente.
Usare l'handle
/azboardsSlack per interagire con l'app. Più avanti in questo articolo viene fornito un elenco di comandi.
Collegare il progetto di Azure Boards all'app Azure Boards
Per usare l'app, è prima necessario collegare il progetto di Azure Boards al canale Slack.
Dopo aver installato l'app nell'area di lavoro slack, connettersi ed eseguire l'autenticazione ad Azure Boards.
Dopo l'accesso, usare il comando slash seguente all'interno di un canale Slack per collegarsi al progetto di Azure Boards specificato con l'URL:
/azboards link [project url]Ad esempio:
/azboards link https://dev.azure.com/myorg/myproject
Dopo aver collegato il progetto, è possibile creare elementi di lavoro usando /azboards create il comando o usare le azioni dei messaggi.
Configurare le sottoscrizioni per monitorare gli elementi di lavoro
È possibile creare sottoscrizioni per monitorare gli elementi di lavoro in qualsiasi momento usando il /azboards subscriptions comando . È possibile configurare le sottoscrizioni subito dopo il collegamento di un progetto.
Selezionare il percorso dell'area desiderato, l'evento a cui si è interessati e usare i filtri associati per personalizzare il canale Slack. Per configurare facilmente le sottoscrizioni, i percorsi di area a cui si accede di recente vengono visualizzati nell'elenco a discesa percorso area.
Se il percorso dell'area del team 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
/azboards addAreapathcomando e i percorsi di area per i quali le sottoscrizioni vengono create nel canale Slack 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 azione è importante principalmente per i team con più di 100 percorsi di area.
Usare il comando seguente per aggiungere percorsi di area dal progetto al canale Slack.
/azboards addAreapath [area path]Ad esempio:
/azboards addAreapath myproject\fabrikam
Se si sceglie il nome del progetto come percorso di area, si ricevono notifiche per tutti i percorsi dell'area nel progetto. Equivale logicamente a scegliere il percorso dell'area "Qualsiasi".
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
/azboards create.
È possibile creare elementi di lavoro direttamente da un comando passando il tipo di elemento di lavoro e il titolo come parametri. Gli elementi di lavoro vengono creati solo se non hanno campi da compilare in modo obbligatorio.
/azboards create [work item type] [work item title]Ad esempio:
/azboards create 'user story' Push cloud monitoring alerts to mobile devices
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. Un collegamento alla conversazione nel canale viene archiviato nella sezione Discussione dell'elemento di lavoro appena creato, consentendo agli utenti di accedere alla discussione che ha portato alla creazione dell'elemento di lavoro.
Per creare elementi di lavoro usando azioni di messaggio
Gestire le sottoscrizioni di Azure Boards
Per visualizzare, aggiungere e rimuovere sottoscrizioni per un canale, usare il
/azboards subscriptionscomando :/azboards subscriptionsQuesto 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.
Anteprime degli URL degli elementi di lavoro
Per supportare la collaborazione sugli elementi di lavoro descritti all'interno di un canale, viene visualizzata un'anteprima degli elementi di lavoro a cui viene fatto riferimento nel canale. 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à, gli utenti devono accedere. Dopo aver eseguito l'accesso, questa funzionalità funziona per tutti i canali in un'area di lavoro.
Scollegare un progetto da un canale
Un canale Slack può collegarsi a un solo progetto di Azure Boards alla volta. Per collegarsi a un progetto diverso, è necessario prima scollegare il progetto corrente usando /azboards 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.
Informazioni di riferimento sui comandi
Nella tabella seguente sono elencati tutti i /azboards comandi che è possibile usare nel canale Slack.
| Comando barra | Funzionalità |
|---|---|
| /azboards link [url del progetto] | Collegare un progetto a questo canale per creare elementi di lavoro e ricevere notifiche |
| /azboards subscriptions | Aggiungere o rimuovere sottoscrizioni per questo canale |
| /azboards create o /azboards create [tipo di elemento di lavoro] [titolo] | Creare un elemento di lavoro |
| /azboards addAreapath [percorso area] | Aggiungere un percorso di area dal progetto a questo canale |
| /azboards signin | Accedere all'organizzazione di Azure Boards |
| /azboards signout | Disconnettersi dall'organizzazione di Azure Boards |
| /azboards unlink | Scollegare un progetto da questo canale |
| /azboards feedback | Segnalare un problema o suggerire una funzionalità |
Gestire il lavoro nei canali privati
L'app Azure Boards per Slack consente di creare elementi di lavoro e monitorare anche l'attività dell'elemento di lavoro nei canali privati. Per invitare il bot al canale privato, immettere /invite @azboards. Dopo aver eseguito la pubblicazione, è possibile creare elementi di lavoro e gestire le notifiche nello stesso modo in cui si farebbe per un canale pubblico.
Risolvere gli errori
Se si verificano gli errori seguenti quando si usa l'app Azure Boards per Slack, 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://slack.come accedere allo spazio di lavoro (usare il client Web). Eseguire il /azboards signout comando seguito dal /azboards signin comando .
Selezionare il Sign in pulsante 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.