SHOEISHA iD

※旧SEメンバーシップ会員の方は、同じ登録情報(メールアドレス&パスワード)でログインいただけます

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

JIRAやConfluenceをもっと使いこなそう! エキスパートが教える、外部ツール連携術(AD)

REST APIを利用して、JIRAのサマリーを外部エディタで編集してみよう!――外部ツール連携の第一歩

JIRAやConfluenceをもっと使いこなそう! エキスパートが教える、外部ツール連携術 第1回

  • X ポスト
  • このエントリーをはてなブックマークに追加

 昨今、開発現場での情報共有は必須ともいえるほどに重要視されています。情報共有ツールとしてJIRAやConfluenceといったアトラシアン製品は多くの開発現場で使用されていますが、チームの仕組みに存在するからなんとなく使っている……そのような方も多いのではないでしょうか。しかしせっかくのツール、多種多様な機能をもっと活用したいと思いませんか? 本連載では使い慣れた環境と組み合わせてツールをさらに使いこなす方法を、アトラシアン製品の国内販売代理店であるリックソフトがお伝えします。初回となる今回は、REST APIを利用してJIRAと外部ツールのエディタを連携させる例を紹介します。

  • X ポスト
  • このエントリーをはてなブックマークに追加

はじめに

 今回は、JIRA課題のサマリー(要約)を外部エディタ上で編集してJIRAに書き戻す機能を、JIRAのREST APIとElectron上に構築したテキストエディタを連携させ、実現していきます。

 通常、JIRAのテキストフィールドで一括置換を行いたい場合、CSV Export/Importを使って外部ツール経由で行うなど一手間が必要です。そこで、テキストエディタとREST APIを用いて直接連携すると、便利なテキスト編集機能を使いながら手軽に要約の一括置換ができるようになります。

 実装はJavaScriptとjQueryを組み合わせて行います。

サマリーエディタのイメージ
サマリーエディタのイメージ

必要な環境

 Electron稼働環境(本記事ではv1.6.2を利用しました)

  • macOS 10.9以降, Windows 7以降
  • JIRA6.4以降(サーバ版のみ)

サマリーエディタを動作させてみる

 はじめに、必要なソフトウェアをインストールしてテキストエディタを起動する準備を行います。Node.jsがインストールされていない場合は、Node.jsをインストールします。こちらからダウンロードしてください。

 次に、Electronのインストールを行います。インストール方法はこちらをご参照ください。ここでは以下のコマンドを利用してインストールします。

npm install -g electron

 その後、コマンドラインで以下の通り入力し、ウインドウが立ち上がればインストールは成功です。

electron

 今回、エディタはAceを使用しますが、起動時に外部から読み込むのでインストールは不要です。

 任意の場所に作業用ディレクトリを作成し、そこに移動します。

mkdir test; cd test

 プロジェクトを作成します。

npm init -y

 同じ場所にサンプルファイル内のファイルを全てコピーしてください。

cp (サンプルファイルのディレクトリ)/index.html (サンプルファイルのディレクトリ)/index.js (サンプルファイルのディレクトリ)/editor.js (サンプルファイルのディレクトリ)/editor.css .

 最後に、editor.js内に固定で設定されているJIRAホストURL、ユーザー名、パスワードを環境に合わせて書き換えてください。

 これでテキストエディタを起動する準備ができました。実際に起動してみましょう。以下のコマンドでエディタが起動します。

electron .

 画面左上のダウンロードボタンを押すとJQL(JIRA検索言語)ダイアログが表示されます。JQLフィールドは空のままでも問題ありません。

JQLダイアログ
JQLダイアログ

 ダイアログ上のロードボタンを押すと課題がロードされ、テキストエディタ上には課題キーとサマリーが表示されます。

課題キーとサマリーの表示
課題キーとサマリーの表示

 いくつかのサマリーをエディタ上で編集します。ちなみに、検索&置換機能で一括変換することもできます(macOSの場合はOpt+Command+F)。

編集の様子
編集の様子

 最後にアップロードボタンを押すと、テキストエディタ上で行った編集がJIRAに反映されます。

編集内容がJIRAに反映される
編集内容がJIRAに反映される

次のページ
REST APIでJIRAから課題を取得する

この記事は参考になりましたか?

  • X ポスト
  • このエントリーをはてなブックマークに追加
JIRAやConfluenceをもっと使いこなそう! エキスパートが教える、外部ツール連携術連載記事一覧

もっと読む

この記事の著者

阿部 賢一(リックソフト株式会社)(アベ ケンイチ)

 さすらいの開発スナイパー。ソースコードの「早打ち」とバグへの「狙い撃ち」には定評がある。彼は言う。「コードを書いている時は、私の後ろに立つな!」

※プロフィールは、執筆時点、または直近の記事の寄稿時点での内容です

【AD】本記事の内容は記事掲載開始時点のものです 企画・制作 株式会社翔泳社

この記事は参考になりましたか?

この記事をシェア

  • X ポスト
  • このエントリーをはてなブックマークに追加
CodeZine(コードジン)
https://codezine.jp/article/detail/10128 2017/10/02 19:06

おすすめ

アクセスランキング

アクセスランキング

イベント

CodeZine編集部では、現場で活躍するデベロッパーをスターにするためのカンファレンス「Developers Summit」や、エンジニアの生きざまをブーストするためのイベント「Developers Boost」など、さまざまなカンファレンスを企画・運営しています。

新規会員登録無料のご案内

  • ・全ての過去記事が閲覧できます
  • ・会員限定メルマガを受信できます

メールバックナンバー

アクセスランキング

アクセスランキング