String

Property Type: string‌
Strings represent a text value and can be configured with validators to limit input using regular expressions, and to enforce minimum and maximum lengths.‌
Property Options
Name
Type
Default
Description
trim
boolean
false
Trims the input string prior to validation but after writers.
lowercase
boolean
false
Lowercase the input string prior to validation but after writers.
uppercase
boolean
false
Uppercase the input string prior to validation but after writers.
localization
document
​Content
String localization options. Note: Although query matching for localized string values is possible, some cases (like $elemMatch) are not supported.
localization.enabled
boolean
false
Enable localization for the string values. Reading and writing to the property occurs on the current locale or the options below. When any string in an object definition is localized, a locales property document appears in the instance. Inside it, each localized string property is represented by an array of documents containing each locale and value that have been written ({locale: 'en_US', value: 'foo'}). Note: Once enabled, localization on a string cannot be disabled.
localization.valid
string[]
[]
Limits writing to a set of locales. Leaving this empty allows all org-level valid locales.
localization.fixed
string
''
Limit the native string property to reading and writing this locale. For reading, the fallback option still applies.
localization.strict
boolean
true
For reading and writing, throw an error if the selected locale is invalid. When false, the fallback option is used to attempt to return a fallback value.
localization.fallback
boolean
true
For reading, fallback to any usable locale value when none exists for the requested locale.
localization.acl
document[]
[]
A set of acl entries to apply to direct reading and writing of the locales-prefixed string property document array.
localization.readAccess
number
4 (read)
The resolved access level required to read the locales-prefixed property document array.
localization.writeAccess
number
6 (update)
The resolved access level required to update the locales-prefixed property document array.
localization.aclOverride
boolean
false
When true, the acl entries that are applied to the locales-prefixed property document array are applied from scratch to the caller, instead of augmenting their current access level.
‌
Property Validators
‌
Required name: required‌
String Validator name: string definition:
Name
Type
Default
Description
min
integer
0
Minimum length of string
max
integer
​Content
Maximum length of string
allowNull
boolean
false
Allow null values
allowEmpty
boolean
false
Allow 0-length strings
‌
Printable String Validator name: printableString definition:
Name
Type
Default
Description
anyFirstLetter
boolean
true
Allow the first letter of the string to be non-alphanumeric.
allowNumberAsFirstLetter
boolean
true
Allows a number as the first letter of the string.
min
integer
0
min length
max
integer
​Content
max length
‌
String Enum Validator name: stringEnum definition:
Name
Type
Default
Description
values
array
​Content
An array of possible entries.
‌
Email Validator name: email definition:
Name
Type
Default
Description
allowNull
boolean
true
Allow blank or null entries
‌
Locale Validator name: locale definition:
Name
Type
Default
Description
allowNull
boolean
false
Allow blank or null entries
‌
Password Strength Validator name: passwordStrength definition:
Name
Type
Default
Description
minScore
integer
​Content
The minimum password score requirement (based on zxcvbn)
‌
Phone Number Strength Validator name: phoneNumber definition:
Name
Type
Default
Description
allowNull
boolean
false
Allow null entries.
requireMobile
boolean
false
If true, requires the number to be a mobile number.
allowedCountries
array or strings
​Content
List of allowed countries
‌
URL Validator name: url definition:
Name
Type
Default
Description
allowNull
boolean
false
Allow null values
allowEmpty
boolean
false
Allow 0-length strings
webOnly
boolean
true
Url must be a web url, beginning with http:// or https://
webSecure
boolean
​Content
Applies when webOnly is true. If present, url must either be https:// (true) or http:// (false). Omitting this property allows either.
‌
Pattern Validator name: pattern definition:
Name
Type
Default
Description
allowNull
boolean
false
Allow null values
allowEmpty
boolean
false
Allow 0-length strings
pattern
regex
​Content
The regex pattern to test against the incoming string value

Last modified 2yr ago

Name	Type	Default	Description
trim	boolean	false	Trims the input string prior to validation but after writers.
lowercase	boolean	false	Lowercase the input string prior to validation but after writers.
uppercase	boolean	false	Uppercase the input string prior to validation but after writers.
localization	document	Content	String localization options. Note: Although query matching for localized string values is possible, some cases (like $elemMatch) are not supported.
localization.enabled	boolean	false	Enable localization for the string values. Reading and writing to the property occurs on the current locale or the options below. When any string in an object definition is localized, a `locales` property document appears in the instance. Inside it, each localized string property is represented by an array of documents containing each locale and value that have been written (`{locale: 'en_US', value: 'foo'}`). Note: Once enabled, localization on a string cannot be disabled.
localization.valid	string[]	[]	Limits writing to a set of locales. Leaving this empty allows all org-level valid locales.
localization.fixed	string	''	Limit the native string property to reading and writing this locale. For reading, the fallback option still applies.
localization.strict	boolean	true	For reading and writing, throw an error if the selected locale is invalid. When false, the fallback option is used to attempt to return a fallback value.
localization.fallback	boolean	true	For reading, fallback to any usable locale value when none exists for the requested locale.
localization.acl	document[]	[]	A set of acl entries to apply to direct reading and writing of the locales-prefixed string property document array.
localization.readAccess	number	4 (read)	The resolved access level required to read the locales-prefixed property document array.
localization.writeAccess	number	6 (update)	The resolved access level required to update the locales-prefixed property document array.
localization.aclOverride	boolean	false	When true, the acl entries that are applied to the locales-prefixed property document array are applied from scratch to the caller, instead of augmenting their current access level.