Jira UI Locations及注意事项总结-编程知识

issue view ui locations : https://developer.atlassian.com/server/jira/platform/issue-view-ui-locations/#issue-operations-bar-locations
1.问题操作栏Issue Operations Bar Locations模块分为两部分: opsbar-operationsflopsbar-transitions两个location.共同定义了问题操作栏中的Web section和Web item,该操作栏在"View Issue"页面上可见。

1. 向现有Web section添加新item:若要将新的Web item添加到Jira的问题操作栏位置的现有Web section中, Web项必须包含一个section属性:
2. 要将Web item添加到opsbar-transitions位置, Web项目的section属性的值必须为**transitions-all**。在Web item定义中显式引用opsbar-transitions将不起作用
3. 自定义itemfUsection的位置:要将您自己的部分添加到"更多操作"下拉菜单中,需定义一个包含位置属性的Web section,其值为"opsbar-operations",向自己的section添加新 Webitem的方法类似于向现有Web section添加新Webitem的方法。将Web section的key属性的值指定为Web item的section属性的值。
4. Right Side of the 'View Issue' Page Location: atljira.view.issue.right.context location页面右侧的Web 面板定义了"查看问题"页面右侧的Web panel.

管理UI location(Administration Ul locations) :
顶部导航栏(Top navigation bar): system.admin.top.navigation.bar位置定义了Web section,这些Web部分显示在"管理"页面上的导航栏和下拉列表中:

一些预定义的section:

在预定义选项卡中创建一个新的section:
1. admin plugins menu位置定义了Jira管理区域的"ADD-ons加载项"选项卡中的Web section和item

在自定义选项卡创建一个新section:如果要创建新的自定义选项卡,则应创建一个包含system.admin.top.navigation.bar位置的Web section。然后按照上一节中的步骤操作,并使用自定义Tab的key而不是admin_plugins_menu

管理位置的现有 Web section (Existing web sections of the administration location):
Proiects

Issues

Add-ons

User Management

System
常规导航 UI 位置（General navigation Ul locations):
顶部导航栏位置(Top Navigation Bar Location) :
1. system.top.navigation.bar位置定义了JIRA顶部导航栏中的Web sectionsfitems,可从所有JIRA区域(JIRA的管理区域JRA’s administration area/模式mode除外)访问这些内容。
2. 可以将新的下拉菜单及其自己的Web section和Web item添加到此导航栏,也可以将新item添加到JIRA的现有下拉菜单中。
用户名下拉位置（User Name Drop-down Location)：
1. system.user.options位置定义了JIRA的用户名下拉菜单中的Web部分和项目,该菜单可从所有JIRA屏幕访问。
用户名下拉位置的现有 Web 部分(Existing Web Sections of the User Name Drop-down Location)：
- 预设问题过滤器项目摘要位置上的下拉列表（Preset Issue Filters Drop-down on Project Summary Location) :
  在JRA 4.0及更高版本中, system.preset.filters位置定义了JIRA项目的项目摘要页面上"筛选器Filters"下拉菜单中的Web item
- 悬停配置文件链接位置(Hover Profile Links Location)：
  user.hover.links位置在JIRA的悬停配置文件功能中定义Web item,当用户将鼠标指针悬停在整个JIRA用户界面中的JIRA用户名上时,可以访问该功能,
- 对话框提示位置(Dialog Box Hint Location)：
- jira.hints 位置定义了允许您在 JIRA 的对话框中添加提示的 Web item。可以向大多数JIRA 对话框添加提示。

2.添加自定义项:要将自己的Web item添加到JIRA的对话框提示特定对话框的位置,您的Web item必须包含一个值为"jira.hints/LOCATION_CONTEXT"的section属性,其中LOCATION_CONTEXT是JIRA中预定义的"context",用于确定您的提示将显示在哪个对话框中。
3. 下表列出了 JIRA的对话框提示位置中可用的预定义context：
在这里插入图片描述

例如，要添加在"Attach Files"对话框中定义提示的 Web 项模块，Web item模块将包含
<web-item… section=“jira.hints/ATTACH”…>
…

项目设置 UI 位置（Project settings Ul locations)：
- 项目配置管理位置（Project configuration administration location)：
  atl.jira.proj.config位置定义了在Jira的管理区域中查看项目配置时可用的Web section (对于选项卡组groups of tabs)和Web item (对于组中的各个选项卡for individual tabs within a group)可以向预定义的Web section (即选项卡组groups of tabs)添加新的Web item,也可以添加新部分及其自己的item。

在这里插入图片描述

要将自己的Web item添加到管理区域中Jira项目配置的现有Web section (即选项卡组) ,您的Web item必须包含一个值为"atljira.proj.config/existing_web_section_name"的section属性,其中existing_web_section_name是将向其添加Webitem的现有选项卡组。

下表列出了这些现有Web部分(按existing_web_section_name)以及与这些Web section关联的现有Webitem。与每个Web section和item关联的权重属性值在括号中表示。

若要添加一个Web item模块,该模块在projectgroup3 section中定义一个新item (该item显示在现有版本和组件Web项之间) , Web item模块应包含以下内容:

 <web-item key="my_new_tabbed_item_in_an_existing_project_group" ... section="at.jira.proj.config/projectgroup3" ... weight="15">...</web-item>

2.添加自定义section和item:

要将**自己的section添加到用户名下拉菜单中**,定义一个包含位置属性的Web section,其值为"atl.jira.proj.config"。
<web-section key="my-custom-group-of-tabs-section" ... location="atl.jira.proj.config" ...>
...
</web-section>
向**自己创建的section添加新Web item**的方法类似于向现有Web section添加新Web item的方法。需要在Web item的分区属性的值(前面是位置)中指定Web section的key属性的值。因此,根据前面的示例,您的Web项应包含以下内容:
<web-item key="my_new_tabbed_item_in_a_custom_project_group"... section="atl.jira.proj.config/my-custom-group-of-tabs-section" 
</web-item>

项目配置管理-摘要选项卡location (Project configuration administration-summary tab location) :

在Jira管理区域中查看项目配置的摘要选项卡时, webpanels.admin.summary.left-panels和webpanels.admin.summary.right-panels位置定义了HTML页面的各个panel/segment的Web panel.
webpanels.admin.summary.left-panels and webpanels.admin.summary.right-panels位置定义了此摘要选项卡的相应左侧和右侧的Web panel.

webpanels.admin.summary.left-panels:
在这里插入图片描述

webpanels.admin.summary.right-panels:
在这里插入图片描述

添加自定义面板：

要将您自己的 Web 面板添加到 Jira 项目配置管理的摘要选项卡位置，您的 Web 面板必须包含具有以下值之一的位置属性：
"webpanels.admin.summary.left-panels"- 在摘要选项卡页(summary tab page.)的左侧添加一个web panel.
"webpanels.admin.summary.right-panels"- 在摘要选项卡页面(summary tab page.)的右侧添加一个web panel.
例如,要添加一个Web panel模块,用于在摘要选项卡页的右侧定义一个新section,您的Web panel模块应包含以下内容:
<web-panel ... location="webpanels.admin.summary.right-panels" ...>...<label key="my-new-panel.title"/>
</web-panel>

*** 项目配置操作位置(Project configuration operations location)**：
system.view.project.operations location 位置定义了“操作(Actions)"下拉菜单的 Web 项。
添加自定义item:

要将自己的 Web item添加到 Jira 项目配置操作位置，Web item必须包含一个值为"system.view.project.operations"的section属性。
例如,若要添加在项目配置页上定义新项目操作链接的Web item模块, Web item模块应包含:
<web-item ... section="system.view.project.operations"...>
...
</web-item>