以管理员身份登录 Jira
点击页面右上角 齿轮 图标 > 管理应用
从左侧菜单栏找到 飞书审批
通用设置
| 参数 | 说明 |
|---|---|
| 回调密钥 | |
| 审批实例字段 | |
| 飞书用户id | |
| Jira 驱动用户 | |
审批模版
在工作流的‘处理结果’步骤中，选择预设的审批模板即可自动发起飞书审批流程。 同时，您可以将 Jira 问题中的相关字段作为参数传递到飞书审批中，实现信息自动填充并减少手动录入。
点击 新增审批模版 可以添加新的模版设置
将需要集成的飞书审批模版id，粘贴到 审批 ID 中，参见如何 获取飞书审批id
然后点击 获取模版 按钮，插件将会从飞书读取发起审批的基本信息
如果审批id正确，审批名称 字段将会显示正确的 审批名称
审批模版中，将会显示飞书审批的模版，例如下面：
[{"id":"widget17632053655230001","name":"标题","type":"input","value":"${JIRA_FIELD_ID}"},{"id":"widget17632053886380001","name":"说明","type":"textarea","value":"${JIRA_FIELD_ID}"}]
需要将上述模版内容中的 JIRA_FIELD_ID 替换为 Jira 变量，以便于审批人可以在飞书审批中查看到 Jira 发来的审批内容。
| 可用变量 | 说明 |
|---|---|
| issue.summary | 问题主题 |
| issue.key | 问题键值 |
| issue.description | 问题描述 |
| issue.customfield_30123 | 问题自定义字段值 |
下面这个例子，就是将 Jira 问题键值 - 主题 当作飞书审批标题，问题描述当作飞书审批说明。
[{"id":"widget17632053655230001","name":"标题","type":"input","value":"${issue.key} - ${issue.summary}"},{"id":"widget17632053886380001","name":"说明","type":"textarea","value":"${issue.description}"}]
事件处理
当飞书审批完成后，Jira 接收飞书审批结果变更，将会按照下面的规则自动执行 Jira 工作流。