「Jira Server」连接器内部调用了 Jira Server 的的开放接口并进行了接口调用时的鉴权，你可以在飞书低代码平台工作流中通过「Jira Server」连接器快速使用 Jira Server 提供的各项能力，实现数据互通。
前置准备
你已经在本地部署了 Jira Server 服务，支持版本为 8.5.3 及更高版本。
生成 Jira Server 的 private key 和 public key
打开电脑终端，依次输入如下命令，并执行如下操作：
- 复制生成的 jira_publickey.pem，供后续申请 Jira Server 应用使用。
注：请在复制时删除“-----BEGIN PUBLIC KEY-----和-----END PUBLIC KEY-----”。
- 复制生成的 jira_privatekey.pem，供后续创建 Jira Server 凭证使用。
注：请在复制时带上“-----BEGIN RSA PRIVATE KEY-----和-----END RSA PRIVATE KEY-----”，并删掉所有换行符。
openssl genrsa -out jira_privatekey.pem 1024openssl req -newkey rsa:1024 -x509 -key jira_privatekey.pem -out jira_publickey.cer -days 365openssl pkcs8 -topk8 -nocrypt -in jira_privatekey.pem -out jira_privatekey.pcks8openssl x509 -pubkey -noout -in jira_publickey.cer > jira_publickey.pemm
申请 Jira Server 应用
登录本地部署的 Jira Software，点击右上角 设置 > 应用程序。
250px|700px|reset
250px|700px|reset
点击 继续，填写必填字段。
250px|700px|reset
找到创建好的应用程序链接，点击 编辑 按钮。
250px|700px|reset
在弹窗的 传入的验证 页面填写以下字段：
- 客户关键字：自定义（复制该参数，供后续创建 Jira Server 凭证使用）
- 客户名称: 自定义
- 公共关键字：前置准备中获取的 public key
- 客户回调 URL：在集成平台创建 Jira Server 凭证时获取
点击 保存 按钮，Jira Server 的环境搭建就完成了。
250px|700px|reset
配置步骤
（一）添加节点
进入流程编辑器，新增节点选择「三方集成」中的「Jira Server」。
250px|700px|reset
（二）操作和连接
1.执行操作
即选择该节点具体要执行什么操作。
通过「Jira Server」连接器，可执行以下15类操作：
250px|700px|reset
250px|700px|reset
2.连接配置
点击「新建连接配置」，输入自定义名称，分别配置线上和开发环境的连接信息。
输入前置准备中获取的 JiraServer Site、Consumer Key 、密钥
250px|700px|reset
250px|700px|reset
（三）基础配置
根据所选「操作」配置相应参数。
更多信息可参考「操作」对应的API调用指南
250px|700px|reset
（四）高级配置
可以根据需要，设置操作执行失败时的重试策略：
250px|700px|reset
配置项 | 说明 |
重试间隔 | 每次重试之间的间隔时间，默认 5000 ms |
重试次数 | 失败后的自动重试次数，默认 0 次 |
超时时间 | 每次重试的 HTTP 请求超时时间，默认 5000ms |
（五）输出变量
「输出变量」会根据所选的操作展示操作执行后的响应数据结构，在后续节点中，我们可以引用输出变量中的具体字段。
节点配置完成后，在流程中也会自动生成一个变量，变量中将承载连接器所选操作执行后，获取到的响应数据内容。
250px|700px|reset
使用案例
列出所有项目
通过在工作流中使用「Jira Server」连接器，可以获取你在 Jira Server 中创建的所有项目。
- 在工作流中插入一个 Jira Server 连接器，在 操作>Project 中选择 列出所有项目 操作。
250px|700px|reset
- 在 基础配置 中输入选填字段即可获取全部项目。
250px|700px|reset
获取 issue 类型元数据
通过在工作流中使用「Jira Server」连接器，你可以获取在 Jira Server 特定项目下支持创建的所有 issue 类型。
- 在工作流中插入一个「Jira Server」连接器，在 操作>issue 中选择选择 获取 issue 类型元信息 操作。
250px|700px|reset
- 在 基础配置 中填入 项目唯一标识 这个必填字段以及其他可选字段，工作流即可正常运行。
250px|700px|reset
获取创建 issue 元数据
通过在工作流中使用「Jira Server」连接器，你可以获取在 Jira Server 特定项目下支持创建的 issue 所需要配置的字段。
- 在工作流中插入一个「Jira Server」连接器，在 操作>issue 中选择选择 获取创建 issue 类型元信息 操作。
250px|700px|reset
2.在 基础配置 中填入 项目唯一标识 和 需要查询的issue类型的唯一标识 等必填字段以及其他可选字段。工作流即可正常运行。
250px|700px|reset
FAQ
- 当用户的内网存在防火墙时，可以将123.58.10.238、123.58.10.239 两个 ip 地址配置在防火墙的白名单，以便 AnyCross 平台可以访问内网部署 Jira Server 服务。
