"urlValidator"
Configures the custom URL Wiki and Wiki Link/URL fields.
Wiki markup and Wiki Link/URL fields can contain valid URLs like "https://codebeamer.com," provided in markup as [https://codebeamer.com].
Users might sometimes want to use:
• Custom URLs like "skype:username?call"
• URLs with custom schemes like "doors://codebeamer.com/mydoorspoint".
Example
"urlValidator": {
"schemes": "doors,myscheme",
"regexp": "skype:[a-z][a-z0-9\\.,\\-_]{5,31}\\?call",
"allowedCustomTLDs": "local,corpdomain"
},
Properties
|
Property Name
|
Description
|
||
|---|---|---|---|
|
"schemes"
|
A comma-separated list of custom URL schemes.
In the example, the doors,myscheme property value means that doors or myscheme schemes are allowed. For example: doors://codebeamer.com:7892/?version=3&view=0000030 or myscheme://codebeamer.com?file=dat. The rest of the URL must still be valid, similar to a standard HTTP URL. Only the scheme might vary.
|
||
|
"regexp"
|
A valid regular expression, so URLs matching the expression are accepted. Exercise caution with your definition of the regular expression. Avoid creating a very open regular expression.
If you specify schemes and regexp in the configuration, the URLs matching both rules are accepted.
|
||
|
"allowedCustomTLDs"
|
A comma-separated list of the custom top-level domains (TLDs) that are permitted, such as local and corpdomain. For example, https://something.corpdomain:8080/cb/?version=3&view=0000030 or https://something.locale:8080/cb/git.
|
Additional Information
The JSON example in the Example section allows URLs as follows:
doors://codebeamer.com:7892/?version=3&view=0000030
skype:askypeuser?call
The standard URLs and schemes like "https://codebeamer.com" are always accepted and these cannot be disabled.
The example cited is of a simplified regular expression which accepts simple Skype URLs like "skype:skypeuser?call". For a more complete Skype URL regular expression, see: https://github.com/kevva/skype-regex/blob/master/index.js.