Jira实战 | 自定义字段

《Jira策略管理实战手册》: 为管理员提供配置、清理和维护Jira的模板。

文末获取Kindle版印刷版

 

最佳实践

应该这么做

限制自定义字段的数量,只创建供多个项目进行查询和使用的必要字段,太多的自定义字段会影响性能。

 

如果需要不同的字段描述或值的时候,仅需使用字段配置或是上下文功能,千万不要使用重复的自定义字段。

 

Jira实战 | 自定义字段_第1张图片

 

 

不要这么做

创建多个相同名称的字段,甚至字段还是不同的类型,这些重名会导致系统管理员在为最终用户创建界面查询时造成混乱。

 

必填字段

这里有两种完成必填字段的方式:

  • 在项目里的“字段配置”方案将字段设置为必填,这个方法会在创建和编辑的界面上呈现红色星号符号,视觉上告知为必填。如果字段留白的话,会在提交的时候显示红色的错误页。

  • 使用“工作流转”换验证器规则让字段必填,这个方法会在转换的时候在覆盖页面上呈现红色错误信息,不会在该字段上呈现红色星号。

 

最好的方法就是根据情况来处理,需要在创建界面上必填字段的时候,可以使用“字段配置”的方法;举个例子,需要在工作流中的三个步骤上必填字段的时候,可以使用“工作流转换”的方法

 

如果必填字段没有显现在界面上的话,你的用户会看到错误信息并且无法继续进行处理。

 

建议

公告一个可用的自定义字段和其用法的列表会是相当有用的,这可以鼓励最终用户请求既有的字段,而不是提出新的或是相类的字段需求,你可以这么做:给用户“常见问题集”页面(在yourjiraurl.com/secure/ShowConstantsHelp.jspa),复制并粘贴上JIRA静态列表、查询数据库、使用REST API去生成可用选项的快速列表。

 

字段配置

字段配置 – 提供了改变字段行为的能力,属性:

  • 名称

  • 描述

  • 所有可用字段的设置

 

应该这么做

在所有项目中呈现用户期望的标准字段

 

不要这么做

必填字段没有呈现在界面上,用户会看到错误信息并且无法进行创建或是转换问题。

 

重要的标准字段

即使不是所有用户都需要输入数据的情况下,下列字段必须是可用的。

 

字段

备注

报告人

必须呈现和使用,报告人,身为唯一的联系人必须提供。

注意: 在较新版本的JIRA中,问题的“创建人”会自动填入报告人,(原始的“创建人”可以有别于当前的“报告人”,这些都是常见的情况,当报告人变更了团队、着重点上的改变,或是离开了公司,就会有所不同。)

描述

必须呈现和使用,当创建的时候,应该要提供问题详细的描述内容。

组件模块

呈现即可,所有项目应该都要能使用这个在路由和分类上有帮助的功能。

优先级

呈现即可,这用来帮助设置问题的预期严重性,好让团队能够将他们的工作按优先级排序(或是重新设置预期)

到期日期

呈现即可,虽然项目可能在使用这个日期方面上有所不同,但是有一个目标日期会是一个有用的信息。(示例用法:代码完成日期 vs. 请求日期等)

附件

呈现即可,所有项目应该要能存储上的支持和附加文档。

链接的问题

呈现即可,所有项目应该都要能够连接到其他相关的问题。

时间跟踪

呈现即可,所有项目应该要能去预估工作量。

填报工时

呈现即可,所有项目应该都要能显示进度并报告实际工作量。

 

字段配置方案

字段配置方案 – 用来将字段配置映射到问题类型,属性:

 

  • 名称

  • 描述

  • 关联字段配置

 

字段配置和方案的关系

在这个例子里,四个字段有特定的设定,“条件”字段在任务问题类型是显现的,但是却在“子任务”问题类型隐藏,这两个字段配置让你可以在不同问题类型让同一个界面略有不同。

 

 

祖父级

父级

子级

 

问题类型

字段

配置

方案

字段

配置

自定义字段

字段设定

任务

资产字段配置方案

任务字段配置

描述

Wiki渲染器

价格

必填

数量

选项

条件

呈现

子任务

资产字段配置方案

子任务字段配置

条件

隐藏

 

或者,你可以使用相反的设定:两个界面(一个没有条件字段)和一个字段配置。

 

另外一个界面设定则是将所有的字段放置在一个界面,并且使用字段配置来隐藏不该呈现在特定问题类型的字段。

 

适当的字段类型

在创建新字段的时候,务必选择最适合的类型来使用,一旦选择字段类型后就不能够更改了,要变更字段类型的话,你需要创建新的自定义字段,从原先的字段所储存的数据迁移到新的字段,然后移除原先的字段,再更新界面呈现新的字段。

 

文本字段 (单行)vs 文本字段 (多行)

这两者之间的选择最重要的是所需字符的长度,文本限制在255个字符或是更少?如果是,"文本字段(单行)"类型会是最佳的选择,对于长段落类型的响应,"文本字段(多行)"类型会是最佳的选择。 

 

复选框 vs 单选框

这两个字段类型容易误用,在JIRA里或是任何网站及线上应用的UI规则都是相同的。

  • 复选框 - 如果有用户能够有多个选项去选择,适合使用核取方块复选框字段格式,用户能够在一个问题中不选择或是选择一到多个选项。

  • 单选框 - 如果用户必须在多个选项中选择一个,选项间彼此是互斥的情况,适合使用单选按钮,用户只能够选择一个,所以须使用清晰的选项标签。

 

特别的功能

有一个插件(在JIRA Cloud和JIRA服务器上都有)叫做"JIRA Toolkit Plugin",这个插件提供了两个非常有用的字段类型,这两个叫做"Message Custom Field (for view)"和"MessageCustom Field (for edit)"。这些字段让你在问题或是工作流转换上让你能够呈现文本或是HTML,它们的特性就是能够帮助提供额外的指令、显示警告或是链接到额外的信息。

 

若要在查看界面上放置消息,使用"Message Custom Field (for view)"字段类型;若要在创建、编辑、转换界面上放置消息,使用"Message Custom Field (for edit)"字段类型。

 

 

 

 

关于《JIRA策略管理实战手册》

本文节选自《JIRA策略管理实战手册》,为Jira管理员提供配置、清理和维护Jira的模板。

 

此实战手册包含:

  • 152条建议- 帮助您设置、清理和维护Jira

  • 50个工作表,以及其他相关模板、代码片段和示例

  • 33个需避免的反面真实案例

  • 每个管理区域的最佳实践和注意事项

  • 作者作为管理员犯下的十大错误

 

关于翻译,编辑和审稿人

 

图片

钟冠智 Kerwin

 

现任Atlassian 大中华区负责人

前CSDN Atlassian Agile DevOps谘询顾问

大中华区首位ACP-100认证专家

Atlassian 中文社区发起人

图片

Ollie Guan

 

携程集团 PMO

Atlassian Community Champion

2018 Community Perfect 10 awards

2019 Community awards winner

2020 Top Community Answerers

图片

周琦

 

优秀的项目管理者及流程改善者曾先后服务于IBM研究院、阿尔卡特朗讯、奇安信(原360企业安全)集团等世界500强企业。

图片

现任某大型保险健康管理中心高级运营经理, 负责健康管理平台规划建.设与推广。先后服务于HITACHI集团、NTTDATA集团、奇安信(原360企业安全)集团等世界500强以及独角兽企业。敏捷实践倡导者,Atlassian产品粉丝。2018规模化敏捷峰会组委会成员。

中科院工程师、系统集成高级PM、PMP、CSM、CAL、Prince2、SAFe SA 、CMMI ATM。

图片

Xudong Liu 刘旭东

 

中国移动研究院信息技术及安全管理中心高级项目经理,负责企业研发相关工具建设及培训工作。

 

有近5年的Jira及Confluence的建设及培训经验,在中国移动内部构件多套基于Atlassian产品的研发工具链产品,帮助多个团队实现基于Atlassian产品的研发管理工作。

图片

闫锦

长期混迹信息安全圈。曾就职于某高校,作为项目管理负责人承担多项国家密码专项,以项目管理主管身份参与到科研项目管理中。

现就职于奇安信(原360企业安全)集团,担任研发学院运营负责人。

图片

现任某大型金融集团高级敏捷教练,为集团子公司提供敏捷转型咨询和实施服务。

曾多年供职于海外,有近十年的敏捷实践经验,精通精益敏捷方法论,熟悉规模化敏捷框架SAFe,认证SAFe Program Consultant。

在跨文化沟通与分布式团队管理方面具备丰富的经验,曾辅导过欧洲,美国和中国等多个团队和项目。

擅长使用以Atlassian产品为核心的DevOps工具链落地组织级敏捷转型,Atlassian中国用户社区创始人和Leader。

 


 

图片

你可能感兴趣的:(Atlassian社区,项目管理,jira,atlassian,devops)