为 JIRA 活动创建或编辑端点

端点提供 Studio 和 Integration Appliance 用于连接到 JIRA 平台的配置信息。JIRA 连接器仅支持基本认证机制以授权用户执行操作。JIRA 连接器还支持 HTTPS 连接。

选择或编辑 JIRA 端点

  1. 创建端点编辑端点窗格中,配置下表中所述的 JIRA 端点。
    注: 更改端点的配置属性会影响项目中使用该端点的所有编排。编辑是全局性的,而不是局部性的。
  2. 单击测试连接以确认连接详细信息有效,并且您能够成功连接到 JIRA。
  3. 单击确定
表 1. 连接属性
字段名 描述
主机名 JIRA 实例(本地或云)的主机名。
端口号 JIRA 实例的端口
用户名 用于访问 JIRA 实例的认证用户名。
密码 用于访问 JIRA 实例的认证密码。
端点测试连接屏幕上需要以下参数以通过代理建立连接:
主机名 代理网络的主机名
端口 代理网络的端口号。
用户名 用于通过代理网络访问服务的用户名。
密码 用于通过代理网络访问服务的密码。
端点测试连接屏幕中需要以下参数来进行 HTTPS 连接:
HTTPS 用于指示是否使用 HTTPS 的复选框
除以上参数外,还为 Secure Connector 配置提供了将端点与 JIRA 本地实例连接的选项。
注: 在每个活动的映射输入部分中,提供了端点面板的相关字段以便在运行时覆盖。您可以向不同的参数组提供数据以进行覆盖, 例如,“代理详细信息”、“连接详细信息”或“认证详细信息”。不允许在选中组中仅提供部分字段数据进行覆盖。

受 JIRA 连接器支持的对象

JIRA 连接器支持下表中详述的 JIRA 对象:

表 2. JIRA 对象支持的操作
JIRA 对象 创建 更新 删除 全部检索 检索 搜索
附件
组件
过滤器
问题
问题注释
问题链接
问题链接类型
问题工作日志
问题表决
版本
项目角色
得票数
观察者
问题类型
优先级
项目
解决方案
状态
用户
多项目用户
可分配用户
具有许可权的用户

定制对象支持

JIRA 不支持定制对象。

定制字段支持

JIRA UI 允许用户添加定制字段。这些字段仅与 JIRA“问题”对象相关联。连接器活动中提供对定制字段的支持 - 针对“问题”对象“创建”、“更新”、“搜索”和“检索”。

在“创建”和“更新”活动的“映射输入”中,“问题”对象将针对定制字段具有其他节点,以便用户能够为其提供值。

对于“搜索”和“检索”活动,“映射输出”将使用其他节点来识别定制字段。

这些活动的定制字段的格式如下所示:
<customFields>
<customFieldId>dept-id</customFieldId>
 <customFieldName>deptName</customFieldName>
<customFieldType>FreeTextField</customFieldType>
 <customFieldValue>HR</customFieldValue>
 </customField>
表 3. JIRA 对象支持的操作
定制字段参数 描述
customFieldId JIRA UI 中创建的定制字段的标识。在定制字段名称与标识间,“customFieldId”具有优先权。如果存在多个同名定制字段,那么应提供 customFieldId 来区分字段,否则将显示相应的错误。
customFieldName JIRA UI 中创建的定制字段的名称。
customFieldType

仅针对“创建”/“更新”活动显示的定制字段类型。允许的值包括:

  • 日期选取器字段
  • 日期时间字段
  • 自由文本字段
  • 复选框
  • 标签
  • 多选
  • 单选按钮
  • 选择列表
  • 文本字段
  • URL 字段
  • 用户选取器
  • 组选取器
  • 多组选取器
  • 多用户选取器
  • 项目选取器
  • 单一版本选取器
  • 版本选取器

尚不支持的 JIRA 定制字段类型有:

  • 级联选择字段
  • 数字字段
customFieldValue 定制字段的值。此参数会重复出现以支持多个用户输入值。如果为单个输入字段提供了多个值,那么仅添加第一个值。
注:
  1. 定制字段是可选字段。
  2. 如果没有为 customFieldName/customFieldId 提供值,那么将忽略其他 2 个参数值,并将在任何定制字段中不作任何修改的情况下成功创建/更新问题。
  3. 如果提供了 customFieldName、customFieldId 和 customFieldType,那么将为 customFieldValue 的缺少值显示相应的错误消息。