De Azure Boards-app gebruiken in Microsoft Teams

  • Artikel

Azure DevOps Services

Als u Microsoft Teams gebruikt, kunt u werkitems maken en de activiteit van werkitems in uw Azure Boards-project bewaken vanuit uw Teams-kanaal. U doet dit door de Azure Boards-app voor Microsoft Teams toe te voegen aan uw Teams-kanaal.

Met de Azure Boards-app voor Microsoft Teams kunnen gebruikers de volgende taken uitvoeren:

  • Abonnementen instellen en beheren voor het maken en bijwerken van werkitems
  • Andere werkitem-gebeurtenissen beheren
  • Meldingen ontvangen en beheren voor werkitems in hun Teams-kanaal
  • Werkitems maken vanuit gesprekken in het kanaal
  • Werkitems zoeken en delen met andere leden in het kanaal met behulp van de berichtenextensie
  • Bekijk voorbeelden van werkitems vanuit hun URL's om discussies te starten en de gesprekken contextueel te houden.

Afbeelding: Melding

Lees dit artikel voor meer informatie over het volgende:

  • De Azure Boards-app toevoegen aan uw team in Microsoft Teams
  • Uw Azure Boards-project koppelen en ontkoppelen naar de Azure Boards-app
  • Abonnementen instellen voor gerelateerde gebeurtenissen met betrekking tot werkitems in uw Teams-kanaal
  • Werkitems maken vanuit uw Teams-kanaal
  • Activiteit van werkitems in uw Teams-kanaal bewaken

Notitie

Integratie van Azure Boards en Microsoft Teams wordt alleen ondersteund voor Azure DevOps Services.

Azure Boards en Microsoft Teams-integratie worden ook niet ondersteund als u een O365 Government Community Cloud-klant (GCC) bent die gebruikmaakt van een commercieel Azure-abonnement in combinatie met uw GCC-tenant.

Vereisten

  • Als u een werkitem wilt maken, moet u een bijdrager zijn aan het Azure Boards-project. Als u nog geen project hebt, kunt u zich registreren en een project maken. Zie Aan de slag met Azure Boards voor meer informatie.
  • Als u abonnementen wilt maken in een Teams-kanaal voor gebeurtenissen voor werkitems, moet u lid zijn van de groep Azure Boards Project Beheer istrators of zijn toegevoegd aan de teambeheerdersrol voor het team. Zie Machtigingen op projectniveau wijzigen of Teambeheerder toevoegen om toe te voegen.
  • Als u meldingen wilt ontvangen, moet u de toepassingstoegang van derden inschakelen via de OAuth-instelling voor de Azure DevOps-organisatie. Zie Toegangsbeleid voor toepassingen voor uw organisatie wijzigen.

Notitie

  • U kunt de Azure Boards-app voor Microsoft Teams op dit moment alleen koppelen aan een project dat wordt gehost in Azure DevOps Services.
  • Meldingen worden momenteel niet ondersteund in directe berichten.
  • Alleen openbare kanalen worden ondersteund.

De Azure Boards-app toevoegen aan Microsoft Teams

U voegt de app toe aan uw Teams-kanaal in Microsoft Teams.

  1. Ga naar de App Store in Microsoft Teams en zoek naar de Azure Boards-app. Na de installatie wordt een welkomstbericht van de app weergegeven, zoals wordt weergegeven in de volgende afbeelding.

    Foto: Welkomstbericht

  2. Gebruik de @azure boards ingang om te communiceren met de app. Zie de opdrachtreferentie verderop in dit artikel voor een lijst met opdrachten.

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

  1. Zodra de app in uw team is geïnstalleerd, maakt u verbinding en verifieert u zich bij Azure Boards. Gebruik Aanmelden met verschillende e-mail als uw Microsoft Teams- en Azure-borden zich in verschillende tenants bevinden.

    Verbinding maken en verifieer uzelf bij Azure Boards.

    Verbinding maken en verifieer uzelf bij Azure Boards, stap 2.

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

     @azure boards link [project url]

    Voorbeeld:

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

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

Abonnementen instellen

U kunt abonnementen maken om werkitems op elk gewenst moment te bewaken met behulp van de @azure boards subscriptions opdracht.

  1. Selecteer het gewenste gebiedspad en de gebeurtenis waarin u geïnteresseerd bent. Gebruik de bijbehorende filters om aan te passen waarover u een melding ontvangt in uw Teams-kanaal. Om eenvoudig abonnementen in te stellen, worden uw onlangs geopende vlakpaden weergegeven in de vervolgkeuzelijst gebiedspaden.

    Abonnementen instellen.

Als het gewenste gebiedspad niet wordt weergegeven in het vervolgkeuzemenu Gebiedspad, volgt u de instructies in de volgende sectie, Gebiedspaden toevoegen. Gebiedspaden die zijn toegevoegd met behulp van de @azure boards addAreapath opdracht- en gebiedspaden waarvoor abonnementen in het kanaal worden gemaakt, worden altijd weergegeven in de vervolgkeuzelijst Gebiedspaden, samen met onlangs geopende gebiedspaden.

Gebiedspaden toevoegen

U kunt gebieden waaraan uw team werkt toevoegen aan het kanaal, zodat ze altijd beschikbaar zijn voor het maken van werkitems en abonnementen. Deze functie is handig voor teams met meer dan 100 vlakpaden in hun project.

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

      @azure boards addAreapath [area path]

    Voorbeeld:

      @azure boards addAreapath myproject\fabrikam

    Bericht over geslaagd gebiedspad toevoegen

  • Als u de projectnaam als uw gebiedspad kiest, ontvangt u meldingen voor alle gebiedspaden in het project.

Een werkitem maken met een opdracht

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

  • Als u een werkitem wilt maken, gebruikt u @azure boards create.

    Werkitem maken met behulp van de opdracht

Een werkitem maken op basis van berichtacties

Discussies in een kanaal vereisen vaak het maken van werkitems. U kunt berichtacties gebruiken om een werkitem te maken. Het geselecteerde bericht wordt vooraf ingevuld in de beschrijvingssectie van het werkitem. In de sectie Discussie van het zojuist toegevoegde werkitem wordt een koppeling naar het gesprek in het kanaal opgeslagen.

  • Werkitems maken met behulp van berichtacties

    Werkitem maken met de berichtactie

    Werkitem maken met de berichtactie, stap 2.

Azure Boards-abonnementen beheren

  1. Gebruik de @azure boards subscriptions opdracht om abonnementen voor een kanaal weer te geven, toe te voegen en te verwijderen:

     @azure boards 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 krijgt met behulp van verschillende filters.

Abonnementen weergeven

Notitie

Teambeheerders kunnen geen abonnementen verwijderen of wijzigen die zijn gemaakt door Projectbeheerders.

Werkitems zoeken en delen met de compose-extensie

Om gebruikers te helpen werkitems te zoeken en te delen, ondersteunt de Azure Boards-app voor Microsoft Teams de compose-extensie. U kunt zoeken naar werkitems op werkitem-id, titel of ondersteunde functionele opdracht. Zie Functioneel werkitem zoeken voor een lijst met opdrachten. Als u de compose-extensie wilt gebruiken, moeten gebruikers zich aanmelden bij de Azure Boards-app door de opdracht uit te voeren @azure boards signin of door zich rechtstreeks aan te melden bij de compose-extensie.

Aanmelden bij de compose-extensie.

URL's van werkitems bekijken

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

Url van werkitem opheffen.

Deze functie werkt alleen als gebruikers zijn aangemeld. Nadat u zich hebt aangemeld, werkt deze functie voor alle kanalen in een team in Microsoft Teams.

Een Teams-kanaal kan slechts één Azure Boards-project tegelijk koppelen. Als u een koppeling naar een ander project wilt maken, moet u eerst het huidige project ontkoppelen met behulp van @azure boards unlink de opdracht.

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

De meldingen van teams-kanaalthreads om gerelateerde meldingen in het kanaal logisch te koppelen en te verminderen. Alle meldingen die aan een bepaald werkitem zijn gekoppeld, worden aan elkaar gekoppeld.

Compacte weergave van threaded meldingen

Compacte thread

Uitgevouwen weergave van threaded meldingen

Uitgevouwen thread

Naslaginformatie over Azure Boards-opdrachten

De volgende tabel bevat alle @azure boards opdrachten die u kunt gebruiken in uw Microsoft Teams-kanaal.

Opdracht Functionaliteit
koppeling @azure borden [project-URL] Een project koppelen aan dit kanaal om werkitems te maken en meldingen te ontvangen
@azure boards abonnementen Abonnementen voor dit kanaal toevoegen of verwijderen
@azure borden maken Een werkitem maken
@azure boards addAreapath [gebiedspad] Een gebiedspad van uw project toevoegen aan dit kanaal
@azure borden aanmelden Aanmelden bij uw Azure Boards-organisatie
afmelden bij @azure borden Afmelden bij uw Azure Boards-organisatie
@azure borden ontkoppelen Een project ontkoppelen van dit kanaal
feedback @azure borden Een probleem melden of een functie voorstellen

Azure DevOps Services-tabbladen configureren in Microsoft Teams

  1. Als u uw Kanbanbord of Dashboard wilt overbrengen naar Microsoft Teams, selecteert u de knop '+' ('nieuw tabblad toevoegen') in het bovenste navigatievenster van uw teamkanaal.

    Het dialoogvenster Een tabblad toevoegen wordt weergegeven. Pictogrammen worden meestal gerangschikt op basis van de meest recente toegang. U kunt A-Z selecteren voor een alfabetische lijst.

    Schermopname van het toevoegen van een nieuw tabblad aan het Teams-kanaal.

  2. Kies het azure DevOps-pictogram en verifieer uw identiteit. U kunt eventueel het websitepictogram kiezen en de URL van uw Kanbanbord of dashboard toevoegen aan het kanaal.

  3. Kies de organisatie waarvan u het bord of dashboard wilt toevoegen.

  4. Vul het gepresenteerde formulier in. Hier voegen we bijvoorbeeld een dashboard toe voor het Azure DevOps-team voor het TechnicalContent-project.

    Dialoogvenster om een teamdashboard toe te voegen aan een Teams-kanaal.

  5. Het Kanbanbord of dashboard dat u hebt geselecteerd, wordt weergegeven.

Ondersteuning voor meerdere tenants

Als u in uw organisatie een andere e-mail of tenant voor Microsoft Teams en Azure DevOps gebruikt, voert u de volgende stappen uit om u aan te melden en verbinding te maken op basis van uw use-case.

Geval

E-mail-id en tenant in Microsoft Teams

E-mail-id en tenant in Azure DevOps

Stappen die moeten worden uitgevoerd

1

email1@abc.com
(tenant 1)

email1@abc.com
(tenant 1)

Meld u aan met de knop Aanmelden .

2

email1@abc.com
(tenant 1)

email1@abc.com
(tenant 2)

  • Aanmelden bij het Azure DevOps-account
  • Start in dezelfde browser een nieuw tabblad, ga naar https://teams.microsoft.com
  • Voer de signin opdracht uit en kies de knop Aanmelden .

3

email1@abc.com
(tenant 1)

email2@pqr.com
(tenant 2)

Meld u aan met behulp van Aanmelden met een ander e-mailadres. Gebruik in de e-mail-idkiezer de e-mail2 om u aan te melden bij Azure DevOps.

4

email1@abc.com
(tenant 1)

email2@pqr.com
(niet-standaardtenant 3)

Dit scenario wordt momenteel niet ondersteund

Problemen oplossen

Als u de volgende fouten ondervindt bij het gebruik van de Azure Boards-app voor Microsoft Teams, 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 dat toepassingstoegang van derden via OAuth wordt ingeschakeld voor de organisatie . Als u deze instelling wilt inschakelen, gaat u naar Beveiligingsbeleid> voor organisatie-instellingen>en stelt u de toegang tot toepassingen van derden in via OAuth voor de organisatieinstelling op Aan.

Toegang tot toepassingen van derden inschakelen via OAuth voor de organisatie-instelling

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

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

Open een in-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 die het project bevat dat u wilt koppelen.

Selecteer de map met de organisatie die het project bevat

Start in dezelfde browser een nieuw tabblad, ga naar https://teams.microsoft.com/. Voer de @azure boards signout opdracht uit en voer vervolgens de @azure boards signin opdracht uit in het kanaal waar de Azure Boards-app voor Microsoft Teams is geïnstalleerd.

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 geven voor de aangevraagde app-machtigingen

Als deze stappen uw verificatieprobleem niet oplossen, neemt u contact met ons op bij de Developer Community.