Jira Cloud REST APIとIBM Cloud
Jira SoftwareやConfluence、Jira Service Deskのクラウド版に無料プランが登場し、Jira Software クラウド版 Free プランの申し込み手順について記事にしました。
Jira Cloud REST APIを操れるようになると、AIやIoT、ブロックチェーンなどと組み合わせることができます。
そこで、クレジットカード不要なIBM Cloud ライト・アカウント上で無料で使えるNode-REDを用いて、Jira Cloud REST APIを用いて、チケット(Jira用語では課題と言う)を起票する手順について説明します。
なぜNode-RED?
市場には、iPaaS(integration Platform-as-a-Service)製品やサービスが幾つもありますが、クラウド、オンプレミス、組み込み機器などどこでも動き、業務アプリケーションの他にAIやIoT、ブロックチェーンなどまとめてサポートしているものは少なく、産業用IoTというカテゴリで言えば、主要企業のサービスでは、Node-REDが採用されています。(参考資料:http://www.mstc.or.jp/iaf/event/2019f/07yokoi.pdf)
AI分野では、IBM Watsonや Microsoft Cognitive Services、Google Assistant、TensorflowベースのAIサービス等と接続できるため、プロジェクト管理やタスク管理、サービスデスクなどの業務アプリケーションを、AIやIoTと連携しようとすると、Node-REDが有力な候補になります。
準備
Jira Software クラウド版 Free プランの申し込み手順を参考に、クラウド版 Jira Software環境を用意し、APIトークンを発行しておきます。
関連資料 https://ja.confluence.atlassian.com/cloud/api-tokens-938839638.html
Node-RED上で、Jira Software クラウド版にチケット(課題)を起票
Node-RED上で、シンプルなフローを作ります。
１つ１つ設定を見ていきます。
異常値を検知しました
injectノードを使用しています。injectノードの左端の四角のボタンを押すと処理が開始されます。
設定は、下図のように、ペイロードに文字列として「異常値を検知しました。」という警告文をセットしています。
issue data
functionノードを使用しています。手前で発信された文字列をsummaryに挿入するとともに、Jiraに起票するためのデータを生成しています。Jira Software クラウド版 Free プランの申し込み手順で説明しているように、Jiraを使うには、プロジェクト作成が必須です。Projectのキーを、ここでは「IOT」としていますが、皆様が作成した各自のプロジェクトキーに読み替えてください。
"fields": {
"project":{"key":"IOT"},
http request
http requestノードを使用しています。
「メソッド」に「POST」、「URL」にJira Software クラウド版を登録した際のサイト名(Site name)を用い、/rest/api/2/issue を追加しています。
また、「認証の使用」にチェックを入れ、次のように値をセットしています。
- 種別 : Basic認証
- ユーザー名 : Jira Software クラウド版へのログインメールアドレス
- パスワード : ユーザー名のメールアドレスで取得したAPIトークン
msg
debug ノードを使用し、対象をオブジェクト全体としています。
動作確認
設定後、画面右上の「デプロイ」ボタンをクリックします。
「異常値を検知しました」と表示されている「inject」ノードの左端の四角のボタンを押すと処理が開始されます。
虫型のアイコンをクリックすると「デバッグ」タブにて、実行結果を確認できます。また、クラウド版のJira Softwareのお使いの環境に、Node-REDで、Jira Cloud REST APIを用いて作成されたチケット(=課題)が起票されているはずです。
活用例
これらの仕組みは、クラウド版ではなくサーバー版のJira Softwareになりますが、昨年開発しました『在宅ケアを想定した自動発報および可視化システムのPoC』では、センサーの異常値を検知し、Jiraに確認を指示するチケット(課題)を自動起票する仕組みに使っています。