JIRA配置手册 (3)—— 字段和界面

在前面我们简单介绍了问题类型和工作流的配置方法,今天我们来聊一聊字段和界面这两个互相依赖的家伙。

界面即Issue展示给用户可见的表单页面,分为创建界面、查看界面和编辑界面。而界面上存在的表单项则称为字段,可以设置这些项是数字、文字、还是图片,以及这些项在界面中是必选、可选,或者是隐藏。

这两个家伙是相互强影响的,因此在这一篇中一起介绍。

* 注:以下配置基于 JIRA 7.1.9

一、字段

我们已经知道如何在项目中建立问题类型和设置这些问题类型的工作流,但是这些问题的状态和内容如何清晰的展示给用户呢?

比如创建问题的时候,界面需要展示哪些内容来明确标识问题的相关信息?选择问题类型之后,如何表述问题的具体内容?所属模块、解决版本等信息都在哪体现呢?这些都需要通过界面和字段进行定义。

当我们创建界面时,需要规定这个界面上显示给用户可见的字段信息,这些字段信息需要预先进行定义。

1.1 创建字段

以管理员身份进入后台管理,在问题模块左导航中选择自定义字段,显示如下:

图 1 创建字段

点击添加自定义字段按钮,显示选择字段类型对话框:

图 2 选择类型

这里出现的字段类型多少,依赖于你的系统,如果觉得不够,可以通过安装一些 JIRA 插件来扩充,按需选择期望的字段类型。

假设我们选择文本框,点击下一页,显示配置字段详情对话框。

图 3 添加文本框

输入字段的名称(即将来展示在界面的名称),点击创建按钮,完成创建。

创建完成后会跳转到字段关联界面的列表中,列表展示目前可以选择的全部界面,后面有选择框可以快速批量勾选添加。但是由于在这里勾选添加的字段会显示在所选界面的最上面,没有在界面上进行过排序,因此一般不建议在这里进行界面与字段关联操作。

1.2 创建字段配置

字段配置即设置在创建某个问题类型的 Issue 时,界面展示和操作的字段有哪些,这些字段是必选还是可选,是隐藏还是显示等等的字段特性。

我们可以在后台管理问题模块的左导航,选择字段配置,进入到字段配置列表页。

图 4 字段配置列表

在右上角点击:添加字段配置按钮,显示添加字段配置弹框,输入字段配置名称(SCman),点击增加按钮即可。

图 5 添加字段配置

点击增加按钮之后,跳转到查看字段配置界面。

当然,如果只是为了解耦或者微调少量字段,也可以通过点击已有字段配置右侧操作中的复制按钮进行复制来创建新的字段配置,根据需求选择方式吧。

字段配置主要是规划每个字段的状态,可以对可用字段进行相关设置,如是否必选,是否隐藏等,也可以在这个字段中增加使用说明,以便在在界面上给予用户明确的提示。

以下简单说一下常用的几个功能:

图 6 配置字段设置

名称:会显示是否可选,附加一些提示信息以及界面显示的样式信息;

界面:显示这个字段目前已经被应用到的界面列表;

操作:

(1)编辑:修改字段配置的描述信息;

(2)隐藏:设置这个字段在界面是否为隐藏;

(3)必选项:设置这个字段在界面上是自选项还是必选项;

(4)界面:点击后会进入界面列表,可以将这个字段配置批量增加到多个界面里去,通常会自动增加到界面的最底端;

(5)渲染器:设置这个字段在界面里的表现形式;

1.3 创建字段配置方案

通过前面的学习,应该能够看到一点端倪,JIRA 中的配置套路就是首先创建独立个体,然后组成方案,再将方案应用于项目使之生效。

字段配置定义完成后,需要将这个方案指定给具体的问题类型,指定后每当创建该问题类型时,界面就可以依据字段配置的规则来进行显示了。

字段配置方案就是将字段配置和问题类型进行绑定的方案。

进入后台管理问题模块,在左导航中选择字段配置方案:

图 6 字段配置方案列表

点击添加字段配置方案,显示添加字段方案会话框,输入名称,点击增加按钮,即创建方案成功。

图 7 添加字段配置方案

点击增加按钮之后,跳转到字段配置方案详情页,表示已创建方案成功。

接下来需要将这个方案和问题类型关联,我们点击将问题类型与字段配置方案关联的按钮,选择问题类型和字段配置,点击增加按钮。

图 8 关联字段配置方案

点击增加按钮之后,跳转到本方案配置界面,显示已配置的内容。

图 9 显示配置内容

可以看到,“下个版本”这个问题类型关联了SCman 字段配置了。

1.4 字段配置方案关联项目

字段配置方案配置完成后,我们需要将它应用到具体的项目中。

可以在项目菜单中找到目标项目,点击项目名称,进入到概要界面里,在侧导航中选择字段。

图 10 字段配置方案关联项目

点击右上角行为下拉框,选择使用不同方案选项,进入方案切换界面。

选择刚才我们创建配置好的字段方案,点击关联按钮,即关联成功。

图 11 关联字段方案

点击关联按钮之后,页面跳转回字段配置方案详情页。

图 12 字段配置方案详情页

可以看到结果,已经将项目和字段方案进行关联了。

二、界面

以上定义了每个类型的问题中的字段有哪些、如何展示。那么这些问题展现的界面应该包括哪些项,在问题根据对应的工作流流转时的界面如何,这些需要通过界面来进行配置。

2.1 创建界面

我们可以在后台管理问题模块的左导航中,选择界面,进入到查看界面页。点击右上角添加按钮创建问题的界面:

图 13 创建界面

点击添加界面按钮,显示创建界面的会话框,输入界面名称,我们命名为:SCView,点击增加按钮。

图 14 创建界面

以上弹框点击增加按钮后,即跳转到配置界面中。

图 15 配置界面

我们可以在字段标签页下方选择在这个界面里应该包括的字段信息,选择好可以通过上下拖动的方式进行字段前后排序。

本次我们简单的配置以下信息:

图 16 配置信息

这样,一个界面已经创建并配置完成。

说明:如果有界面对 Tab 需要的话,可以在这个界面中选择增加字段卡,在实际的界面中可以出现 Tab 切换的效果。如果存在多个卡,tab 的名称可以通过字段标签页进行编辑。

2.2 创建界面方案

和字段一样,创建的界面也需要将其指定到具体的问题类型中。当然,一个界面可以指定到不同的问题类型中。

我们在后台问题模块下左导航中,选择界面方案,定义一个界面方案,如下图:

图 17 创建界面方案

点击添加界面方案按钮,显示添加界面方案对话框。输入名称(SChtml),点击增加按钮。

图 18 添加界面方案

点击增加按钮后,进入到这个界面方案的配置页,会显示默认的界面方案。

图 19 界面方案配置页

点击右上角将问题操作与界面关联按钮,显示关联对话框,此操作表示将问题与操作界面绑定。

图 20 问题与界面关联

我们需要配置的信息就是指定问题类型的不同操作(创建、编辑、查看)分别对应哪一个界面。

点击增加按钮,进入到配置界面:

图 21 配置界面

可以看到我们已经把创建问题的界面设置为使用SCView 界面,同理也可以设置编辑使用哪个界面,查看使用哪个界面,在实际的情况中可以通过创建多个界面来做不同的展示和选择。

图 21 配置界面

在这里可以很清楚的看到,各个操作都引用的是哪一个界面。

2.3 创建问题类型界面方案

配置好界面方案,接着针对一个项目,需要将这个项目所有的问题类型每一个类型关联一个界面方案。

问题类型界面方案主要是将一组定义好的界面方案指定到不同的问题类型中。 

我们到后台管理中问题模块左导航,选中问题类型界面方案,如下图:

图 22 创建问题类型界面方案

点击界面右上角:添加问题类型界面方案,我们新增一个方案,然后选择刚才我们在界面方案中定义并配置好的界面配置方案:SChtml,点击增加按钮。

图 23 添加问题类型界面方案

注意:这个方案是作为未映射问题类型的界面方案,如果该项目中的某些类型没有指定具体的界面方案,将采用这个界面方案作为默认的方案。

点击增加按钮后,即转入到问题类型界面方案中具体的配置界面里,我们点击界面右上角:将问题类型与界面方案关联按钮,显示关联对话框。

图 24 关联问题类型界面方案      

在弹出的关联对话框中选择问题类型和我们已创建的界面方案,点击增加按钮即关联成功。

图 25 关联问题类型界面方案

点击增加按钮,跳转回配置问题类型的界面方案详情页。

图 26 关联问题类型界面方案      

以上表示这样问题类型界面方案便配置好了。

2.4 问题类型界面方案关联项目

问题类型界面方案配置完成后,需要将它应用到具体的项目中。

我们可以在后台管理项目模块中找到目标项目,点击项目名称,进入到概要界面里,在侧导航中选择界面:

图 27 问题类型界面方案关联项目

点击右上角行为下拉框,选择使用不同方案选项,则跳转到关联问题类型界面方案详情页中,选择已创建的界面方案,点击关联按钮。

图 28 关联问题类型界面方案

点击关联按钮之后跳回到界面配置方案详情页,显示已关联的界面。

图 29 已关联的界面

可以通过创建问题查看以上我们已完成的相关配置。

三、坑点

注意界面和字段是相辅相成的,当你的界面里面选择的字段在字段配置里面设置为隐藏等状态,那么在界面中是不可查看的,一定是他们的交集才能正常使用,请再三检查哦。

emmm,字段就像可重复使用的一堆字母,界面就像一个个口袋,比如界面1的口袋里面放了字段 ABC,界面2的口袋里面放了字段 AB,界面3的口袋里面放了 ACD,只有当你启用了字段配置让本次配置中的每个字段都有效的情况下,应用哪个界面,就可以看到对应界面口袋里有的字段值了。

好了,今天就扯到这里,下一次要不讲讲权限吧?

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,602评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,442评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,878评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,306评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,330评论 5 373
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,071评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,382评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,006评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,512评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,965评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,094评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,732评论 4 323
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,283评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,286评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,512评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,536评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,828评论 2 345

推荐阅读更多精彩内容

  • 本文按照以下两个要求,来实现问题类型的界面设置 1、”软件Item “的问题类型,创建时必须包含自定义字段 “It...
    viky_lyn阅读 16,525评论 1 6
  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,599评论 18 139
  • 成长过程痛苦并快乐着,我们都需要一份勇气给25岁的自己。 01 路过一家饭店,闻到了13年前熟悉的饭菜香。 初中食...
    小妖耳子阅读 211评论 0 0