Redmine REST APIを操作するpython_redmineを試してみた
Redmine のGUIの登録が面倒なのでコマンドで登録、更新、時間の記録が出来るようにしたい、ってことで、Redmine REST APIをPythonで扱う方法をいろいろ見てみましたが、python_redmineが必要な操作を満たしていて使い勝手が良さそうなので試してみました。
目次
RedmineでREST APIを有効にする
管理者でRedmineにログインして[API]タグ-[RESTによるWebサービスを有効にする]にチェックします。
※バージョンによっては[認証]タグにあります。
API操作に使用するユーザの[個人設定]の右ペインでAPIアクセスキーをコピーして使います。
インストール
pipでインストール出来ます。
1 2 |
$ pip install python_redmine |
基本
「key=」にAPIアクセスキーを指定します。
1 2 3 4 |
from redmine import Redmine redmine = Redmine('http://mydomain.com', key='xxxxxxxxxxxxxxxxxxxxxxxxxxxx') |
チケット登録
手入力同様に必須でもデフォルト値のあるフィールドは省略可能です。
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は厳密に日付型で指定します。
チケット更新
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です。
よくあるケースとして、ステータス、期日を変更してみました。
作業時間の記録
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とかを検索できるコマンドも用意しないと、コマンドだけでは完結しないので、そのへんも作ろうと思います。
最後までお読みいただきましてありがとうございました!
【PR】 「AWS認定試験対策 AWS クラウドプラクティショナー」という本を書きました。
【PR】 「AWSではじめるLinux入門ガイド」という本を書きました。
【PR】 「ポケットスタディ AWS認定 デベロッパーアソシエイト」という本を書きました。
【PR】 「AWS認定資格試験テキスト&問題集 AWS認定ソリューションアーキテクト - プロフェッショナル」という本を書きました。

開発ベンダー5年、ユーザ企業システム部門通算9年、ITインストラクター5年目でプロトタイプビルダーもやりだしたSoftware Engineerです。
質問はコメントかSNSなどからお気軽にどうぞ。
出来る限りなるべく答えます。
このブログの内容/発言の一切は個人の見解であり、所属する組織とは関係ありません。
このブログは経験したことなどの共有を目的としており、手順や結果などを保証するものではありません。
ご参考にされる際は、読者様自身のご判断にてご対応をお願いいたします。
また、勉強会やイベントのレポートは自分が気になったことをメモしたり、聞いて思ったことを書いていますので、登壇者の意見や発表内容ではありません。
ad
ad
関連記事
-
-
CentOS 6.5にgit連携のTracを構築する
秋の夜長に自宅でTracサーバを構築してみる。 ひとまずRedmineはいったん …
-
-
PythonでHTMLエスケープされた全角ハイフンをアンエスケープする
PythonでHTMLエスケープとアンエスケープについて調べていると、 xml. …
-
-
CentOS 6でPythonからOracleに接続する
OracleのデータをPythonでさわりたくて、その実行環境がCentOS6の …
-
-
docomo Developer supportの 雑談対話APIから自然対話APIへ移行しました
LINEやSlackのbotで重宝していた、雑談対話APIが終了する、とのことで …
-
-
「streamlit勉強会」に参加しました
streamlitってなんだろう? と思いながら参加しまししました。 fin-p …
-
-
Python SQLAlchemy MySQLでテーブルを指定せずにFunctionを使う
難しく考えて悩んでいましたが、queryに書いてやればいいだけでした。 sess …
-
-
Pandoc PDF出力時に目次とヘッダをつける
目次をつける 環境などはPandoc関連記事をご確認ください。 Pandoc実行 …
-
-
Redmine 3.0.0に CRMプラグインをインストールする
Redmine CRMプラグインのFreeのLightバージョンを使ってみる事に …
-
-
Redmineの作業時間、予定工数をSQLで抽出
プラグインとかでやればいいのかもなのですが、可視化はダッシュボードツールとかBI …
-
-
「第14回RxTStudy(Redmine勉強会)」に行ってきました
土曜日の真っ昼間に半分以上が初参加者さんで80席が満席。 それだけRedmine …