Documentation for JIRA 5.1.x. Documentation for other versions of JIRA is available too.

The JIRA Issue Navigator enables you to display your search results in XML format, suitable for use with the Confluence JIRA Issues Macro, for example. (Also suitable for use as an RSS 0.9.2 feed. Note: for an RSS 2.0 feed, please see 'Receiving Search Results via RSS'.)

You can choose which fields to include in the XML output, as described below.

Exporting to XML

To display your search results in XML format,

  1. On the top navigation bar, click the 'Issues' tab.
  2. Refine your search, as described in 'Searching for Issues', until the required results are displayed in the Issue Navigator.
  3. Click the 'Views' menu, and select 'XML'.
  4. Your search results will be displayed in XML format. Note:
    • If you wish to restrict which fields are included in the XML output, use the * field * parameter as described below.
    • To choose how many issues are included in the XML output, change the value of the tempMax parameter. The default is 1,000 issues (i.e. tempMax=1000).
  5. Copy the URL that is currently displayed on your screen.
  6. If you are using the Confluence JIRA Issues Macro, paste the URL into your Confluence document as described in the Confluence documentation.

On this page:

Choosing which fields to include

To restrict which issue fields are returned in the XML export, specify the field parameter in your URL. For example, to include only the Issue key and Summary, add &field=key&field=summary to the URL.

注意:

  • If the field parameter is not specified, the XML output will include all the issue fields.
  • If one or more field parameters are specified, the XML output will contain only the Issue key plus your chosen field(s).

The complete list of available values for the field parameter is as follows:

値

XML 出力例

注意

title 

<title>[TEST-4] これはテストです</title>

 

link 

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

これは課題への "パーマリンク" です。課題間のリンクについては、後述の「issuelinks」をご参照ください。

project (またはpid) 

<project id="10330" key="TST">テスト</project>

 

description 

<description>これは課題の詳細な説明です。<description>

 

environment 

<environment>シドニー ネットワーク<environment>

 

key 

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

 

summary 

<summary>これはテストです<summary>

 

type (またはissuetype) 

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

 

parent 

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

Only relevant if the issue is a sub-task.

priority 

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

 

status 

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

 

resolution 

<resolution id="1">修正済み</resolution>

 

labels 

<labels>
<label>フォーカス</label>
<labels>

 

assignee 

<assignee username="jsmith">ジョン スミス</assignee>

 

reporter 

<assignee username="jsmith">ジョン スミス</assignee>

 

security 

<security id="10021">プライベート</security>

Only relevant if a security level has been applied to the issue.

created 

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

 

updated 

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

 

resolved (またはresolutiondate) 

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

 

due (またはduedate) 

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

 

version (またはversions) 

<version>2.4.7</version>

 

fixfor (またはfixVersions) 

<fixVersion>2.6</fixVersion>

 

component (またはcomponents) 

<component>ドキュメンテーション</component>

 

votes 

<votes>1</votes>

 

comments (またはcomment) 

<comments>
    <comment id="39270" author="jsmith" created="Tue, 24 Feb 2009 16:45:02 -0600 (CST)">これは私も</comment>
    <comment id="39273" author="jbrown" created="Tue, 24 Feb 2009 16:48:16 -0600 (CST)">よく知っています</comment>
</comments>

 

attachments (またはattachment) 

<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>

Only available if your administrator has enabled attachments.

timeoriginalestimate 

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

Only available if your administrator has enabled 'time-tracking'.

timeestimate 

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

Only available if your administrator has enabled 'time-tracking'.

timespent 

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

Only available if your administrator has enabled 'time-tracking'.

aggregatetimeoriginalestimate 

<aggregatetimeoriginalestimate seconds="36000">10 時間</aggregatetimeoriginalestimate>

(ie. aggregate time for the issue plus all of its sub-tasks.) Only available if your administrator has enabled 'time-tracking'.

aggregatetimeestimate 

<aggregatetimeremainingestimate seconds="18000">5 時間</aggregatetimeremainingestimate>

(ie. aggregate time for the issue plus all of its sub-tasks.) Only available if your administrator has enabled 'time-tracking'.

aggregatetimespent 

<aggregatetimespent seconds="18000">5 時間</aggregatetimespent>

(ie. aggregate time for the issue plus all of its sub-tasks.) Only available if your administrator has enabled 'time-tracking'.

timetracking 

<timeoriginalestimate seconds="600">10 分</timeoriginalestimate>
<timeestimate seconds="300">5 分</timeestimate>
<timespent seconds="300">5 分</timespent>
<aggregatetimeoriginalestimate seconds="36000">10 時間</aggregatetimeoriginalestimate>
<aggregatetimeremainingestimate seconds="18000">5 時間</aggregatetimeremainingestimate>
<aggregatetimespent seconds="18000">5 時間</aggregatetimespent>

This is a convenient shorthand way of specifying all of the above six time-tracking fields. (Only available if your administrator has enabled 'time-tracking'. )

issuelinks 

<issuelinks>
    <issuelinktype id="10020">
        <name>重複</name>
        <inwardlinks description="が以下と重複しています：">
            <issuelink>
                <issuekey id="22477">INTSYS-1009</issuekey>
            </issuelink>
        </inwardlinks>
    </issuelinktype>
</issuelinks>

 

subtasks (またはsubtask) 

<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>

(where "xxxxx" is the id of a given custom field. E.g. this output is the result of specifying &field=customfield_10112 )

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 から生成したデータへアクセスする場合、一部のリソースへのアクセスにはユーザー認証が必要な場合があります (例：ログインが必要)。これには次の 3 つのオプションがあります。
  1. ログインせずにデータへアクセスできるようにするには、JIRA 管理者が「閲覧」権限を全員にする必要があります。
  2. You can provide the parameters os_username and os_password in the request URL (e.g. http://jira.atlassian.com/browse/TST-1?os_username=tester&os_password=tstpassword). The problem with this method is that it transmits your username and password across the wire in clear text, which may not be an option for some users.
  3. You can provide the request parameter os_authType=basic (e.g. http://mycompany.com/anypage?os_authType=basic). This will force the server to issue a challenge for user credentials (i.e. a login prompt) via the basic http authentication protocol. If you are running over SSL, you still need to specify the os_authType=basic parameter if you require the user to authenticate.



See our Getting Help page for details.



Raise an issue for our developers.



See answers from the community.



Tweet, blog and update our documentation.

Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.