...
...
...
Warning |
---|
Looking for the documentation on the newest versions of SIL Engine and the Simple Issue Language for Jira 8 for Server/Data Center? Click here ! |
Managing Custom Field Mappings
Excerpt |
---|
SIL SIL™ custom field descriptors mappings are used to translate the custom field value into a valid SIL SIL™ value. |
Most of them are already mapped to a certain descriptormapping, but there are certain of them that are not, because we cannot guess in advance the types of custom fields you are using in your installation.
For those custom fields that are not mapped to a descriptor, the default descriptor mapping is used. This does not guarantee that the descriptor mapping is the proper one for the field, but it will attempt to determine the correct type by looking at the basic values it manipulates. Keep in mind that this may not be enough. For instance, a custom field may be represented internally by a number, but its real meaning is minutes. We cannot offer that interpretation, unless a descriptor is developed for that custom field (remember Shannon's Theory of Information? data != information).
Info |
---|
Our team is available to add more descriptorsmappings. If you believe a descriptor mapping is really needed, let us know. |
To access the custom field descriptors page mappings page go to cPrime Plugins Configuration -> Custom Field DescriptorsMappings:
For known fields, descriptors are not configurable because we want to prevent accidental modification. However, for unknown custom fields, you may click the Edit button and set a real descriptor:
Factories (Custom Field
...
Mappings)
The following factories (custom fields descriptorsmappings) are bundled in by default. They act like translators, hence the notation Jira native type -> SIL SIL™ Type.
- Default
This descriptor determines the SIL representation of the custom field based on the type of its value. - Boolean -> boolean
Translates a boolean to its SIL internal representation. - Interval -> interval
Translates an interval to its SIL internal representation. The custom field value can either be the user friendly string representation (1d 2h) or the number of seconds. - User[] -> string []
Translates a collection of Users to a string array. The collection can also be represented as a single string with values separated by a pipe (|). The values represent the usernames. - Group -> string
Translates a group to a string value representing the group name. - Number[]-> number []
Translates a collection of numbers to a number array. The collection can also be represented as a single string with values separated by a pipe (|). - Option-> string
Translates an option to a string value. - Number -> number
Translates a number to its SIL internal representation. - Boolean[]-> boolean[]
Translates to an array of boolean values. Custom field value can be a collection of boolean values or their string representation separated by a pipe (|). - Date[] -> date []
Translates a collection of dates to a date array. The collection can also be represented as a single string with values separated by a pipe (|). - Date -> date
Translates a date value to its SIL internal representation. - User -> string
Translates a user to a string value representing the username. - Label[] -> string []
Translates labels custom field to a string array containing the labels as strings. - String -> String
Translates to a string value. - Interval[] -> interval []
Translates a collection of intervals to an interval array. The collection can also be represented as a single string with values separated by a pipe (|).
The interval values can be represented either in a user-friendly string form (1d 2h) or in seconds. - Group[] -> string []
Translates a collection of Groups to a string array.
The collection can also be represented as a single string with values separated by a pipe (|).The values represent the group names. - Cascade -> string []
Translates to an array of string values. First is key, second is value. - Collection(String) -> string []
Translates a collection of string values to a string array.
The collection can also be represented as a single string with values separated by a pipe (|).
Note |
---|
Each app may add its own factories. The system is pluggable, so anyone can write new custom field descriptors apps and add support to the SIL SIL™ language for them. Don't be surprised if you see more descriptors. |
...