Manage tasks

1. In the Settings dialog CtrlAlt0S, select Tools | Tasks | Servers.

2. Click and select the necessary issue tracker from the list.

3. Enter connection details. Note that settings differ depending on your issue tracker.

   Normally, you have to specify the server URL and connection credentials: Username and Password.

   In some cases, you need to enter an API token instead of your password.

   For example, if you're connecting your IDE to YouTrack, the Password field is replaced with Token. Learn more from Manage Permanent Tokens.

   For Jira, enable the Use personal access token option to use a token instead of your user name and password.

4. Select the Share URL option to allow access to the server for other members of your team. When this option is enabled, a server URL and its type are saved to the .idea/misc.xml file, which can be shared between development team members through version control.

5. Click Proxy settings… if you want to access the server using a proxy server. You can find more information on proxy settings in the HTTP Proxy section.

   

6. On the Commit Message tab, you can enable adding a commit message for a changelist and configure a message template.

7. On the Server Configuration tab, configure advanced parameters for connecting to your issue tracker.

   tip

   Code completion is available in the fields on this tab.

1. In the Settings dialog CtrlAlt0S, select Tools | Tasks.

2. Configure the necessary options:

   • Changelist name format: when you open or create a new task, JetBrains Rider prompts you to create a new changelist associated with this task. In this field, you can specify a template that will be used for generating names for new changelists.

     Click to select placeholders from the list.

   • Feature branch name format: when you create or open a new task, JetBrains Rider prompts you to create a new feature branch. In this field, you can configure the template for generating names of new feature branches.

     Click to select placeholders from the list.

     Use the Lowercased and Replace spaces with options to configure prompted feature branch names.

     These settings are useful if your IDE is integrated with an issue tracker. For example, the DSGN-0001 Add new icon task name is going to be converted to the dsgn-0001add-new-icon feature branch name.

     tip

     You can always modify a feature branch name before creating it if the generated name doesn't work for you.

   • Task history length: the number of tasks that JetBrains Rider stores.

   • Save context on commit: every time you commit changes, JetBrains Rider creates a new closed local task that keeps files, bookmarks, and breakpoints that you have worked with. This way, you can quickly restore all tabs associated with the task any time in the future.

   • Enable issue cache: optimize synchronization between JetBrains Rider and your issue tracker. Synchronization is especially recommended if you work with "slow" issue tracking systems.

     JetBrains Rider caches the list of issues loaded from the tracker and updates them repeatedly. You can specify how many issues should be cached and how often JetBrains Rider should update information about them.

     

Tracker tasks are loaded to your JetBrains Rider once you connect it to your issue tracker.

1. In the main menu, go to Tools | Tasks & Contexts | Open Task , or click the task combo on the toolbar.

2. Select the necessary task from the list.

3. In the Open Task dialog, you can update the issue state.

   note

   The Update issue state option is available for YouTrack, JIRA, GitHub, Trello, Pivotal, and Bugzilla.

   If you want to close all tabs that are currently opened in the editor, select the Clear current context checkbox.

4. In the VCS operations section, you can create a new changelist, select an existing branch to which you want to contribute, or create a new one.

   You can also shelve the current changes to return to them later.

   

In JetBrains Rider, you can create local tasks that do not originate from your issue tracker.

1. In the main menu, go to Tools | Tasks & Contexts | Open Task. You can also use the task combo or press .

2. In the Enter task name dialog, select Create New Task.

3. Enter a name for the new task.

   If you want to close all tabs that are currently opened in the editor, select the Clear current context checkbox.

4. In the VCS operations section, you can create a new changelist, select an existing branch to which you want to contribute, or create a new branch.

   You can also shelve the current changes to return to them later.

When you are choosing a task to switch to, the list of tasks shows only task IDs. This information is not always enough because it reflects neither the steps that lead to the problem nor the related discussion.

1. In the main menu, go to Tools | Tasks & Contexts | Open Task.

2. Open the necessary task and press Ctrl0K,0I to open the task description in JetBrains Rider, or AltShift0B to view the description in a browser.

Alternatively, go to Tools | Tasks & Contexts and click Show 'task ID' Description or Open 'task ID' in Browser.

A closed local task is a task not associated with a changelist if the entire project or the affected directory is under a version control.

A closed tracker task is a task that has the closed status in your issue tracker.

1. Click the task combo and then click Open Task.

2. Select the Include closed tasks checkbox, or press .

• In the main menu, go to Tools | Tasks & Contexts and click Close Active Task.

This will close the current context in the JetBrains Rider. Select the necessary checkboxes to commit changes and, optionally, merge the branch that was created. For tracker tasks, you can also change their state. The new state will be propagated to your issue tracker.

If you do not need a task to appear in JetBrains Rider, you can remove it from the list of tasks.

1. Click the task combo on the main toolbar.

2. Select one or more tasks you want to delete.

   Use Shift (for adjacent items) or Ctrl (for non-adjacent items) keys for multiple selection.

3. Click the right-arrow button and select Remove.

When you are deleting tracker tasks, you remove them from the IDE. They will remain in your issue tracker. Local tasks in this case will be completely removed since they are not connected to your issue tracker.

1. Press CtrlAlt0S to open settings and then select Tools | Tasks | Time Tracking.

2. Select the Enable Time Tracking checkbox.

3. (Optionally) Change the Suspend delay value.

   Here you can specify how long you have to stay inactive before the task will be considered suspended.

• Click for automatic time logging.

  For manual time tracking, click . To stop manual time tracking, click .

tip

To reopen the Time Tracking tool window, select View | Tool Windows | Time Tracking.

1. Click Post work item to bugtracker in the Time Tracking tool window.

2. Specify the time interval you want to log and add a comment if necessary. Click OK.