Table of Contents

Entity properties

Entity properties are members of an entity. They are used to define the data on the entity.

Type of entity property

There are several types of entity property :

  • Scalar properties are properties whose actual values are contained in the entity. A property of an entity is a single field in the model.
  • Navigation properties allow you to navigate from the current entity to another one. There are two types of navigation properties :
    • Reference properties are, like their name suggest, a reference to another entity.
    • Collection properties are the other side of reference properties. They represent a collection of entities of a certain type that reference the entity containing the collection property

To learn more about the references and collections, we invite you to consult the following article.

Attributes

Character casing

The character casing of the property applied to the string content. It can be defined using the Character casing property of string properties. The following values are supported:

  • Normal: The case of characters is left unchanged
  • lower casing: Converts all characters to lowercase
  • UPPER CASING: Converts all characters to uppercase
  • camelCasing: Converts all characters to camelCasing (all spaces are removed and the next character is capitalized)
  • PascalCasing: Converts all characters to PascalCasing (all spaces are removed and the next character is capitalized)

On the server side (entity and entity views), a check will be automatically generated to ensure that the value entered complies with the expected casing. This property can also be defined on the entity view property and the UI view property.

Format

This attribute allows you to format the value (number or date and time) of the property. The format is applied to the value displayed in the UI view. The format string is expressed as .NET-style.

Standard numeric format strings

"C" or "c" Currency: The currency symbol is determined by the current culture.

  • 123.456 ("C", en-US) -> $123.46
  • 123.456 ("C", fr-FR) -> 123,46 €

"E" or "e" Exponential (scientific): Exponential notation.

  • 1052.0329112756 ("E", en-US) -> 1.052033E+3
  • 1052.0329112756 ("e", fr-FR) -> 1,052033e+3

"N" or "n" Number: Integral and decimal digits, group separators, and a decimal separator with optional negative sign.

  • 1234.567 ("N", en-US) -> 1,234.57
  • -1234.56 ("N3", en-US) -> -1 234,560

Standard date and time format strings:

"d" Short date pattern.

  • 2009-06-15T13:45:30 -> 6/15/2009 (en-US)
  • 2009-06-15T13:45:30 -> 15/06/2009 (fr-FR)

"D" Long date pattern.

  • 2009-06-15T13:45:30 -> Monday, June 15, 2009 (en-US)
  • 2009-06-15T13:45:30 -> Lundi 15 Juin 2009 (fr-FR)

Custom date and time format strings:

"dd" The day of the month, from 01 through 31.

  • 2009-06-15T13:45:30 -> 15

"ddd" The abbreviated name of the day of the week.

  • 2009-06-15T13:45:30 -> lun. (fr-FR)

"MM" The month, from 01 through 12.

  • 2009-06-15T13:45:30 -> 06

"MMM" The abbreviated name of the month.

  • 2009-06-15T13:45:30 -> juin (fr-FR)

"yyyy" The year as a four-digit number.

  • 2009-06-15T13:45:30 -> 2009

White space handling

The white space handling of the property applies to strings and localizable strings. It can be defined using White space handling property of string properties and localizable string properties. This property is automatically propagated to related entity view property and UI view property. It can also be defined on the entity view property and the UI view property.

On back end (entity and entity view), a check will be automatically generated to ensure that the value entered complies with the case. On the front end (view ui), white spaces are automatically cleaned as required. The following values are supported:

  • No leading and trailing white space
  • No leading white space
  • No trailing white space
  • No white space
  • None: Specifies that there are no check (back end) or conversion (front end).
  • Default: Uses the default value configured on the cluster. We invite you to consult the following article.
Note

White spacing handling does not apply when Character casing is camelCasing or PascalCasing

Multiline

The Multiline attribute applies to String and LocalizableString properties.

  • Multiline = true: line breaks are allowed.
  • Multiline = false: line breaks are rejected by backend validation on entities and entity views.

By default, this validation is enabled. This backend control is new in Neos 3.0; previous versions could allow incorrect multiline values to be saved in single-line properties. If you need to temporarily disable it, configure TextValidation:EnforceMultiLineConstraint in the backend configuration. See backend application configuration.

Max length validation

For text properties (String and LocalizableString) with a maximum length, backend validation rejects values that exceed the configured limit.

By default, this validation is enabled. If you need to temporarily disable it, configure TextValidation:EnforceMaxLengthConstraint in the backend configuration. See backend application configuration.