List

Property Type: list

List types store an array of references. Lists are used to model One-to-Many Relationships.

Property Options

Name

Type

Default

Description

sourceObject

String

0

The name of the source object for the list.

grant

Access Level (Integer) See Access Levels

This defines what level of access you have to the expanded list of object instances.

roles

ObjectID[]

This defines a set of roles to merge into the calling principal for access to the expanded object list.

skipAcl

Boolean

false

Select this if you'd like the matching to disregard all ACL rules.

where

String

A stringified where clause consisting of local instance properties linking the list references. Example: "{"c_doc_ref": "{{input._id}}" }"

linkedProperty

String

When set, connects the property to a top-level, indexed, readable, indexed, custom Reference in the sourceObject that points back to the current object. When using a linked property, the where condition is augmented with {c_parent: "{{input._id}}"}, which in many case makes the where clause obsolete. When using write-through, newly created children will automatically set the liked property to the identifier of the list holder. To further secure the relationship, the child reference can be marked as cascadeDelete:true and writable:false.

readThrough

Boolean

false

Allows reading objects in a list using specific identifiers and overriding list rules (defaultAcl, grant, roles)

writeThrough

Boolean

false

Allows creating and updating objects in a list using specific identifiers and overriding list rules (createAcl/defaultAcl, grant, roles)

updateOnWriteThrough

Boolean

false

When true, write-through events bubble up to the current instance and modify the updated date, firing any triggers and updating the ETag where required.

inheritInstanceRoles

Boolean

false

When true, instance roles held by the caller on the current instance are applied to the list instances.

createAcl

Object[]

[]

An overriding set of acl rules to apply to creation of child object instances when write-through is enabled.

defaultAcl

Object[]

[]

An overriding set of acl rules to apply to reading of child object instances when read/write-through is enabled.

Base property options not available:

  • array

  • indexed

  • unique

  • writable

  • minItems

  • maxItems

  • canPull

  • canPush

  • maxShift

  • writeOnCreate

Last updated