JIRA
设置
您需要一个 用户名 (您用于登录的电子邮件地址) 和一个 API 令牌 来连接到 Jira。该令牌的行为类似于密码。
在 Redash V8 之前,JIRA 设置屏幕会要求输入密码。您仍然需要一个 API 令牌才能成功连接。请使用您的 API 令牌代替密码。
查询
对于一个简单的查询,即返回没有过滤的问题
{}
仅返回特定字段
{
"fields": "summary,priority"
}
仅返回特定字段并按优先级过滤
{
"fields": "summary,priority",
"jql": "priority=medium"
}
计算 priority=medium
的问题数量
{
"queryType": "count",
"jql": "priority=medium"
}
您还可以使用字段映射来重命名结果的字段 - 这在处理自定义字段时非常有用
{
"fields": "summary,priority,customfield_10672",
"jql": "priority=medium",
"fieldMapping": {
"customfield_10672": "my_custom_field_name"
}
}
JIRA 返回的某些字段是具有多个属性的 JSON 对象。您可以定义字段映射来选择要返回的特定成员属性 (在本例中为 ‘priority’ 字段的 ‘id’ 成员)
{
"fields": "summary,priority",
"jql": "priority=medium",
"fieldMapping": {
"priority.id": "priority"
}
}
这是一个更复杂的示例,结合了不同的过滤选项
{
"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"
}
}
如果字段包含一个值列表,则所有值都将使用“,”连接返回。