假如使用在这种场景下，开发负责人在业务上说需要修改一个名称变为：开发责任人，那么我们就需要将系统中所有用到这段代码的脚本都找到，来修改它的值。
或者我们通过以下方式这种方式来写 In this scenario, if the development leader says that it is necessary to change a name to: "Dev leader", then we need to find all the scripts in the system that use this code to modify its value.Or we can write it this way,
| customFieldManager.getCustomFieldObjec (123456L) |
|---|
在这种情况下也有可能这个字段被不小心删除，又重新创建；那么它的ID值也会发生变化，依然需要需要将系统中所有用到这段代码的脚本都找到，来修改它的值。
或者有以下情况，这个ID值或者名称，在我们的生产环境 或者测试环境并不一致，这样也会导致我们在测试环境 调试好的脚本，在拿到生产环境的脚本上一一变更这个值才能运行起来。
针对以上的上场景，使用此365娱乐场体育投注_365现金官网_365bet备用器下载 我们可以在里面定义一个固定的变量，这个变量的值可以快速的进行可视化的管理，修改这个值后系统中所有用一这个变更的全部都会生效，这样就方便我们统一来管理这些变量，达到可视化、全局化来管理我们系统中到处使用的变量脚本。
参数管理
Gears properties manager为了能够对全局性的参数进行科学管理，并方便管理人进行维护，比如管理员需要写入多个与第三方系统进行对接的参数，那么他可以将这些参数进行分组；
因此，对全局性分组，在此365娱乐场体育投注_365现金官网_365bet备用器下载 中将以前缀来进行区别；那么在对参数进行管理的时候，首先需要确定此参数应当归属哪一个前缀。
前缀信息
前缀信息是对全局性参数进行分组的一个定义，因此需要进行前缀的管理。
可以转到前缀信息中，对前缀进行增加管理。保存后将显示系统中已定义的前缀信息。
键值信息
键值信息是提供给业务使用的有效信息，允许在相应前缀中增加一个键值对，以便在系统中通过全键获取信息。
可以选择系统中定义的前缀查询此前缀中包括的所有键值对，当然对某一个键值对也可以进行修改操作。
如果需要在一个前缀中新增加一个键值对，那么可以新增一个，此时我们点击“新增”，即可弹出新增界面进行填写。
键值对使用
当对键值对进行定义新增加之后，那么可以在需要的地方获得它的信息，以便开展业务上的处理。
使用是，可以使用此类comIn this case, it is also possible that this field is accidentally deleted and re created; Then its ID value will also change. You still need to find all the scripts in the system that use this code to modify its value.
Or in the following cases, the ID value or name is inconsistent in our production environment or test environment, which will also lead to the script debugged in the test environment, and the script obtained from the production environment can only be run by changing this value one by one.
For the above scenarios, using this plug-in, we can define a fixed variable in it. The value of this variable can be quickly managed visually. After modifying this value, all the changes in the system will take effect, which makes it convenient for us to manage these variables in a unified way, so as to achieve visual and global management of variable scripts used everywhere in our system.
Parameters
In order to manage global parameters and facilitate the maintenance of managers, for example, if an administrator needs to write multiple parameters for interfacing with a third-party system, he can group by these parameters;
Therefore, the global grouping will be distinguished by prefix in this app; When managing parameters, you first need to determine which prefix for them .
Prefix
Prefix information is a definition of grouping global parameters, so prefix management is required.
You can navigate to the prefix information to add and manage prefixes. After saving, the prefix information defined in the system will be displayed.
Key-Value
Key-value is effective information provided for business use. It is allowed to add a key value pair to the corresponding prefix to obtain information through full key in the system.
You can select the prefix defined in the system to query all key value pairs included in this prefix. Of course, you can also modify a key value pair.
If you need to add a new key value pair to a prefix, you can add one. At this time, click "add" to pop up the add interface
Usage
When the key value pair is defined and newly added, its information can be obtained where needed for business processing.
Yes, you can use this kind of com.atlassian.jira.config.properties. ApplicationProperties，并使用它的getStringApplicationproperties and use its getText()方法。 method.
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
String value = applicationProperties.getString($fullkey) ; |
|
REST API
获得一个前缀所有的参数信息
接口Get all key-values information for a prefix
REST URL
/rest/gearsproperties/1.0/properties/prefix/{prefixkey}
- 方法Method
get
- 示例Example
/rest/gearsproperties/1.0/properties/prefix/ITDESK
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"fullkey": "HKTXPROPERTIESKEY.ITDESK.StaffId",
"prefix": "ITDESK",
"key": "StaffId",
"value": "1123"
},
{
"fullkey": "HKTXPROPERTIESKEY.ITDESK.key1",
"prefix": "ITDESK",
"key": "key1",
"value": "value11"
},
{
"fullkey": "HKTXPROPERTIESKEY.ITDESK.key2",
"prefix": "ITDESK",
"key": "key2",
"value": "value22"
}
] |
获得一个全Key参数信息
接口Get a value for a specific full key
- REST URL
/rest/gearsproperties/1.0/properties/fullkey/{fullkey}
- 方法Method
get
- 示例Example
/rest/gearsproperties/1.0/properties/fullkey/HKTXPROPERTIESKEY.ITDESK.StaffId
[
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"fullkey": "HKTXPROPERTIESKEY.ITDESK.StaffId",
"value": "1123"
} |
使用示例
我们还以“使用场景”中的示例来进行如何使用此365娱乐场体育投注_365现金官网_365bet备用器下载 。
定义变量值
首先我们在property365娱乐场体育投注_365现金官网_365bet备用器下载 中定义一个变量值（假定前缀是：SCRITRUNNER，KEY值为：DEV_OWNER）,那么它的Fullkey即为：API
First, we define a variable value by this app（ prefix is：SCRITRUNNER，KEY is ：DEV_OWNER） then its fullkey is：HKTXPROPERTIESKEY.SCRITRUNNER.DEV_OWNER ,其值为 value is：123456
脚本中取Your code may be like this
import com.atlassian.jira.config.properties.ApplicationProperties//CustomField devOwnerCustomfield = customFieldManager.getCustomFieldObjec (123456L) 将改造为： String devOwnerCustomfieldId = applicationProperties.getString("HKTXPROPERTIESKEY.SCRITRUNNER.DEV_OWNER") ; CustomField devOwnerCustomfield = customFieldManager.getCustomFieldObject(Long.parseLong(devOwnerCustomfieldId)); ApplicationUser devOwnerUser = issue.getCustomFieldValue(devOwnerCustomfield); |
|---|
业务修改
当我们在业务上需要调整，需要将原来取“开发负责人”(ID为：123456)，修改为去取“开发责任人”（ID为：654321）或者其它的值时，我们只需要在properties365娱乐场体育投注_365现金官网_365bet备用器下载 中，修改：SCRITRUNNER.DEV_OWNER 的值为 654321，即可完成业务的变更。
如果这类业务逻辑被 应用到N个脚本，我们只需要修改一处，即可完成N处的修改，减少了修改的工作量，也不至于漏掉某处而导致业务异常。