GoLand
 
2023.2
Shortcuts: Windows
Get GoLand
You are viewing the documentation for an earlier version of GoLand.
  1. Tutorials
  2. Configure a generic task server

Configure a generic task server

Last modified: 15 June 2023

Ensure that the Task Management plugin is installed and enabled.

This tutorial describes how to:

  • Connect to JIRA Cloud as a generic server.

  • Obtain the list of issues assigned to you.

  • For each issue, get its ID, title, description, date and time when the issue was created and updated.

Before you start configuring a connection to your tracker, note that GoLand:

  • Supports only services with REST API.

  • Supports either Basic HTTP authentication or sending preliminary requests to the server.

  • Supports GET and POST requests.

  • Does not support pagination in server responses.

Specify server URL and credentials

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

  2. Click the Add button and select Generic.

  3. On the General tab, specify the URL of your task tracker and connection credentials.

    In the Username field, type your email address.

    In the Password field, enter your Atlassian API token.

  4. Select the Use HTTP authentication checkbox at the bottom of the dialog.

Specifying server URL and credentials

Configure the server settings

  1. Switch to the Server Configuration tab.

    Note that the Login URL field will be disabled, as you are using HTTP authentication.

  2. In the Tasks List URL, enter the URL for obtaining issues from the server. You can use variables or enter the full URL:

    {serverUrl}/rest/api/2/search or https://serverurl.atlassian.net/rest/api/2/search

    The {serverUrl} is a variable that stands for the URL you have specified on the General tab.

  3. Add the ?jql={JQL_Query} expression to your task list URL: {serverUrl}/rest/api/2/search?jql={JQL_Query}.

    tip

    You can use code completion in the Login URL, Tasks List URL and Single Task URL fields.

    Configuring server settings

  4. Click Manage Template Variables at the bottom of the dialog to configure the JQL_Query variable.

  5. Click the Add button and in the new field, specify the variable name JQL_Query and add its value assignee = currentUser() AND resolution = unresolved.

    This will let you obtain unresolved issues assigned to you.

  6. Click OK.

    Specifying template variables

note

All variables specified in URL fields, except {serverUrl}, are encoded with application/x-www-form-urlencoded by default.

tip

For more information on how to do advanced searches, refer to Advanced searching - fields reference.

Configure response type and specify selectors

  1. In the Server Configuration dialog, select the JSON response type.

  2. Specify selectors in the table to get IDs and titles of issues and their description. You can also obtain the date and time when issues were created and updated:

    • tasks: $.issues

    • id: key

    • summary: fields.summary

    • description: fields.description

    • updated: fields.updated

    • created: fields.created

    tip

    For JIRA, you can check the server responses in real time. Replace placeholders with actual values in the link and open it in a browser: http://<serverURL>:<port>/rest/api/2/search

  3. Click Test to make sure all parameters are configured correctly.

    Configuring a response type and specifying selectors

Upload issues from the server

  1. Click the tasks combo and select Open Task. GoLand will load from the server all issues that match your configuration.

  2. Select the necessary issue from the list.

  3. Press Ctrl0Q to open issue description and make sure all required details are obtained.

See also

External Links