Как получить все спринты в проекте с помощью JIRA REST API
есть ли что-нибудь вроде "http://www.example.com/jira/rest/agile/1.0/sprint?project=XYZ", чтобы получить все спринты в проекте.
Jira platform api может извлекать информацию о проектах, а JIRA software API может извлекать спринты для данной платы. Но мне нужны спринты для любого данного проекта (комбинация) или по крайней мере доски для данного проекта, чтобы я мог получить спринты в этих досках позже
3 ответов
вы можете сделать это, но с двух ресурсов:
- сначала вы можете получить все доски scrum проекта с помощью этого:
https://docs.atlassian.com/jira-software/REST/cloud/#agile/1.0/board-getAllBoards
используйте параметры запроса projectKeyOrId и тип фильтровать их.
повторите все элементы и используйте url-адрес ниже с идентификатором каждого доска, чтобы получить свои спринты:
https://docs.atlassian.com/jira-software/REST/cloud/#agile/1.0/board/{boardId}/sprint-getAllSprints
возвращает ли это какие-либо результаты для вас?
http://jira-domain.com/rest/greenhopper/latest/rapidviews/list
Если это так, найдите идентификатор представления, содержащего этот проект, а затем попробуйте этот url:
http://jira-domain.com/rest/greenhopper/latest/sprintquery/{view-id}?includeHistoricSprints=true&includeFutureSprints=true
давайте сделаем некоторые предположения перед написанием кода:
- имя доски такое же как имя проекта
- там будет только одна доска с именем
- у нас есть модель Sprint
Я использую клиент Джерси здесь, чтобы получить данные от JIRA.
private Client jerseyClient = Client.create();
jerseyClient.addFilter(new HTTPBasicAuthFilter("username", "password"));
private Gson gson = new Gson();
вспомогательные методы
/**
* This method will a GET request to the URL supplied
* @param url to request
* @return String response from the GET request
*/
public String makeGetRequest(String url){
ClientResponse response = jerseyClient.resource(url).accept("application/json").get(ClientResponse.class);
return response.getEntity(String.class);
}
/**
* This method helps in extracting an array from a JSON string
* @param response from which Array need to be extracted
* @param arrayName
* @return JsonArray extracted Array
*/
public JsonArray extractArrayFromResponse(String response, String arrayName){
JsonObject jsonObject = gson.fromJson(response, JsonObject.class);
return jsonObject.get(arrayName).getAsJsonArray();
}
код для получения спринты
/**
* This method will retrieve list of sprints in a given project
* @param project for which we are requesting sprints
* @return List of sprints
*/
public List<Sprint> getSprints(String project) {
List<Sprint> sprintList = new ArrayList<>();
try {
//get board URL for the given
String boardUrl = "https://jira.company.com/rest/agile/1.0/board?name=" + URLEncoder.encode(project, "UTF-8"); //assumption 1
String boardResponse = makeGetRequest(boardUrl);
JsonArray boards = extractArrayFromResponse(boardResponse, "values");
if(boards.size() > 0){
JsonObject board = boards.get(0).getAsJsonObject(); //assumption 2
//get all sprints for above obtained board
String sprintUrl = jsonHandler.extractString(board, "self")+"/sprint";
String sprintsResponse = makeGetRequest(sprintUrl);
JsonArray sprints = extractArrayFromResponse(sprintsResponse, "values");
//loop through all sprints
for (int i = 0; i < sprints.size(); i++) {
JsonElement sprint = sprints.get(i);
JsonObject sprintObj = sprint.getAsJsonObject();
String sprintName = sprintObj.get("name").getAsString();
Sprint sprint = new Sprint(sprintName);
sprintList.add(sprint);
}//end of for loop
}
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
return sprintList;
}