Använda Azure-lagringsplatser med Microsoft Teams

  • Artikel

Azure DevOps Services

Om du använder Microsoft Teams och Azure Repos kan du använda Azure Repos-appen för Teams för att övervaka dina lagringsplatser. Appen stöder övervakning av både Git- och Team Foundation-lagringsplatser för versionskontroll (TFVC), men den stöder inte integrering med GitHub-lagringsplatser.

I den här artikeln får du lära dig hur du utför följande uppgifter:

  • Lägga till Azure Repos-appen i ditt team i Microsoft Teams
  • Ansluta Azure Repos-appen till dina lagringsplatser
  • Hantera prenumerationer på lagringsplatsrelaterade händelser i din kanal
  • Söka efter och dela PR-information med hjälp av skrivtillägget
  • Url:er för förhandsversion av pull-begäran
  • Ta bort prenumerationer och lagringsplatser från en kanal

Förutsättningar

  • Hantera din prenumeration, så att du får meddelanden i kanalen när kod skickas eller checkas in, eller när en pull-begäran (PR) skapas, uppdateras eller sammanfogas. Om du vill skapa prenumerationer för lagringsplatsrelaterade händelser måste du vara medlem i gruppen Projektadministratörer eller en gruppadministratör. Information om hur du lägger till finns i Ändra behörigheter på projektnivå eller Lägg till en gruppadministratör.
  • Om du vill ta emot meddelanden aktiverar du inställningen Program från tredje part via OAuth för Azure DevOps-organisationen. Se Ändra principer för programåtkomst för din organisation.

Anteckning

  • Meddelanden stöds för närvarande inte i direktmeddelanden.
  • Du kan bara länka Azure Repos-appen för Microsoft Teams till ett projekt som finns i Azure DevOps Services.

Lägga till Azure Repos-appen i ett team i Microsoft Teams

  1. Gå till Azure Repos-appen i Microsoft Teams, Microsoft Teams > Azure Repos.

  2. Välj Lägg till eller om du redan har laddat ned appen, välj den nedrullningsbara menyn bredvid Öppna och välj sedan Lägg till i ett team.

  3. Ange ett team- eller kanalnamn och välj sedan Konfigurera en robot.

    Skärmbild av välkomstmeddelande från Azure-lagringsplatser i Teams.

Ansluta Azure Repos-appen till dina lagringsplatser

  1. När appen har installerats i ditt team anger du följande text i svarsfältet: @azure repos signin

    Om dina Microsoft Teams och Azure Boards finns i olika klientorganisationer väljer du Logga in med annan e-post.

    Skärmbild som visar teams inloggningspost för Azure Repos.

    Skärmbild som visar ett fullständigt svar för inloggning.

  2. Om du vill övervaka alla Git-lagringsplatser i ett projekt anger du @azure repos subscribe [project url] i kanalen. Se till att lägga till projekt-URL:en. Projekt-URL:en kan vara till valfri sida i projektet (förutom URL:er till lagringsplatser).

    Du kan också övervaka en specifik lagringsplats med hjälp av: @azure repos subscribe [repo url].

    Lagringsplatsens URL kan vara till valfri sida i din lagringsplats som har lagringsplatsens namn, @azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepotill exempel , eller för TFVC-lagringsplatser: @azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.

  3. Med subscribe kommandot kommer du igång med en standardprenumeration. För Git-lagringsplatser prenumererar kanalen på händelsen pull-begäran som skapats (med målgrenen = main). För TFVC-lagringsplatser prenumererar kanalen på den incheckade koden .

    Skärmbild som visar meddelande om att standardprenumerationer skapas.

Hantera prenumerationer

Om du vill visa, lägga till och ta bort prenumerationer för en kanal anger du följande text: @azure repos subscriptions.

Du ser en lista över alla aktuella prenumerationer för kanalen och du kan lägga till nya prenumerationer eller ta bort befintliga. Anpassa dina meddelanden med olika filter enligt beskrivningen i följande avsnitt.

Anteckning

Teamadministratörer kan inte ta bort eller ändra prenumerationer som skapats av projektadministratörer.

Visa prenumerationer

Använd filter för att endast få meddelanden som du vill ha

När du prenumererar på en lagringsplats med @azure repos subscribeskapas en standardprenumeration utan filter. Ofta behöver användarna anpassa dessa prenumerationer så att de bara meddelas när vissa villkor uppfylls. Följande skärmbilder visar ett exempel på hur du konfigurerar meddelanden endast när vårt team finns i granskningslistan för en pull-begäran.

  1. Ange följande text i kanalen: @azure repos subscriptions.

  2. Om det finns en prenumeration som du inte vill ha eller måste ändras i listan över prenumerationer väljer du Ta bort för att ta bort den.

  3. Välj knappen Lägg till prenumeration .

  4. Välj en händelsetyp och välj sedan Nästa.

    Skärmbild som visar val av händelsetyp.

  5. Välj en lagringsplats och välj sedan Nästa.

    Skärmbild som visar val av lagringsplats.

  6. Välj lämpliga filter för att anpassa prenumerationen och välj sedan Skicka.

    Skärmbild som visar valda filter.

Anteckning

  • Alla filter är vanligtvis listrutor. Men om listrutan innehåller fler än 100 objekt måste du ange värdena manuellt.
  • För DEN TFVC-kod som checkats in måste filtret Under sökväg ha formatet $/myproject/path.

Söka efter och dela information om pull-begäranden med hjälp av skrivtillägget

För att hjälpa användare att söka efter och dela information om pull-begäranden stöder Azure Repos-appen för Microsoft Teams ett skrivtillägg. Du kan söka efter pull-begäranden efter ID eller namn. Logga in på Azure Repos-projektet för att tillägget ska fungera genom att ange @azure repos signin eller logga in direkt på skrivtillägget.

Skärmbild som visar skrivtillägget.

Url:er för förhandsversion av pull-begäranden

När du klistrar in URL:en för en pull-begäran visas en förhandsgranskning som den i följande bild, vilket hjälper till att hålla PR-relaterade konversationer sammanhangsbaserade och korrekta. Du måste vara inloggad och sedan kan du förhandsgranska PR för URL:er i alla kanaler i ett team.

Skärmbild som visar hur URL:en utvecklas.

Ta bort prenumerationer och lagringsplatser från en kanal

Om du vill ta bort alla prenumerationer som är relaterade till en lagringsplats i projektet och ta bort lagringsplatserna från kanalen anger du följande text i Teams: @azure repos unsubscribe all [project url]. Se till att ange projektets URL. Endast projektadministratörer kan utföra den här uppgiften.

Trådade meddelanden

Om du vill länka en uppsättning relaterade meddelanden och minska det utrymme som används av meddelanden i en kanal blir meddelanden trådade. Alla meddelanden som är länkade till en viss pull-begäran länkas ihop.

Kompakt vy över trådade meddelandenSkärmbild som visar en kompakt vy över trådade meddelanden.

Utökad vy över trådade meddelandenSkärmbild som visar en utökad vy över trådade meddelanden.

Kommandoreferens

I följande tabell visas alla azure repos kommandon som du kan använda i Teams-kanalen.

Kommando Funktioner
@azure repos subscribe [repo url/ project url] Prenumerera på en lagringsplats eller alla lagringsplatser i ett projekt för att ta emot meddelanden
@azure repos subscriptions Lägga till eller ta bort prenumerationer för den här kanalen
@azure repos signin Logga in på din Azure Repos-organisation
@azure repos signout Logga ut från din Azure Repos-organisation
@azure repos feedback Rapportera ett problem eller föreslå en funktion
@azure repos unsubscribe all [project url] Ta bort alla lagringsplatser (som tillhör ett projekt) och deras associerade prenumerationer från en kanal

Stöd för flera klienter

Om du använder ett annat e-postmeddelande eller en annan klientorganisation för Microsoft Teams och Azure DevOps gör du följande för att logga in, baserat på ditt användningsfall.

Användningsfall Email-ID + Microsoft Teams-klientorganisation Email-ID + Azure DevOps-klientorganisation Steg
1 email1@abc.com (klientorganisation 1) email1@abc.com (klientorganisation 1) Välj Logga in.
2 email1@abc.com (klientorganisation 1) email1@abc.com (klientorganisation 2) Logga in på Azure DevOps. Starta en ny flik i samma webbläsare och gå till https://teams.microsoft.com/. Kör inloggningskommandot och välj Logga in.
3 email1@abc.com (klientorganisation 1) email2@pqr.com (klientorganisation 2) Välj Logga in med en annan e-postadress. I e-post-ID-väljaren använder du sedan email2 för att logga in på Azure DevOps.
4 email1@abc.com (klientorganisation 1) email2@pqr.com (icke-standardklient 3) Det här scenariot stöds inte.

Felsöka

Om du får följande fel när du använder Azure Repos App följer du procedurerna i det här avsnittet.

Något gick tyvärr fel. Försök igen.

Azure Repos-appen använder OAuth-autentiseringsprotokollet och kräver programåtkomst från tredje part via OAuth för att organisationen ska aktiveras. Om du vill aktivera den här inställningen går du tillSäkerhetsprinciper> för organisationsinställningar> och ställer in programåtkomst från tredje part via OAuth för organisationsinställningenpå På.

Aktivera programåtkomst från tredje part via OAuth för organisationsinställningen

Konfigurationen misslyckades. Kontrollera att organisationen {organisationsnamn} finns och att du har tillräcklig behörighet.

Logga ut från Azure DevOps genom att gå till https://aka.ms/VsSignout med webbläsaren.

Öppna ett in privat eller inkognito-webbläsarfönster och gå till https://aex.dev.azure.com/me och logga in. I listrutan under profilikonen till vänster väljer du den katalog som innehåller den organisation som innehåller lagringsplatsen som du vill prenumerera på.

Välj den katalog som innehåller den organisation som innehåller projektet

I samma webbläsare startar du en ny flik och loggar in https://teams.microsoft.com/på . @Azure Repos signout Kör kommandot och kör @Azure Repos signin sedan kommandot i kanalen där Azure Repos-appen för Microsoft Teams är installerad.

Sign in Välj knappen så omdirigeras du till en medgivandesida som den i följande exempel. Kontrollera att katalogen som visas bredvid e-postmeddelandet är samma som den som valdes i föregående steg. Acceptera och slutför inloggningsprocessen.

Medgivande till de begärda appbehörigheterna

Om de här stegen inte löser ditt autentiseringsproblem kontaktar du oss i Utvecklarcommunityn.