Usare l'app Azure Boards con Slack per gestire gli elementi di lavoro

Azure Boards

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 Azure Boards dal canale Slack.

L Azure Boards app per Slack consente agli utenti di configurare e gestire le sottoscrizioni nel canale Slack. Possono gestire le sottoscrizioni per gli eventi di creazione, aggiornamento e altri elementi 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 degli elementi di lavoro consentono agli utenti di avviare discussioni sul lavoro.

Pic: Notification

Leggere questo articolo per informazioni su come:

  • Aggiungere l'app Azure Boards'area di lavoro Slack
  • Collegare e scollegare il progetto Azure Boards'app Azure Boards app
  • Configurare le sottoscrizioni per gli eventi correlati agli elementi di lavoro nel canale Slack
  • Creare elementi di lavoro dal canale Slack
  • Monitorare l'attività degli elementi di lavoro nel canale Slack
  • Ottenere notifiche nei canali Slack privati

Nota

  • Azure Boards e Slack sono supportate solo per Azure DevOps Services.
  • Le notifiche non sono attualmente supportate all'interno dei messaggi diretti.

Prerequisiti

  • Per creare un elemento di lavoro, è necessario essere un collaboratore al Azure Boards progetto. Se non si ha ancora un progetto, è possibile iscriversi e creare un progetto. Per informazioni dettagliate, vedere Iniziare a usare Azure Boards.
  • Per creare sottoscrizioni in un canale Slack per gli eventi degli elementi di lavoro, è necessario essere membri del gruppo Administrators Azure Boards Project gruppo Administrators o Team Administrators. Per ottenere l'aggiunta, vedere Impostare le autorizzazioni a livello di progetto o di raccolta o Aggiungere l'amministratore del team.
  • Per ricevere notifiche, è necessario che l'impostazione Accesso alle applicazioni di terze parti tramite OAuth sia abilitata per l'organizzazione. Vedere Modificare i criteri di accesso alle applicazioni per l'organizzazione

Aggiungere l'app Azure Boards'area di lavoro Slack

  1. Per installare l'app Azure Boards nell'area di lavoro Slack, aprire un Web browser, accedere a Slack e aprire l'app Azure Boards.

  2. Dopo l'aggiunta, verrà visualizzato un messaggio di benvenuto dall'app, come illustrato nell'immagine seguente.

    Pic: Welcome message

  3. Usare /azboards l'handle Slack per interagire con l'app. Un elenco di comandi viene fornito più avanti in questo articolo, Riferimento ai comandi.

Per usare l'app, è innanzitutto necessario collegare il progetto Azure Boards al canale Slack.

  1. Dopo aver installato l'app nell'area di lavoro Slack, connettersi ed eseguire l'autenticazione per Azure Boards.

    screenshot of sign-in

  2. Dopo l'accesso, usare il comando barra seguente all'interno di un canale Slack per collegarsi al progetto 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 le azioni del messaggio.

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.

  1. 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 del percorso dell'area.

    Set up subscriptions.

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

Aggiungere percorsi di area

È possibile aggiungere al canale aree su cui lavora il team in modo che siano sempre disponibili per la creazione di elementi di lavoro e sottoscrizioni. Questo è 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
    

    add areapath success message

  • Se si sceglie il nome del progetto come percorso dell'area, si riceveranno notifiche per tutti i percorsi di area nel progetto. È logicamente equivalente alla scelta del percorso dell'area "Qualsiasi".

Creare un elemento di lavoro con un comando

  1. Con l Azure Boards app, è possibile creare elementi di lavoro dal canale. L'app supporta anche elementi di lavoro personalizzati.
  • Per creare un elemento di lavoro, usare /azboards create .

    Create work item using command

  1. È 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 verranno creati solo se non hanno campi da determinare.

     /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 messaggio

Spesso, le discussioni in un canale chiamano per la creazione di elementi di lavoro. È possibile usare le azioni messaggio per creare un elemento di lavoro. Il messaggio selezionato viene precompilato nella sezione relativa alla descrizione dell'elemento di lavoro. Un collegamento alla conversazione nel canale viene archiviato nella sezione Discussione dell'elemento di lavoro appena creato, offrendo agli utenti l'accesso alla discussione che ha portato alla creazione dell'elemento di lavoro.

  • Per creare elementi di lavoro usando azioni messaggio

    Create work item using message action

Gestire Azure Boards sottoscrizioni

  1. Per visualizzare, aggiungere e rimuovere sottoscrizioni per un canale, usare il /azboards subscriptions comando :

     /azboards 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 le notifiche tramite vari filtri.

[! NOTA]Gli amministratori del team non possono rimuovere o modificare le sottoscrizioni create Project amministratori.

Pic: View subscriptions

Anteprime degli URL degli elementi di lavoro

Per supportare la collaborazione sugli elementi di lavoro discussi 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 le conversazioni correlate agli elementi di lavoro pertinenti e corrette.

Pic: URL unfurling

Per il funzionamento di questa funzionalità, gli utenti devono essere connessi. Dopo aver eseguito l'accesso, questa funzionalità funzionerà per tutti i canali in un'area di lavoro.

Un canale Slack può collegarsi a un Azure Boards alla volta. Per collegarsi a un progetto diverso, è prima necessario scollegare il progetto corrente usando il /azboards unlink 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 di progetto possono scollegare un progetto da un canale.

Informazioni di riferimento sui comandi

La tabella seguente elenca tutti /azboards i comandi che è possibile usare nel canale Slack.

Comando Slash Funzionalità
/azboards link [url 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] [title] Creare un elemento di lavoro
/azboards addAreapath [percorso area] Aggiungere un percorso di area dal progetto a questo canale
/azboards signin Accedere all'organizzazione Azure Boards locale
/azboards signout Disconnettersi dall'organizzazione Azure Boards locale
/azboards scollega Scollegare un progetto da questo canale
/azboards feedback Segnalare un problema o suggerire una funzionalità

Gestire il lavoro nei canali privati

L Azure Boards app per Slack consente di creare elementi di lavoro e monitorare l'attività degli elementi di lavoro anche nei canali privati. Per invitare il bot al canale privato, immettere /invite @azboards . Dopo aver pubblicato questo articolo, è 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 problema. Riprova.

L Azure Boards app usa il protocollo di autenticazione OAuth e richiede l'accesso alle applicazioni di terze parti tramite OAuth perché l'organizzazione sia abilitata. Per abilitare questa impostazione, passare a Criteri di sicurezza Impostazioniorganizzazione e impostare l'accesso alle applicazioni di terze parti tramite OAuth per l'organizzazione su On.

Enable the Third-party application access via OAuth for the organization setting

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

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

Aprire una finestra del browser in privato o in incognito e passare a e accedere. Nell'elenco a discesa sotto l'icona del profilo a sinistra selezionare la directory contenente l'organizzazione contenente il progetto da collegare.

Select the directory that contains the organization that contains the project

Nello stesso browseravviare una nuova scheda, passare a e accedere all'spazio di lavoro ( usare il clientWeb). Eseguire il /azboards signout comando seguito dal comando /azboards signin .

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

Consent to the requested app permissions

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