[Ruby] Backlog の課題を擬似的にインポートする

先人のコードを参考に目的はすぐに達成できたのですが、いろいろいじくりまわしながら ruby の勉強をしてました。
忘れないうちにひとまずまとめておきます。

• Backlog API に ruby スクリプトから接続する | deadwood

きっかけ

• 他のプロジェクトの課題を、別のプロジェクトにインポートできないか。
• 課題の検索画面でダウンロードできる .csv ファイルを登録できればよい。

どうやらインポート機能は無いよう。

API と CSV を確認

無料版をほぼ一人で使ったことしかないので、そういう用途を満たせるか確認してみる。

API

こんな手順で API を使えば、疑似インポートできるのではないか。

1. backlog.createIssue … 課題を作成
2. backlog.updateIssue … 完了理由とコメントを追加
3. backlog.addComment … さらにコメントがあれば追加
4. backlog.switchStatus … 状態（完了ステータス）を変更

CSV

API Method と CSV の項目を照らし合わせるとカバーできそう。

• 必須項目でないものを () で記載。
• 対応しない項目は取り消し線を書き加えた。

※ 以降、コメントがあれば行が増える。

補足

一工夫いりそうなところ。

• projectId が、管理画面からすぐに把握できないのでキーから取得する。
• due_date は、取り得る値 "" を API を通しては受け付けなかったので処理を分ける。
• 課題種別、バージョン、カテゴリー名、マイルストーンは、インポート先に存在しないものを事前に作成しておく。
  • backlog.addIssueType で作成。
  • backlog.addComponent で作成。複数選択される。
  • backlog.addVersion で作成。複数選択される。
  • Milestone は、backlog.addVersion であわせて作成される。
• assignerId は、存在しない担当者の作成まで含めると複雑になりすぎるのでやめる。

コード

というわけでまとめました。

• DriftwoodJP/Backlog-Issue-Importer

課題

他にいろいろやらなければならない・力尽きた・まとめないと光の速さで忘れてしまうので、今後やる（かもしれない）ことをとりあえず書いておく。

• テストがないので勉強してつける。
• config ファイルの持たせ方と読み込み方がよく分からないので他を参考に勉強する。
• assignerId が存在すれば、登録する機能があった方が便利かな。
• NKF.guess では、Shift_JIS の亜種、CP932 が判別できないのか。
• 件名が全角空白だけのデータがありえて、UTF-8内部変換で空になってエラー。
• バージョン、カテゴリー名、マイルストーンの複数選択時の登録に対応していない。