With the Azure DevOps integration, you can:

  • Connect to your Azure DevOps organization(s).

  • Use filters to find work items you want to import. Or, use a query you’ve built in Azure DevOps to find work items.

  • Import work items as sticky notes on the canvas.

Some common use cases are to import work items onto a template to help with sprint planning, user story mapping, PI (program increment) planning, roadmap planning, big room planning, retrospectives, and more.

This article walks you through the setup required in MURAL and in Azure DevOps. If you’re an admin and would like to enable this integration, check out our Azure DevOps admin guide here.


Contents


Use the integration to import work items as sticky notes

Ready to import your Azure DevOps work items into a mural as sticky notes? Let’s get started.

To import your work items as sticky notes:

  1. Right-click on the canvas.

  2. Select Import Azure DevOps from the context menu.

  3. If it’s your first time connecting your Azure DevOps organization, follow the flow to grant permissions between Azure DevOps and MURAL.

  4. Paste your Azure DevOps organization URL to connect to your Azure DevOps organization.

  5. Click Continue.

  6. If it’s your first time connecting your Azure DevOps organization, follow the steps to give MURAL permission to access your Azure DevOps organization on your behalf.

  7. Select the checkboxes for each work item you want to import.

  8. Click Import work items.

Now your work items have been imported into MURAL as sticky notes!


Choose attributes from Azure DevOps to import as tags

To select which attributes will import as tags from Azure DevOps:

  1. Right-click on the canvas.

  2. Select Import Azure DevOps from the context menu.

  3. From the Azure DevOps import window, click Edit import.

  4. In the Select fields to import section, select which work item attributes you want to import as tags on sticky notes. (You can also choose which size sticky note you want to use.)

  5. Click the back ( < ) arrow to return to the import window. Your selections will be saved for the next time you import work items.

  6. From the import window, select the work items you want to import. The attributes you added when customizing your import will be imported as tags on your sticky notes.

    Note: If the attribute doesn't exist for a work item, no tag will be created.


FAQ

Here are answers to some frequently asked questions about Azure DevOps:

  • When I try to import work items, I see a “Something went wrong” message. What does that mean?

    Most likely, the Azure DevOps integration needs to be enabled:


  • When I import many work items, they’re arranged in three columns. How can I rearrange them?

    It’s easy to rearrange your sticky notes. Of course, you’re free to drag and drop the sticky notes to organize in a way that works for you. Or, you can use the Arrange option in the toolbar.

    To rearrange your sticky notes:

    1. Select all imported work item sticky notes.

    2. Right-click the selected sticky notes.

    3. Select the Arrange icon in the toolbar.

    4. Select how you want your sticky notes arranged: By Type, Into a Row, Into a Column, or In a Grid.


  • Why can’t I see all of the tags I imported on the sticky note?

    When there are too many tags on a sticky or the text of the tags is long, they will collapse under a three-dot icon for a better viewing experience. To view the tags, click the three-dot icon in the bottom corner of the sticky note.

    You can also make the sticky notes larger so that more tags are visible.


  • How can I organize my sticky notes after importing them?

    Aside from using the Arrange function in the toolbar, you can also organize your sticky notes from the Find panel. One popular option is to organize imported sticky notes by tags or work item titles.

    To organize your sticky notes using the Find panel:

    1. Click the Find icon in the top right of your mural.

    2. Select the checkbox for the tag you want to filter by. (For this integration, State and Work item type are imported as tags on the sticky note.)

    Alternatively, you can enter the work item title in the search bar.

    You can now click and drag as if you're selecting all of your sticky notes; only the filtered sticky notes will be selected! From there, you can organize the sticky notes into an area, row, grid, smiley face, or whatever works best for you.


  • Can I connect to more than one Azure DevOps organization?

    Yes! You can connect to as many Azure DevOps organizations as you’d like. Each time you import work items from Azure DevOps into your mural, you can open the drop-down menu to choose which Azure DevOps organization you’d like to import from.

    To add and connect to another Azure DevOps organization:

    1. Click your avatar to open User options.

    2. Select Integrations.

    3. Click the three-dot icon on the Azure DevOps card.

    4. Select Manage settings.

    5. Click Add organization to add another Azure DevOps organization.

    6. Enter the URL of the Azure DevOps organization you want to connect to.

    7. Click Continue.

    After authenticating with Azure DevOps, you’ll be connected to the organization.


  • How do I disconnect from an Azure DevOps organization?

    To disconnect from an Azure DevOps organization:

    1. Click your avatar to open User options.

    2. Select Integrations.

    3. Click the three-dot icon on the Azure DevOps card.

    4. Select Manage settings.

    5. Click Disconnect next to the organization that you want to disconnect from. If you’d like to delete the organization permanently, click the trash bin icon.

Did this answer your question?