De Azure Boards-app met Slack gebruiken om werkitems te beheren

  • Artikel

Azure DevOps Services

Als u Slack gebruikt, kunt u de Azure Boards app voor Slack gebruiken om werkitems te maken en de activiteit van werkitems in uw Azure Boards-project te bewaken vanuit uw Slack-kanaal.

Met de Azure Boards-app voor Slack kunnen gebruikers abonnementen instellen en beheren in hun Slack-kanaal. Ze kunnen abonnementen beheren voor maken, bijwerken en andere werkitems gebeurtenissen. Gebruikers kunnen ook meldingen ontvangen voor deze gebeurtenissen in hun Slack-kanaal. Gesprekken in het Slack-kanaal kunnen worden gebruikt om werkitems te maken. Voorbeelden voor werkitem-URL's helpen gebruikers bij het starten van discussies over werk.

Afbeelding: Melding

Lees dit artikel voor meer informatie over het volgende:

  • De Azure Boards-app toevoegen aan uw Slack-werkruimte
  • Uw Azure Boards-project koppelen en ontkoppelen met de Azure Boards-app
  • Abonnementen instellen op gebeurtenissen met betrekking tot werkitems in uw Slack-kanaal
  • Werkitems maken vanuit uw Slack-kanaal
  • Activiteit van werkitems in uw Slack-kanaal bewaken
  • Meldingen ontvangen in privé-Slack-kanalen

Notitie

  • Azure Boards en Slack-integratie wordt alleen ondersteund voor Azure DevOps Services.
  • Meldingen worden momenteel niet ondersteund in directe berichten.

Vereisten

De Azure Boards-app toevoegen aan uw Slack-werkruimte

  1. Als u de Azure Boards-app wilt installeren in uw Slack-werkruimte, opent u een webbrowser, meldt u zich aan bij Slack en opent u de Azure Boards-app.

  2. Na het toevoegen ziet u een welkomstbericht van de app, zoals wordt weergegeven in de volgende afbeelding.

    Afbeelding: Welkomstbericht

  3. Gebruik de /azboards Slack-ingang om te communiceren met de app. Een lijst met opdrachten vindt u verderop in dit artikel, Naslaginformatie over opdrachten.

Als u de app wilt gebruiken, moet u eerst uw Azure Boards-project koppelen aan uw Slack-kanaal.

  1. Zodra de app is geïnstalleerd in uw Slack-werkruimte, maakt u verbinding en verifieert u uzelf bij Azure Boards.

    schermopname van aanmelding

  2. Nadat u zich hebt aangemeld, gebruikt u de volgende slash-opdracht in een Slack-kanaal om een koppeling te maken naar het Azure Boards-project dat u opgeeft met de URL:

     /azboards link [project url]

    Bijvoorbeeld:

     /azboards link https://dev.azure.com/myorg/myproject

Zodra het project is gekoppeld, kunt u werkitems maken met behulp van /azboards create de opdracht of berichtacties gebruiken.

Abonnementen instellen om werkitems te bewaken

U kunt abonnementen maken om werkitems op elk gewenst moment te bewaken met behulp van de /azboards subscriptions opdracht . U kunt abonnementen instellen net nadat u een project hebt gekoppeld.

  1. Selecteer het gewenste gebiedspad, de gebeurtenis waarin u geïnteresseerd bent en gebruik de bijbehorende filters om uw Slack-kanaal aan te passen. Als u eenvoudig abonnementen wilt instellen, worden uw onlangs geopende gebiedspaden weergegeven in de vervolgkeuzelijst met gebiedspaden.

    Stel abonnementen in.

    Als het gebiedspad van uw team niet wordt weergegeven in de vervolgkeuzelijst Gebiedspad, volgt u de instructies in de volgende sectie Gebiedspaden toevoegen. Vlakpaden die zijn toegevoegd met behulp van de /azboards addAreapath opdracht- en gebiedspaden waarvoor abonnementen worden gemaakt in het Slack-kanaal, worden altijd weergegeven in de vervolgkeuzelijst Gebiedspaden, samen met onlangs geopende gebiedspaden.

Vlakpaden toevoegen

U kunt gebieden waaraan uw team werkt toevoegen aan het kanaal, zodat ze altijd beschikbaar zijn voor het maken van werkitems en abonnementen. Dit is vooral belangrijk voor de teams met meer dan 100 vlakpaden.

  • Gebruik de volgende opdracht om gebiedspaden van uw project toe te voegen aan het Slack-kanaal.

      /azboards addAreapath [area path]

    Bijvoorbeeld:

      /azboards addAreapath myproject\fabrikam

    bericht over geslaagd gebiedspad toevoegen

  • Als u de projectnaam als gebiedspad kiest, ontvangt u meldingen voor alle vlakpaden in het project. Dit is logischerwijs gelijk aan het kiezen van het gebiedspad 'Any'.

Een werkitem maken met een opdracht

  1. Met de app Azure Boards kunt u werkitems maken vanuit uw kanaal. De app ondersteunt ook aangepaste werkitems.

  • Als u een werkitem wilt maken, gebruikt u /azboards create.

    Werkitem maken met de opdracht

  1. U kunt werkitems rechtstreeks vanuit een opdracht maken door het type werkitem en de titel door te geven als parameters. Werkitems worden alleen gemaakt als ze geen velden hebben die verplicht moeten worden ingevuld.

     /azboards create [work item type] [work item title]

    Bijvoorbeeld:

     /azboards create 'user story' Push cloud monitoring alerts to mobile devices

Een werkitem maken van berichtacties

Vaak vragen discussies in een kanaal om werkitems te maken. U kunt berichtacties gebruiken om een werkitem te maken. Het geselecteerde bericht wordt vooraf ingevuld in de beschrijvingssectie van het werkitem. Een koppeling terug naar het gesprek in het kanaal wordt opgeslagen in de sectie Discussie van het zojuist gemaakte werkitem, zodat gebruikers toegang hebben tot de discussie die heeft geleid tot het maken van het werkitem.

  • Werkitems maken met behulp van berichtacties

    Werkitem maken met de berichtactie

Azure Boards-abonnementen beheren

  1. Als u abonnementen voor een kanaal wilt weergeven, toevoegen en verwijderen, gebruikt u de /azboards subscriptions opdracht:

     /azboards subscriptions

    Met deze opdracht worden alle huidige abonnementen voor het kanaal weergegeven en kunt u nieuwe abonnementen toevoegen en bestaande abonnementen verwijderen. Als onderdeel van het toevoegen van abonnementen kunt u ook aanpassen waarover u een melding ontvangt met behulp van verschillende filters.

[! OPMERKING]Teambeheerders kunnen geen abonnementen verwijderen of wijzigen die zijn gemaakt door projectbeheerders.

Afbeelding: Abonnementen weergeven

Voorbeelden van URL's voor werkitems

Ter ondersteuning van samenwerking rond werkitems die binnen een kanaal worden besproken, wordt een voorbeeld weergegeven van werkitems waarnaar in het kanaal wordt verwezen. Wanneer een gebruiker de URL van het werkitem plakt, wordt een voorbeeld weergegeven dat lijkt op de volgende afbeelding. Deze preview helpt om gesprekken met betrekking tot werkitems relevant en correct te houden.

Afbeelding: URL unfurling

Deze functie werkt alleen als gebruikers zijn aangemeld. Zodra ze zijn aangemeld, werkt deze functie voor alle kanalen in een werkruimte.

Een Slack-kanaal kan slechts aan één Azure Boards-project tegelijk worden gekoppeld. Als u een koppeling naar een ander project wilt maken, moet u eerst het huidige project ontkoppelen met behulp van /azboards unlink de opdracht .

Als u een project ontkoppelt, worden alle abonnementen verwijderd, samen met toegevoegde gebiedspaden uit het kanaal. Als het kanaal geen abonnementen heeft, kan elke gebruiker een project ontkoppelen. Als een kanaal echter abonnementen heeft, kunnen alleen projectbeheerders een project ontkoppelen van een kanaal.

Opdrachtreferentie

De volgende tabel bevat alle /azboards opdrachten die u in uw Slack-kanaal kunt gebruiken.

Slash-opdracht Functionaliteit
/azboards link [project-URL] Een project koppelen aan dit kanaal om werkitems te maken en meldingen te ontvangen
/azboards-abonnementen Abonnementen voor dit kanaal toevoegen of verwijderen
/azboards create of /azboards create [type werkitem] [titel] Een werkitem maken
/azboards addAreapath [gebiedspad] Een gebiedspad van uw project toevoegen aan dit kanaal
/azboards aanmelden Meld u aan bij uw Azure Boards-organisatie
/azboards afmelden Afmelden bij uw Azure Boards-organisatie
/azboards unlink Een project ontkoppelen van dit kanaal
Feedback over /azboards Een probleem melden of een functie voorstellen

Werk in privékanalen beheren

Met de App Azure Boards voor Slack kunt u werkitems maken en de activiteit van werkitems in uw privékanalen bewaken. Als u de bot wilt uitnodigen voor uw privékanaal, voert u in /invite @azboards. Nadat u dat hebt geplaatst, kunt u werkitems maken en uw meldingen op dezelfde manier beheren als voor een openbaar kanaal.

Problemen oplossen

Als u de volgende fouten ondervindt bij het gebruik van de Azure Boards-app voor Slack, volgt u de procedures in deze sectie.

Er is iets fout gegaan. Probeer het opnieuw.

De Azure Boards-app maakt gebruik van het OAuth-verificatieprotocol en vereist toegang tot toepassingen van derden via OAuth om de organisatie in te schakelen. Als u deze instelling wilt inschakelen, gaat u naar Organisatie-instellingen>Beveiligingsbeleid> en stelt u de instelling Toegang tot toepassingen van derden via OAuth voor de organisatie in op Aan.

De toepassingstoegang van derden via OAuth inschakelen voor de organisatie-instelling

Configuratie is mislukt. Zorg ervoor dat de organisatie {organization name} bestaat en dat u over voldoende machtigingen beschikt.

Meld u af bij Azure DevOps door naar uw browser te https://aka.ms/VsSignout gaan.

Open een privé - of incognitobrowservenster en ga naar en meld u aan https://aex.dev.azure.com/me . Selecteer in de vervolgkeuzelijst onder het profielpictogram aan de linkerkant de map met de organisatie met het project dat u wilt koppelen.

Selecteer de map met de organisatie die het project bevat

Start in dezelfde browser een nieuw tabblad, ga naar https://slack.comen meld u aan bij uw werkruimte (gebruik webclient). Voer de /azboards signout opdracht uit, gevolgd door de /azboards signin opdracht .

Selecteer de Sign in knop en u wordt omgeleid naar een toestemmingspagina zoals in het volgende voorbeeld. Zorg ervoor dat de map die naast het e-mailbericht wordt weergegeven, hetzelfde is als de map die in de vorige stap is gekozen. Accepteer en voltooi het aanmeldingsproces.

Toestemming voor de aangevraagde app-machtigingen

Als u met deze stappen uw verificatieprobleem niet kunt oplossen, neemt u contact met ons op via de Ontwikkelaarscommunity.