「google/zx」と「Backlog API」を組み合わせたJavaScriptのプログラムからのBacklog操作 / JBUG広島#9 × Agile Japan HIROSHIMA

「google/zx」と「Backlog API」を組み合わせた JavaScriptのプログラムからのBacklog操作 2022年1月22日 (土) JBUG広島#9 × Agile Japan HIROSHIMA
@オンライン豊田陽介（） @youtoy

自己紹介ビジュアルプログラミングや IoT関連、その他にも豊田陽介（）普段は、某通信会社勤務（＠埼玉）　　　　　　　　　 ※地元は愛媛 @youtoy
・IT系イベント主催、登壇や運営なども・子ども向けの活動いろいろ（IT系以外も）・ Microsoft MVP（2021/10 から）プライベートでの活動・ガジェット好き・アドベントカレンダーで記事を多数アップ　（全26記事を19のカレンダーに投稿）その他自宅にたくさん ↓直近のイベント　が2/24に

今日の本題へ

この発表のキーワード ▪ Backlog API ▪ google/zx

キーワードの話に入る前に背景を補足 Backlogについて、こんな時にどう対応してますか？・定期的に、わりとまとまった数の課題を登録・頻度は多くないけれど、毎年数回、大量に　似たような課題を登録

手作業やってました... ちょこちょこ対応すればなんとかできてもいた（大変だけど）

いつか（半）自動化したいなと思いつつ🥺

そして2021年のアドベントカレンダーこの機会に📝

課題を一括で登録するという話については...

課題の一括登録を行う方法の検索結果から 🔍 調べてよく　出てくる話は Googleスプレッドシートを使う方法

こんなパターンが　　　　　　　あるかもしれない... ・規定的に自由に外部クラウドが　使えない（特定のものが指定されてる等も）・外部クラウドに社外秘に関わる　情報を置くのが厳しい

そこで自前で（APIで）

APIを使う：アカウントの個人設定画面で API利用めのキーを生成する画面

特定のものを試すだけならブラウザ上でも GETメソッドのもの

試しつつ理解を深めたいそのために手軽に試せるツール・環境を使っていろいろ試していく

課題追加はPOSTメソッドのためcurlでメソッド： POST Node.js で作っていく前に、まずは簡単なテスト Postman や VSCode＋REST Client等を使うのも OK
パラメータはたくさんだけど必須は4つ

curlで実行するコマンドの内容必須パラメータ 4つのみで課題追加を試す • projectId (必須)【数値】：課題を登録するプロジェクトのID • summary (必須)【文字列】：
課題の件名 • issueTypeId (必須)【数値】：課題の種別のID • priorityId (必須)【数値】：課題の優先度のID

まずは最小限で動かす早い段階で実際に動くのが体験できると、個人的に楽しい（その後さらに試していくモチベーションアップ・維持）

キーワード2つ目： zx Googleさん提供の Node.js用のパッケージ •google/zx: A tool for writing
better scripts 　https://github.com/google/zx

なぜ zx を使う？気になっていて、いつか試したいと思っていたものだったから（今回の話は別の方法でも可）

アドベントカレンダーに登録した後の流れネタは作業効率化関連で考えたい「API でまとめて課題を追加する話」は、すぐに決まったが実行方法は？ RPAツール・自動テストツールなどでもできたりするけど... せっかくだから新しいものを試そう！ zx が気になってたけど試せてなかった

Node.jsのプログラム（わりとコンパクト） 3件の課題をまとめて登録する処理（対象データは必須項目のみに絞っているもの）

無事Backlogに課題が3件追加された！配列で持たせた課題の件名（仮）が Backlog上に

詳細はアドベントカレンダーの記事にて •Googleさんの zx で Backlog API を扱う　（JavaScript で課題を追加する）
　 https://qiita.com/youtoy/items/36ea84e09332d4e6815a

対応中の内容配列で持たせたデータをExcel・CSVから読み込んだものにしたり、必須項目以外も登録したり ⇒ 課題に追加する内容は、他の方（技術系では　ない方含め）と Excelベースで共有できると　いろいろ捗る！

zx に関して今回はあまり zx 特有の機能を活用できた感じではないが、個人的には知見が蓄積された ⇒ 今後も試して Qiita などで記事化できればと

まとめ APIを用いた課題追加が実現できた！ • Node.js（JavaScript）のプログラムで処理 • テキストのリストをもとに、まとめて Backlog に登録できた ⇒ API活用による効率化は進められそうになった！
今後やりたいこと • zx 特有の機能を活用していく • API での課題追加時に、各課題にいろいろ情報を追加できるようにしたい

終わり！

「google/zx」と「Backlog API」を組み合わせたJavaScriptのプログラ...

「google/zx」と「Backlog API」を組み合わせたJavaScriptのプログラムからのBacklog操作 / JBUG広島#9 × Agile Japan HIROSHIMA

you（@youtoy）
PRO

More Decks by you（@youtoy）

Other Decks in Technology

Featured

Transcript

「google/zx」と「Backlog API」を組み合わせた JavaScriptのプログラムからのBacklog操作 2022年1月22日 (土) JBUG広島#9 × Agile Japan HIROSHIMA

自己紹介ビジュアルプログラミングや IoT関連、その他にも豊田陽介（）普段は、某通信会社勤務（＠埼玉）　　　　　　　　　 ※地元は愛媛 @youtoy