こんにちは、俊介です！ Workatoで社内の業務を自動化したので、ブログを書こうと思います。今回はAzure DevOpsとの連携する話です。
弊社は日々お客様からご質問がSlack経由で寄せられます。その際にAzure DevOpsでチケット管理を行うのですが日々SlackとAzure DevOpsを行き来するのが凄い大変で… なので、Slackで完結出来ないかなと思い、作成してみました。Slackにて特定のリアクションをすると自動的にAzure DevOpsにチケット起票する動きを想定しています。詳しい内容はレシピの概要で書いていきたいと思います。
はじめに
Workatoって何？
そもそもWorkatoって何？って言う方、聞いた事あるけどあまり他のサービスとの違いが分からない….という方は、弊社取扱製品ページにて分かりやすく説明しておりますので弊社のWorkato紹介ページをご覧ください。
Azure DevOpsって何？
Azure DevOpsは開発や運営をしていく上で、作業をスムーズに進めるような、環境やツールが揃っているプラットフォームです。Azure DevOpsには下記のツールが含まれています。
- Azure Boards
- Azure Repos
- Azure Pipelines
- Azure Test Plans
- Azure Artifacts
その中で弊社ではAzure Boardsを利用しています。Azure BoardsはAzure DevOpsのサービスの1つで、タスクの管理がしやすく、進捗の可視化されているので、共同作業者も簡単に確認する事が出来ます。
弊社ではAzure Boardを利用して、お客様ごとのプロジェクトを管理したり、日々質問が来た際に集約させて管理する際に使ってます。
レシピの概要
今回作成したレシピは冒頭でも記載した通り、お客様から頂いたご質問を自動的にチケットとして起票するレシピです。今までは手動で特定のチャンネルに質問リンクを貼って、かつAzure DevOpsにチケットを起票しておりましたが、毎日沢山のご質問を受けている中、その度に同じ作業を行っていました。それをWorkatoを使って自動化させてみました。
Before
- お客様から質問が来る
- 質問に気づいた人が特定のチャンネルにリンクを貼り付ける
- その人がAzure DevOpsにアクセスし、質問内容をコピペしてチケットを起票する
After
- お客様から質問が来る
- 質問に気づいた人が特定のリアクション(スタンプ)を押す
- 自動的にAzure DevOpsにチケットが起票される
- 特定のSlackチャンネルへURLと合わせて投稿され、投稿したメッセージをピン留めされる
最後にピン留めさせる仕様にしていますが理由は、ピン留めされてるものは現在対応中の物を一覧で見れるように設定しました。ピン留めされている物はまだ対応が残ってる物で、対応が終わり次第ピン留めを外すことによって、対応終了しているかどうかをすぐに判断出来るように設定にしています。
作成したレシピ
WorkatoにはまだAzure DevOpsのAppコネクターが無かったので、自分で作成しました。レシピ自作について詳しくはWorkatoの公式ドキュメントをご覧ください。
作業としては以下の2つです。
- Azure DevOpsのカスタムコネクターの作成
- レシピの組み立て方法
Azure DevOpsのカスタムコネクターの作成
ブロックごとに簡単に説明していきます。困った点、気をつけるポイントも書いていくので、皆さんのお力になれたらなと思います。
またカスタムコネクターはRubyで記述する必要があります。
connectionブロック
ここはAzure DevOpsと連携する際に認証する部分になります。重要なのはfields部分と、authorization部分です。fields部分接続時に入力させる部分になります。
authorization部分では、そのAPI(今回はAzure DevOps)がどのような認証方法を使っているか書いていきます。今回はベーシック認証で書きましたが、連携するサービスのapiによって認証方法が異なりますので、事前にお調べください。
authorization: { type: "basic_auth", apply: lambda do |connection| token = "#{connection['user_name']}:#{connection['personal_access_token']}".encode_base64 headers("Authorization": "Basic #{token}") end }, base_uri: lambda do |connection| "https://dev.azure.com/#{connection['organization']}/" end }, test部分 この部分は接続ができるか試す部分になります。基本的にconnectionブロックで記載された部分を見て認証テストを行います。
test: lambda do |connection| get("https://dev.azure.com/#{connection['organization']}/_apis/projects?api-version=5.1") end, 私はRubyを触った事が無いので、ここで大変手こずりました…。書き方がダメだった為、なかなか認証がうまくいきませんでした…。先輩からcurlでリクエストして、ちゃんと期待通りのものが返ってくるか確認すると良いとの助言を頂いて対応しました。
> curl -H'Authorization: Basic <Azure DevOpsから入手したAPIトークン> https://dev.azure.com/<テナント名>/<プロジェクト名>/_apis/wit/workitemtypes?api-version=5.1 | jq . これは勉強になったので、備忘録として書いておきます。
object_definitionsブロック
ここはMicrosoftの公式ドキュメントのSample Requestから参考にして書きました。コードの様子は長い為、割愛させて頂きます。
actionブロック
ここで重要なのは3つです。
- input_fields → レシピ作成時の入力フィールドを書く所です
- execute → どのように動かすか処理部分を書く所です
- output_fields → レシピの後続のフローでデータを使う為の書く所です
actions: { create_item: { title: "Create item", input_fields: lambda do |_object_definitions| [ {name: "project", control_type: "text"}, {name: "type", control_type: "text"}, {name: "title", control_type: "text"}, {name: "description", control_type: "text-area"} ] end, execute: lambda do |connection, input| body = [ { "op": "add", "path": "/fields/System.Title", "from": "null", "value": input["title"] }, { "op": "add", "path": "/fields/System.Description", "from": "null", "value": input["description"] }, ] post( "https://dev.azure.com/#{connection['organization']}/#{input['project']}/_apis/wit/workitems/$#{input['type']}?api-version=5.1" ) .request_body(body.to_json) .headers("Content-Type": "application/json-patch+json") end, output_fields: lambda do |object_definitions| object_definitions["projects"] end, }, 沼にハマった点はexecute部分です。最初は公式ドキュメントに記載されてるpostをそのまま利用してたのですが、エラーが直りませんでした。原因はRequest Bodyを書いていなかった為です。それらを追加してやり直すと無事起票のテストを行う事が出来ました。
レシピの組み立て方法
Trigger部分
Action部分
- 投稿のリンク(用途：特定のチャンネルに貼る為)
- チャンネル名(用途：Azure DevOpsのチケットのタイトルに使う為)
- 投稿されたテキスト(用途：Azure DevOpsのチケットの説明に使う為)
limitを設定していないと、同じチャンネルで他の投稿に同じリアクションをした投稿まで取得してしまいます。
- 質問のリンク
- Azure DevOpsのチケットURL
実際に動かした様子
まずは投稿に特定のリアクションをつけます。
今回はテストでやってるので特定のリアクションを「:eyes:」で設定しています。
最後に
今回はSlackとAzure DevOpsを連携させて、Slackで特定のリアクションするだけでAzure DevOpsにチケット起票する動きを作りました。ユーザーはリアクション1つするだけでSlack専用チャンネルへの転記とピン留め、更にはAzure DevOpsへの起票まで行えるようになったので、対応時間を大幅に減らす事が出来たと同時に、起票漏れや対応漏れも分かりやすくなりました。
現状はチケット起票までを自動化していますが、別レシピでAzure DevOpsのチケットのステータスをDoneにする、をトリガーにして、ピン留めを外すレシピを作成すると、より便利に。完了していないタスクのSlackリマインドも実装したいと思っています。
あと今回作ったレシピもカスタムコネクターも共有する事が出来ますので、もし気になった方や、使ってみたいう方がいらっしゃいましたらお気軽にご相談ください！ではまた！
