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.
Configuration
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.
Set-up the 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
You already use To Do? Perfect, then go ahead.
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.
Choose a To Do list
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.
Switch to the advanced mode to 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.
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.
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”:
