python - 通过 REST API 查询 JIRA 以及查询中可能存在错误值

Question

我有一个基于 Cherrypy 构建的门户，用户可以访问该门户，其中有一些可以提交的表单，这些表单将通过 REST api 发送到 JIRA 以用于跟踪目的。提交后，我会从用户在表单上提供的信息和 JIRA 问题 ID 中获取信息，并将它们发送到 Oracle DB。

此外，我还扩展了门户的功能，以便能够通过列表页面查看用户提交的内容，然后选择一条记录来查看该提交的数据库中存储的内容。我的想法是使用 JIRA 的 REST API 来获取 JIRA 中问题的状态和受让人。将我的代码转换为提交到 API，然后使用必要的 JQL 语句进行查询非常简单，如下所示。

def jira_status_check(jira_id):
if jira_id != "No JIRA Issue":
    try:
        search_url = "https://myjirainstance.atlassian.net/rest/api/2/search/?jql=issue=" + jira_id + "&fields=status,assignee,resolution"
        print search_url
        username = 'some_user'
        password = 'some_password'
        request = urllib2.Request(search_url)
        base64string = base64.encodestring('%s:%s' % (username, password)).replace('\n', '')
        request.add_header("Authorization", "Basic %s" % base64string)
        request.add_header("Content-Type", "application/json")
        result = urllib2.urlopen(request).read()
        json_results = json.loads(result)
        print json_results
        jira_status = json_results["issues"][0]["fields"]["status"]["name"]
        if json_results["issues"][0]["fields"]["resolution"] is None:
            tmp = "tmp"
        if json_results["issues"][0]["fields"]["resolution"] is not None:
            jira_status = jira_status + " - " + json_results["issues"][0]["fields"]["resolution"]["name"]
        # assignee_name = "TEST"
        # assignee_NT = "TEST"
        if json_results["issues"][0]["fields"]["assignee"] is None:
            assignee_name = "Unassigned"
            assignee_NT = "Unassigned"
        if json_results["issues"][0]["fields"]["assignee"] is not None:
            assignee_name = json_results["issues"][0]["fields"]["assignee"]["displayName"]
            assignee_NT = json_results["issues"][0]["fields"]["assignee"]["name"]
        # if json_results["issues"][0]["fields"]["assignee"]["displayName"] is not None:
        #     assignee_name = json_results["issues"][0]["fields"]["assignee"]["displayName"]
        # if json_results["issues"][0]["fields"]["assignee"] is None:
        #     assignee_NT = "Unassigned"
        # if json_results["issues"][0]["fields"]["assignee"]["name"] is not None:
        #     assignee_NT = json_results["issues"][0]["fields"]["assignee"]["name"]
        print jira_status
        print assignee_name
        print assignee_NT
        output = [jira_status, assignee_name, assignee_NT]
    except:
        jira_status = "No JIRA Issue by that number or JIRA inaccessible"
        assignee_name = "No JIRA Issue by that number or JIRA inaccessible"
        assignee_NT = "No JIRA Issue by that number or JIRA inaccessible"
        output = [jira_status, assignee_name, assignee_NT]
else:
    jira_status = "No JIRA Issue"
    assignee_name = "No JIRA Issue"
    assignee_NT = "No JIRA Issue"
    output = [jira_status, assignee_name, assignee_NT]
return output

但是，它仅限于一次搜索一条记录，这在您仅查看一条记录时有效，但我希望将其扩展到我的列表页面，并使用一个 api 查询一次搜索多个记录，而不是大量的单一问题查询。我能够使用 jql 和其余 API 在这样的链接中搜索多个问题编号 https://myjirainstance.atlassian.net/rest/api/2/search/?jql=Issue%3DSPL-3284 %20OR%20Issue%3DSPL-3285&fields=状态、受让人、决议

但后来我在想，如果以某种方式保存了错误的问题 ID 并将其作为大规模查询的一部分进行查询，该怎么办。以前，当它是单记录查询时，它是通过我的 jira_status_check 函数中的 except 语句进行处理的。当我尝试使用像最后一个共享的链接查询其余 api 时，我得到了

 {"errorMessages":["An issue with key 'SPL-6666' does not exist for field 'Issue'."],"warningMessages":[]}

我尝试通过问题的高级搜索构建查询，但是当我执行 Issue=SPL-3284 OR Issue=SPL-3285 OR Issue=SPL-6666 之类的操作时，我得到的响应为字段“Issue”不存在 key “SPL-6666”的问题。

是否有正确的方法可以通过 JQL 搜索多个问题编号，并且对于不匹配问题编号的字段不返回任何值？

或者我是否坚持对 api 进行大量单一问题查询来覆盖我的基础？这不太理想，并且可能会导致我将 api 查询限制为查看单个记录而不是列表页面的可用性。

我最好将查询 JIRA 的函数移至可以在页面呈现后填充提交列表的 javascript/jquery 吗？

Answer 1

我最终联系了 Atlassian，提出了有关 JQL 的问题，然后得到了以下剩余 api 文档，并告知了要添加到我的 JQL 中以实现搜索的 validateQuery 参数。 https://docs.atlassian.com/jira/REST/6.1.7/

当我现在在带有附加参数的 REST API 链接上使用与此类似的查询时

jql=Issue%3DSPL-3284 或 Issue%3DSPL-3285&fields=status,受让人,resolution&validateQuery=true

我返回一个 JSON，其中包含有效问题的实际内容，然后返回一个单独的 warningMessages 对象，其中包含任何不良问题。下面是一个 JSON 示例，但显然 $CONTENT 将是查询的实际结果

{
  "expand": "schema,names",
  "startAt": 0,
  "maxResults": 50,
  "total": 2,
  "issues": [
    {
      $CONTENT
    },
    {
      $CONTENT
    }
  ],
  "warningMessages": [
    "An issue with key 'SPL-6666' does not exist for field 'Issue'."
  ]
}

希望其他人将来会发现这有帮助