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.
...
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 | ||
|---|---|---|
| ||
 |
...
Configuration
| Info |
|---|
The feature needs to be configured directly in the 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:
This means you are all set to configure your first sync!
Choose a filter and a 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.
If you want to use a more specific filter, you can always switch to the advanced mode in the top right corner. For example, by default, we only sync issues that are not “Done”, so if you want to include these in your sync, you’ll need to go advanced.
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.
...
Set-up the sync
Where to find the feature
Open a Jira project → Go to sidebar → Choose “Microsoft To Do”
Choose between simple or advanced mode → Choose simple.
...
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
Log in with your Microsoft 365 account
...
Step 1: Choose issues & To Do list
Choose a To Do list to sync Jira issues in → Choose issue types → Choose To Do list (or create a new one)
| Info |
|---|
Switch to the advanced mode to use more specific filters for your issue sync. |
...
Step 2: Define dependency Jira issue <> To Do
Define the sync and dependencies
If a Jira issue is done, is the task in To Do completed, as well?
...
Step 3: Define dependency To Do <> Jira issue
Define the sync and dependencies
If a task in To Do is completed, what should happen with the Jira issue status?
...
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”
...
.
...