backlog.switchStatus
課題の状態を変更します。
状態の変更に成功した場合は、更新された課題が返ります。
メソッド名
backlog.switchStatus
権限
「一般ユーザ」以上の権限が必要です。
パラメータ
structの要素に下記パラメータが指定できます。
key (課題キー)は、課題を指定するために必須です。
| パラメータ名 | 型 | 内容 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| key (必須) | string | 課題キー (例：BLG-10) | ||||||||||
| statusId (必須) | int |
変更したい状態ID 現在の状態によって指定できる状態IDが異なります。
|
||||||||||
| assignerId | int |
担当者ユーザID
(プロジェクト参加ユーザはgetUsersで取得できます) |
||||||||||
| resolutionId | int |
完了理由ID 0 : 対応済み 1 : 対応しない 2 : 無効 3 : 重複 4 : 再現しない |
||||||||||
| comment | string | コメント |
レスポンス
更新した課題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.switchStatus</methodName>
<params>
<param>
<value>
<struct>
<member>
<name>statusId</name>
<value>
<int>2</int>
</value>
</member>
<member>
<name>comment</name>
<value>
<string>テストさんが対応しています</string>
</value>
</member>
<member>
<name>assignerId</name>
<value>
<int>2</int>
</value>
</member>
<member>
<name>resolutionId</name>
<value>
<int>0</int>
</value>
</member>
<member>
<name>key</name>
<value>
<string>DORA-310</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>status</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>key</name>
<value>
<string>DORA-310</string>
</value>
</member>
<member>
<name>updated_on</name>
<value>
<string>20081106135235</string>
</value>
</member>
<member>
<name>summary</name>
<value>
<string>BacklogAPIで課題を登録してみる(1225945534)</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>created_on</name>
<value>
<string>20081106132534</string>
</value>
</member>
<member>
<name>url</name>
<value>
<string>https://demo.backlog.jp/view/DORA-310</string>
</value>
</member>
<member>
<name>id</name>
<value>
<i4>250274</i4>
</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>assigner</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>description</name>
<value>
<string>XML-RPCで課題を登録してみるテストです。
いわゆるBacklogAPIです。
詳細を追記します。</string>
</value>
</member>
<member>
<name>due_date</name>
<value>
<string>20081230000000</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>resolution</name>
<value>
<struct>
<member>
<name>name</name>
<value>
<string>対応済み</string>
</value>
</member>
<member>
<name>id</name>
<value>
<i4>0</i4>
</value>
</member>
</struct>
</value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>ＡＰＩメソッド
