Отображение результатов поиска в XML

С помощью «Навигатора  задач» пользователь может просматривать  результаты поиска в формате XML,  для их использования с макросами задач  JIRA. (Также подходит для использования в качестве RSS-ленты 0.9.2.  Примечание: для ленты RSS 2.0 см.  «Получение результатов поиска через RSS».)

Как описано ниже,вы можете выбрать, какие поля включить в выход XML.

Экспорт в XML

Чтобы отобразить результаты поиска в формате XML, необходимо выполнить следующие шаги:

  1. Выберите «Задачи» (Issues)> «Поиск задач» (Search for Issues).
  2. Уточните свой поиск, как описано в «Поиске задач», затем выберите меню «Экспорт» (Export).
  3. В раскрывающемся меню выберите XML.
  4. Результаты поиска будут отображаться в формате XML.                                                                                         Заметка:
  • Если вы хотите ограничить, какие поля включены в выход XML, используйте параметр поля, как описано ниже.
  • Чтобы выбрать, сколько задач включено в выход XML, измените значение параметра tempMax. Значение по умолчанию - 1000 задач (т. е. тempMax = 1000).
  1. Скопируйте URL- адрес, который в настоящее время отображается на вашем экране.
  2. Если вы используете макрос задач Confluence JIRA, вставьте URL- адрес в документ Confluence, как описано в документации Confluence.

Выбор полей для включения

Чтобы ограничить, какие поля задач возвращены в XML- экспорте, укажите параметр поля в своем URL- адресе. Например, чтобы включить в URL только «Ключ задачи» (Issue key) и «Резюме» (Summary), добавьте & field = key & field = summary.

 Заметка:

  • Если параметр поля не указан, выход XML будет содержать все поля задачи.
  • Если заданы один или несколько параметров поля, вывод XML будет содержать только «Ключ задачи» (Issue key) плюс выбранные вами поля.

Полный список доступных значений для параметра поля выглядит следующим образом:

Значение

Образец вывода XML

 заглавие

 

<title>[TEST-4] This is a test</title>

 

 

 ссылка

 

<link>https://extranet.atlassian.com:443/jira/browse/TEST-4</link>

 

 

 Проект (или pid)

 

<project id="10330" key="TST">Test</project>

 

 

 Описание

 

<description>This is a detailed description of the issue.<description>

 

 

 Окружающая среда

 

<environment>Sydney network<environment>
				

 

 

 ключ

 

<key id="22574">TEST-4</key>
				

 

 

 резюме

 

<summary>This is a test<summary>
				

 Тип (тип задачи)

 

<type id="3" iconUrl="https://extranet.atlassian.com:443/jira/images/icons/task.gif">Task</type>
				

 

 

 родитель

 

<parent id="22620">TEST-5</parent>
				

 

 

 приоритет

 

<priority id="4" iconUrl="https://extranet.atlassian.com:443/jira/images/icons/priority_minor.gif">
Minor
<priority>
				

 

 

 статус

 

<status id="5" iconUrl="https://extranet.atlassian.com:443/jira/images/icons/status_resolved.gif">
Resolved
</status>
				

 

 

 решение

 

<resolution id="1">Fixed</resolution>
				

 

 метки

<labels>
<label>focus</label>
</labels>

 представитель

 

<assignee username="jsmith">John Smith</assignee>

 

 

 репортер

 

<assignee username="jsmith">John Smith</assignee>
				

 

 безопасность

 

<security id="10021">Private</security>
				

 

 создано

 

<created>Mon, 1 Sep 2008 17:30:03 -0500 (CDT)>/created>
				

 

 обновлено

 

<updated>Mon, 1 Sep 2008 17:30:03 -0500 (CDT)>/updated>
				

 

 Разрешено (или дата разрешения)

 

<resolved>Mon, 1 Sep 2008 17:30:03 -0500 (CDT)>/resolved>

 

 

 в соответствии (или срок)

 

<due>Mon, 1 Sep 2008 17:30:03 -0500 (CDT)>/due>
				

 

 

 Версия (или версии)

 

<version>2.4.7</version>

 

 Исправления для (версия исправления)

 

<fixVersion>2.6</fixVersion>
				

 

 

 Компонента или компоненты

 

<component>Documentation</component>

 

 

 голоса

 

<votes>1</votes>
				

 

 

 Комментарий или комментарии

 

                                
<comments>
<comment id="39270" author="jsmith" created="Tue, 24 Feb 2009 16:45:02 -0600 (CST)">this looks familiar</comment>
<comment id="39273" author="jbrown" created="Tue, 24 Feb 2009 16:48:16 -0600 (CST)">to me too</comment>
</comments>
                                

 Вложения (или вложение)

<attachments>
<attachment id="30318" name="Issue Navigator - Atlassian JIRA-2.png" size="16161" author="yoz" created="Mon, 9 Feb 2009 13:32:58 -0600 (CST)"/>
<attachment id="30323" name="Windows XP (with Firefox 3.0).jpg" size="5802" author="vbharara" created="Tue, 10 Feb 2009 00:30:11 -0600 (CST)"/>
</attachments>			

 timeoriginalestimate

<timeoriginalestimate seconds="600">10 minutes</timeoriginalestimate> 

 

 

 Оцененное время

                      
<timeestimate seconds="300">5 minutes</timeestimate>
                                                

 Потраченное время

 

<timespent seconds="300">5 minutes</timespent>

 

 

 aggregatetimeoriginalestimate

 

				<aggregatetimeoriginalestimate seconds="36000">10 hours</aggregatetimeoriginalestimate>

 

 

 aggregatetimeoriginalestimate

 


<aggregatetimeremainingestimate seconds="18000">5 hours</aggregatetimeremainingestimate>

 

 aggregatetimespent

 

				<aggregatetimespent seconds="18000">5 hours</aggregatetimespent>

 

 Отслеживание времени


<timeoriginalestimate seconds="600">10 minutes</timeoriginalestimate>
<timeestimate seconds="300">5 minutes</timeestimate>
<timespent seconds="300">5 minutes</timespent>
<aggregatetimeoriginalestimate seconds="36000">10 hours</aggregatetimeoriginalestimate>
<aggregatetimeremainingestimate seconds="18000">5 hours</aggregatetimeremainingestimate>
<aggregatetimespent seconds="18000">5 hours</aggregatetimespent>
		

 Ссылки на задачи

 


<issuelinks>
<issuelinktype id="10020">
<name>Duplicate</name>
<inwardlinks description="is duplicated by">
<issuelink>
<issuekey id="22477">INTSYS-1009</issuekey>
</issuelink>
</inwardlinks>
</issuelinktype>
</issuelinks>
			

 Подзадачи (или подзадача)


<subtasks>
<subtask id="22623">TEST-8</subtask>
</subtasks>
				

 customfield_xxxxx


<customfields>
<customfield id="customfield_10112" key="com.atlassian.jira.plugin.system.customfieldtypes:select">
<customfieldname>Department</customfieldname>
<customfieldvalues>
<customfieldvalue>Adminstration</customfieldvalue>
</customfieldvalues>
</customfield>
</customfields>
			

 allcustom


<customfields>
<customfield id="customfield_10112" key="com.atlassian.jira.plugin.system.customfieldtypes:select">
<customfieldname>Department</customfieldname>
<customfieldvalues>
<customfieldvalue>Adminstration</customfieldvalue>
</customfieldvalues>
</customfield>
<customfield id="customfield_10111" key="com.atlassian.jira.plugin.system.customfieldtypes:select">
<customfieldname>Expenditure Type</customfieldname>
<customfieldvalues>
<customfieldvalue>Operating</customfieldvalue>
</customfieldvalues>
</customfield>
</customfields>
				

 

  Доступ к защищенным данным

При доступе к данным, полученным из JIRA, вы можете обнаружить, что для доступа к некоторым ресурсам требуется аутентификация пользователя (т. е. требуется авторизация). Для этого есть три варианта:

  1. Чтобы включить доступ к данным без входа в систему, администратор JIRA может указать разрешение «Обзор» для любого пользователя.
  2. Вы можете указать параметры os_username и os_password в URL-адресе задачи (например, http://jira.atlassian.com/browse/TST-1?os_username=tester&os_password=ts...). Проблема с этим методом заключается в том, что он передает ваше имя пользователя и пароль по проводке открытым текстом, что не может быть доступно для некоторых пользователей.
  3. Вы можете указать параметр задачи os_authType = basic (например, http://mycompany.com/anypage?os_authType=basic). Это заставит сервер выдавать задачу для учетных данных пользователя (т. е. приглашение для входа) через базовый протокол проверки подлинности HTTP. Если вы используете SSL, вам все равно необходимо указать параметр os_authType = basic, если вам требуется аутентификация пользователя.

 

По материалам Atlassian JIRA User's Guide: Displaying Search Results in XML