growing hard days.

Redmine REST APIを操作するpython_redmineを試してみた

2017/03/05

Redmine のGUIの登録が面倒なのでコマンドで登録、更新、時間の記録が出来るようにしたい、ってことで、Redmine REST APIをPythonで扱う方法をいろいろ見てみましたが、python_redmineが必要な操作を満たしていて使い勝手が良さそうなので試してみました。

RedmineでREST APIを有効にする

管理者でRedmineにログインして[API]タグ-[RESTによるWebサービスを有効にする]にチェックします。
※バージョンによっては[認証]タグにあります。

API操作に使用するユーザの[個人設定]の右ペインでAPIアクセスキーをコピーして使います。

インストール

pipでインストール出来ます。

$ pip install python_redmine

1 2	$ pip install python_redmine

基本

「key=」にAPIアクセスキーを指定します。

from redmine import Redmine

redmine = Redmine('http://mydomain.com', key='xxxxxxxxxxxxxxxxxxxxxxxxxxxx')

1

2

3

4

from redmine import Redmine

redmine = Redmine('http://mydomain.com', key='xxxxxxxxxxxxxxxxxxxxxxxxxxxx')

チケット登録

手入力同様に必須でもデフォルト値のあるフィールドは省略可能です。

issue = redmine.issue.new()
issue.project_id = 'test'
issue.subject = u'題名'
issue.tracker_id = 1
issue.description = u'チケットの説明フィールド\n改行'
issue.assigned_to_id = 1
issue.start_date = datetime.date(2017, 2, 1)
issue.due_date = datetime.date(2017, 2, 28)
issue.estimated_hours = 3
issue.save()

1

2

3

4

5

6

7

8

9

10

11

issue = redmine.issue.new()

issue.project_id = 'test'

issue.subject = u'題名'

issue.tracker_id = 1

issue.description = u'チケットの説明フィールド\n改行'

issue.assigned_to_id = 1

issue.start_date = datetime.date(2017, 2, 1)

issue.due_date = datetime.date(2017, 2, 28)

issue.estimated_hours = 3

issue.save()

project_idはプロジェクトの識別子を指定します。

tracker_id(トラッカー) はtrackerテーブルのレコードで確認します。

assigned_to_id(担当者)はusersテーブルのレコードで確認します。

estimated_hours(予定工数)は時間です。

start_date , due_dateは厳密に日付型で指定します。

チケット更新

issue = redmine.issue.get(12345)
issue.status_id = 2
issue.due_date = datetime.date(2017, 3, 31)
issue.save()

1

2

3

4

5

issue = redmine.issue.get(12345)

issue.status_id = 2

issue.due_date = datetime.date(2017, 3, 31)

issue.save()

該当のチケットIDはredmine.issue.getで取得します。
このチケットIDは画面で確認出来るIDです。

よくあるケースとして、ステータス、期日を変更してみました。

作業時間の記録

time_entry = redmine.time_entry.new()
time_entry.issue_id = 12345
time_entry.spent_on = datetime.date.today()
time_entry.hours = 3
time_entry.activity_id = 12
time_entry.comments = u'作業の内容'
time_entry.save()

1

2

3

4

5

6

7

8

time_entry = redmine.time_entry.new()

time_entry.issue_id = 12345

time_entry.spent_on = datetime.date.today()

time_entry.hours = 3

time_entry.activity_id = 12

time_entry.comments = u'作業の内容'

time_entry.save()

activity_id(作業種別)は事前に確認しておきます。

spent_on(作業日)は厳密に日付型なので、datetime.today()ではなくdate.today()を使います。

issue_idにチケットIDを指定します。

今後

Slackからの操作を予定しているので、各IDとかを検索できるコマンドも用意しないと、コマンドだけでは完結しないので、そのへんも作ろうと思います。

開発ベンダー5年、ユーザ企業システム部門通算9年、ITトレーナー1年目のSoftware Engineerです。
質問はコメントかSNSなどからお気軽にどうぞ。
出来る限りなるべく答えます。

このブログの内容/発言の一切は個人の見解であり、所属する組織とは関係ありません。

また、勉強会やイベントのレポートは自分が気になったことをメモしたり、聞いて思ったことを書いていますので、登壇者の意見や発表内容ではありません。

- ProjectManagement, Python, Redmine python, Redmine

Tweet

関連記事

: Redmine 3.0.0 にLocal Avatar プラグインをインストールしてユーザーがアバターを簡単に変更出来るようにする

Redmineのアバターは標準でGravater採用なのですが、エンドユーザーに …

: PyCharmでテキストを折り返す

超小ネタです。コーディングしているときは1行でそんなに長いコードを書かないので …

: Python SQLAlchemy MySQLでcase文を使う

PythohのORMライブラリSQLAlchemyでMySQLのテーブルSele …

: Redmine 3.0.0 のメールサーバーでGoogleApps SMTPサーバーを利用する

Redmineのメール通知サーバーとしてGoogleAppsを使用する方法です。 …

: Redmineの作業時間、予定工数をSQLで抽出

プラグインとかでやればいいのかもなのですが、可視化はダッシュボードツールとかBI …

: CentOS 6でPythonからOracleに接続する

OracleのデータをPythonでさわりたくて、その実行環境がCentOS6の …

: Amazon LinuxにRedmine をインストールする(手順整理版)

Amazon LinuxにRedmineをインストールしました手順を記載します。 …

: 個人のGoogleカレンダーの予定をPythonで取得する

Google Calendar Twilio ReminderのGoogleカレ …

: 「第14回RxTStudy(Redmine勉強会)」に行ってきました

土曜日の真っ昼間に半分以上が初参加者さんで80席が満席。それだけRedmine …

: Linux Mint 17 MATE 64bit にTensorFlowをインストールする

勉強会でTensorFlowを使用しますので、Linux Mint 17 MAT …

PREV: RedmineにEasy Gantt プラグインをインストールしようとしたらRubyのバージョンが古いという事にひっかかったのでRubyもアップグレードした
NEXT: 「JAWS-UG大阪第18回勉強会サーバーレス」の運営をしました