Skip to content

Latest commit

 

History

History
 
 

teams

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
images
images
 
 
readme.md
readme.md
 
 

readme.md

title layout sidebar permalink folder redirect_from
Microsoft Teams with Azure DevOps Services (Collaborate, Communicate and Celebrate)
page
vsts
/labs/vstsextend/teams/
/labs/vstsextend/teams/
/labs/vsts/teams/index.htm

Overview

Microsoft Teams is a hub for teamwork in Office 365. Keep all your team's chats, meetings, files, and apps together in one place. Software development teams get instant access to everything they need in a dedicated hub for teamwork, that brings your teams, conversations, content and tools from across Office 365 and Azure DevOps together into one place.

{% include note.html content= "This topic applies to Azure DevOps Services and to TFS 2017.2 and later versions." %}

Prerequisites

  1. You should have Office365 account in order to integrate Azure DevOps Services with Microsoft Teams.

  2. Only Azure DevOps organizations in the same organization (AAD tenant) can be used to integrate with your Microsoft Teams account.

You can start a free trial if you don't have Office365 account from here{:target="_blank"}

In this lab, you’ll learn about how Azure DevOps integrates with Microsoft Teams to provide a comprehensive chat and collaboration experience, across your Agile and development work.

Getting started with Microsoft Teams

  1. Launch Microsoft Teams - you can either open the web app or download the app to your desktop from here{:target="_blank"}

  2. After launching the app, on the left side of Teams, click Teams, and then at the bottom of the teams list, click Join or create a team. A team is a collection of people who gather together around a common goal.

  3. In the Join or create team window select Create team.

  4. Give a name for your team and description if needed. Select the privacy settings and click on Next.

  5. Add members for your team in order to get notified the events that occur and also start conversations with your team members.

Integrating Microsoft Teams with Azure DevOps Services

Azure DevOps Services integration with Microsoft Teams provides a comprehensive chat and collaborative experience across the development cycle. Teams can easily stay informed of important activities in your Azure DevOps team projects with notifications and alerts on work items, pull requests, code commits, build and release.

  1. Select Tailwind Traders team that was created. Click the ellipsis or '...' at the top nav of your team channel, and then select Connectors.

  2. Select Azure DevOps connector from the list and click Add.

  3. Click Install to add the connector for your team.

  4. Select your organization (you may be prompted to sign in first), the project, and your team. Choose the type of activity you want to be notified about. Depending on the event, you may be given further fields to filter down the notifications so you can filter out notifications your team does not care about. For example, for work item events, you can filter by area path, work item type, and even particular field changes.

    When you are happy with the configuration, Save it.

  5. Since Azure DevOps is configured now, activity from your Azure DevOps Services project will start appearing in your Teams channel.

  6. If you want to make a change to an existing connector, navigate to the Configured tab on the Connector dialog, find the connector, and click Manage.

Azure DevOps Kanban board & Dashboards in Teams

Your Kanban board turns your backlog into an interactive signboard, providing a visual flow of work. As work progresses from idea to completion, you update the items on the board. Each column represents a work stage, and each card represents a user story (blue cards) or a bug (red cards) at that stage of work.

You can bring in your teams kanban board or favourite dashboard directly into Microsoft Teams. These can be added using Tabs. Tabs allow team members to access your service on a dedicated canvas, within a channel or in user's personal app space. You can leverage your existing web app to create a great tab experience within Teams.

  1. To bring your Kanban board or Dashboard into Microsoft Teams, click the + icon to add new tab. Find the Azure DevOps icon and select Azure DevOps

  2. Select the Organization

    {% include note.html content= " The Kanban board and Dashboard integration has the following limitations:

    1. Only works for Azure DevOps Services (Team Foundation Server is not supported)

    2. Only Kanban boards and Dashboards within organizations in the same organization (Azure Active Directory tenant) as your Microsoft Teams account can be configured." %}

  3. Once you have authenticated and selected your organization, you will be displayed a screen to select a Kanban board or Dashboard.

    Select the Kanban board and select your project, team, backlog level. Save the configuration.

  4. Now you can see the Kanban Board appearing in the tab.

  5. All the work can be monitored during the daily standup's and the updates are real when the work items states are changed. It also allows us to customize the Kanban Board from within the Teams and synced.

Azure Pipelines with Microsoft Teams

Azure Pipelines app on Microsoft Teams enables you to monitor the events for your pipelines. You can set up and manage subscriptions for releases, pending approvals, completed builds etc. and get notifications right into your Teams channel for these updates. You can also approve releases from within your Teams channel.

Install Azure Pipelines app to your team

  1. Visit the App store in Microsoft Teams and search for the Azure Pipelines app. Select Azure Pipelines app.

  2. In the app, window select your team and click Install.

  3. Once the app is installed to your team, select channel and click Set up

  4. Use the @azure pipelines handle to start interacting with the app.

  5. In Conversations enter @Azure Pipelines signin.

  6. The app asks you to Sign in and authenticate to Azure Pipelines. Click Sign in and complete the authentication.

Subscribe for the pipelines notifications

To start monitoring a pipeline, use the following command inside a channel:

@azure pipelines subscribe [pipeline url]

The pipeline URL can be to any page within your pipeline that has a definitionId or buildId/releaseId present in the URL.

  1. For example, to subscribe for Build pipelines enter

    @azure pipelines subscribe https://dev.azure.com/myorg/Tailwind%20Traders/_build?definitionId=2

    For Build pipelines, the channel is subscribed to the Build completed notification

  2. To subscribe for Release pipelines enter

    @azure pipelines subscribe https://dev.azure.com/myorg/Tailwind%20Traders/_releaseDefinition?definitionId=2

    For Release pipelines, the channel is subscribed to the Release deployment started, Release deployment completed, and Release deployment approval pending notifications.

  3. Managing Subscriptions: You can add or remove subscriptions by using the following command

    @azure pipelines subscriptions This command lists all of the current subscriptions for the channel and allows you to add/remove subscriptions.

Using filters to customize subscriptions

When a user subscribes to any pipeline, a few subscriptions are created by default without any filters being applied. Often, users have the need to customize these subscriptions. For example, users may want to get notified only when builds fail or when deployments are pushed to a production environment. The Azure Pipelines app supports filters to customize what you see on your channel.

Run the @Azure Pipelines subscriptions command and select Add Subscription.

  • Get notifications only for failed builds

  • Get notifications only if the deployments are pushed to prod environment

Collaboration Experience

Messages are a good way to connect and keep a history of the conversation. It's even better to use emoji, stickers, and GIFs to make a great impression.

  1. Start having conversations with your team members by selecting the Conversations tab.

  2. All the conversations could be retrieved at any time without losing the history which helps the entire team to have a collaborative experience

  3. Teams can have a collaborative experience with the latest updates with respect to the work items, build summary etc so that it helps in better transparency

  4. Easily find and discuss work items from DevOps in Teams : You can easily search, find and discuss work items from Azure DevOps in Teams, keeping the conversation and collaboration within your Teams app. For example if you would like to discuss about any User Story you can click on Azure DevOps icon. It will prompt a window where you can search your project workitems. Select the work item to discuss and enter your comments.

For more information about using the Conversation tab in Microsoft Teams click here

Working with Channels

Channels are dedicated sections within a team to keep conversations organized by specific topics, projects, disciplines—-whatever works for your team!

  • Team channels are places where everyone on the team can openly have conversations. Private chats are only visible to those people in the chat.

  • Channels are most valuable when extended with apps that include tabs, connectors, and bots that increase their value to the members of the team.

To learn more about best practices for creating teams and channels view this short video.

  1. Select the Team that was created earlier and click on ellipsis (...)

  2. Give a name and description for your channel and click on Add

  3. Once the channel is created, the conversations can be started among the team members.

Sharing the Contents

As your team works together you'll undoubtedly have files that you'll want to share and collaborate on. Microsoft Teams makes it easy to share files within channels. If the files are Word, Excel. PowerPoint or Visio files your colleagues can even view, edit, and collaborate on the files right within Teams. For Word, Excel, and PowerPoint, they can see each others changes in almost real time.

  1. Select Files and select Upload to share a document with the team. You can also use Drag and drop (Using your mouse, drag the file from where it's currently located and drop it on the Teams window among the files.) method to upload files.

  2. Click on the document that was uploaded from the list to start editing and having a live conversation with your team members

  3. You can also share the related websites within the Teams as Tabs. As we use Wiki to explain project objectives, epics, specs, release notes, best practices or other content to ensure all your team members and stakeholders learn, you can also share your Team's Wiki content as website within teams as tab.

  4. Navigate to your Azure DevOps projects Wiki page. Copy the URL.

  5. Now switch back to the Teams. Click on + and select Website

  6. Provide a name for the website, enter the wiki URL copied in previous step and click on Save. It appears on the channel where all of the team members can access to get quick information if there were any updates done

  7. This is how the website/Wiki looks when added to the channel.

Now that you have connected Microsoft Teams and Azure DevOps think about the other development team information that you can expose via Microsoft teams, for example:

References