Common Annotations
Find here a reference and glossary of common annotations intrinsically supported by the CDS compiler and runtimes.
Learn more about the syntax of annotations.
Content
General Purpose
Annotation | Description | Alternatives |
---|---|---|
@title |
Common.Label |
|
@description |
Core.Description |
Access Control
Annotation | Description |
---|---|
@readonly |
see Input Validation |
@insertonly |
see Generic Handlers |
@restrict |
see Authorization |
@requires |
see Authorization |
Input Validation
Annotation | Description |
---|---|
@readonly |
see Input Validation |
@mandatory |
see Input Validation |
@assert.unique |
see Input Validation |
@assert.integrity |
see Input Validation |
@assert.target |
see Input Validation |
@assert.format |
see Input Validation |
@assert.range |
see Input Validation |
@assert.notNull |
see Input Validation |
Services / APIs
Annotation | Description |
---|---|
@path |
see Services |
@impl |
see Reuse & Compose |
@odata.etag |
see Providing Services |
@cds.autoexpose |
see Providing Services |
@cds.api.ignore |
see OData |
@cds.query.limit |
see Providing Services |
@cds.localized |
see Localized Data |
@cds.valid.from/to |
see Temporal Data |
@cds.search |
see Search Capabilities |
Persistence
Annotation | Description |
---|---|
@cds.persistence.exists |
tells compile.to.sql this is created otherwise |
@cds.persistence.table |
tells compile.to.sql to create a table, not a view |
@cds.persistence.skip |
tells the compiler, this entity shall not exist in database at all |
@cds.persistence.mock |
false excludes this entity from automatic mocking |
@cds.on.insert |
see Providing Services |
@cds.on.update |
see Providing Services |
OData
Learn more about OData Annotations in CDS.
Shortcuts:
Annotation | Description |
---|---|
@ValueList.entity |
see Domain Modeling |
@odata.Type |
see OData |
@odata.MaxLength |
see OData |
@odata.Precision |
see OData |
@odata.Scale |
see OData |
@odata.singleton |
see OData |
Intrinsically supported OData Annotations:
Annotation | Description |
---|---|
@Core.Computed |
see Providing Services |
@Core.Immutable |
see Providing Services |
@Core.MediaType |
see Media Data |
@Core.IsMediaType |
see Media Data |
@Core.IsUrl |
see Media Data |
@Capabilities... |
see Fiori |
@Common.FieldControl |
see Input Validation |