目录

JIRA查询语言扩展

JQL函数：Dept()

组织机构插件为JQL查询扩展了Dept方法，能够按问题相关人员所属的部门筛选问题。

方法名

Dept

支持参数

部门名称，用双引号包裹，支持多个部门参数，用逗号分隔

支持运算符

in

支持JQL字段

assignee、reporter、worklogAuthor、任意选择用户（单选）或选择用户（多用户）类型的JIRA自定义字段

作用

将字段值人员与所有直属于参数部门的成员进行匹配筛选。

注意：如果成员A直属于部门B，部门B是部门C的子部门，那么成员A无法匹配到Dept("部门C")。

注意：如果一个成员直属于多个部门，无论主部门还是副部门都可以使用Dept方法匹配。

选择 问题 > 搜索问题 > 高级，进入【搜索问题】界面的高级搜索模式。

例如在搜索框中输入 assignee in Dept("软件开发二部")，点击“搜索”，即可获取到经办人属于开发部的问题列表。


JQL函数：Depts()

组织机构插件为JQL查询扩展了Depts方法，能够按问题相关人员所属的部门筛选问题，区别于Dept方法，Depts方法的返回结果包括子部门中的成员。

方法名

Depts

支持参数

部门名称，用双引号包裹，支持多个部门参数，用逗号分隔

支持运算符

in

支持JQL字段

assignee、reporter、worklogAuthor、任意选择用户（单选）或选择用户（多用户）类型的JIRA自定义字段

作用

将字段值人员与所有属于参数部门的成员进行匹配筛选，包括所有子部门中的成员

注意：如果一个成员直属于多个部门，无论主部门还是副部门都可以使用Depts方法匹配。

示例：

JQL函数：OrgMemProp()

组织机构插件为JQL查询扩展了OrgMemProp方法，能够按问题相关人员的成员属性筛选问题。

方法名

OrgMemProp

支持参数

成员属性名称，用双引号包裹，支持多个成员属性参数，用逗号分隔。

注意：仅支持单选和多选类型的成员属性

支持运算符

  • in
  • not in
  • is EMPTY
  • is not EMPTY

支持AND和OR组合查询多个成员属性。

支持JQL字段

assignee、reporter、worklogAuthor、任意选择用户（单选）或选择用户（多用户）类型的JIRA自定义字段

作用

将字段值人员与成员属性进行匹配筛选。

示例：

在搜索框中输入 assignee in OrgMemProp("雇佣类型 in (外部) AND 工作地点 in (北京,上海)")，点击“搜索”，即可获取到经办人为外部雇佣类型且在北京或上海工作的问题列表。

注意：

若字段名称包含空格，如：字段名称为 【雇佣 类型】，中间包含空格，需为字段加上引号，引号需要使用“\”反斜杠进行转义。正确写法为：assignee in OrgMemProp("\"雇佣 类型\" in (外部) AND 工作地点 in (北京,上海)")

自定义部门字段

用户所属部门

组织机构插件提供了“用户所属部门”的字段类型。这个字段会根据Issue中的一个指定的用户字段，自动计算人员对应的所属部门，显示出来。

使用场景

  • Issue 页面中显示 报告人所属部门、经办人所属部门、牵头负责人所属部门。

  • 导出Issue列表时增加对应的部门列。

  • 按人员所属部门查询问题。
  • 仪表板按人员所属部门统计问题。

选择 设置 > 问题 > 自定义字段 > 添加自定义域 > 高级

成功添加字段后，还需进入到对应字段的配置界面，设置以下内容：

    1. 显示的部门具体对应哪一个用户字段，可以选择“经办人”、“报告人”或者一个用户选择器（单选）类型的自定义字段。

    2. 可以选择部门显示的信息形式。可以设置成显示人员所在的具体某一级部门的名称，也可以设置成显示完整的部门路径。


部门选择器字段

V4.6.0及之后的版本提供

组织机构插件还提供了“部门选择器（单部门）”、“部门选择器（多部门）”的字段类型。可以从已有的组织机构中选择一个或多个部门作为字段的值。

成功添加字段后，还需进入到对应字段的配置界面，设置可选项：


部门选择器类型的字段既可以用于Issue界面的编辑、查看，也支持在问题查询时使用以及在Gadget中统计。


  • No labels