get first item
This block is part of the array group and was last modified in core v10.4.28.
Type Selection Required
This block requires you to select the data type you want to work with. You must manually select the type using the type selector modal. To access the modal, click the white button on the block.
Field Selection Required
This block requires field selection (out). You must manually select the fields you want to work with using the field selector modal. To access the modal, click the white button on the block.
get first item v10.4.28 Get the first item from the array.
- array required
arrayThe array from which to retrieve the first item.
Outputs the FIRST element of the array on the type-selected output pin (pin id value when no type is chosen). An empty or missing array, or a first element that is null, outputs null. The array itself is not modified.
A typical wiring for get first item: search feeds the array pin; the value out pin feeds custom field.
Commonly used with
In production blueprints, this block is most often wired together with:
- search: feeds into this block. searches in the given storage based on a query.
- get fields: wired in both directions with this block. Gets the selected fields from the given object.
- custom field: wired in both directions with this block. get the value of a custom field with a custom value block, or dynamic value.
- find by key - value: feeds into this block. Returns the matching objects for the given key value pair.
- update document: this block feeds into it. Update document in the given storage and creates a revision for it.
- fields: this block feeds into it.
Version history
Introduced in v10.4.28.
Back to
array Return to the main group to view all sub-groups Back to array Return to the group to view all blocks within this group