YouTrack Server 2023.3 Help

Task Management

JetBrains IDEs support native integration with YouTrack with the Task Management plugin. This plugin is installed and enabled by default in IntelliJ IDEA, PhpStorm, PyCharm, RubyMine, WebStorm, AppCode, CLion, Rider, and MPS.

You can extend the functionality of this plugin and unlock additional features with the YouTrack Integration Plugin. If you already use the YouTrack Integration Plugin, the features that are described on this page are already enabled in your IDE.

The Task Management plugin lets you open a YouTrack issue as a task in your IDE. This sets the YouTrack issue as the current work context. Changes to the code base are added to a change list that is associated with the issue.

Configure the Task Management Plugin

Perform this setup directly in your IDE. You do not need to configure anything in YouTrack.

To configure the Task Management plugin:

  1. Open a project in your IDE.

  2. To configure your IDE, open the Preferences dialog for macOS or Settings dialog for Windows and Linux.

  3. Select the Plugins menu. Verify that the Task Management plugin is enabled.

    Embedded IDE plugin for task management.

    The plugin is installed and enabled by default. If not, select the checkbox and enable the plugin.

  4. Navigate to the Tools > Tasks > Servers settings.

  5. Click the Add server button and select YouTrack.

    Option to add a server for task management activity.
  6. Configure the connection to your YouTrack server:

    General configuration options for connection to a YouTrack server.

    Setting

    Description

    Server URL

    Enter the URL of your YouTrack server.

    Username

    Enter the username of your YouTrack user account.

    Token

    Paste the value for a personal token or application password that has been generated for your YouTrack account. This field also accepts the password that you use to log in to YouTrack, but personal tokens are more secure.

    To learn how to generate a personal token for your YouTrack account, see Manage Permanent Tokens.

    Search

    Enter a search query that returns the issues that you want to set as tasks in your IDE.

  7. Click the Test button to test the connection to the server.

  8. Select the Commit Message tab.

  9. Enter placeholders for issue properties to set the default text for your commit messages.

    Options for adding a default commit message for YouTrack issues.
  10. Click the OK button.

    • Your IDE is configured to connect to your YouTrack server.

Set the Work Context

When you configure the Task Management plugin, you can set the working context to a specific issue in YouTrack. All the changes that you make in the code are associated with the issue that is selected as the current task.

To define the work context:

  1. In the task management tool window, select the Open Task option.

    Option to start a new task in the IDE.
  2. Select an issue from the list. Enter part of the issue ID or summary to filter the list.

  3. Set the parameters of the new task.

    Parameters for the new open task.

    Note that the parameters in the VCS operations section (and the ability to track a set of changes in a changelist) are only available when your project is managed under version control.

  4. Click the OK button.

    • The new task is set as your work context.

    • A new change list with the issue ID and summary is created automatically.

    • While you work within the context of this task, the changes in your project are added to this changelist.

      Task change list created
Last modified: 22 March 2024