JiraJira

Jira に接続するには、 ユーザー名 (ログインに使用する電子メールアドレス) と API トークン が必要です。You need a Username (the email address you use to login) and API Token to connect to Jira. トークンはパスワードのように動作します。The token behaves like a password.

Jira データソースJira data source

クエリQuery

単純なクエリの場合、フィルター処理を行わずに問題が返されます。For a simple query, one that returns issues with no filtering:

{}

特定のフィールドのみを返す:Return only specific fields:

{
  "fields": "summary,priority"
}

特定のフィールドだけを返し、優先順位によってフィルター処理する:Return only specific fields and filter by priority:

{
  "fields": "summary,priority",
  "jql": "priority=medium"
}

次の問題の数 priority=medium :Count number of issues with priority=medium:

{
  "queryType": "count",
  "jql": "priority=medium"
}

フィールドマッピングを使用して、結果のフィールドの名前を変更することもできます。これは、カスタムフィールドを操作する場合に便利です。You can also use the field mapping to rename a field for the result - this is useful when working with custom fields:

{
  "fields": "summary,priority,customfield_10672",
  "jql": "priority=medium",
  "fieldMapping": {
    "customfield_10672": "my_custom_field_name"
  }
}

JIRA によって返されるいくつかのフィールドは、複数のプロパティを持つ JSON オブジェクトです。Some fields returned by JIRA are JSON objects with multiple properties. フィールドマッピングを定義して、取得する特定のメンバープロパティを選択できます (この例では、' priority ' フィールドの ' id ' メンバー)。You can define a field mapping to pick a specific member property you want to return (in this example ‘id’ member of the ‘priority’ field):

{
  "fields": "summary,priority",
  "jql": "priority=medium",
  "fieldMapping": {
    "priority.id": "priority"
  }
}

さまざまなフィルターオプションを組み合わせるより複雑な例を次に示します。Here’s a more complex example combining the different filter options:

{
  "fields": "summary,priority,customfield_10672,resolutiondate,fixVersions,watches,labels",
  "jql": "project = MYPROJ AND resolution = unresolved ORDER BY priority DESC, key ASC",
  "maxResults": 30,
  "fieldMapping": {
    "customfield_10672": "my_custom_field_name",
    "priority.id": "priority",
    "fixVersions.name": "my_fix_version",
    "fixVersions.id": "my_fix_version_id"
  }
}

フィールドに値のリストが含まれている場合は、all が "," と連結されて返されます。If a field contains a list of values all are returned concatenated with “,”.