Jira 任务同步到 Microsoft Teams

网友投稿 312 2022-09-15

Jira 任务同步到 Microsoft Teams

假设你有这么一个任务:

你需要将 ​​Jira​​​ 上的任务定时同步到 ​​Microsoft Teams​​ 上,并提醒相关的负责人当前的任务。

举个例子:在每个工作日(周一到周五)早上 ​​10 点钟 01 分 01 秒​​ 的时候,通过机器人发送一条消息到你所在团队的 channel 上,并 @ 相关的任务负责人员。

相关解析:​​Jira Software​​ 专为软件团队中每个成员构建,可用于规划、跟踪和发布卓越的软件。​​Microsoft Teams​​ 微软协助沟通软件。channel: 团队的频道,一个团队可以有多个频道。

基础工作

我们要实现一个服务,作为一个前端切图仔,我们选用nodejs来开发。这里选用了​​Koa​​框架。

因为实现的功能比较简单,不涉及到前端的开发,所以这里不进行前端技术的选型。

后台的开发涉及到获取 ​​Jira​​​ 的数据,我们直接使用相关的包 ​​jira-client​​ 来获取。

综上,你只需要安装的关键包文件如下:

npm install koa // nodejs 框架npm install jira-client // 获取 jira 数据npm install aixos // 库npm install node-cron // 定时任务处理

从 Jira 获取数据

我们只是 Jira 数据的搬运工,​​jira-client 文档​​ 已经详细介绍了我们能够通过何种方式获取到相关数据。

比如:

/*** 删除指定 Jira 的 Issue* [Jira Doc](@name deleteIssue* @function* @param { string } issueId - 要删除的 Issue 的 Id*/deleteIssue(issueId) { return this.doRequest(this.makeRequestHeader(this.makeUri({ pathname: `/issue/${issueId}` }), { method: 'DELETE', followAllRedirects: true

当然,我们要实现的是查询的任务,使用的是 ​​searchJira​​ 方法。

我们对 ​​jira-client​​ 包提供的方法封装如下:

import JiraApi from 'jira-client';// jira-client 实例const instance = new JiraApi({ protocol: config.jira.protocol, host: config.jira.host, username: config.jira.username, password: config.jira.password, apiVersion: config.jira.apiVersion, strictSSL: config.jira.strictSSL})// 搜索 Jiraexport.searchJira = async (ctx, next) => { let ctx_query = ctx.query try { const issue = await instance.searchJira(ctx_query.searchString, { maxResult: 1 }); ctx.body = { success: true, data: issue } } catch (err) { ctx.body = err } await next()}// searchString 这个字段是 Jira 查询条件,比如:project in

通过上面的操作,你可以获取到相关 ​​Jira​​​ 的 ​​Issues​​ 数据,如下:

卡片数据组装

上面我们能够成功获取到了 ​​Jira​​ 上的数据,那么我们把获取到的数据进行美化,组装成相应的卡片。

详细的格式卡可戳​​链接​​了解详情。

因为我们需要 ​​@任务的负责人​​​ ,所以我们选择的卡片类型是 ​​adaptive-card​​。

const body_list = [];const msteams_entities = [];body_list.push({ "type": "TextBlock", "text": `${_item.username} 当前任务`, "weight": "bolder", "wrap": true}, { "type": "TextBlock", "text": `到期任务: ${personalOverdueIssuesCount}`, "wrap": true, "color": `${personalOverdueIssuesCount >= 1 ? "attention" : "default"}`});msteams_entities.push({ "type": "mention", "text": `${_item.username}`, "mentioned": { "id": `${_item.email}`, "name": `${_item.display_name}` }})let postMoreLink = `${config.jira.jira_hostname}/issues/?jql=${encodeURIComponent(`resolution = Unresolved AND assignee in (${_item.username}) ORDER BY priority DESC, duedate ASC`)}`;const page_json = { "type": "message", "attachments": [ { "contentType": "application/vnd.microsoft.card.adaptive", "content": { "type": "AdaptiveCard", "$schema": " "version": "1.0", "body": body_team_list, "actions": [ { "type": "Action.OpenUrl", "url": postMoreLink, "title": "详情" } ], "msteams": { "width": "Full", "entities": msteams_team_entities } } }]};

为了很好地兼容移动端和pc端,请选用文档支持的属性,不可自己编写相关的 markdown 进行内容美化。

发送数据到 Microsoft Teams 的 Channel 上

查看 ​​Microsoft Teams​​​ 的相关文档,如果我们需要打通 ​​Microsoft Teams​​​ 软件的话,我们需要创建传入 ​​Webhook​​​。​​创建传入 Webhook​​,官方已经有很详细的介绍了,这里不累赘介绍。

我们在自己的团队中创建了 ​​channel-02​​ 。

然后将内容传送到这个频道上。

我们选用了 ​​axios​​ HTTP 库进行数据的发送。

const axios = require('axios');axios.post(channel.url, page_json).then(res { console.log(res)});// 因为是定时的任务,我们还引入了处理定时的库 - [node-cron](cron = require('node-cron');cron.schedule("01 01 10 * * 1-5", () => { // 调起相关的请求 // init()}, { scheduled: true, timezone: "Asia/Shanghai", // 中国时区,根据你团队所在的时区进行调整

我们发送到 ​​channel-02​​ 上的效果如下:

上图右上角出现的红色的 @ 表示已经触发并提醒当前任务的负责人,比如图上我自己 ​​Jimmy​​​。相关提醒还会在电脑的右上角进行 ​​banner​​ 横幅跳出展示。

版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。

上一篇:中国影史票房最高春节档“炼成”记!
下一篇:使用 vscode 省时的6个插件
相关文章

 发表评论

暂时没有评论,来抢沙发吧~