jira7经过全局js给编辑区自定义快捷键【原】

时间 2020-07-09

标签 jira7 jira 经过全局编辑自定义快捷键栏目 JavaScript 繁體版

原文原文链接

jira7编辑区自定义快捷键

本文主要描述了jira7如何经过添加全局js引用,给文本编辑区自定义快捷键用以快速填充模板内容.javascript

jira 3/4/5可参考官方api https://developer.atlassian.com/server/jira/platform/adding-javascript-to-all-pages-for-google-analytics/ (未作过实验)java

第1步--备份web.xml文件

注意这一步比如下两部更重要, 当web.xml改错会致使jira没法启动让人欲哭无泪 , 当心驶得万行船, 万一出错, 还能还原.jquery

第2步--修改web.xml文件

该文件位于"C:\Program Files\Atlassian\JIRA\atlassian-jira\WEB-INF\web.xml"git

删除web.xml中的含有如下17个名称对应的servlet-mapping,web

由于如下jsp文件中都包含了<%@ include file="/includes/decorators/aui-layout/head-resources.jsp" %>,api

至于为什么包含了head-resources.jsp要删除servlet-mapping目前彻底意义不明,浏览器

如此操做来源于https://jira.atlassian.com/browse/JRASERVER-59587 jira的feedback, 另外该feedback还说起须要删除head-resources.jsp对应的servlet-mapping,但本人不删仍正常.服务器

 1 /displayError.jsp:  2 /decorators/navigator.jsp:  3 /decorators/admin.jsp:  4 /decorators/general.jsp:  5 /decorators/popups.jsp:  6 /decorators/printable.jsp:  7 /decorators/onboarding.jsp:  8 /decorators/message.jsp:  9 /decorators/issueaction.jsp: 10 /decorators/general-head-pre.jsp: 11 /decorators/blank.jsp: 12 /decorators/error.jsp: 13 /decorators/userprofile.jsp: 14 /decorators/panel-admin.jsp: 15 /decorators/panel-general.jsp: 16 /decorators/content-panel-only.jsp: 17 /decorators/login.jsp:

上一步的具体意思为删除web.xml中的如下17个servlet-mapping,默认折叠请自行展开, 注意它们在web.xml并不是都以下排在一块儿,须要您手动搜索后当心删之.网络

<servlet-mapping>
    <servlet-name>jsp.displayError_jsp</servlet-name>
    <url-pattern>/displayError.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.navigator_jsp</servlet-name>
    <url-pattern>/decorators/navigator.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.admin_jsp</servlet-name>
    <url-pattern>/decorators/admin.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.general_jsp</servlet-name>
    <url-pattern>/decorators/general.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.popups_jsp</servlet-name>
    <url-pattern>/decorators/popups.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.printable_jsp</servlet-name>
    <url-pattern>/decorators/printable.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.onboarding_jsp</servlet-name>
    <url-pattern>/decorators/onboarding.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.message_jsp</servlet-name>
    <url-pattern>/decorators/message.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.issueaction_jsp</servlet-name>
    <url-pattern>/decorators/issueaction.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.general_002dhead_002dpre_jsp</servlet-name>
    <url-pattern>/decorators/general-head-pre.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.blank_jsp</servlet-name>
    <url-pattern>/decorators/blank.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.error_jsp</servlet-name>
    <url-pattern>/decorators/error.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.userprofile_jsp</servlet-name>
    <url-pattern>/decorators/userprofile.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.panel_002dadmin_jsp</servlet-name>
    <url-pattern>/decorators/panel-admin.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.panel_002dgeneral_jsp</servlet-name>
    <url-pattern>/decorators/panel-general.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.content_002dpanel_002donly_jsp</servlet-name>
    <url-pattern>/decorators/content-panel-only.jsp</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>jsp.decorators.login_jsp</servlet-name>
    <url-pattern>/decorators/login.jsp</url-pattern>
</servlet-mapping>

View Code

第3步--修改head-resources.jsp文件

该文件位于 "C:\Program Files\Atlassian\JIRA\atlassian-jira\includes\decorators\aui-layout\head-resources.jsp" app

第3.1步--外网版 (若是公司全员都能连外网,建议用该版)

在head-resources.jsp文件末尾添加一行语句以下

<script type="text/javascript" src="https://gitee.com/KingBoBo/codes/wijfrq2utahc9k05o3nby72/raw?blob_name=jira-header-extension.js" charset="utf-8"></script>

其中https://gitee.com/KingBoBo/codes/wijfrq2utahc9k05o3nby72/raw?blob_name=jira-header-extension.js 这个地址指向的是互联网上的一个js文件,用于给全局的jira页面添加js效果.

jira-header-extension.js文件内容参考以下:

$(function(){ //jira7.2使用jquery-1.7.2.min.js，须要用live,这里用on效果没法彻底发挥,jquery1.9以后用on比较稳妥
    //http://blog.csdn.net/aya19880214/article/details/39998117
    $("textarea").live("keydown",function(e) { var ev = window.event || e; var code = ev.keyCode || ev.which; console.log("King "+code + " | "+ e.ctrlKey); if(e.ctrlKey){ switch(code){ case 49://1
                      alertHelp(this);//友情提示
 preventDefaultEvent(ev); break; case 50://2
                      createIssue(this);//建立问题
 preventDefaultEvent(ev); break; case 51://3
                      handleProblem(this);//处理问题
 preventDefaultEvent(ev); break; case 52://4
                      testAllGood(this);//测试彻底经过
 preventDefaultEvent(ev); break; case 53://5
                      testPartGood(this);//测试部分经过
 preventDefaultEvent(ev); break; case 54://6
                      testAllBad(this);//测试全不经过
 preventDefaultEvent(ev); break; case 55://7
                      waitingForYou(this);//待定
 preventDefaultEvent(ev); break; case 56://8
                      waitingForYou(this);//待定
 preventDefaultEvent(ev); break; case 57://9
                      waitingForYou(this);//待定
 preventDefaultEvent(ev); break; case 48://0
                      waitingForYou(this);//待定
 preventDefaultEvent(ev); break; default: break; } } }); }) function wikiEditExistAndEmpty(wikiEdit){ var target = $(wikiEdit); if(target.length != 0){ if(target.val().trim() == ""){ return true; }else{ return false; } }else{ return false; } } function alertHelp(wikiEdit){//友情提示
    alert("【友情提示】空文本才触发如下模板填充效果 \n ctrl+2 : 建立问题 \n ctrl+3 : 处理问题 \n ctrl+4 : 测试彻底经过\n ctrl+5 : 测试部分经过\n ctrl+6 : 测试全不经过\n "); } function createIssue(wikiEdit){//建立问题
    if(wikiEditExistAndEmpty(wikiEdit)){ $(wikiEdit).val("登录帐号：\n"+
        "机构：填写出单机构\n"+
        "产品：涉及产品\n"+
        "单号：例如：对车承保来讲，写投保单号/保单号；没有单号的，写清楚车架号\n"+
        "问题描述：\n"+
        "重现步骤：\n"+
        "实际结果：（可选）\n"+
        "预期结果：\n"+
        "SQL："); } } function handleProblem(wikiEdit){//处理问题
    if(wikiEditExistAndEmpty(wikiEdit)){ $(wikiEdit).val("{panel:title=开发修改记录1| borderStyle=dashed| borderColor=#ccc| titleBGColor=#C0C0C0| bgColor=#87CEFA}\n"+
        "- *问题描述*\n"+
        "- *解决方法*\n"+
        "- *提交内容* \n"+
        "-- *数据脚本*\n"+
        "-- *自测单号*\n"+
        "{panel}"); } } function testAllGood(wikiEdit){//测试彻底经过
    if(wikiEditExistAndEmpty(wikiEdit)){ $(wikiEdit).val("{panel:title=测试彻底经过反馈 修改记录1| borderStyle=dashed| borderColor=#C0C0C0| titleBGColor=#C0C0C0| bgColor=#00FF7F}\n"+
        "*测试经过* (/)\n"+
        "*测试内容*: \n"+
        "出单机构：浙江分公司\n"+
        "工号：133501773\n"+
        "单据号：2993301010220170000019\n"+
        "*简单描述测试覆盖的场景*\n"+
        "{panel}"); } } function testPartGood(wikiEdit){//测试部分经过
    if(wikiEditExistAndEmpty(wikiEdit)){ $(wikiEdit).val("{quote}\n"+
        "{panel:title=测试部分经过反馈 修改记录1 |borderStyle=dashed| borderColor=#ccc| titleBGColor=#ccc| bgColor=#FFE4C4}\n"+
        "- *测试内容*  \n"+
        "\n"+
        "- *遗留问题列表* \n"+
        "-# 问题1  \n"+
        "-# 问题2  \n"+
        "- *遗留问题BUG*\n"+
        "-# JIRA号\n"+
        "{panel}"); } } function testAllBad(wikiEdit){//处理全不经过
    if(wikiEditExistAndEmpty(wikiEdit)){ $(wikiEdit).val("{panel:title=测试全不经过反馈 修改记录-01| borderStyle=dashed| borderColor=#ccc| titleBGColor=#C0C0C0| bgColor=#FFC0CB}\n"+
        "- *测试内容*\n"+
        "\n"+
        "- *问题列表* \n"+
        "-# 反馈问题1\n"+
        "-# 反馈问题2\n"+
        "- *反馈问题BUG*\n"+
        "新建JIRA号\n"+
        "{panel}\n"); } } function waitingForYou(wikiEdit){//waiting宝贵建议
    if(wikiEditExistAndEmpty(wikiEdit)){ $(wikiEdit).val("ctrl+7/8/9/0 模板征集中,您有任何珍贵的建议,请联系【逸檀 or 英姿】."); } } function preventDefaultEvent(ev){//阻止浏览器默认事件
    if (ev.preventDefault) { ev.preventDefault(); ev.stopPropagation(); } else { ev.keyCode = 0; ev.returnValue = false; } }

View Code

以后若有新的页面需求,您能够引用一个新的js文件用以扩展或修改功能.

第3.2步--内网版 (若是公司有人不能连外网,建议用该版)

在head-resources.jsp文件末尾添加一行语句以下

<script type="text/javascript" src="<%=request.getContextPath()%>/static/king/js/jira-header-extension.js" charset="utf-8"></script>

把3.1外网版的jira-header-extension.js内容复制到C:/Program Files/Atlassian/JIRA/atlassian-jira/static/king/js/jira-header-extension.js , 其中static文件夹后的/king/js/jira-header-extension.js须要本身建文件夹和文件. 而后使用文本编辑器另存为UTF-8版 , 最后在浏览器打开jira地址 http://localhost:8080/static/king/js/jira-header-extension.js ,只要能正常打开,且不乱码,那么基本上是成功了.

以后若有新的页面需求,您能够引用一个新的js文件用以扩展或修改功能.

经屡次测试,在内网版的 head-resources.jsp文件中<script ....... charset="utf-8"></script> 的charset使用"utf-8"和charset="gb2312" 均可以,甚至能够不指定, 由此推测 jira项目的filter层可能默认对资源文件作了utf-8编码转换, 因此只要文件自己是utf-8格式的,那么charset 就不关心了.

此外内网版还存在一个"偶发性"问题

当修改jira-header-extension.js文件后, 若是在浏览器打开jira地址 http://localhost:8080/static/king/js/jira-header-extension.js 看到的仍是未修改前的旧文件,那么咱们须要作如下2步操做:

将head-resources.jsp文件末尾一行的src="...jira-header-extension.js"修改为src="...jira-header-extension-newName.js"
C:/Program Files/Atlassian/JIRA/atlassian-jira/static/king/js/jira-header-extension.js 复制并命名成jira-header-extension-newName.js

而后刷新jira页,面便可看到加载了新的jira-header-extension2.js. 方法自创, 但缘由不明, 猜想是jira可能只会加载一次static目录下的静态资源文件,就算重启有时候也仍是旧的, 须要让head-resources.jsp引用一份新的js 或直接访问 http://localhost:8080/static/king/js/jira-header-extension-newName.js 以加载新资源.

第3.3补充--内外网版优缺点分析

笔者更偏向于外网版.

外网版

优势: 有新需求时,只要改动相关网站以前上传的js文件,而不须要再去找jira 服务器上C:/Program Files/Atlassian/JIRA/atlassian-jira/static/king/js/jira-header-extension.js 文件了, 至关于彻底独立于jira
缺点: 不能连外网时,会致使js无效,而且<script>加载该外网地址时较卡.

肉网版:

优势: 稳定, 不担忧网络问题
缺点: 有新需求时,定位该文件稍微麻烦点,须要记住该路径, 文件改动后常常不生效,缘由不明,不生效时须要引用新的js

第4步--重启jira

重启jira的只针对"第2步--修改web.xml文件" 以后才须要操做. 第3步的操做实际上是不须要重启jira的.

效果演示

当指针焦点在编辑区时,按ctrl+1能够弹出【友情提示】效果，按ctrl+2/3/4/5/6/7/8/9/0时能够给非空状态的编辑区填充模板.

碰见问题

开发过程碰见如下问题,均可以先还原再重来.

web.xml配置错误致使jira没法启动
head-resources.jsp中引用的js语法严重错误的时候致使全部jira界面没法打开

改版后的文件

百度网盘: https://pan.baidu.com/s/1kVZRj6J

扩展

若是彻底理解上文,现想要在编辑区添加自定义按钮(请自行思考,同理).