はじめに

This page provides basic documentation on JIRA's XML-RPC capabilities. For latest methods available through the XML-RPC please refer to the latest javadoc for XmlRpcService.

JIRA supports both SOAP and XML-RPC. We recommend the SOAP interface as it is more complete.

メモ:

(warning) You may also wish to see the Creating a XML-RPC Client or Creating a SOAP Client if you're interested in creating a JIRA remote client.

Enable the RPC plugin

Remote Methods

The most recent and up-to-date source of information of available exposed methods is the javadoc for the RPC plugin, specifically those on the XmlRpcService.

The javadoc will often refer to "hashtables with fields from RemoteObject". To the hashtable will contain keys that map to the fields available through reflection of the particular RemoteObject. For example, the object RemoteVersion, has the methods getReleaseDate(), getSequence(), isArchived() and isReleased(). This will be converted into a Hashtable with keys releaseDate, sequence, archived and released.

Data Objects

Most returned structs have a summary and a detailed form:

Unless otherwise specified, all returned structs are in detailed form.

プロジェクト

キー

タイプ

ID

文字列

the id of the project

鍵 (キー)

文字列

the project key

name

文字列

the name of the project

URL

文字列

the url to view this project online

projectUrl

文字列

the url of this project in your organisation (ie not a JIRA URL)

lead

文字列

the username of the project lead

description

文字列

a description of this project

コンポーネント

キー

タイプ

ID

文字列

the id of the component

name

文字列

the name of the component

バージョン

キー

タイプ

ID

文字列

the id of the version

name

文字列

the name of the version

released

ブーリアン

whether or not this version is released

archived

ブーリアン

whether or not this version is archived

IssueType / Status / Resolution

キー

タイプ

ID

文字列

the id of this constant

name

文字列

the name of the constant

description

文字列

the description of this constant

icon

文字列

the URL to retrieve the icon of this constant

Priority

キー

タイプ

ID

文字列

the id of this constant

name

文字列

the name of the constant

description

文字列

the description of this constant

icon

文字列

the URL to retrieve the icon of this constant

文字列

the colour of this constant

フィルター

キー

タイプ

ID

文字列

the id of this filter

name

文字列

the name of the filter

description

文字列

the description of this filter

author

文字列

the username of this filter's owner

プロジェクト

文字列

the id of the project this search relates to (null if the search is across projects)

XML

文字列

a complete XML representation of this search request - I don't recommend you use this for now, it's complex (smile)

ユーザー

キー

タイプ

name

文字列

the username of this user

氏名

文字列

the full name of this user

email

文字列

the email address of this user