Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This article will walk you trough our task / issue sync feature.

...

Table of Contents

...

What is a sync?

A sync creates new tasks in your Microsoft To Do list. You can setup an issue sync per project, with a specific filter. For example, if you are working on a “Development” project and want to see issues that have been assigned to you in Microsoft To Do, you can use the issue sync to create them automatically.

The sync is something that is on-going, so when a new task is created and it matches your filter (e.g. assigned to you), the app will automatically create a new task in To Do.

...

Configuring your first sync

Getting started and logging in

To get started, please go to the project for which you want to configure the issue sync. You can find the app in the sidebar of the project.

Expand
titleWhere to find the app
Image Removed

...

Configuration

Info

The feature needs to be configured directly in your Jira project.

Prerequisite

To use Microsoft To Do, you’ll need one of the following accounts:

  • Personal Microsoft account

  • Office 365 school account

  • Office 365 work account

In most cases, you might already have one of those, either for your personal Windows 10 computer or your work email / calendar account. If you are sure you have neither of those accounts, please create a new Microsoft account when installing the app.

After logging in, you should see something like this:

Image Removed

This means you are all set to configure your first sync!

...

.

...

Where to find the feature

To get started, please go to one of your Jira projects → via the sidebar → choose “Microsoft To Do”.

By clicking on the button, you can decide if you’d like to configure the app in the simple or advanced way.

...

Install the Microsoft To Do app

(tick) You already use To Do? Perfect, then go ahead.

(error) You don’t yet use the To Do app? Get the Microsoft To Do app here and go ahead with the configuration. Familiarize yourself with the app first, if you like.

...

Log in

When using our app you need to log in with your Microsoft 365 account (see: prerequisite)

Right after logging in you can move on to the third and thus, last step of the simple configuration.

...

Set-up the sync

In the next step, you’ll need to specify which Jira issues you’d like to sync into which list in Microsoft To Do. You can just use your main task list, or create a new one, by typing a name.Image Removed

Info

...

Switch to the advanced modeto use more specific filters for your issue sync.

...

Complete the task in To Do automatically?

In this step, you can choose what happens when the Jira issue is marked as resolved (e.g. status is set to “Done”). If you want, you can choose to check off the task from your To Do list in case this happens.Image Removed

...

Move Jira issue automatically?

This step is the opposite of the previous step. Here, you can specify if something should happen automatically if you check of the task in your To Do app. If you want, we can move the Jira issue to a specific status, e.g. Done. To do this, please choose a status you want to use.Image Removed

...

Start the sync!

Now you are all set and you can start the sync. After starting it, it will sync all issues to your To Do list, that currently match your filter. You will be able to preview which issues will be created as tasks, by clicking “Preview issues”:

...