Logic Appsを使って、Backlogとslackを連携してみた。

Logic Appsを使って、Backlogとslackを連携してみました。

1 Logic Appsとは
2 BacklogからWebhookに渡すJSONファイルの作成
3 JSON → Scheme
4 Logic Appを作成
5 Logic App と Slackと連携
6 BacklogからLogic Appsの設定
7 実際に課題を追加してみる

Logic Appsとは

Azureで提供されているサービスの一つで、いろいろなサービスを連携させることができるサービスです。zaiperやIFTTTと似たようなサービスです。フローの定義はJSON形式ですが、GUIからポチポチ操作することでフローを作成することができるのでEngineer出ない方にも使いやすいサービスです。

例えば、

FTP サーバーにアップロードされたファイルを Azure Storage に移動する
Tweetを監視して、アラートやタスクを作成する
日本語で書いたメッセージを自動で英語に翻訳してcommitする
MailChimp リストに新しいメンバーが追加されたときにそのメンバーを SharePoint リストにも追加する
Facebook で自分のツイートを共有する

など様々なサービスを組みわせることができます。

今回はBacklogで課題が追加されたら、WebhookでLogic Appに飛ばし、そこからSlackに飛ばすようにしてみました。

このように【課題のタイトル】, 【期日】, 【担当者】がslackに通知されるようにします。

BacklogからWebhookに渡すJSONファイルの作成

BacklogにはWebhook機能が実装されており、この機能を使うとBacklogの課題やコメントを外部サービスに飛ばすことができます。
今回は【課題のタイトル】, 【期日】, 【担当者】を受け取れるようにします。

下記のリンクを参考にしてJSONファイルを作成します。
https://developer.nulab-inc.com/ja/docs/backlog/api/2/get-comments

そして出来上がったのがこちら。かなり簡略化してます。

{
  "content": {
    "summary": "",
    "dueDate": "",
    "assignee": {
      "userId": ""
    }
  }
}

JSON → Scheme

この作成したJSONからSchemeを作成します。
下記のようなサイトを利用すると良いと思います。

https://jsonschema.net/

画面左側に先ほど作成したJSONを貼り付け、generates schemaをクリックすると画面左側にSchemeが作成されるのでこれを保存しときます。

変換したScheme

{
  "$schema": "https://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {
    "content": {
      "type": "object",
      "properties": {
        "summary": {
          "type": "string"
        },
        "dueDate": {
          "type": "string"
        },
        "assignee": {
          "type": "object",
          "properties": {
            "userId": {
              "type": "string"
            }
          },
          "required": [
            "userId"
          ]
        }
      },
      "required": [
        "summary",
        "dueDate",
        "assignee"
      ]
    }
  },
  "required": [
    "content"
  ]
}