backlog.createIssue
課題を追加します。
追加に成功した場合は、追加された課題が返ります。
メソッド名
backlog.createIssue
権限
「一般ユーザ」以上の権限が必要です。
パラメータ
structの要素に下記パラメータが指定できます。
| パラメータ名 | 型 | 内容 |
|---|---|---|
| projectId (必須) | int | 課題を追加するプロジェクトID |
| summary (必須) | string | 課題の件名 |
| description | string | 課題の詳細 |
| start_date | string | 開始日(YYYYMMDD) (プレミアムプラン以上で指定可) |
| due_date | string | 期限日(YYYYMMDD) |
| estimated_hours | double | 予定時間(hour) 0.00〜999.00で指定できます。 (プレミアムプラン以上で指定可) |
| actual_hours | double | 実績時間(hour) 0.00〜999.00で指定できます。 (プレミアムプラン以上で指定可) |
| issueTypeId または issueType | issueTypeId は int、 issueType は string |
種別ID または 種別名 (種別はgetIssueTypesで取得できます) 未指定の場合、指定プロジェクトの１番目の種別になります。 |
| componentId または component | componentId は int または intのarray、 component は string または stringのarray |
カテゴリID または カテゴリ名 (カテゴリはgetComponentsで取得できます) |
| versionId または version | versionId は int または intのarray、 version は string または stringのarray |
発生バージョンID または 発生バージョン名 (発生バージョンはgetVersionsで取得できます) |
| milestoneId または milestone | milestoneId は int または intのarray、 milestone は string または stringのarray |
マイルストーンID または マイルストーン名 (マイルストーンはgetVersionsで取得できます) |
| priorityId または priority | int または string |
優先度ID または 優先度名 2 : 高 3 : 中 4 : 低 未指定の場合は「中」になります。 |
| assignerId | int |
担当者ユーザID
(プロジェクト参加ユーザはgetUsersで取得できます) |
レスポンス
追加した課題structのarrayを返します。
課題structの各フィールドの意味は下記の通りです。
| フィールド | 説明 | 例 |
|---|---|---|
| id | 課題ID | 73 |
| key | 課題キー | BLGWEBSITE-213 |
| summary | 件名 | トップページのデザイン決定 |
| description | 詳細 | トップページのデザイン決定します |
| url | 課題のURL | https://demo.backlog.jp/BLGWEBSITE-213 |
| due_date | 期限日 | 20090821 |
| start_date | 開始日 | 20090801 |
| estimated_hours | 予定時間 | 3.5 |
| actual_hours | 実績時間 | 5.5 |
| issueType | 種別 | - |
| ├ id | 種別ID | 5 |
| └ name | 種別名 | タスク |
| priority | 優先度 | - |
| ├ id | 優先度ID | 3 |
| └ name | 優先度 | 中 |
| resolution | 完了理由 | - |
| ├ id | 完了理由ID | 0 |
| └ name | 完了理由 | 対応済み |
| status | 状態 | - |
| ├ id | 状態ID | 2 |
| └ name | 状態 | 処理中 |
| components | カテゴリ | - |
| ├ id | カテゴリID | 1967 |
| └ name | カテゴリ名 | プロモーション |
| versions | 発生バージョン | - |
| ├ id | 発生バージョンID | 732 |
| ├ name | 発生バージョン名 | デザイン案作成 |
| └ date | リリース予定日 | 20090910 |
| milestones | マイルストーン | - |
| ├ id | マイルストーンID | 733 |
| ├ name | マイルストーン名 | サイトオープン |
| └ date | リリース予定日 | 20091010 |
| created_user | 登録者 | - |
| ├ id | ユーザID | 2 |
| └ name | ハンドルネーム | やまもと |
| assigner | 担当者 | - |
| ├ id | ユーザID | 3 |
| └ name | ハンドルネーム | 山田 |
| created_on | 登録日時 | 20090731151859 |
| updated_on | 最終更新日時 | 20090812132418 |
リクエストXMLの例
<?xml version="1.0" encoding="utf-8"?>
<methodCall>
<methodName>backlog.createIssue</methodName>
<params>
<param>
<value>
<struct>
<member>
<name>priority</name>
<value>
<string>高</string>
</value>
</member>
<member>
<name>projectId</name>
<value>
<int>1</int>
</value>
</member>
<member>
<name>due_date</name>
<value>
<int>20081230</int>
</value>
</member>
<member>
<name>issueType</name>
<value>
<string>バグ</string>
</value>
</member>
<member>
<name>summary</name>
<value>
<string>BacklogAPIで課題を登録してみる(1225947152)</string>
</value>
</member>
<member>
<name>milestone</name>
<value>
<string>お披露目パーティ</string>
</value>
</member>
<member>
<name>description</name>
<value>
<string>XML-RPCで課題を登録してみるテストです。
いわゆるBacklogAPIです。</string>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodCall>レスポンスXMLの例
<?xml version="1.0" encoding="utf-8"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>priority</name>
<value>
<struct>
<member>
<name>name</name>
<value>
<string>高</string>
</value>
</member>
<member>
<name>id</name>
<value>
<i4>2</i4>
</value>
</member>
</struct>
</value>
</member>
<member>
<name>created_user</name>
<value>
<struct>
<member>
<name>name</name>
<value>
<string>demo</string>
</value>
</member>
<member>
<name>id</name>
<value>
<string>2</string>
</value>
</member>
</struct>
</value>
</member>
<member>
<name>milestones</name>
<value>
<array>
<data>
<value>
<struct>
<member>
<name>date</name>
<value>
<string>21121010</string>
</value>
</member>
<member>
<name>name</name>
<value>
<string>お披露目パーティ</string>
</value>
</member>
<member>
<name>id</name>
<value>
<i4>5</i4>
</value>
</member>
</struct>
</value>
</data>
</array>
</value>
</member>
<member>
<name>status</name>
<value>
<struct>
<member>
<name>name</name>
<value>
<string>未対応</string>
</value>
</member>
<member>
<name>id</name>
<value>
<i4>1</i4>
</value>
</member>
</struct>
</value>
</member>
<member>
<name>description</name>
<value>
<string>XML-RPCで課題を登録してみるテストです。
いわゆるBacklogAPIです。</string>
</value>
</member>
<member>
<name>key</name>
<value>
<string>DORA-313</string>
</value>
</member>
<member>
<name>updated_on</name>
<value>
<string>20081106135233</string>
</value>
</member>
<member>
<name>due_date</name>
<value>
<string>20081230000000</string>
</value>
</member>
<member>
<name>issueType</name>
<value>
<struct>
<member>
<name>name</name>
<value>
<string>バグ</string>
</value>
</member>
<member>
<name>id</name>
<value>
<i4>5</i4>
</value>
</member>
</struct>
</value>
</member>
<member>
<name>summary</name>
<value>
<string>BacklogAPIで課題を登録してみる(1225947152)</string>
</value>
</member>
<member>
<name>created_on</name>
<value>
<string>20081106135233</string>
</value>
</member>
<member>
<name>url</name>
<value>
<string>https://demo.backlog.jp/view/DORA-313</string>
</value>
</member>
<member>
<name>milestone</name>
<value>
<struct>
<member>
<name>date</name>
<value>
<string>21121010</string>
</value>
</member>
<member>
<name>name</name>
<value>
<string>お披露目パーティ</string>
</value>
</member>
<member>
<name>id</name>
<value>
<i4>5</i4>
</value>
</member>
</struct>
</value>
</member>
<member>
<name>id</name>
<value>
<i4>250291</i4>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>ＡＰＩメソッド
