Common Properties of Fields

Refer to Common Properties of Fields chapter for detailed description.

Property Name

Allowed type / value

DSL Version

Required

Default Value

Description

name

name string

1

yes

Name of the field.

description

string

1

no

Human readable description of the field.

reuse

reference string

1

no

Field definition of which to copy.

displayName

string

1

no

Name of the field to display. If empty, the code generator must use value of property name instead. In order to force empty name to display, use "_" (underscore).

displayReadOnly

1

no

false

Disable modification of the field in visual analysis tool(s).

displayHidden

1

no

false

Don't display field at all in visual analysis tool(s).

sinceVersion

1

no

0

Version of the protocol in which field was introduced. Applicable only to members of the <message> or <bundle>.

deprecated

1

no

max unsigned

Version of the protocol in which field was deprecated. Must be greater than value of sinceVersion. Applipable only to members of the <message> or <bundle>.

removed

1

no

false

Indicates whether deprecated field has been removed from being serialized. Applicable only to members of the <message> or <bundle>.

failOnInvalid

1

no

false

Fail read operation if read value is invalid.

pseudo

1

no

false

In case of true, don't serialize/deserialize this field.

customizable

1

no

false

Mark the field to allow compile time customization regardless of code generator's level of customization.

semanticType

"none", "messageId", "version", "length"

1

no

none

Specify semantic type of the field. It allows code generator to generate special code for special cases. Value "length" was introduced in v2 of this specification.

Last updated

Was this helpful?